[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
proposals for new XML
From: |
Patrice Dumas |
Subject: |
proposals for new XML |
Date: |
Mon, 5 Sep 2011 01:53:32 +0200 |
User-agent: |
Mutt/1.4.2.2i |
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="−"><itemprepend>−</itemprepend>
<item><prepend>−</prepend><para>in item
</para>
</item><item><prepend>−</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
- proposals for new XML,
Patrice Dumas <=
- Re: proposals for new XML, Karl Berry, 2011/09/05
- Re: proposals for new XML, Patrice Dumas, 2011/09/06
- Re: proposals for new XML, Karl Berry, 2011/09/06
- Re: proposals for new XML, Patrice Dumas, 2011/09/06
- Re: proposals for new XML, Karl Berry, 2011/09/06
- Re: proposals for new XML, Patrice Dumas, 2011/09/06
- Re: proposals for new XML, Karl Berry, 2011/09/07