Explanation of basic fields

[gildor478]

This feature request has been migrated from artifact #700 on forge.ocamlcore.org. It was assigned to user102.

user188 posted on 2010-07-27 15:18:24:

I find the current documentation insufficient.

The ConfType field is described as "Configuration system" which is meaningless. I suppose it should be "identifier of the configuration system to be used". But it should be explained what is the scope of "configuration system" in case of OASIS.

There is a related problem is the hints OASIS gives during -quickstart: some of them are useless. For example:

Value for field 'ConfType'? (default is 'internal (0.1.0)', type '?' for help) Configuration system.

The hint doesn't explain what should be entered here. My proposal is just to list all accepted values (with their description).

user102 replied on 2010-07-27 15:49:34:

Maybe being a little bit more verbose about what a configuration system is, could be helpful.

There is also the online documentation and the 'OASIS -manual' documentation that are more lengthy.

user188 replied on 2010-07-27 15:58:56:

I have installed OASIS from the available tarball. It has no -manual: /usr/local/bin/OASIS: unknown option `-manual'.

Which revision is the more current but stable enough to play with?

user102 replied on 2010-07-27 16:09:43:

Sorry "OASIS -documentation" (in v0.2.0 this "OASIS manual") or the online manual http://oasis.forge.ocamlcore.org/MANUAL.html