🚀 go-pugleaf

"David J. MacKenzie" writes:
 > I had to make the following changes to the vm 5.33 vm.texinfo so that
 > makeinfo 1.43 would format it without warnings.  After the diff are
 > the error messages I got initially.

Unfortunately to do this you had to take out the some lines
necessary for the printed manual.  I'm not willing to do this in
the distribution.  Also makeinfo whines about things that it
shouldn't care about.  Let's go over the errors:

 > Making info file `vm' from `vm.texinfo'.
 > vm.texinfo:626: Expected `table', but saw `ifinfo'..

This is generated by

@iftex
@table @asis
@end iftex
@ifinfo
@table @key
@end ifinfo

Here I'm using one type of @table construct for the Info
document and another for the TeX document.  Seems a fair use of 
@iftex/@ifinfo to me.

 > vm.texinfo:52: Node `Top''s Next field not pointed back to.
 > vm.texinfo:385: This node (`Introduction') is the one with the bad `Prev'.

Top is the top level of the info tree and you can get to it with
an 'up' from any of the chapters.  Top really doesn't have a
logical next, but since the next field is there I decided to make
it the most logical place a reader would want to go from Top when
they first started using the manual.  Top->next is therefore
Introduction.  Introduction->prev is License, because I wanted to
stub License into the manual somewhere out of the way.

 > vm.texinfo:82: Node `License''s Prev field not pointed back to.
 > vm.texinfo:1415: This node (`Variable Index') is the one with the bad `Next'.

License isn't really part of the manual so I felt no need to out
it into the main chapter loop.

 > vm.texinfo:52: `License' has an Up field of `Top', but `Top' has no menu item for `License'.

License isn't really part of the Manual so I felt no need to put
it in the main chapter menu.

 > vm.texinfo:1415: Node `Variable Index''s Next field not pointed back to.
 > vm.texinfo:385: This node (`Introduction') is the one with the bad `Prev'.

Variable Index->next points to Introduction.  Introduction->prev
points to License to stub it into the manual.  License->prev
points to Variable Index to get back into the manual.

 > vm.texinfo:82: Warning: Unreferenced node `License'.

I assume this is because there's no menu entry or cross-reference.

I hope makeinfo creates the Info file despite these warnings.  I
doubt that I'm going to do much to satisfy makeinfo's idea of
what a well-structured Info document ought to be.