CVSROOT: /cvs/ppl Module name: ppl Changes by: bagnara@cs.unipr.it 2006-01-16 11:12:06
Modified files: . : TODO
Log message: To-do items for PPL 0.8 removed. Remember to complete/write man pages for PPL 0.9.
Patches: http://www.cs.unipr.it/cgi-bin/cvsweb.cgi/ppl/TODO.diff?cvsroot=ppl&r1=1...
Roberto Bagnara bagnara@cs.unipr.it writes:
CVSROOT: /cvs/ppl Module name: ppl Changes by: bagnara@cs.unipr.it 2006-01-16 11:12:06
Modified files: . : TODO
Log message: To-do items for PPL 0.8 removed. Remember to complete/write man pages for PPL 0.9.
It'd be nice if the manual pages also came in texinfo format.
Patches: http://www.cs.unipr.it/cgi-bin/cvsweb.cgi/ppl/TODO.diff?cvsroot=ppl&r1=1...
PPL-devel mailing list PPL-devel@cs.unipr.it http://www.cs.unipr.it/mailman/listinfo/ppl-devel
Matthew Mundell wrote:
It'd be nice if the manual pages also came in texinfo format.
It's a problem of manpower, as usual.
Notice that the current man pages have been generated by a simple script based un help2man. This is a GNU tool that generates a man page out of '--help' and '--version' output. The big advantage is that you only maintain the application, and let help2man update the man documentation accordingly. I will commit the scripts after the release of PPL 0.8.
Meanwhile you can:
1) note your wish in the TODO file; 2) start looking for a help2texinfo or man2texinfo tool.
Ciao,
Roberto
Roberto Bagnara bagnara@cs.unipr.it writes:
Matthew Mundell wrote:
It'd be nice if the manual pages also came in texinfo format.
It's a problem of manpower, as usual.
Notice that the current man pages have been generated by a simple script based un help2man. This is a GNU tool that generates a man page out of '--help' and '--version' output. The big advantage is that you only maintain the application, and let help2man update the man documentation accordingly. I will commit the scripts after the release of PPL 0.8.
From the help2man README:
Since most GNU documentation is now in info format, this provides a way to generate a placeholder man page pointing to that resource while still providing some useful information.
In the long term maybe the invocation help can be moved into the user manual, and texinfo can be added to the user manual formats. The man page could then duplicate the invocation details in the user manual.
Meanwhile you can:
- note your wish in the TODO file;
- start looking for a help2texinfo or man2texinfo tool.
Ciao,
Roberto
participants (2)
-
Matthew Mundell -
Roberto Bagnara