bugGNU Octave - Bugs: bug #59168, Build of the documentation fails...

 
 

bug #59168: Build of the documentation fails if not-yet-released texinfo versions are used

Submitted by:  Stefan Husmann <haawda>
Submitted on:  Tue 22 Sep 2020 11:41:01 PM UTC  
 
Category:  Configuration and Build System Severity:  3 - Normal
Priority:  5 - Normal Item Group:  Documentation
Status:  None Assigned to:  None
Originator Name:  Stefan Husmann Open/Closed:  Open
Release:  dev Operating System:  GNU/Linux

Add a New Comment (Rich Markup)
   

You are not logged in

Please log in, so followups can be emailed to you.

 

Wed 23 Sep 2020 03:03:31 PM UTC, comment #1: 

This feels like a classic speed versus correctness issue.  The version of texinfo that conforms to all standards, past and present, is slow, but the fast version does not reproduce everything that the old program did.

I agree that speeding up the Design/Build/Test loop is a good idea.  Unfortunately, the Octave binary is used at some points in constructing the documentation so it needs to be built before the documentation.

If I were you I would download the Octave sources, configure, and build to create everything.

Then, you can start making changing and re-building single files one at a time to see what makes a difference.

If you use "touch plot.txi" in the doc/interpreter directory the Makefile will then rebuild the plot.texi file which has the chapter on plotting.  There are 49 .txi files so lots of files for testing.

From the error messages I would judge that something is not working with the @anchor command or the @xref command.

Taking just one of the errors

gkUdm2pEl7:48830: @pxref reference to nonexistent node `XREFmovfun'

This probably came from stats.texi where I see

For additional options and documentation, @pxref{XREFmovfun,,movfun}.

and earlier

@anchor{XREFmovfun}

Rik <rik5>
Project Administrator
Tue 22 Sep 2020 11:41:01 PM UTC, original submission:  

In the upcomming version of texinfo the maintainer plans to introduce TEXINFO_XS_PARSER=1 as a default, which will increase, among other advantages, the speed documentation will be generated.

But this breaks the build of octave's documentation. I am in contact with him and we wonder if it is possible (for testing purposes and to avoid long runnig build circles) to only build the documentaion without any binaries given octave is installed by a package manager.

On my box I get

GEN      doc/interpreter/doc-cache
gkUdm2pEl7:1116: @xref reference to nonexistent node `Executable Octave Programs'
gkUdm2pEl7:1126: @xref reference to nonexistent node `Executable Octave Programs'
gkUdm2pEl7:1640: @xref reference to nonexistent node `The unwind_protect Statement'
gkUdm2pEl7:2227: @pxref reference to nonexistent node `Function Handles'
gkUdm2pEl7:2546: @xref reference to nonexistent node `Diary and Echo Commands'
gkUdm2pEl7:6583: @xref reference to nonexistent node `XREFtic'
gkUdm2pEl7:6963: @pxref reference to nonexistent node `XREFdbstop'
gkUdm2pEl7:7805: @pxref reference to nonexistent node `Formatted Output'
gkUdm2pEl7:7902: @pxref reference to nonexistent node `Formatted Output'
gkUdm2pEl7:7917: @ref reference to nonexistent node `XREFerror'
gkUdm2pEl7:7922: @pxref reference to nonexistent node `XREFwarning_ids'
gkUdm2pEl7:10873: @xref reference to nonexistent node `Strings'
gkUdm2pEl7:11061: @ref reference to nonexistent node `XREFmatlab_lang_makeValidName'
gkUdm2pEl7:12366: @ref reference to nonexistent node `Linear Algebra'
gkUdm2pEl7:12626: @ref reference to nonexistent node `Linear Algebra'
gkUdm2pEl7:12718: @ref reference to nonexistent node `Logical Values'
gkUdm2pEl7:12745: @ref reference to nonexistent node `Linear Algebra'
gkUdm2pEl7:12896: @ref reference to nonexistent node `Broadcasting'
gkUdm2pEl7:12963: @ref reference to nonexistent node `Broadcasting'
gkUdm2pEl7:13469: @ref reference to nonexistent node `Installation'
gkUdm2pEl7:13487: @xref reference to nonexistent node `Installation'
gkUdm2pEl7:14451: @pxref reference to nonexistent node `XREFbalance'
gkUdm2pEl7:14499: @pxref reference to nonexistent node `Startup Files'
gkUdm2pEl7:15018: @xref reference to nonexistent node `XREFregexp'
gkUdm2pEl7:15028: @xref reference to nonexistent node `XREFregexp'
gkUdm2pEl7:15853: @pxref reference to nonexistent node `XREFsize'
gkUdm2pEl7:15899: @pxref reference to nonexistent node `XREFsize'
gkUdm2pEl7:16524: @xref reference to nonexistent node `Timing Utilities'
gkUdm2pEl7:16528: @xref reference to nonexistent node `Timing Utilities'
gkUdm2pEl7:16532: @xref reference to nonexistent node `Timing Utilities'
gkUdm2pEl7:19768: @pxref reference to nonexistent node `XREFunique'
gkUdm2pEl7:19799: @pxref reference to nonexistent node `XREFsparse'
gkUdm2pEl7:20682: @pxref reference to nonexistent node `Formatted Output'
gkUdm2pEl7:21376: @pxref reference to nonexistent node `Formatted Output'
gkUdm2pEl7:21404: @pxref reference to nonexistent node `Formatted Output'
gkUdm2pEl7:22430: @pxref reference to nonexistent node `XREFcellfun'
gkUdm2pEl7:23234: @ref reference to nonexistent node `Figure Properties'
gkUdm2pEl7:23743: @ref reference to nonexistent node `XREFgetappdata'
gkUdm2pEl7:23766: @ref reference to nonexistent node `Uibuttongroup Properties'
gkUdm2pEl7:23810: @ref reference to nonexistent node `Uicontextmenu Properties'
gkUdm2pEl7:23852: @ref reference to nonexistent node `Uicontrol Properties'
gkUdm2pEl7:24048: @ref reference to nonexistent node `Uimenu Properties'
gkUdm2pEl7:24082: @ref reference to nonexistent node `Uipanel Properties'
gkUdm2pEl7:24128: @ref reference to nonexistent node `Uipushtool Properties'
gkUdm2pEl7:24248: @ref reference to nonexistent node `Uitable Properties'
gkUdm2pEl7:24448: @ref reference to nonexistent node `Uitoggletool Properties'
gkUdm2pEl7:24487: @ref reference to nonexistent node `Uitoolbar Properties'
gkUdm2pEl7:24547: @ref reference to nonexistent node `Figure Properties'
gkUdm2pEl7:24990: @pxref reference to nonexistent node `XREFlu'
gkUdm2pEl7:24993: @pxref reference to nonexistent node `XREFcgs'
gkUdm2pEl7:24993: @pxref reference to nonexistent node `XREFgmres'
gkUdm2pEl7:25021: @pxref reference to nonexistent node `Broadcasting'
gkUdm2pEl7:25282: @pxref reference to nonexistent node `Command Line Options'
gkUdm2pEl7:25915: @ref reference to nonexistent node `Image Properties'
gkUdm2pEl7:25949: @ref reference to nonexistent node `Image Properties'
gkUdm2pEl7:26163: @pxref reference to nonexistent node `Representing Images'
gkUdm2pEl7:26682: @pxref reference to nonexistent node `XREFdlmread'
gkUdm2pEl7:26699: @pxref reference to nonexistent node `XREFdlmwrite'
gkUdm2pEl7:27103: @pxref reference to nonexistent node `Anonymous Functions'
gkUdm2pEl7:27125: @pxref reference to nonexistent node `Anonymous Functions'
gkUdm2pEl7:29191: @pxref reference to nonexistent node `XREFsystem'
gkUdm2pEl7:30500: @xref reference to nonexistent node `XREFload'
gkUdm2pEl7:30503: @xref reference to nonexistent node `XREFhgload'
gkUdm2pEl7:30949: @xref reference to nonexistent node `XREFwarning_ids'
gkUdm2pEl7:32185: @ref reference to nonexistent node `XREFoptimset'
gkUdm2pEl7:32587: @ref reference to nonexistent node `XREFoptimset'
gkUdm2pEl7:33150: @pxref reference to nonexistent node `XREFoptimset'
gkUdm2pEl7:33309: @pxref reference to nonexistent node `XREFoptimset'
gkUdm2pEl7:34358: @pxref reference to nonexistent node `XREFcamup'
gkUdm2pEl7:34359: @pxref reference to nonexistent node `XREFcamva'
gkUdm2pEl7:34360: @pxref reference to nonexistent node `XREFcamtarget'
gkUdm2pEl7:34361: @pxref reference to nonexistent node `XREFcampos'
gkUdm2pEl7:34369: @pxref reference to nonexistent node `XREFgca'
gkUdm2pEl7:34400: @pxref reference to nonexistent node `XREFcamtarget'
gkUdm2pEl7:34404: @pxref reference to nonexistent node `XREFcamup'
gkUdm2pEl7:34432: @pxref reference to nonexistent node `XREFcamup'
gkUdm2pEl7:34446: @ref reference to nonexistent node `XREFcampos'
gkUdm2pEl7:34446: @ref reference to nonexistent node `XREFcamup'
gkUdm2pEl7:34660: @pxref reference to nonexistent node `XREFcamtarget'
gkUdm2pEl7:34674: @ref reference to nonexistent node `XREFcamroll'
gkUdm2pEl7:34850: @ref reference to nonexistent node `Text Properties'
gkUdm2pEl7:34985: @ref reference to nonexistent node `Text Properties'
gkUdm2pEl7:35081: @ref reference to nonexistent node `Graphics Object Properties'
gkUdm2pEl7:35162: @ref reference to nonexistent node `Legend Properties'
gkUdm2pEl7:35440: @ref reference to nonexistent node `Text Properties'
gkUdm2pEl7:35565: @ref reference to nonexistent node `Text Properties'
gkUdm2pEl7:35683: @ref reference to nonexistent node `Text Properties'
gkUdm2pEl7:35799: @ref reference to nonexistent node `Text Properties'
gkUdm2pEl7:35923: @ref reference to nonexistent node `Patch Properties'
gkUdm2pEl7:35987: @ref reference to nonexistent node `Patch Properties'
gkUdm2pEl7:36083: @ref reference to nonexistent node `Patch Properties'
gkUdm2pEl7:36090: @pxref reference to nonexistent node `XREFbar'
gkUdm2pEl7:36151: @pxref reference to nonexistent node `XREFcamup'
gkUdm2pEl7:36152: @pxref reference to nonexistent node `XREFcampos'
gkUdm2pEl7:36154: @pxref reference to nonexistent node `XREFcamtarget'
gkUdm2pEl7:36231: @ref reference to nonexistent node `Axes Properties'
gkUdm2pEl7:37167: @ref reference to nonexistent node `Patch Properties'
gkUdm2pEl7:37229: @ref reference to nonexistent node `Line Properties'
gkUdm2pEl7:37307: @ref reference to nonexistent node `Patch Properties'
gkUdm2pEl7:37353: @pxref reference to nonexistent node `XREFmeshgrid'
gkUdm2pEl7:37515: @pxref reference to nonexistent node `XREFmeshgrid'
gkUdm2pEl7:37646: @ref reference to nonexistent node `Light Properties'
gkUdm2pEl7:37721: @ref reference to nonexistent node `Line Properties'
gkUdm2pEl7:37770: @xref reference to nonexistent node `XREFerrorbar'
gkUdm2pEl7:37805: @ref reference to nonexistent node `Surface Properties'
gkUdm2pEl7:37843: @ref reference to nonexistent node `Surface Properties'
gkUdm2pEl7:37881: @ref reference to nonexistent node `Surface Properties'
gkUdm2pEl7:38037: @ref reference to nonexistent node `Patch Properties'
gkUdm2pEl7:38271: @ref reference to nonexistent node `Line Properties'
gkUdm2pEl7:38440: @ref reference to nonexistent node `Line Properties'
gkUdm2pEl7:38562: @pxref reference to nonexistent node `XREFcart2pol'
gkUdm2pEl7:38722: @ref reference to nonexistent node `Patch Properties'
gkUdm2pEl7:38748: @pxref reference to nonexistent node `XREFpatch'
gkUdm2pEl7:38813: @pxref reference to nonexistent node `XREFmeshgrid'
gkUdm2pEl7:38959: @ref reference to nonexistent node `Scatter Properties'
gkUdm2pEl7:39007: @ref reference to nonexistent node `Scatter Properties'
gkUdm2pEl7:39054: @xref reference to nonexistent node `XREFerrorbar'
gkUdm2pEl7:39106: @xref reference to nonexistent node `XREFerrorbar'
gkUdm2pEl7:39348: @ref reference to nonexistent node `Line Properties'
gkUdm2pEl7:39413: @ref reference to nonexistent node `Line Properties'
gkUdm2pEl7:39496: @ref reference to nonexistent node `Line Properties'
gkUdm2pEl7:39503: @xref reference to nonexistent node `XREFstem'
gkUdm2pEl7:39829: @ref reference to nonexistent node `Surface Properties'
gkUdm2pEl7:39871: @ref reference to nonexistent node `Surface Properties'
gkUdm2pEl7:39902: @ref reference to nonexistent node `Surface Properties'
gkUdm2pEl7:39998: @ref reference to nonexistent node `Surface Properties'
gkUdm2pEl7:40055: @ref reference to nonexistent node `Patch Properties'
gkUdm2pEl7:40095: @ref reference to nonexistent node `Patch Properties'
gkUdm2pEl7:40151: @ref reference to nonexistent node `Patch Properties'
gkUdm2pEl7:40188: @ref reference to nonexistent node `Surface Properties'
gkUdm2pEl7:40386: @ref reference to nonexistent node `Axes Properties'
gkUdm2pEl7:40533: @ref reference to nonexistent node `Figure Properties'
gkUdm2pEl7:40552: @pxref reference to nonexistent node `XREFfindobj'
gkUdm2pEl7:40628: @xref reference to nonexistent node `XREFfindall'
gkUdm2pEl7:40854: @ref reference to nonexistent node `Axes Properties'
gkUdm2pEl7:41516: @ref reference to nonexistent node `XREFfigurepaperorientation'
gkUdm2pEl7:41540: @ref reference to nonexistent node `XREFfigurepaperorientation'
gkUdm2pEl7:41950: @ref reference to nonexistent node `Axes Properties'
gkUdm2pEl7:46447: @xref reference to nonexistent node `XREFbetaln'
gkUdm2pEl7:48830: @pxref reference to nonexistent node `XREFmovfun'
gkUdm2pEl7:48935: @pxref reference to nonexistent node `XREFmovfun'
gkUdm2pEl7:49040: @pxref reference to nonexistent node `XREFmovfun'
gkUdm2pEl7:49145: @pxref reference to nonexistent node `XREFmovfun'
gkUdm2pEl7:49250: @pxref reference to nonexistent node `XREFmovfun'
gkUdm2pEl7:49355: @pxref reference to nonexistent node `XREFmovfun'
gkUdm2pEl7:49475: @pxref reference to nonexistent node `XREFmovfun'
gkUdm2pEl7:49580: @pxref reference to nonexistent node `XREFmovfun'
gkUdm2pEl7:49699: @pxref reference to nonexistent node `XREFmovfun'
gkUdm2pEl7:51770: @xref reference to nonexistent node `XREFexample'
gkUdm2pEl7:52518: @xref reference to nonexistent node `Installation'
makeinfo produced no output! at ../doc/interpreter/mk-doc-cache.pl line 108.
make[2]: *** [Makefile:31593: doc/interpreter/doc-cache] Error 1
make[2]: Leaving directory '/home/haawda/paketierung/meine_Pakete/octave-hg/src/octave/build'
make[1]: *** [Makefile:27603: all-recursive] Error 1
make[1]: Leaving directory '/home/haawda/paketierung/meine_Pakete/octave-hg/src/octave/build'

The build works if I export TEXINFO_XS_PARSER=0. If it is not easily fixable, this should at least be mentioned in the build instructions.

Stefan Husmann <haawda>

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by rik5 (Posted a comment)
  • -email is unavailable- added by haawda (Submitted the item)
  •  

    Do you think this task is very important?
    If so, you can add your encouragement to it.
    This task has 0 encouragements so far.

    Only project members can vote.

     

     

     

    No changes have been made to this item

    Back to the top


    Powered by Savane 3.5