You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@trafficserver.apache.org by "Leif Hedstrom (JIRA)" <ji...@apache.org> on 2015/07/02 04:05:04 UTC
[jira] [Updated] (TS-3700) should run doxygen before running sphinx
[ https://issues.apache.org/jira/browse/TS-3700?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Leif Hedstrom updated TS-3700:
------------------------------
Fix Version/s: Docs
> should run doxygen before running sphinx
> ----------------------------------------
>
> Key: TS-3700
> URL: https://issues.apache.org/jira/browse/TS-3700
> Project: Traffic Server
> Issue Type: Bug
> Components: Docs
> Reporter: Oknet Xu
> Fix For: Docs
>
>
> warning message:
> Running Sphinx v1.1.3
> WARNING: Doxygen files not found: xml/index.xml
> The files are used to add links from an API description to the source
> code for that object.
> Run "$ make doxygen" to generate these XML files.
> here is the patch:
> {code}
> diff --git a/doc/Makefile.am b/doc/Makefile.am
> index 557d8a4..4ff456f 100644
> --- a/doc/Makefile.am
> +++ b/doc/Makefile.am
> @@ -35,9 +35,11 @@ endif
> clean-local:
> -rm -rf $(BUILDDIR)/* _build/html/* xml
>
> -doxygen: Doxyfile
> +xml/index.xml: Doxyfile
> $(DOXYGEN)
>
> +doxygen: xml/index.xml
> +
> # Makefile for Sphinx documentation
> #
>
> @@ -71,32 +73,32 @@ help:
> @echo " changes to make an overview of all changed/added/deprecated items"
> @echo " linkcheck to check all external links for integrity"
>
> -html-local:
> +html-local: doxygen
> $(SBUILD) -d $(BUILDDIR)/doctrees -b html $(srcdir) $(BUILDDIR)/html
> @echo
> @echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
>
> -dirhtml:
> +dirhtml: doxygen
> $(SBUILD) -d $(BUILDDIR)/doctrees -b dirhtml $(srcdir) $(BUILDDIR)/html
> @echo
> @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
>
> -singlehtml:
> +singlehtml: doxygen
> $(SBUILD) -d $(BUILDDIR)/doctrees -b singlehtml $(srcdir) $(BUILDDIR)/singlehtml
> @echo
> @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
>
> -epub:
> +epub: doxygen
> $(SBUILD) -d $(BUILDDIR)/doctrees -b epub $(srcdir) $(BUILDDIR)/epub
> @echo
> @echo "Build finished. The epub file is in $(BUILDDIR)/epub."
>
> -latex:
> +latex: doxygen
> $(SBUILD) -d $(BUILDDIR)/doctrees -b latex $(srcdir) $(BUILDDIR)/latex
> @echo
> @echo "Build finished. The epub file is in $(BUILDDIR)/latex."
>
> -man:
> +man: doxygen
> $(SBUILD) -d $(BUILDDIR)/doctrees -b man $(srcdir) $(BUILDDIR)/man
> @echo
> @echo "Build finished. The man pages are in $(BUILDDIR)/man."
> {code}
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)