public inbox for cgen@sourceware.org
 help / color / mirror / Atom feed
* cgen/doc/running.texi: Fix documentation build
@ 2014-10-28 19:04 Carlos Valiente
  0 siblings, 0 replies; only message in thread
From: Carlos Valiente @ 2014-10-28 19:04 UTC (permalink / raw)
  To: cgen

Hi! My version of `makeinfo` (5.2) fails to build the documentation 
because of the `@subsection Set up the arguments for cgen` line in 
`cgen/doc/running.texi`:

     $ make info
     restore=: && backupdir=".am$$" && \
             rm -rf $backupdir && mkdir $backupdir && \
             if (makeinfo --split-size=5000000 --version) >/dev/null 
2>&1; then \
               for f in cgen.info cgen.info-[0-9] cgen.info-[0-9][0-9] 
cgen.i[0-9] cgen.i[0-9][0-9]; do \
                 if test -f $f; then mv $f $backupdir; restore=mv; else 
:; fi; \
               done; \
             else :; fi && \
             if makeinfo --split-size=5000000   -I ../.././cgen/doc \
              -o cgen.info `test -f 'cgen.texi' || echo 
'../.././cgen/doc/'`cgen.texi; \
             then \
               rc=0; \
             else \
               rc=$?; \
               $restore $backupdir/* `echo "./cgen.info" | sed 
's|[^/]*$||'`; \
             fi; \
             rm -rf $backupdir; exit $rc
     ./running.texi:19: raising the section level of @subsection which is 
too low
     make: *** [cgen.info] Error 1
     $

When that line is removed, the documentation can be built:

     diff --git a/cgen/doc/running.texi b/cgen/doc/running.texi
     index a435405..0b76f49 100644
     --- a/cgen/doc/running.texi
     +++ b/cgen/doc/running.texi
      @@ -16,8 +16,6 @@ The main tasks of this script are to:
      @item Apply any post processing to the output files.
      @end enumerate

     -@subsection Set up the arguments for cgen.
     -
      CGEN takes several standard arguments.
      Each application can then add its own arguments.
      By convention generic CGEN options are lowercase letters

Is there a better way of fixing this issue?

C



^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2014-10-28 19:04 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2014-10-28 19:04 cgen/doc/running.texi: Fix documentation build Carlos Valiente

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).