Texinfo 5 complains about the documentation

[Göran Uddeborg]

I was trying to build an updated version of the vm package for Fedora 19, but the build failed. Fedora 19 includes texinfo 5.1, and obviously it is a bit stricter with the syntax than previous versions. More exactly, I got these error messages when trying to format the documentation of vm 8.1.2:

vm.texinfo:786: warning: @end should only appear at a line beginning
vm.texinfo:2345: warning: superfluous arguments for node
vm.texinfo:3333: warning: @vindex should only appear at a line beginning
vm.texinfo:3337: warning: @vindex should only appear at a line beginning
vm.texinfo:999: @ref reference to nonexistent node `maildrop
  specification'
vm.texinfo:4591: raising the section level of @unnumberedsubsec which is too low

I also tried to format the documentation of the more current 8.2.0b release, and saw similar problems there.

[Uday Reddy (reddyuday)]

Hi Goran, were these 'fatal errors', i.e., did they block the info files
from getting made?

Cheers,
Uday

[Göran Uddeborg (goeran-uddeborg)]

Yes, makeinfo returned exit status 1 and did not produce any output. Since I wrote it, I have figured out a patch, which I'm attaching in case you are interested.

[Göran Uddeborg (goeran-uddeborg)]

Um, "it", in "wrote it" in the last comment refers to this report. I realised the comment wasn't perfectly clear.