[Octave-bug-tracker] [bug #59168] Build of the documentation fails if not-yet-released texinfo versions are used

[Rik]

Follow-up Comment #1, bug #59168 (project octave):

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}




    _______________________________________________________

Reply to this item at:

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

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