trafficserver-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From James Peach <jamespe...@me.com>
Subject Re: user level man pages
Date Wed, 18 Jan 2012 04:44:08 GMT
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.galic@brainsware.org
> URL: http://brainsware.org/
> GPG: 6880 4155 74BD FD7C B515  2EA5 4B1D 9E08 A097 C9AE
> 


Mime
View raw message