[help-texinfo] makeinfo: error messages for processing nested entries (table->item->enumeration)

[Simon Sobisch]

makeinfo produces error messages like

./1.texi:488: @item outside of table or list
./1.texi:501: unmatched address@hidden table'

for the following part

@p @table @asis                      <--- line 475
@p @item Color
@p [...]  The eight colors, by number, with the constant names defined
in screenio.cpy, are as follows:
@enumerate 0
@p @item Black: COB-COLOR-BLACK
@p @item Blue: COB-COLOR-BLUE
@p @item Green: COB-COLOR-GREEN
@p @item Cyan (Turquoise): COB-COLOR-CYAN
@p @item Red: COB-COLOR-RED
@p @item Magenta: COB-COLOR-MAGENTA
@p @item Yellow: COB-COLOR-YELLOW
@p @item White: COB-COLOR-WHITE
@end enumerate
@item Text Brightness                 <--- line 488
@p [...]
@item [...]
@p [...]
@end table                            <--- line 501

As far as I see the @item in line 488 and the @end table belong to the
@table in line 475.
This is the way it can be seen in the PDF generated by texi2pdf, too.


Note: The full texinfo files can be inspected at
https://svn.code.sf.net/p/open-cobol/code/external-doc/guide/
The error is the first of many similar issues and is reported in
https://svn.code.sf.net/p/open-cobol/code/external-doc/guide/1.texi,
the command to process the files was:
makeinfo --no-split gnucobpg.texi


Questions:
* Is there anything wrong with nesting these items?
* How should this be done in a way that makeinfo understands?
* Side question: Do you see any use of producing an info file from a
570+ pages document? I'd currently only think HTML (splitted) or docbook
are reasonable for a size like this but would like to know if/how others
read big texinfo files in general.


Thank you for responding to any of these,
Simon Sobisch