proposals for new XML

[Patrice Dumas]

Hello,

We are currently changing the Texinfo XML with the new implementation,
to avoid loss of information when going from the texinfo code to 
Texinfo XML.



1. Some things that break compatibility but seems not questionable to me:

@printindex cp  -> <printindex value="cp"></printindex>
<xref> becomes <xref> or <pxref> or <ref>.
No more See or see together with *ref.
@findex -> <findex index="fn"><indexterm index="fn">index entry</...></..>
@fooindex -> <indexcommand command="fooindex" index="foo"><indexterm 
index="foo">index entry</...></..>
@abbr do not becomes <abbrev>, but <abbr>
menu comment -> <menucomment>
menu entry description -> <menudescription> (instead of <menucomment>)
definfoenclosed @-command -> <infoenclose command=".." begin=".." end="..">...

No more <definition>, but instead use the command, like <deffn>.
Also use the def*x commands, like
<defivarx><definitionterm>.....</definitionterm></defivarx>

If the @-command is an alias with category generated (like for @defun it 
is Function), it has a automatic="on" attribute, like 
<defun><definitionterm><defcategory automatic="on">Function</defcategory>

no more <floatpos>.




2. Some more proposals

Have only <image> and no <inlineimage>.

Use <pre> for preformatted portions of text, and use the xml:space="preserve"
on <pre>, for example 

 @example
 in 
 @end example

would become

 <example>
 <pre xml:space="preserve">in
 </pre></example>

rename, for @itemize the argument <itemfunction> -> <itemprepend>

rename <title> for sectioning @-commands as <sectiontitle>
let @settitle and @title -> <settitle> and <title>



3. Some questions

I have trouble with 2 constructs, what is prepended to a @item in
@itemize, and the @command applied to @item or @itemx line in @[fv]?table.
I think these should not be applied as if things were formatted, otherwise
it is not possible to determine what was the @item and what is added.

Here is what I propose.

For @itemize, add a <prepend> element, so for example

@itemize @minus
@item in item

@item A

B
@end itemize

gives

<itemize commandarg="&minus;"><itemprepend>&minus;</itemprepend>
<item><prepend>&minus;</prepend><para>in item
</para>
</item><item><prepend>&minus;</prepend><para>A
</para>
<para>B
</para></item></itemize>


For table I propose an element called itemformat with the command in 
attribute. For example

@table @samp
@item in item
@end table

gives

<table commandarg="samp">
<tableitem><tableterm command="item"><itemformat command="samp">in 
item</..></....
</table>

Also if the commandarg is a definfoencose'd command, it gives, with
@definfoenclose a,:,:

@table @a
@item in item
@end table

<table commandarg="a" begin=":" end=":">
<tableitem><tableterm command="item"><itemformat infoenclose="a" begin=":" 
end=":">in item</..></.
</table>



Any issue with any of these?

-- 
Pat