[
https://issues.apache.org/jira/browse/TS-764?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13761183#comment-13761183
]
James Peach commented on TS-764:
--------------------------------
Although, the man pages are currently skeletons, and none of the docs are
actually *shipped* with the product (ie. not installed) ...
> Traffic Server does not ship any documentation
> -----------------------------------------------
>
> Key: TS-764
> URL: https://issues.apache.org/jira/browse/TS-764
> Project: Traffic Server
> Issue Type: Improvement
> Components: Documentation
> Affects Versions: 2.1.8
> Reporter: Arno Toell
>
> A major problem for ATS to the unskilled user as of today is, there is no
> on-line documentation besides the (somewhat scarce) information from the
> home page is available. In particular ATS misses
> * first of all: man pages
> * Description of command line switches (if any), including an interactive
> help, e.g. the common _"-h/--help"_ switch.
> * Description of the used environment, e.g. _$TS_ROOT_ where applicable.
> I think this would be an important release goal for the 3.0 release since
> that branch is intended for productive use, not by developers. If someone
> provides me the information or has all needed information in a written form,
> I could assist to provide man pages.
> I'm aware there is some documentation for _traffic_shell_ commands. I'm
> unsure if the documentation there reflects the most recent development and is
> generally up to date. If it is still suitable for ATS as of today, it should
> be merged with any newly created documentation. As a remark: I remember there
> was some discussion in the past, where to install the man pages because of
> the rather generic names, for example "enable", "disable", "exit", ...
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira