On Tue, 2014-10-21 at 15:24 -0400, David Malcolm wrote: > On Tue, 2014-10-21 at 18:15 +0200, Gerald Pfeifer wrote: > > On Monday 2014-10-20 15:19, David Malcolm wrote: > > > +@item Sphinx (any working version) > > > > As opposed to "any non-working version"? ;-) I'd just omit > > "working" from this. > > FWIW, all my development has been with Sphinx 1.1.3, which is from > 2012-03-10. My guess is that it work with earlier versions: looking at > Sphinx's own docs, the most recently-added feature that I'm using is > domains, which is marked as 1.0 or later. > > > Otherwise this looks good to me, except... > > > > > +Necessary to regenerate @file{jit/docs/_build/texinfo} from the .rst > > > +files in the directories below @file{jit/docs}. > > > > ...that it probably should read @file{.rst}?
Committed to branch dmalcolm/jit: gcc/ChangeLog.jit: * doc/install.texi (Tools/packages necessary for modifying GCC): Specify that sphinx version 1.0 or later is required. Wrap .rst inside an @file command. --- gcc/ChangeLog.jit | 6 ++++++ gcc/doc/install.texi | 4 ++-- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/gcc/ChangeLog.jit b/gcc/ChangeLog.jit index 1c7f585..613084e 100644 --- a/gcc/ChangeLog.jit +++ b/gcc/ChangeLog.jit @@ -1,3 +1,9 @@ +2014-10-29 David Malcolm <dmalc...@redhat.com> + + * doc/install.texi (Tools/packages necessary for modifying GCC): + Specify that Sphinx version 1.0 or later is required. Wrap .rst + inside an @file command. + 2014-10-22 David Malcolm <dmalc...@redhat.com> * cgraph.h: Drop now-redundant prototype of ipa_cp_c_finalize, diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index 5add9f6..ef7656c 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -491,9 +491,9 @@ Necessary for running @command{texi2dvi} and @command{texi2pdf}, which are used when running @command{make dvi} or @command{make pdf} to create DVI or PDF files, respectively. -@item Sphinx (any working version) +@item Sphinx version 1.0 (or later) -Necessary to regenerate @file{jit/docs/_build/texinfo} from the .rst +Necessary to regenerate @file{jit/docs/_build/texinfo} from the @file{.rst} files in the directories below @file{jit/docs}. @item SVN (any version) -- 1.7.11.7