I had a proposal about preparing a standard for manual pages of commands.
Some of us have projects about lunix kernel or its applications. So, can we supply the manuals of our applications in an standard form? With this way we can provide a unix-like 'man' command for our needs. Only thing we have to do is preparing the manuals concerning the presented form below. But of course it would be good if we keep the manual as short as possible.
I guess using petscii is OK for the moment, later we can convert it to iso-latin. Also petcsii has the advantage of existing editor ED to be used to enter or alter man. pages in the LUnix environment. After examination of a unix system, here what I propose:
<cmd-name> - one line description
Descriptions of the features
You can explain all the switches here.
Bugs, restrictions warnings ...
a few is enough I think.
files supplied with the application program. At least there is
references to related commands applications should be placed here.
you can supply your disclaimer here. ...
That's all, but please use a newline at the end.
Any other suggestions, ideas ?
You can click here to go to CBM Projects and search page: http://members.tripod.com/~ilkerf/cbm.html