From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <cgen-return-2617-listarch-cgen=sources.redhat.com@sourceware.org>
Received: (qmail 10110 invoked by alias); 28 Oct 2014 19:04:14 -0000
Mailing-List: contact cgen-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <cgen.sourceware.org>
List-Subscribe: <mailto:cgen-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/cgen/>
List-Post: <mailto:cgen@sourceware.org>
List-Help: <mailto:cgen-help@sourceware.org>, <http://sourceware.org/lists.html#faqs>
Sender: cgen-owner@sourceware.org
Received: (qmail 10099 invoked by uid 89); 28 Oct 2014 19:04:13 -0000
Authentication-Results: sourceware.org; auth=none
X-Virus-Found: No
X-Spam-SWARE-Status: No, score=-1.9 required=5.0 tests=AWL,BAYES_00 autolearn=ham version=3.3.2
X-HELO: box00.pepelabs.net
Received: from xvm-14-181.ghst.net (HELO box00.pepelabs.net) (92.243.14.181) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Tue, 28 Oct 2014 19:04:12 +0000
Received: from localhost (localhost [127.0.0.1])	by box00.pepelabs.net (Postfix) with SMTP id EFF2120801	for <cgen@sourceware.org>; Tue, 28 Oct 2014 20:04:09 +0100 (CET)
Received: from mail.pepelabs.net (localhost [127.0.0.1])	by box00.pepelabs.net (Postfix) with ESMTP id BD6E8207F0	for <cgen@sourceware.org>; Tue, 28 Oct 2014 20:04:08 +0100 (CET)
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII; format=flowed
Content-Transfer-Encoding: 7bit
Date: Tue, 28 Oct 2014 19:04:00 -0000
From: Carlos Valiente <carlos@pepelabs.net>
To: cgen@sourceware.org
Subject: cgen/doc/running.texi: Fix documentation build
Message-ID: <f1d297cda75c1f86b54359f84d94da6a@pepelabs.net>
X-Sender: carlos@pepelabs.net
User-Agent: Roundcube Webmail/1.0.0
X-DSPAM-Result: Innocent
X-DSPAM-Processed: Tue Oct 28 20:04:09 2014
X-DSPAM-Confidence: 1.0000
X-DSPAM-Probability: 0.0023
X-DSPAM-Signature: 544fe8a915388649356227
X-IsSubscribed: yes
X-SW-Source: 2014-q4/txt/msg00001.txt.bz2

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