Doc/tools/sgmlconv/conversion.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<conversion>
  <!-- Miscellaneous. -->
  <macro name="declaremodule">
    <attribute name="id" optional="yes"/>
    <attribute name="type"/>
    <attribute name="name"/>
    </macro>
  <macro name="modulesynopsis">
    <content/>
    </macro>
  <macro name="platform">
    <content/>
    </macro>
  <macro name="deprecated">
    <attribute name="version"/>
    <content/>
    </macro>
  <macro name="label">
    <attribute name="id"/>
    </macro>
  <macro name="nodename" outputname="label">
    <attribute name="id"/>
    </macro>
  <macro name="localmoduletable"/>
  <macro name="manpage">
    <attribute name="name"/>
    <attribute name="section"/>
    </macro>
  <macro name="module">
    <content/>
    </macro>
  <macro name="moduleauthor">
    <attribute name="name"/>
    <attribute name="email"/>
    </macro>
  <macro name="citetitle">
    <attribute name="href" optional="yes"/>
    <content/>
    </macro>
  <macro name="pep">
    <attribute name="num"/>
    </macro>
  <macro name="rfc">
    <attribute name="num"/>
    </macro>
  <macro name="sectionauthor" outputname="author">
    <attribute name="name"/>
    <attribute name="email"/>
    </macro>
  <macro name="author">
    <attribute name="name"/>
    </macro>
  <macro name="authoraddress">
    <content/>
    </macro>
  <macro name="shortversion"/>
  <macro name="note">
    <content/>
    </macro>
  <macro name="warning">
    <content/>
    </macro>
  <!-- These are broken:  we need to re-order the optional and required
       parameters, making the optional parameter the content for the
       element.  latex2esis.py is not powerful enough to handle this.
    -->
  <macro name="versionadded">
    <attribute name="info" optional="yes"/>
    <attribute name="version"/>
    </macro>
  <macro name="versionchanged">
    <attribute name="info" optional="yes"/>
    <attribute name="version"/>
    </macro>

  <!-- Module referencing. -->
  <macro name="refmodule" outputname="module">
    <!-- this causes the optional parameter to \refmodule to be
         discarded -->
    <attribute name="" optional="yes"/>
    <content/>
    </macro>

  <!-- Information units. -->
  <!-- C things. -->
  <environment name="cfuncdesc">
    <attribute name="type"/>
    <attribute name="name"/>
    <child name="args"/>
    </environment>
  <environment name="ctypedesc">
    <attribute name="tag" optional="yes"/>
    <attribute name="name"/>
    </environment>
  <environment name="cvardesc">
    <attribute name="type"/>
    <attribute name="name"/>
    </environment>

  <!-- Python things. -->
  <macro name="optional">
    <content/>
    </macro>
  <macro name="unspecified"/>
  <macro name="moreargs"/>
  <environment name="classdesc">
    <attribute name="name"/>
    <child name="args"/>
    </environment>
  <environment name="classdesc*" outputname="classdesc">
    <attribute name="name"/>
    </environment>
  <environment name="datadesc">
    <attribute name="name"/>
    </environment>
  <environment name="datadescni" outputname="datadesc">
    <attribute name="index">no</attribute>
    <attribute name="name"/>
    </environment>
  <macro name="dataline">
    <attribute name="name"/>
    </macro>
  <environment name="excclassdesc">
    <attribute name="name"/>
    <child name="args"/>
    </environment>
  <environment name="excdesc">
    <attribute name="name"/>
    </environment>

  <environment name="funcdesc">
    <attribute name="name"/>
    <child name="args"/>
    </environment>
  <macro name="funcline">
    <attribute name="name"/>
    <child name="args"/>
    </macro>
  <environment name="funcdescni" outputname="funcdesc">
    <attribute name="index">no</attribute>
    <attribute name="name"/>
    <child name="args"/>
    </environment>
  <macro name="funclineni" outputname="funcline">
    <attribute name="index">no</attribute>
    <attribute name="name"/>
    <child name="args"/>
    </macro>

  <environment name="memberdesc">
    <attribute name="class" optional="yes"/>
    <attribute name="name"/>
    </environment>
  <environment name="memberdescni" outputname="memberdesc">
    <attribute name="index">no</attribute>
    <attribute name="class" optional="yes"/>
    <attribute name="name"/>
    </environment>
  <macro name="memberline">
    <attribute name="name"/>
    </macro>

  <environment name="methoddesc">
    <attribute name="class" optional="yes"/>
    <attribute name="name"/>
    <child name="args"/>
    </environment>
  <macro name="methodline">
    <attribute name="class" optional="yes"/>
    <attribute name="name"/>
    <child name="args"/>
    </macro>
  <environment name="methoddescni">
    <attribute name="index">no</attribute>
    <attribute name="class" optional="yes"/>
    <attribute name="name"/>
    <child name="args"/>
    </environment>
  <macro name="methodlineni" outputname="methodline">
    <attribute name="index">no</attribute>
    <attribute name="class" optional="yes"/>
    <attribute name="name"/>
    <child name="args"/>
    </macro>

  <environment name="opcodedesc">
    <attribute name="name"/>
    <attribute name="var"/>
    </environment>

  <!-- "See also:" sections. -->
  <environment name="seealso*" outputname="seealso">
    <attribute name="sidebar">no</attribute>
    </environment>
  <macro name="seemodule">
    <!-- this causes the optional parameter to \seemodule to be
         discarded -->
    <attribute name="" optional="yes"/>
    <attribute name="name"/>
    <child name="description"/>
    </macro>
  <macro name="seepep">
    <attribute name="number"/>
    <child name="title"/>
    <child name="description"/>
    </macro>
  <macro name="seerfc">
    <attribute name="number"/>
    <child name="title"/>
    <child name="description"/>
    </macro>
  <macro name="seetext">
    <child name="description"/>
    </macro>
  <macro name="seetitle">
    <attribute name="href" optional="yes"/>
    <child name="title"/>
    <child name="description"/>
    </macro>
  <macro name="seeurl">
    <attribute name="href"/>
    <child name="description"/>
    </macro>

  <!-- Index-generating markup. -->
  <macro name="index" outputname="indexterm">
    <attribute name="term1"/>
    </macro>
  <macro name="indexii" outputname="indexterm">
    <attribute name="term1"/>
    <attribute name="term2"/>
    </macro>
  <macro name="indexiii" outputname="indexterm">
    <attribute name="term1"/>
    <attribute name="term2"/>
    <attribute name="term3"/>
    </macro>
  <macro name="indexiv" outputname="indexterm">
    <attribute name="term1"/>
    <attribute name="term2"/>
    <attribute name="term3"/>
    <attribute name="term4"/>
    </macro>

  <macro name="ttindex" outputname="indexterm">
    <attribute name="style">tt</attribute>
    <attribute name="term1"/>
    </macro>

  <macro name="refmodindex">
    <attribute name="module"/>
    </macro>
  <macro name="stmodindex">
    <attribute name="module"/>
    </macro>
  <macro name="refbimodindex" outputname="refmodindex">
    <attribute name="module"/>
    </macro>
  <macro name="refexmodindex" outputname="refmodindex">
    <attribute name="module"/>
    </macro>
  <macro name="refstmodindex" outputname="refmodindex">
    <attribute name="module"/>
    </macro>

  <macro name="bifuncindex">
    <attribute name="name"/>
    </macro>
  <macro name="exindex">
    <attribute name="name"/>
    </macro>
  <macro name="obindex">
    <attribute name="name"/>
    </macro>
  <macro name="kwindex">
    <attribute name="name"/>
    </macro>
  <macro name="opindex">
    <attribute name="type"/>
    </macro>
  <macro name="stindex">
    <attribute name="type"/>
    </macro>
  <macro name="withsubitem">
    <attribute name="text"/>
    <content/>
    </macro>
  <macro name="setindexsubitem">
    <attribute name="text"/>
    </macro>

  <!-- Entity management. -->
  <macro name="include" outputname="xi:include">
    <attribute name="href"/>
    </macro>
  <macro name="input" outputname="xi:include">
    <attribute name="href"/>
    </macro>

  <!-- Large-scale document structure. -->
  <macro name="documentclass">
    <attribute name="classname"/>
    </macro>

  <macro name="usepackage">
    <attribute name="options" optional="yes"/>
    <attribute name="pkg"/>
    </macro>

  <environment name="document"
               endcloses="chapter chapter* section section*
                          subsection subsection*
                          subsubsection subsubsection*
                          paragraph paragraph* subparagraph
                          subparagraph*">
    <attribute name="xmlns:xi"
      >http://www.w3.org/2001/XInclude</attribute>
    </environment>

  <macro name="chapter"
         closes="chapter chapter* section section* subsection subsection*
                 subsubsection subsubsection*
                 paragraph paragraph* subparagraph subparagraph*">
    <text>
</text>
    <child name="title"/>
    <content implied="yes"/>
    </macro>
  <macro name="chapter*" outputname="chapter"
         closes="chapter chapter* section section* subsection subsection*
                 subsubsection subsubsection*
                 paragraph paragraph* subparagraph subparagraph*">
    <attribute name="numbered">no</attribute>
    <text>
</text>
    <child name="title"/>
    <content implied="yes"/>
    </macro>

  <macro name="section"
         closes="section section* subsection subsection*
                 subsubsection subsubsection*
                 paragraph paragraph* subparagraph subparagraph*">
    <text>
</text>
    <child name="title"/>
    <content implied="yes"/>
    </macro>
  <macro name="section*" outputname="section"
         closes="section section* subsection subsection*
                 subsubsection subsubsection*
                 paragraph paragraph* subparagraph subparagraph*">
    <attribute name="numbered">no</attribute>
    <text>
</text>
    <child name="title"/>
    <content implied="yes"/>
    </macro>

  <macro name="subsection"
         closes="subsection subsection* subsubsection subsubsection*
                 paragraph paragraph* subparagraph subparagraph*">
    <text>
</text>
    <child name="title"/>
    <content implied="yes"/>
    </macro>
  <macro name="subsection*" outputname="subsection"
         closes="subsection subsection* subsubsection subsubsection*
                 paragraph paragraph* subparagraph subparagraph*">
    <attribute name="numbered">no</attribute>
    <text>
</text>
    <child name="title"/>
    <content implied="yes"/>
    </macro>

  <macro name="subsubsection"
         closes="subsubsection subsubsection*
                 paragraph paragraph* subparagraph subparagraph*">
    <text>
</text>
    <child name="title"/>
    <content implied="yes"/>
    </macro>
  <macro name="subsubsection*" outputname="subsubsection"
         closes="subsubsection subsubsection*
                 paragraph paragraph* subparagraph subparagraph*">
    <attribute name="numbered">no</attribute>
    <text>
</text>
    <child name="title"/>
    <content implied="yes"/>
    </macro>

  <macro name="paragraph"
         closes="paragraph paragraph* subparagraph subparagraph*">
    <text>
</text>
    <child name="title"/>
    <content implied="yes"/>
    </macro>
  <macro name="paragraph*" outputname="paragraph"
         closes="paragraph paragraph* subparagraph subparagraph*">
    <attribute name="numbered">no</attribute>
    <text>
</text>
    <child name="title"/>
    <content implied="yes"/>
    </macro>

  <macro name="subparagraph"
         closes="subparagraph subparagraph*">
    <text>
</text>
    <child name="title"/>
    <content implied="yes"/>
    </macro>
  <macro name="subparagraph*" outputname="subparagraph"
         closes="subparagraph subparagraph*">
    <attribute name="numbered">no</attribute>
    <text>
</text>
    <child name="title"/>
    <content implied="yes"/>
    </macro>
  <macro name="title">
    <content/>
    </macro>

  <macro name="appendix" outputname="back-matter"
         closes="chapter chapter* section subsection subsubsection
                 paragraph subparagraph"/>

  <environment name="list"
               endcloses="item">
    <attribute name="bullet"/>
    <attribute name="init"/>
    </environment>
  <macro name="item" closes="item">
    <child name="leader" optional="yes"/>
    <content implied="yes"/>
    </macro>

  <macro name="ref">
    <attribute name="ref"/>
    </macro>

  <environment name="description" outputname="descriptionlist"
               endcloses="item"/>

  <environment name="enumerate" outputname="enumeration"
               endcloses="item"/>

  <environment name="fulllineitems"
               endcloses="item"/>

  <environment name="itemize"
               endcloses="item"/>

  <environment name="definitions" outputname="definitionlist"
               encloses="term"/>
  <macro name="term" closes="definition">
    <!-- not really optional, but uses the [] syntax -->
    <child name="term" optional="yes"/>
    <child name="definition" implied="yes"/>
    </macro>

  <environment name="alltt" outputname="verbatim"/>
  <environment name="comment" verbatim="yes"/>
  <environment name="verbatim" verbatim="yes"/>
  <environment name="verbatim*" verbatim="yes">
    <!-- not used anywhere, but it's a standard LaTeXism -->
    <attribute name="spaces">visible</attribute>
    </environment>
  <macro name="verbatiminput" ouptutname="xi:include">
    <attribute name="parse">text</attribute>
    <attribute name="href"/>
    </macro>

  <!-- Table markup. -->
  <macro name="hline"/>
  <environment name="tableii" outputname="table">
    <attribute name="cols">2</attribute>
    <attribute name="colspec"/>
    <attribute name="style"/>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    </environment>
  <environment name="longtableii" outputname="table">
    <attribute name="cols">2</attribute>
    <attribute name="colspec"/>
    <attribute name="style"/>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    </environment>
  <macro name="lineii" outputname="row">
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    </macro>

  <environment name="tableiii" outputname="table">
    <attribute name="cols">3</attribute>
    <attribute name="colspec"/>
    <attribute name="style"/>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    </environment>
  <environment name="longtableiii" outputname="table">
    <attribute name="cols">3</attribute>
    <attribute name="colspec"/>
    <attribute name="style"/>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    </environment>
  <macro name="lineiii" outputname="row">
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    </macro>

  <environment name="tableiv" outputname="table">
    <attribute name="cols">4</attribute>
    <attribute name="colspec"/>
    <attribute name="style"/>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    </environment>
  <environment name="longtableiv" outputname="table">
    <attribute name="cols">4</attribute>
    <attribute name="colspec"/>
    <attribute name="style"/>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    </environment>
  <macro name="lineiv" outputname="row">
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    </macro>

  <environment name="tablev" outputname="table">
    <attribute name="cols">4</attribute>
    <attribute name="colspec"/>
    <attribute name="style"/>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    </environment>
  <environment name="longtablev" outputname="table">
    <attribute name="cols">4</attribute>
    <attribute name="colspec"/>
    <attribute name="style"/>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    </environment>
  <macro name="linev" outputname="row">
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    <text>
         </text>
    <child name="entry"/>
    </macro>

  <!-- These are handled at a later translation stage, at least for now. -->
  <macro name="Cpp" outputname="">
    <text>C++</text>
    </macro>
  <macro name="geq" outputname="">
    <entityref name="geq"/>
    </macro>
  <macro name="infinity" outputname="">
    <entityref name="infin"/>
    </macro>
  <macro name="LaTeX" outputname="">
    <text>LaTeX</text>
    </macro>
  <macro name="ldots" outputname="">
    <text>...</text>
    </macro>
  <macro name="leq" outputname="">
    <entityref name="leq"/>
    </macro>
  <macro name="plusminus" outputname="">
    <entityref name="plusmn"/>
    </macro>
  <macro name="TeX" outputname="">
    <text>TeX</text>
    </macro>
  <macro name="version"/>

  <!-- Distutils things. -->
  <macro name="command">
    <content/>
    </macro>
  <macro name="option">
    <content/>
    </macro>
  <macro name="filevar" outputname="var">
    <content/>
    </macro>
  <macro name="XXX" outputname="editorial-comment">
    <content/>
    </macro>

  <!-- Grammar production lists -->
  <environment name="productionlist">
    <attribute name="grammar" optional="yes"/>
    </environment>
  <macro name="production">
    <attribute name="token"/>
    <content/>
    </macro>
  <macro name="token" outputname="grammartoken">
    <content/>
    </macro>
  <macro name="grammartoken">
    <content/>
    </macro>
  <macro name="orgroup">
    <content/>
    </macro>
  <macro name="oritem"/>

  <!-- Misc. -->
  <macro name="emph">
    <content/>
    </macro>
  <macro name="strong">
    <content/>
    </macro>
  <macro name="textrm">
    <content/>
    </macro>
  <macro name="texttt">
    <content/>
    </macro>
  <macro name="code">
    <content/>
    </macro>
  <macro name="exception">
    <content/>
    </macro>
  <macro name="keyword">
    <content/>
    </macro>
  <macro name="samp">
    <content/>
    </macro>
  <macro name="class">
    <content/>
    </macro>
  <macro name="cdata">
    <content/>
    </macro>
  <macro name="cfunction">
    <content/>
    </macro>
  <macro name="ctype">
    <content/>
    </macro>
  <macro name="pytype">
    <content/>
    </macro>
  <macro name="character">
    <content/>
    </macro>
  <macro name="constant">
    <content/>
    </macro>
  <macro name="envvar" outputname="envar">
    <content/>
    </macro>
  <macro name="file" outputname="filename">
    <content/>
    </macro>
  <macro name="filenq" outputname="filename">
    <attribute name="quote">no</attribute>
    <content/>
    </macro>
  <macro name="function">
    <content/>
    </macro>
  <macro name="kbd" outputname="keysym">
    <content/>
    </macro>
  <macro name="mailheader">
    <content/>
    </macro>
  <macro name="makevar">
    <content/>
    </macro>
  <macro name="method">
    <content/>
    </macro>
  <macro name="member">
    <content/>
    </macro>
  <macro name="mimetype">
    <content/>
    </macro>
  <macro name="newsgroup">
    <content/>
    </macro>
  <macro name="program" outputname="command">
    <content/>
    </macro>
  <macro name="programopt" outputname="option">
    <content/>
    </macro>
  <macro name="longprogramopt" outputname="longoption">
    <content/>
    </macro>
  <macro name="regexp">
    <content/>
    </macro>
  <macro name="var">
    <content/>
    </macro>
  <macro name="email">
    <content/>
    </macro>
  <macro name="ulink">
    <!-- order of the parameters makes this difficult;
         we'll need to fix it up to <ulink href="...">...</ulink>
         in docfixer.py.
      -->
    <child name="text"/>
    <child name="href"/>
    </macro>
  <macro name="url">
    <content/>
    </macro>
  <macro name="footnote">
    <content/>
    </macro>
  <macro name="dfn" outputname="definedterm">
    <content/>
    </macro>

  <macro name="mbox">
    <content/>
    </macro>

  <!-- minimal math stuff to get by -->
  <macro name="pi"/>
  <macro name="sqrt">
    <content/>
    </macro>
  <macro name="frac" outputname="fraction">
    <child name="numerator"/>
    <child name="denominator"/>
    </macro>
  <macro name="sum">
    <content/>
    </macro>

  <macro name="leftline" outputname="">
    <content/>
    </macro>

  <!-- Conversions to text; perhaps could be different?  There's -->
  <!-- no way for a style sheet to work with these this way.	 -->
  <macro name="ABC" outputname="">
    <text>ABC</text>
    </macro>
  <macro name="ASCII" outputname="">
    <text>ASCII</text>
    </macro>
  <macro name="C" outputname="">
    <text>C</text>
    </macro>
  <macro name="EOF" outputname="">
    <text>EOF</text>
    </macro>
  <macro name="e" outputname="">
    <text>\</text>
    </macro>
  <macro name="NULL" outputname="constant">
    <text>NULL</text>
    </macro>
  <macro name="POSIX" outputname="">
    <text>POSIX</text>
    </macro>
  <macro name="UNIX" outputname="">
    <text>Unix</text>
    </macro>
  <macro name="textasciicircum" outputname="">
    <text>^</text>
    </macro>
  <macro name="textasciitilde" outputname="">
    <text>~</text>
    </macro>
  <macro name="textbackslash" outputname="">
    <text>\</text>
    </macro>
  <macro name="textbar" outputname="">
    <text>|</text>
    </macro>

  <!-- These will end up disappearing as well! -->
  <macro name="catcode" outputname=""/>
  <macro name="fi" outputname=""/>
  <macro name="ifhtml" outputname=""/>
  <macro name="indexname" outputname=""/>
  <macro name="labelwidth" outputname=""/>
  <macro name="large" outputname=""/>
  <macro name="leftmargin" outputname=""/>
  <macro name="makeindex" outputname=""/>
  <macro name="makemodindex" outputname=""/>
  <macro name="maketitle" outputname=""/>
  <macro name="noindent" outputname=""/>
  <macro name="protect" outputname=""/>
  <macro name="textwidth"/>
  <macro name="renewcommand">
    <attribute name="macro"/>
    <attribute name="nargs" optional="yes"/>
    <content/>
    </macro>
  <macro name="tableofcontents" outputname=""/>
  <macro name="vspace">
    <attribute name="size"/>
    </macro>
</conversion>