From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 23425 invoked by alias); 4 Feb 2015 18:22:49 -0000 Mailing-List: contact jit-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Post: List-Help: List-Subscribe: Sender: jit-owner@gcc.gnu.org Received: (qmail 23406 invoked by uid 89); 4 Feb 2015 18:22:49 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Checked: by ClamAV 0.98.5 on sourceware.org X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.0 required=5.0 tests=AWL,BAYES_00,SPF_HELO_PASS,SPF_PASS,T_RP_MATCHES_RCVD autolearn=ham version=3.3.2 X-Spam-Status: No, score=-2.0 required=5.0 tests=AWL,BAYES_00,SPF_HELO_PASS,SPF_PASS,T_RP_MATCHES_RCVD autolearn=ham version=3.3.2 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on sourceware.org X-Spam-Level: X-Spam-User: qpsmtpd, 2 recipients X-HELO: mx1.redhat.com From: David Malcolm To: jit@gcc.gnu.org, gcc-patches@gcc.gnu.org Cc: Gerald Pfeifer , Jeff Law , David Malcolm Subject: [PATCH] More fixes for update_web_docs_svn for jit docs (PR jit/64257) Date: Thu, 01 Jan 2015 00:00:00 -0000 Message-Id: <1423074736-47636-1-git-send-email-dmalcolm@redhat.com> In-Reply-To: References: X-Scanned-By: MIMEDefang 2.68 on 10.5.11.23 X-SW-Source: 2015-q1/txt/msg00058.txt.bz2 To build the jit docs, we need to use sphinx 1.0 or later; the 0.6.6 in EPEL 6 doesn't support all the directives we need. The alternate python-sphinx10 in EPEL 6 has 1.0.8: python-sphinx10-1.0.8-1.el6.noarch which is able to build the jit docs, apart from not having the "pyramid" theme (this theme appears to have been added in 1.1). Change the theme to "sphinxdoc", which seems to be the most attractive theme in 1.0.8 (FWIW, it appears that LLVM are using a custom variant of this sphinx theme for the docs on their website). I was able to use these changes to run the jit docs Makefile on sourceware.org; the generated HTML can be seen at: https://dmalcolm.fedorapeople.org/gcc/2015-02-04/jit-docs-sphinxdocs/ OK for trunk? gcc/jit/ChangeLog: PR jit/64257 * docs/conf.py (html_theme): Change from 'pyramid' to 'sphinxdoc'. maintainer-scripts/ChangeLog: PR jit/64257 * update_web_docs_svn: Update build of jit docs to use EPEL6 variant install of sphinx 1.0.8, rather than 0.6.6. --- gcc/jit/docs/conf.py | 2 +- maintainer-scripts/update_web_docs_svn | 18 ++++++++++++++---- 2 files changed, 15 insertions(+), 5 deletions(-) diff --git a/gcc/jit/docs/conf.py b/gcc/jit/docs/conf.py index 1bdc081..8f4dd8b 100644 --- a/gcc/jit/docs/conf.py +++ b/gcc/jit/docs/conf.py @@ -107,7 +107,7 @@ pygments_style = 'sphinx' # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. -html_theme = 'pyramid' +html_theme = 'sphinxdoc' # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the diff --git a/maintainer-scripts/update_web_docs_svn b/maintainer-scripts/update_web_docs_svn index ac3bae6..e0132dc 100755 --- a/maintainer-scripts/update_web_docs_svn +++ b/maintainer-scripts/update_web_docs_svn @@ -166,11 +166,21 @@ for file in $MANUALS; do done # The jit is a special-case, using sphinx rather than texinfo. -# The jit Makefile uses "sphinx-build". This is packaged in -# Fedora and EPEL 6 within "python-sphinx", and in openSUSE -# within "python-Sphinx". +# Specifically, the jit docs need sphinx 1.0 or later. +# +# The jit/docs Makefile uses the executable $(SPHINXBUILD), +# defaulting to "sphinx-build". +# +# sphinx is packaged in Fedora and EPEL 6 within "python-sphinx", +# and in openSUSE within "python-Sphinx". +# +# For EPEL6, python-sphinx is sphinx 0.6.6, which is missing various +# directives (e.g. ":c:macro:"), so we need the variant +# python-sphinx10 package. The latter installs its executable as: +# /usr/bin/sphinx-1.0-build +# so we need to override SPHINXBUILD with this when invoking "make". pushd gcc/gcc/jit/docs -make html +make SPHINXBUILD=/usr/bin/sphinx-1.0-build html popd cp -a gcc/gcc/jit/docs/_build/html jit mkdir -p $DOCSDIR/jit -- 1.8.5.3