Re: Bug#335016: Bug reports for texinfo (and 2 wishes)

[Torsten Bronger]

address@hidden (Karl Berry) writes:

>     Is it allowed
>     to have index entries before any @item in a list?  
>
> Yes, certainly.  Index entries are allowed essentially anywhere
> within the document.  (Which has caused lots of TeX problems, but
> anyway ...)  Can you change the DTD?

Yes, appended.  By the way, "itemize" already used to be like this,
which is a very good sign.

>     Apparently @code and things like that are allowed
>     within menu comments.  (Right?)  
>
> Right.
>
>     Are multiple paragraphs allowed, too?  I've never seen them.
>
> Technically, I think they are/should be, although I can't say I've ever
> seen them either, or have ever tested it.

I found in xml.c:

    typedef struct _element
    {
      char name[32];
      int contains_para;
      int contained_in_para;
      int keep_space;
    } element;

    element texinfoml_element_list [] = {
      [...]
      { "menucomment",         0, 0, 0 },

So I think they must not contain paragraphs.  makeinfo couldn't
generate them anyway.  The appended patch fixes menucomment, too.

Tschö,
Torsten.


--- texinfo.dtd 6 Feb 2006 19:47:04 -0000       1.9
+++ texinfo.dtd 7 Feb 2006 20:36:38 -0000
@@ -235,7 +235,7 @@
 <!ELEMENT menuentry (menunode?, menutitle?, menucomment?)>
 <!ELEMENT menunode (#PCDATA)>
 <!ELEMENT menutitle (#PCDATA)>
-<!ELEMENT menucomment (#PCDATA | para)*>
+<!ELEMENT menucomment (#PCDATA | %Inline.phrase;)*>

 <!-- Floating displays -->
 <!ELEMENT float (floattype, floatpos, (%block;)*,
@@ -252,12 +252,11 @@

 <!-- Lists -->
 <!ELEMENT itemize (itemfunction, (item | itemize | enumerate | indexterm)*)>
-<!ELEMENT enumerate (enumarg?, (item | itemize | enumerate)*)>
+<!ELEMENT enumerate (item | itemize | enumerate | indexterm)*>
 <!ATTLIST enumerate
           first CDATA #IMPLIED>

 <!ELEMENT item (%block;)*>
-<!ELEMENT enumarg (#PCDATA)>

 <!ELEMENT itemfunction (#PCDATA | %Inline.phrase;)*>