[jira] [Commented] (TS-2377) DOC: install man pages as part of the build

["ASF subversion and git services (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/TS-2377?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13829242#comment-13829242 ] 

ASF subversion and git services commented on TS-2377:
-----------------------------------------------------

Commit aeb5bbb7f4d557b1a45b0554401c2699046da8f5 in branch refs/heads/master from [~jpeach@apache.org]
[ https://git-wip-us.apache.org/repos/asf?p=trafficserver.git;h=aeb5bbb ]

TS-2377: install man pages as part of the build

Add options to conf.py to tell us the man pages for each section,
because AFAICT there's no portable way to set automake variables
from shell output commands. We also teach conf.py to test for a
current sphinx version at configure time.

Wire up sphinx to the man page install and test for the sphinx
version pretty aggressively at configure time. Distro packaging
seems prety variable, so I think it's best to be conservative.


> DOC: install man pages as part of the build
> -------------------------------------------
>
>                 Key: TS-2377
>                 URL: https://issues.apache.org/jira/browse/TS-2377
>             Project: Traffic Server
>          Issue Type: Bug
>          Components: Documentation, Quality
>            Reporter: James Peach
>            Assignee: James Peach
>             Fix For: 4.2.0
>
>
> We should install the sphinx-generated man pages as part of the build. This would make it easy for both vendors and users to package the documentation with the binary products.



--
This message was sent by Atlassian JIRA
(v6.1#6144)