On 15/01/2012, at 10:27 PM, Igor Galić wrote: > > > ----- Original Message ----- >> Hi all, >> >> I noticed that there are man pages in doc/man, but these largely >> consist of documentation for the traffic_shell tool. It strikes me > > I suppose the reason is that putting everything in one man page > makes it terribly awful for navigating. > Compare bash's and zsh's man pages.
IMHO it's unlikely that anyone doing "man exit" is looking for the traffic_shell subcommand ;) >> as a little odd for all the sub commands to have their own man page. >> The build does not install these, and the corresponding Makefile.am >> seems to have bitrotted. >> >> Is there any interest in having man pages for user/admin >> documentation? or are these planned for the doxygen build? > > I'm afraid there's nothing concrete planned, but whatever helps > us get to a status of where those are usable again is highly > appreciated. > > I suggest communicating your plans either in the STATUS file > (the docs have their own) -- in a project proposal in the wiki > > https://cwiki.apache.org/confluence/display/TS/Projects https://cwiki.apache.org/confluence/display/TS/User+Interface+Improvements > >> J > > > i > > -- > Igor Galić > > Tel: +43 (0) 664 886 22 883 > Mail: i.ga...@brainsware.org > URL: http://brainsware.org/ > GPG: 6880 4155 74BD FD7C B515 2EA5 4B1D 9E08 A097 C9AE >
