From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 31777 invoked by alias); 5 Feb 2015 01:28:54 -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 31753 invoked by uid 89); 5 Feb 2015 01:28:53 -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.4 required=5.0 tests=AWL,BAYES_00,FREEMAIL_FROM,RCVD_IN_DNSWL_LOW,SPF_PASS autolearn=ham version=3.3.2 X-Spam-Status: No, score=-2.4 required=5.0 tests=AWL,BAYES_00,FREEMAIL_FROM,RCVD_IN_DNSWL_LOW,SPF_PASS 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: mail-la0-f44.google.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=qFeZM2r6QFRyyNdfgun18NaEoT8qkM1VH43LAqxHYg8=; b=GkU9DJLZL3cZHkRlyTMNjq/xAyEBz2BpdH0vN2DpVrJElwxFB3ajx2XfRy67lOiFph nnmBZJQdcOyOI4faRg8RxmcliGzmR2fdcOd6BXyQ1ZvUFNtxUDJgqDxUZZJuLiWTG2cc AY68MT3tEdSczoa64tZSZoCnPoXCLAQOU3IT0F6aAKHvf8GkbkUa+iixGax2WtttGhVY c903mVat0Mn0SBvJ7P2RGOZSyM1iegBzZBGxbW7R0PxBj+HfuEiJotSqn9rHvFicGWU1 r0cKsuL7WYPE0YILexNWlZdFjCzuBLst5SYUzyjShKCF9IvqDiFoaYom25rDc0nqAhN6 9O2Q== MIME-Version: 1.0 X-Received: by 10.112.25.104 with SMTP id b8mr954848lbg.69.1423099728660; Wed, 04 Feb 2015 17:28:48 -0800 (PST) In-Reply-To: <1423074736-47636-1-git-send-email-dmalcolm@redhat.com> References: <1423074736-47636-1-git-send-email-dmalcolm@redhat.com> Date: Thu, 01 Jan 2015 00:00:00 -0000 Message-ID: Subject: Re: [PATCH] More fixes for update_web_docs_svn for jit docs (PR jit/64257) From: Andrew Pinski To: David Malcolm Cc: jit@gcc.gnu.org, GCC Patches , Gerald Pfeifer , Jeff Law Content-Type: text/plain; charset=UTF-8 X-SW-Source: 2015-q1/txt/msg00064.txt.bz2 On Wed, Feb 4, 2015 at 10:32 AM, David Malcolm wrote: > 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/ Can you document this in https://gcc.gnu.org/install/prerequisites.html ? Also can you make sure that release script creates the precreates documentation so people don't need to install something else to install GCC (releases don't need makeinfo to install). Thanks, Andrew > > 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 >