<?xml version='1.0'?>
<!-- -*- DocBook -*- -->
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
    "/usr/share/sgml/docbook/dtd/xml/4.2/docbookx.dtd" [
 <!ENTITY % sgml.features "IGNORE">
 <!ENTITY % xml.features  "INCLUDE">
 <!ENTITY % dbcent PUBLIC
      "-//OASIS//ENTITIES DocBook Character Entities V4.2//EN"
      "/usr/share/sgml/docbook/dtd/xml/4.2/dbcentx.mod"> %dbcent;
 <!ENTITY % commondata     SYSTEM "../common.ent"      > %commondata;
 <!ENTITY % popcon         SYSTEM "../popcon.ent"      > %popcon;
 <!ENTITY % pkgsize        SYSTEM "../pkgsize.ent"     > %pkgsize;
 <!ENTITY % urlsdata       SYSTEM "../urls.ent"        > %urlsdata;
]>
<chapter id="guideforcontribuodebianreference">
    <title>Guide for contributing to Debian Reference</title>
    <para>Debian Reference upstream source is <ulink url="&httpwikidebianorgdebianreference;">http://wiki.debian.org/DebianReference</ulink> . </para>
    <para/>
    <section id="rules">
      <title>Rules</title>
      <para>Here are the rules. </para>
      <itemizedlist>
        <listitem>
          <para>Do not use Edit(GUI) button of MoinMoin. </para>
        </listitem>
        <listitem>You can update anytime for: <itemizedlist><listitem><para>grammar errors </para></listitem><listitem><para>spelling errors </para></listitem><listitem><para>moved URL location </para></listitem><listitem><para>package name transition adjustment (emacs23 etc.) </para></listitem><listitem><para>clearly broken script. </para></listitem></itemizedlist></listitem>
        <listitem>Before updating real contents: <itemizedlist><listitem><para>You have to discuss it on <ulink url="&debiandoclistsdebianorg;">debian-doc@lists.debian.org</ulink> (1 week wait for response please) </para></listitem><listitem><para>You have to read the whole document to avoid duplication. </para></listitem><listitem><para>Follow the existing style. </para></listitem><listitem><para>Make sure you are reachable via e-mail. </para></listitem><listitem><para>Think twice before doing anything. </para></listitem><listitem><para>Do your own research on the latest Debian system by experimenting. </para></listitem><listitem><para>Make contents as generic suitable for slow content update cycle (including future translation work). </para></listitem><listitem><para>It is usually good to place only the pointer to the original information. </para></listitem><listitem><para>Even if new contents are required, please shorten the description to half its original draft length. </para></listitem><listitem><para>Make alternative page proposals as wiki and post message to <ulink url="&debiandoclistsdebianorg;">debian-doc@lists.debian.org</ulink> </para></listitem></itemizedlist></listitem>
      </itemizedlist>
      <para>I use this moinmoin platform for its ability for table and XML export. </para>
      <para>This wiki will be post-processed by XSLT/XML tools and should be written accordingly: </para>
      <itemizedlist>
        <listitem><para>The content in the index section at the top of each wiki page will be dropped when converted to XML. </para></listitem>
        <listitem>
          <para><code>@ { @ tag @ } @</code> (without spaces between @s) markup on wiki pages is converted to an internal link. </para>
        </listitem>
        <listitem>Do not use overly fancy wiki features not supported by XML conversion backend, available from the git repo. (Your help to remove fancy features in moinmoin is welcome.) <itemizedlist><listitem><para>Do not make a complicated table with connected cells spanning rows or columns. </para></listitem><listitem><para>Do not use FootNote nor face marks such as <code>:)</code> for  . </para></listitem></itemizedlist></listitem>
        <listitem><para>Follow the wiki style: </para></listitem>
        <listitem>The codenames are always in the lower case (sid, etch, lenny, ...) <itemizedlist><listitem><para>Indent only for <code>*</code> and <code>1.</code> -started lines, one space per level of nesting. </para></listitem><listitem><para>Do not indent lines started with : <code>||</code>, <code> { { {</code> (without spaces). </para></listitem><listitem><warning><para>Some graphic marks such as <code>/!\</code> for  are converted to marking for para. (See test page.) </para></warning><itemizedlist><listitem><para>Do not indent for lines started with these graphic marks. </para></listitem></itemizedlist></listitem></itemizedlist></listitem>
        <listitem>Wiki table markup is processed in special ways: <itemizedlist><listitem><para>The first line of a table is used as: &lt;title&gt; [, package column, popcon column]. </para></listitem><listitem><para>popcon and package sizes are autogenerated by a script if specified in the first line.  (Values in wiki are ignored) </para></listitem><listitem><para>The second line of a table is used as: &lt;thead&gt;. </para></listitem></itemizedlist></listitem>
        <listitem>
          <para><code>@ @ @tag@ @ @</code> (without spaces between @s) in wiki are converted to <code>&amp;tag;</code> in XML. </para>
          <itemizedlist>
            <listitem><para>The final tag contents in HTML is determined by the HTML generation script. </para></listitem>
          </itemizedlist>
        </listitem>
        <listitem><para>All internal wiki links will be removed when converted to XML. </para></listitem>
        <listitem>For the same text with URL link, external URL link should match if it repeats. <itemizedlist><listitem><para>one word reference should chose mostly wikipedia </para></listitem><listitem><para>No <code>%</code> or <code>&amp;</code> usage in URL address reference until I fix moin2urls.xsl. </para></listitem></itemizedlist></listitem>
        <listitem><para>Try to keep contents in </para></listitem>
      </itemizedlist>
      <para/>
      <screen> ... commands examples ...
</screen>
      <itemizedlist>
        <listitem><para>language neutral so translation will not affect them. </para></listitem>
      </itemizedlist>
      <itemizedlist>
        <listitem>Do not bloat this document. <itemizedlist><listitem><para>It is already getting too big for me (osamu) to maintain . </para></listitem><listitem><para>If you want to make an XML document for a particular topic from the wiki, please use the code I use and start a new document. (GPL). </para></listitem></itemizedlist></listitem>
      </itemizedlist>
      <para>This ensures (eventually) clean conversion to DocBook XML and makes my work easy.  </para>
      <para/>
      <para> </para>
      <para>If funny things happen, look for single quote repeats, etc. in wiki source. </para>
      <para>Code sections marked as "{ { { \n } } }" without using spaces will cause XML export errors; thus, always use spaces around \n. </para>
      <para>List export has &lt;para&gt; markup bugs; after conversion, review and correct them, please. </para>
      <para/>
    </section>
    <section id="hintsfortoolstohtingthisdocument">
      <title>Hints for tools to help updating this document</title>
      <itemizedlist>
        <listitem>
          <para>Public server: <ulink url="&httpwikidebianorgdebianreference;">http://wiki.debian.org/DebianReference</ulink> </para>
        </listitem>
        <listitem>
          <para>You may create your own mirror: <code>http://localhost/Wiki/DebianReference</code> </para>
        </listitem>
        <listitem><para>See Makefile and use targets: diff gedit ... </para></listitem>
      </itemizedlist>
      <para>Build scripts and xml sources are available via Git repository at: </para>
      <itemizedlist>
        <listitem>
          <para>
            <code>ssh://git.debian.org/git/users/osamu/debian-reference.git</code>
          </para>
        </listitem>
        <listitem>
          <para>
            <code>git://git.debian.org/git/users/osamu/debian-reference.git</code>
          </para>
        </listitem>
        <listitem>
          <para><ulink url="&httpgitdebianorgbianreferencegit;">http://git.debian.org/?p=users/osamu/debian-reference.git</ulink> (for browsing)  </para>
        </listitem>
      </itemizedlist>
      <para>For example, this wiki page is converted step-by-step as follows: </para>
      <orderedlist numeration="arabic">
        <listitem>
          <para>
            <ulink url="&wikisourceinrawtextmode;">wiki source in raw text mode</ulink>
          </para>
        </listitem>
        <listitem>
          <para>
            <ulink url="&docbookxmlcoverpage;">Docbook XML (cover page)</ulink>
          </para>
        </listitem>
        <listitem>
          <para>
            <ulink url="&docbookxmlcontents;">Docbook XML (contents)</ulink>
          </para>
        </listitem>
        <listitem>
          <para>
            <ulink url="&htmlcreatedfromdocbookxmlfiles;">HTML created from Docbook XML files</ulink>
          </para>
        </listitem>
      </orderedlist>
      <para/>
    </section>
    <section id="examples">
      <title>Examples</title>
      <para>This section contains examples and scratch pad contents. </para>
      <para/>
      <section id="table">
        <title>Table</title>
        <para>Always assumes the first line is <code>&lt;title&gt;</code>, the second line is <code>&lt;thead&gt;</code> and the rest lines are <code>&lt;tbody&gt;</code> <code>&lt;row&gt;</code>s.  (hello) </para>
        <table id="exampleoftableb">
          
          <title> Example of table 1 </title><tgroup x-pkgname=" " x-popcon="" x-pkgsize="" cols="2">
            <colspec colname="xxx1"/>
            <colspec colname="xxx2"/>
            <thead><row>
                <entry>
                  <para>
                    <emphasis role="strong">TITLE1</emphasis>
                  </para>
                </entry>
                <entry>
                  <para>
                    <emphasis role="strong">TITLE2</emphasis>
                  </para>
                </entry>
              </row></thead><tbody><row>
                <entry>
                  <para> DATA 11 </para>
                </entry>
                <entry>
                  <para> DATA 12 </para>
                </entry>
              </row><row>
                <entry>
                  <para> DATA 21 </para>
                </entry>
                <entry>
                  <para> DATA 22 </para>
                </entry>
              </row></tbody>
          </tgroup>
        </table>
        <para/>
      </section>
      <section id="specialparagraphs">
        <title>Special paragraphs</title>
        <para>Here are examples of Wiki marking used. </para>
        <warning><para><code> /!\ </code>  for "Warning" (alert) </para></warning>
        <caution><para><code> &lt;!&gt; </code>  for "Caution" (attention) </para></caution>
        <important><para><code> {*} </code>  for "Important" (star_on) </para></important>
        <tip><para><code> {i} </code>  for "Tip" (icon-info) </para></tip>
        <note><para><code> (!) </code>  for "Note" (idea) </para></note>
        <note><para><code> {OK} </code>  for "Note" (thumbs-up) </para></note>
        <note><para><code> (./) </code>  for "Note" (check-mark) </para></note>
        <para/>
      </section>
      <section id="linefoldings">
        <title>Line foldings</title>
        <para>line1 starting line break examples line2 w/o space from previous line </para>
        <para>line3 w 1 line space from previous line </para>
        <para>line2 w 2 space from previous line </para>
        <para>line2 w 3 space from previous line line with ampersand &amp; &amp; </para>
        <para/>
      </section>
      <section id="dataforpopcondataandpackagesize">
        <title>Data for popcon data and package size</title>
        <para>The calculated popcon and size can be checked at: <ulink url="&dataforpopcondataandpackagesize;">Data for popcon data and package size</ulink>. </para>
        <para>The following packages are referred in the main text. </para>
        <table id="listofpackageswhredinthemaintext">
          
          <title> List of packages whose popcon and/or package size were referred in the main text </title><tgroup x-pkgname=" 1 " x-popcon=" 2 " x-pkgsize=" 3 " cols="4">
            <colspec colname="xxx1"/>
            <colspec colname="xxx2"/>
            <colspec colname="xxx3"/>
            <colspec colname="xxx4"/>
            <thead><row>
                <entry>
                  <para>
                    <emphasis role="strong">package</emphasis>
                  </para>
                </entry>
                <entry>
                  <para>
                    <emphasis role="strong">popcon</emphasis>
                  </para>
                </entry>
                <entry>
                  <para>
                    <emphasis role="strong">package size</emphasis>
                  </para>
                </entry>
                <entry>
                  <para>
                    <emphasis role="strong">dummy</emphasis>
                  </para>
                </entry>
              </row></thead><tbody><row>
                <entry>
                  <para>
                    <code>gksu</code>
                  </para>
                </entry>
                <entry><para>&pop-gksu;</para></entry>
                <entry><para>&size-gksu;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>screen</code>
                  </para>
                </entry>
                <entry><para>&pop-screen;</para></entry>
                <entry><para>&size-screen;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>rutebook</code>
                  </para>
                </entry>
                <entry><para>&pop-rutebook;</para></entry>
                <entry><para>&size-rutebook;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row></tbody>
          </tgroup>
        </table>
        <para>The following packages are meant to evaluate backup utilities. </para>
        <table id="listofpackagespoaintextforbackup">
          
          <title> List of packages possibly mentioned in the main text for backup </title><tgroup x-pkgname=" 1 " x-popcon=" 2 " x-pkgsize=" 3 " cols="4">
            <colspec colname="xxx1"/>
            <colspec colname="xxx2"/>
            <colspec colname="xxx3"/>
            <colspec colname="xxx4"/>
            <thead><row>
                <entry>
                  <para>
                    <emphasis role="strong">package</emphasis>
                  </para>
                </entry>
                <entry>
                  <para>
                    <emphasis role="strong">popcon</emphasis>
                  </para>
                </entry>
                <entry>
                  <para>
                    <emphasis role="strong">package size</emphasis>
                  </para>
                </entry>
                <entry>
                  <para>
                    <emphasis role="strong">dummy</emphasis>
                  </para>
                </entry>
              </row></thead><tbody><row>
                <entry>
                  <para>
                    <code>sbackup</code>
                  </para>
                </entry>
                <entry><para>&pop-sbackup;</para></entry>
                <entry><para>&size-sbackup;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>amanda-common</code>
                  </para>
                </entry>
                <entry><para>&pop-amandacommon;</para></entry>
                <entry><para>&size-amandacommon;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>amanda-client</code>
                  </para>
                </entry>
                <entry><para>&pop-amandaclient;</para></entry>
                <entry><para>&size-amandaclient;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>amanda-server</code>
                  </para>
                </entry>
                <entry><para>&pop-amandaserver;</para></entry>
                <entry><para>&size-amandaserver;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>cdrw-taper</code>
                  </para>
                </entry>
                <entry><para>&pop-cdrwtaper;</para></entry>
                <entry><para>&size-cdrwtaper;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>par2</code>
                  </para>
                </entry>
                <entry><para>&pop-parc;</para></entry>
                <entry><para>&size-parc;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>parchive</code>
                  </para>
                </entry>
                <entry><para>&pop-parchive;</para></entry>
                <entry><para>&size-parchive;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>backup-manager</code>
                  </para>
                </entry>
                <entry><para>&pop-backupmanager;</para></entry>
                <entry><para>&size-backupmanager;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>backup2l</code>
                  </para>
                </entry>
                <entry><para>&pop-backupcl;</para></entry>
                <entry><para>&size-backupcl;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>backupninja</code>
                  </para>
                </entry>
                <entry><para>&pop-backupninja;</para></entry>
                <entry><para>&size-backupninja;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>bacula</code>
                  </para>
                </entry>
                <entry><para>&pop-bacula;</para></entry>
                <entry><para>&size-bacula;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>bacula-common</code>
                  </para>
                </entry>
                <entry><para>&pop-baculacommon;</para></entry>
                <entry><para>&size-baculacommon;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>bacula-client</code>
                  </para>
                </entry>
                <entry><para>&pop-baculaclient;</para></entry>
                <entry><para>&size-baculaclient;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>bacula-console</code>
                  </para>
                </entry>
                <entry><para>&pop-baculaconsole;</para></entry>
                <entry><para>&size-baculaconsole;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>bacula-server</code>
                  </para>
                </entry>
                <entry><para>&pop-baculaserver;</para></entry>
                <entry><para>&size-baculaserver;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>cdbackup</code>
                  </para>
                </entry>
                <entry><para>&pop-cdbackup;</para></entry>
                <entry><para>&size-cdbackup;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>cedar-backup2</code>
                  </para>
                </entry>
                <entry><para>&pop-cedarbackupc;</para></entry>
                <entry><para>&size-cedarbackupc;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>faubackup</code>
                  </para>
                </entry>
                <entry><para>&pop-faubackup;</para></entry>
                <entry><para>&size-faubackup;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>flexbackup</code>
                  </para>
                </entry>
                <entry><para>&pop-flexbackup;</para></entry>
                <entry><para>&size-flexbackup;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>mondo</code>
                  </para>
                </entry>
                <entry><para>&pop-mondo;</para></entry>
                <entry><para>&size-mondo;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>afbackup</code>
                  </para>
                </entry>
                <entry><para>&pop-afbackup;</para></entry>
                <entry><para>&size-afbackup;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>afbackup-client</code>
                  </para>
                </entry>
                <entry><para>&pop-afbackupclient;</para></entry>
                <entry><para>&size-afbackupclient;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>afbackup-common</code>
                  </para>
                </entry>
                <entry><para>&pop-afbackupcommon;</para></entry>
                <entry><para>&size-afbackupcommon;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>backuppc</code>
                  </para>
                </entry>
                <entry><para>&pop-backuppc;</para></entry>
                <entry><para>&size-backuppc;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>boxbackup-client</code>
                  </para>
                </entry>
                <entry><para>&pop-boxbackupclient;</para></entry>
                <entry><para>&size-boxbackupclient;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>boxbackup-server</code>
                  </para>
                </entry>
                <entry><para>&pop-boxbackupserver;</para></entry>
                <entry><para>&size-boxbackupserver;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>chiark-backup</code>
                  </para>
                </entry>
                <entry><para>&pop-chiarkbackup;</para></entry>
                <entry><para>&size-chiarkbackup;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>storebackup</code>
                  </para>
                </entry>
                <entry><para>&pop-storebackup;</para></entry>
                <entry><para>&size-storebackup;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>keep</code>
                  </para>
                </entry>
                <entry><para>&pop-keep;</para></entry>
                <entry><para>&size-keep;</para></entry>
                <entry>
                  <para> - </para>
                </entry>
              </row></tbody>
          </tgroup>
        </table>
        <para>The following packages are meant to evaluate office utilities. </para>
        <table id="listofguipackageaintextforoffice">
          
          <title> List of GUI packages possibly mentioned in the main text for office </title><tgroup x-pkgname=" 1 " x-popcon=" 2 " x-pkgsize=" 3 " cols="5">
            <colspec colname="xxx1"/>
            <colspec colname="xxx2"/>
            <colspec colname="xxx3"/>
            <colspec colname="xxx4"/>
            <colspec colname="xxx5"/>
            <thead><row>
                <entry>
                  <para>
                    <emphasis role="strong">package</emphasis>
                  </para>
                </entry>
                <entry>
                  <para>
                    <emphasis role="strong">popcon</emphasis>
                  </para>
                </entry>
                <entry>
                  <para>
                    <emphasis role="strong">package size</emphasis>
                  </para>
                </entry>
                <entry>
                  <para>
                    <emphasis role="strong">description</emphasis>
                  </para>
                </entry>
                <entry>
                  <para>
                    <emphasis role="strong">type</emphasis>
                  </para>
                </entry>
              </row></thead><tbody><row>
                <entry>
                  <para>
                    <code>scribus-ng</code>
                  </para>
                </entry>
                <entry><para>&pop-scribusng;</para></entry>
                <entry><para>&size-scribusng;</para></entry>
                <entry>
                  <para> desktop page layout editor </para>
                </entry>
                <entry>
                  <para> KDE </para>
                </entry>
              </row><row>
                <entry>
                  <para>
                    <code>scribus</code>
                  </para>
                </entry>
                <entry><para>&pop-scribus;</para></entry>
                <entry><para>&size-scribus;</para></entry>
                <entry>
                  <para> desktop page layout editor </para>
                </entry>
                <entry>
                  <para> KDE </para>
                </entry>
              </row></tbody>
          </tgroup>
        </table>
        <para>The following assorted packages are meant to evaluate inclusion to the main text. </para>
        <table id="listofassortedpanedinthemaintext">
          
          <title> List of assorted packages possibly mentioned in the main text </title><tgroup x-pkgname=" 1 " x-popcon=" 2 " x-pkgsize=" 3 " cols="4">
            <colspec colname="xxx1"/>
            <colspec colname="xxx2"/>
            <colspec colname="xxx3"/>
            <colspec colname="xxx4"/>
            <thead><row>
                <entry>
                  <para>
                    <code>traceroute</code>
                  </para>
                </entry>
                <entry>
                  <para> - </para>
                </entry>
                <entry>
                  <para> - </para>
                </entry>
                <entry>
                  <para> Traces the route taken by packets over an IPv4/IPv6 network (included) </para>
                </entry>
              </row></thead><tbody><row>
                <entry>
                  <para>
                    <code>tcptraceroute</code>
                  </para>
                </entry>
                <entry><para>&pop-tcptraceroute;</para></entry>
                <entry><para>&size-tcptraceroute;</para></entry>
                <entry>
                  <para> Traces the route taken by packets over an IPv4/IPv6 network using TCP SYN packets (excluded) </para>
                </entry>
              </row></tbody>
          </tgroup>
        </table>
        <para>See <ulink url="&httpwikidebianorgutfibrokenapps;">http://wiki.debian.org/UTF8BrokenApps</ulink> </para>
        <para/>
      </section>
      <section id="escapeconfusion">
        <title>Escape confusion</title>
        <para>MoinMoin conversion bug for "<code> \n </code>" needs to be worked around by placing space around it. </para>
        <para/>
        <para/>
      </section>
      <section id="internallinks">
        <title>internal links</title>
        <para>can be referred as <xref linkend="internallinks"/> which will create correct reference in HTML. </para>
        <itemizedlist>
          <listitem><para>All characters converted to lower cases. </para></listitem>
          <listitem><para>0-9 converted to a-j </para></listitem>
          <listitem><para>Drop all special characters and spaces.   </para></listitem>
          <listitem><para>For longer reference name, it trim center parts and make it first and last 16 characters each.   </para></listitem>
          <listitem><para>See HTML link name as quick check after generation. </para></listitem>
        </itemizedlist>
        <para>Do not use "<code> [[Anchor(internalLinks)]] </code>" for now in the main text used by building final HTML files.  (It may be a good idea but you need to do it for entire document.)   </para>
        <para>The normal anchor feature of MoinMoin wiki is not supported by the XML conversion tool now. </para>
      </section>
    </section>
  </chapter>