[bug #64983] PDF generation fails with texinfo/7.1

[Yavor Doganov]

URL:
  <https://savannah.gnu.org/bugs/?64983>

                 Summary: PDF generation fails with texinfo/7.1
                   Group: GNUstep
               Submitter: yavor
               Submitted: Tue 05 Dec 2023 10:14:17 AM EET
                Category: Makefiles
                Severity: 3 - Normal
              Item Group: Documentation
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any


    _______________________________________________________

Follow-up Comments:


-------------------------------------------------------
Date: Tue 05 Dec 2023 10:14:17 AM EET By: Yavor Doganov <yavor>
With texinfo/7.1, PDF generation for two documents in the gnustep-make package
(gnustep-make.texi and gnustep-filesystem.texi) fails with the following
error:


$ texi2pdf gnustep-filesystem.texi 
This is pdfTeX, Version 3.141592653-2.6-1.40.25 (TeX Live 2023/Debian)
(preloaded format=pdfetex)
 restricted \write18 enabled.
entering extended mode
(./gnustep-filesystem.texi (/usr/share/texmf/tex/texinfo/texinfo.tex
Loading texinfo [version 2023-09-19.19]: pdf, fonts, glyphs, page headings,
tables, conditionals, indexing, sectioning, toc, environments, defuns,
macros,
cross references, insertions,
(/usr/share/texlive/texmf-dist/tex/generic/epsf/epsf.tex
This is `epsf.tex' v2.7.4 <14 February 2011>
) localization, formatting, microtype, and turning on texinfo input format.)
[1{/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map}] [2]
(/tmp/gnustep-make-2.9.1/Documentation/gnustep-filesystem.toc
/tmp/gnustep-make-2.9.1/Documentation/gnustep-filesystem.toc:1: Undefined
contr
ol sequence.
@numsecentry ...dafter @xdef @csname @curchapname 
                                                  @endcsname {@the @wd 0}@fi 
l.1 ...e System Domain}{1.1}{The System Domain}{1}
                                                  
? 
/tmp/gnustep-make-2.9.1/Documentation/gnustep-filesystem.toc:1: Emergency
stop.

@numsecentry ...dafter @xdef @csname @curchapname 
                                                  @endcsname {@the @wd 0}@fi 
l.1 ...e System Domain}{1.1}{The System Domain}{1}
                                                  
/tmp/gnustep-make-2.9.1/Documentation/gnustep-filesystem.toc:1:  ==> Fatal
erro
r occurred, no output PDF file produced!
Transcript written on gnustep-filesystem.log.
This is pdfTeX, Version 3.141592653-2.6-1.40.25 (TeX Live 2023/Debian)
(preloaded format=pdfetex)
 restricted \write18 enabled.
entering extended mode
(./gnustep-filesystem.texi (/usr/share/texmf/tex/texinfo/texinfo.tex
Loading texinfo [version 2023-09-19.19]: pdf, fonts, glyphs, page headings,
tables, conditionals, indexing, sectioning, toc, environments, defuns,
macros,
cross references, insertions,
(/usr/share/texlive/texmf-dist/tex/generic/epsf/epsf.tex
This is `epsf.tex' v2.7.4 <14 February 2011>
) localization, formatting, microtype, and turning on texinfo input format.)
[1{/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map}] [2]
(/tmp/gnustep-make-2.9.1/Documentation/gnustep-filesystem.toc
/tmp/gnustep-make-2.9.1/Documentation/gnustep-filesystem.toc:1: Undefined
contr
ol sequence.
@numsecentry ...dafter @xdef @csname @curchapname 
                                                  @endcsname {@the @wd 0}@fi 
l.1 ...e System Domain}{1.1}{The System Domain}{1}
                                                  
? 
/tmp/gnustep-make-2.9.1/Documentation/gnustep-filesystem.toc:1: Emergency
stop.

@numsecentry ...dafter @xdef @csname @curchapname 
                                                  @endcsname {@the @wd 0}@fi 
l.1 ...e System Domain}{1.1}{The System Domain}{1}
                                                  
/tmp/gnustep-make-2.9.1/Documentation/gnustep-filesystem.toc:1:  ==> Fatal
erro
r occurred, no output PDF file produced!
Transcript written on gnustep-filesystem.log.
/usr/bin/texi2dvi: pdfetex exited with bad status, quitting.


I guess the culprit is that a sectioning command is used for the top node
while it is not destined for printed output (that's why texinfo documentation
advised to enclose it in an @ifnottex conditional but that's now done
automatically behind the scenes).  Note that even with older texinfo versions,
the PDF file for gnustep-filesystem is generated wrongly: it lacks the
introductory text at the beginning, starting with "The System Domain" right
after the contents.

Attached is a trivial patch that fixes these problems.






    _______________________________________________________
File Attachments:


-------------------------------------------------------
Date: Tue 05 Dec 2023 10:14:17 AM EET  Name:
0001-Fix-PDF-generation-with-texinfo-7.1.patch  Size: 27KiB   By: yavor

<http://savannah.gnu.org/bugs/download.php?file_id=55405>

    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?64983>

_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/