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

Submitter:  Stefan Husmann <haawda>
Submitted:  Tue 22 Sep 2020 11:41:01 PM UTC
   
 
Category:  Configuration and Build System Severity:  3 - Normal
Priority:  5 - Normal Item Group:  Documentation
Status:  Invalid / Not an Octave Bug Assigned to:  None
Originator Name:  Stefan Husmann Open/Closed:  * Closed
Release:  * dev Operating System:  * GNU/Linux
Fixed Release:  None Planned Release:  None
* Mandatory Fields

Add a New Comment Rich Markup
   

Tue 30 Aug 2022 04:02:59 PM UTC, comment #2: 

I'm not sure which upcoming version of texinfo @haawda was referring to. But since Sep 2020 a new texinfo version has been released. Afaict, building Octave's manual didn't break.

Anyway, IIUC this issue is not about a bug in Octave. So, closing report.

If there is something that should be changed in Octave that is related to the issue described here, please leave a comment and we can re-open the report.

Markus Mützel <mmuetzel>
Group administrator
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>
Group 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 mmuetzel (Posted a comment)
  • -email is unavailable- added by rik5 (Posted a comment)
  • -email is unavailable- added by haawda (Submitted the item)
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only group members can vote.

     

    Follow 2 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2022-08-30 mmuetzel StatusNone Invalid / Not an Octave Bug
        Open/ClosedOpen Closed

    Back to the top

    Powered by Savane 3.13-f8d8.
    Corresponding source code