[jira] [Commented] (DISPATCH-123) Separate target to build documentation.

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

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

ASF subversion and git services commented on DISPATCH-123:
----------------------------------------------------------

Commit 1664745 from [~aconway] in branch 'dispatch/trunk'
[ https://svn.apache.org/r1664745 ]

DISPATCH-123: Separate target to build documentation.

Create a separate "make doc" target to build documentation, not run automatically by "make all"

NOTE: This uses cmake 2.8 features (optional install) to work. On cmake < 2.8 we go back to
the previous behavior of building the doc in "make all"

> Separate target to build documentation.
> ---------------------------------------
>
>                 Key: DISPATCH-123
>                 URL: https://issues.apache.org/jira/browse/DISPATCH-123
>             Project: Qpid Dispatch
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 0.4
>            Reporter: Alan Conway
>            Assignee: Alan Conway
>             Fix For: 0.5
>
>
> Building the API documentation takes a while and is a onec-off task so for developer convenience it doesn't need to be in the "all" target.
> You can already disable it with the BUILD_DOCS cmake option but it's a pain to twiddle those options all the time, and developers might want to build the docs when they're done with changes e.g. to review APIdoc changes, but not to re-build them for every source change.
> Move the doc creation to a seprate target "make doc" that is not automatically included in "make all"



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@qpid.apache.org
For additional commands, e-mail: dev-help@qpid.apache.org