From: Date: March 23 2004 4:05pm
Subject: bk commit - mysqldoc tree (Administrator:1.1333)
List-Archive: http://lists.mysql.com/internals/13072
Message-Id: <200403231505.i2NF5LHW005299@mail.mysql.com>

Below is the list of changes that have just been committed into a local
mysqldoc repository of Administrator. When Administrator does a push these changes will
be propagated to the main repository and, within 24 hours after the
push, to the public repository.
For information on how to access the public repository
see http://www.mysql.com/doc/I/n/Installing_source_tree.html

ChangeSet
  1.1333 04/03/23 16:05:17 Administrator@athena. +2 -0
  slartibartfast.xml:
    Completed contributor tools section
    Prepared other toolset sectionsrest of toolset sections
  html.css:
    new file

  Docs/slartibartfast.xml
    1.10 04/03/23 16:02:26 Administrator@athena. +214 -15
    Completed contributor tools section
    Prepared other toolset sectionsrest of toolset sections

  Docs/html.css
    1.1 04/03/23 12:34:29 Administrator@athena. +595 -0

  Docs/html.css
    1.0 04/03/23 12:34:29 Administrator@athena. +0 -0
    BitKeeper file C:/cygwin/home/Administrator/mysqldoc/Docs/html.css

# This is a BitKeeper patch.  What follows are the unified diffs for the
# set of deltas contained in the patch.  The rest of the patch, the part
# that BitKeeper cares about, is below these diffs.
# User:	Administrator
# Host:	athena.
# Root:	C:/cygwin/home/Administrator/mysqldoc
--- New file ---
+++ Docs/html.css	04/03/23 12:34:29
/***********************************************************************

 main.css

 ***********************************************************************/

body,th,td,div,p,h1,h2,li,dt,dd {
 font-family: Arial, sans-serif;
}

body {
 margin: 15px;
 color: #333333;
 background-color: #ffffff;
}

img.box {
 vertical-align: middle;
}

a:link {
 color: #006486;
}
a:active {
 color: #1d93b6;
}
a:hover {
 color: #64bfdb;
}
a:visited {
 color: #4e5265;
}

/* work around issue with docbook-generated pages */
a[id]:hover {
 color: inherit;
}

a img {
 border: 0px;
 color: #ffffff; /* makes border disappear in ns4 (sometimes) */
}

h1, h2 {
 font-size: larger;
}

ul {
 list-style-image: url(box.png);
 list-style-type: square;
}

table.data {
 border-collapse: collapse;
 border: 1px solid #bdcebb;
}
table.data th {
 border: 1px solid #bdcebb;
 background: #cbdac9;
}
table.data td {
 border: 1px solid #bdcebb;
 background: #e3ebe2;
}

input.required, textarea.required {
 background: #e3ebe2;
}
input.bad, textarea.bad {
 background: #ffcd76;
}

.error, .errors {
 color: #e18a07;
}

p.byline {
 font-size: smaller;
 font-weight: bold;
}

#header {
 width: 100%;
 border: 0px;
 margin: 0px;
 padding: 0px;
 border-spacing: 0px;
}
#header td {
 padding: 0px;
 font-size: 12px;
}

#header #logo {
 vertical-align: middle;
}
#header #logo img {
/*/*/
 margin: 2px 15px;
 border: none; /* workaround for layout quirk in ie5.5 */
/* stupid ns4. */
}

#header #tagline {
 font-size: 12px;
 font-weight: bold;
 font-style: italic;
 color: #006486;
 white-space: nowrap;
}

#header #navigation {
 color: #666666;
 text-align: right;
 white-space: nowrap;
}
#header #searchfields {
 padding: 0px 10px;
}

#search {
 margin: 0px;
}

#search #q {
 font-size: 11px;
/*/*/
 width: 100px;
 padding: 3px 4px;
 border: 1px solid #bdcebb;
/* stupid ns4. */
}
#search #submit {
 background: #bdcebb;
 color: #ffffff;
 font-weight: bold;
/*/*/
 border: 1px outset #bdcebb;
 font-size: 10px;
 voice-family: "\"}\""; 
 voice-family: inherit;
 padding: 3px 4px;
/* stupid ns4. */
} 
#header #topnav {
 vertical-align: bottom;
}

#topnav table {
 border-spacing: 0px;
 height: 18px;
}

#topnav td {
 padding: 2px 8px;
 background-color: #e2e9eb;
 white-space: nowrap;
 border: none;
 font-size: 12px;
 text-align: center;
}
#topnav td.sep {
 padding: 0px;
}
#topnav td.sep img {
 display: block;
}

#topnav td.a {
 background-color: #1d93b6; 
}
#topnav td.s {
 background-color: #bdcebb; 
}

#topnav a:link {
 text-decoration: none;
 color: #000000;
}
#topnav a:visited {
 text-decoration: none;
 color: #000000;
}
#topnav a:hover {
 text-decoration: underline;
 color: #000000;
}

#topnav td.a a:link {
 text-decoration: none;
 color: #ffffff;
}
#topnav td.a a:visited {
 text-decoration: none;
 color: #ffffff;
}
#topnav td.a a:hover {
 text-decoration: underline;
 color: #ffffff;
}

#topnav td.s a:link {
 text-decoration: none;
 color: #000000;
}
#topnav td.s a:visited {
 text-decoration: none;
 color: #000000;
}
#topnav td.s a:hover {
 text-decoration: underline;
}

#subnav {
 background-color: #1d93b6;
 height: 19px;
 vertical-align: bottom;
}

#subnav #right {
 width: 100%;
}
#subnav td {
 font-size: 12px;
 padding: 0px 4px 0px 10px;
 border-bottom: 1px solid #2a5a8a;
 vertical-align: bottom;
 white-space: nowrap;
}
#subnav td.sep {
 padding: 0px;
 border-bottom: 1px solid #ffffff;
 border-bottom: none;
}
#subnav td.sep img {
 padding: 0px;
 display: block;
}
#subnav td.u {
 background: #ffffff;
 padding-left: 0px;
 border-bottom: 1px solid #ffffff;
}
#subnav img {
 vertical-align: bottom;
}

#subnav a:link {
 text-decoration: none;
 color: #ffffff;
}
#subnav a:visited {
 text-decoration: none;
 color: #ffffff;
}
#subnav a:hover {
 text-decoration: underline;
}

#subnav td.p {
 background: #e2e9eb;
 padding-left: 0px;
 border-bottom: 1px solid #e2e9eb;
}
#subnav td.u a:link, #subnav td.p a:link {
 text-decoration: none;
 color: #000000;
}
#subnav td.u a:visited, #subnav td.p a:visited {
 text-decoration: none;
 color: #000000;
}
#subnav td.u a:hover, #subnav td.p a:hover {
 text-decoration: underline;
}

.shim {
 clear: both;
}

#contents {
 position: relative;
}
#contentspacer {
 float: left;
 width: 0px;
 height: 500px;
}

#body {
 margin: 10px 30px;
}

#content {
 border: none;
 padding-right: 19px;
 margin: 10px 240px 10px 30px;
 border-right: 1px solid #e3ebe2;
}

h1.title {
 color: #1d93b6;
}

h1.title {
 position: relative;
 left: -10px;
}

#sidebar {
 border: none;
 margin-top: 10px;
 margin-right: 10px;
 
 width: 220px;

 /*/*/
 position: absolute;
 left: auto;
 right: 0px;
 top: 0px;
}
/* */

div.promo {
 margin-top: 10px;
 background: #e4ebe4;
 border: none;
 padding: 10px;
}
div.promo p {
 margin-top: 0px;
}

#sidebar #related h2 {
 font-size: larger;
 border-bottom: 1px solid #e4ebe4;
}

#sidebar #related ul {
 list-style-type: none;
 list-style-image: none;
 margin-left: 0px;
 padding-left: 0px;
}

#footer {
 font-size: smaller;
 clear: both;
 border: none;
 background: #e3ebe2;
 margin-top: 20px;
 padding-left: 30px;
 padding-top: 10px;
 padding-bottom: 10px;
}

#footer a:link {
 color: #666666;
}
#footer a:active, .footer a:hover {
 color: #006486;
}
#footer a:visited {
 color: #949494;
}

/*********************************************************************

 documentation.css

 *********************************************************************/

#toc {
 float: left;
 font-size: smaller;
 width: 205px;
}
#toc #doctop {
 border-bottom: 3px double #cccccc;
}
#toc #docup {
 border-bottom: 1px solid #cccccc;
}
#toc img {
 margin-left: -10px;
 padding-right: 5px;
}
#toc div {
 padding: 10px 0px;
}

#innertoc ul {
 margin: 0px;
 padding: 0px;
 list-style-type: none;
 list-style-image: none;
}
#toc ul.children {
 margin-left: 10px;
}

#toc #promo {
 text-align: center;
}

#doccontent {
 /* left margin has enough room to fit the toc */
 margin: 15px 15px 15px 220px;
 border-left: 1px solid #cccccc;
 padding-left: 19px;
}

#docnav {
 font-size: smaller;
}

#docsearch {
 font-size: smaller;
}
#docsearch fieldset {
 border: none;
}
#docsearch label {
 position: static;
}
#docsearch #searchq {
 font-size: 11px;
/*/*/
 width: 120px;
 padding: 3px 4px;
 border: 1px solid #bdcebb;
/* stupid ns4. */
}
#docsearch #searchsubmit {
 background: #bdcebb;
 color: #ffffff;
 font-weight: bold;
/*/*/
 border: 1px outset #bdcebb;
 font-size: 10px;
 padding: 3px 4px;
/* stupid ns4. */
}

#langs, #formats {
 border-top: 3px double #cccccc;
}
#langs h2, #formats h2 {
 margin: 0px;
}
#langs ul, #formats ul {
 padding-left: 2em;
}

code {
 color: purple;
}

/* Need to comment this out because Norman Walsh's XSL style sheets love tt
tt {
 color: green;
}
*/

samp {
 color: navy;
}
        
pre {
 color: maroon;
}
        
#comments {
 background: #dbe6d9;
 padding: 0px 8px;
}
#comments h2 {
 border-bottom: 1px solid #cccccc;
}
.commentdetails {
 font-size: smaller;
 font-weight: bold;
}
.commenttext {
 margin-left: 10px;
}


/*********************************************************************
  Additions
  Author       : Stefan Hinz <stefan@stripped>
  Purpose      : Account for classes used in 
                 MySQL GUI tool documentation
  Note         : You can show/hide remarks with display property 
                 all/none
  Last edited  : 2004-02-10
 *********************************************************************/

 .guibutton {
  border              : 1px solid;
  border-left-color   : #ffffff;
  border-top-color    : #ffffff;
  border-right-color  : #000000;
  border-bottom-color : #000000;
  padding-top         : 1px;
  padding-bottom      : 1px;
  padding-left        : 6px;
  padding-right       : 6px;
  color               : #000000;
  background-color    : #cccccc;
  font-family         : "MS Sans Serif", sans-serif;
  font-size           : 12px;
  font-style          : normal;
  white-space         : nowrap;
 }
 .guilabel {
  border              : 1px solid;
  border-left-color   : #cccccc;
  border-top-color    : #cccccc;
  border-right-color  : #eeeeee;
  border-bottom-color : #eeeeee;
  padding-top         : 1px;
  padding-bottom      : 1px;
  padding-left        : 6px;
  padding-right       : 6px;
  color               : #000000;
  background-color    : #eeeeee;
  font-family         : "MS Sans Serif", sans-serif;
  font-size           : 12px;
  font-style          : normal;
  white-space         : nowrap;
 }
 .guimenu {
  border              : 1px solid;
  border-left-color   : #cccccc;
  border-top-color    : #cccccc;
  border-right-color  : #eeeeee;
  border-bottom-color : #eeeeee;
  padding-top         : 1px;
  padding-bottom      : 1px;
  padding-left        : 6px;
  padding-right       : 6px;
  color               : #000000;
  background-color    : #cccccc;
  font-family         : "MS Sans Serif", sans-serif;
  font-size           : 12px;
  font-style          : normal;
  white-space         : nowrap;
 }
 .keycap {
  border              : 1px solid black;
  padding-top         : 1px;
  padding-bottom      : 1px;
  padding-left        : 6px;
  padding-right       : 6px;
  color               : white;
  background-color    : black;
  font-family         : "MS Sans Serif", sans-serif;
  font-size           : 12px;
  font-style          : normal;
  white-space         : nowrap;
 }
 .command {
  color               : purple;
  font-family         : "Lucida Console", monospace;
  font-size           : smaller;
  font-weight         : normal;
 }
 .literal {
  color               : purple;
  font-family         : "Lucida Console", monospace;
  font-size           : smaller;
  font-weight         : normal;
 }
 .replaceable {
  font-family         : "Lucida Console", monospace;
  font-size           : normal;
  font-weight         : normal;
 }
 tt {
  font-family         : "Lucida Console", monospace;
  font-weight         : normal;
 }
 .remark {
  font-style          : italic;
  font-weight         : bolder;
  color               : red;
  display             : visible;
 }
 .worklog {
  font-weight         : bold;
  color               : green;
  display             : visible;
 }

--- 1.9/Docs/slartibartfast.xml	Mon Mar 22 18:58:22 2004
+++ 1.10/Docs/slartibartfast.xml	Tue Mar 23 16:02:26 2004
@@ -120,16 +120,16 @@
      The concepts in those chapters might also be interesting for <emphasis>people contributing <link linkend="slartibartfast-preface-other-documentation">other MySQL documentation</link></emphasis>.
     </para></listitem>
     <listitem><para>
-     <emphasis>Everyone editing the English manual</emphasis> and <emphasis>translators</emphasis> should read the appropriate sections of the <link linkend="slartibartfast-toolset">Slartibartfast Toolset</link> chapter. For contributors to the English manual, the <link linkend="slartibartfast-toolset-contributors">Tools for Contributors</link> section is the most interesting part, while for translators, the <link linkend="slartibartfast-toolset-translators">Tools for Translators</link> section is more important.
+     <emphasis>Everyone editing the English manual</emphasis> and <emphasis>translators</emphasis> should read the appropriate sections of the <link linkend="slartibartfast-toolset">Slartibartfast Toolset</link> chapter. For contributors to the English manual, the <link linkend="slartibartfast-toolset-contrib">Tools for Contributors</link> section is the most interesting part, while for translators, the <link linkend="slartibartfast-toolset-translate">Tools for Translators</link> section is more important.
     </para></listitem>
     <listitem><para>
      <emphasis>Everyone who wants to produce output</emphasis> (HTML, PDF, CHM, and so forth) from the XML should read the <link linkend="slartibartfast-toolset-output">Output Generators</link> section of the Slartibartfast Toolset chapter.
     </para></listitem>
     <listitem><para>
-     <emphasis>Everyone editing the English manual</emphasis> should read the <link linkend="slartibartfast-conventions-contributors">Conventions for Contributors</link> appendix. The conventions listed there are also interesting for <emphasis>people contributing <link linkend="slartibartfast-preface-other-documentation">other MySQL documentation</link></emphasis>.
+     <emphasis>Everyone editing the English manual</emphasis> should read the <link linkend="slartibartfast-conventions-contrib">Conventions for Contributors</link> appendix. The conventions listed there are also interesting for <emphasis>people contributing <link linkend="slartibartfast-preface-other-documentation">other MySQL documentation</link></emphasis>.
     </para></listitem>
     <listitem><para>
-     <emphasis>Translators</emphasis> should read the <link linkend="slartibartfast-conventions-translators">Conventions for Translators</link> appendix.
+     <emphasis>Translators</emphasis> should read the <link linkend="slartibartfast-conventions-translate">Conventions for Translators</link> appendix.
     </para></listitem>
    </itemizedlist>
  	</para>
@@ -311,7 +311,7 @@
    <para>Tools that help them make sure they don't mess up the manual (well-formedness, validity)
    </para>
   </sect1> <!-- Design Goals for Developers -->
-  <sect1 id="slartibartfast-design-goals-translators">
+  <sect1 id="slartibartfast-design-goals-translate">
    <title>Design Goals for Translators</title>
    <para>The tasks of translators regarding the manual are:
    </para>
@@ -1540,7 +1540,7 @@
     </itemizedlist>
   	</para>
   </sect1> <!-- Software Requirements for Contributors and Translators -->
-  <sect1 id="slartibartfast-toolset-contributors">
+  <sect1 id="slartibartfast-toolset-contrib">
    <title>Tools for Contributors</title>
   	<para>
     The tools running on contributors' machines are designed to run platform-independent. See the <link linkend="slartibartfast-toolset-software-requirements">Software Requirements</link> section for a list of the software that needs to be installed so that the tools will run.
@@ -1548,9 +1548,8 @@
    <para>
     The <emphasis>contributor tools</emphasis> consist of two sets: One set of tools makes sure contributions to the manual are in a consistent state before such contributions are pushed to the central English repository. The other set of tools helps contributors to work with the manual in various ways. Both sets of tools reside on the local machines of those who contribute to the manual, and thus work with the local repository clones.
    </para>
-   <sect2 id="slartibartfast-toolset-contributors-literalentities">
+   <sect2 id="slartibartfast-toolset-contrib-literalentities">
     <title><literal>manual-contrib-literalentities.pl</literal></title>
-    <remark>[SH] Not programmed yet</remark>
    	<para>
      This script is not intended for daily use by contributors, but rather for enforcing consistency of terms in the English manual.
    	</para>
@@ -1576,25 +1575,225 @@
      From looking at that list, we might decide to encode both <literal>MySQL</literal> and <literal>MySQL server</literal> as XML entities, thus writing them as <literal>&amp;mysql;</literal> and <literal>&amp;mysql-server;</literal> in the manual, and defining those entities in the <filename>words.ent</filename> file.
     </para>
     <para>
-     For more information on <filename>words.ent</filename>, see the <link linkend="slartibartfast-entities-translated-words-ent">words.ent</link> section.
+     For more information on XML entities and the <filename>words.ent</filename> file, see the <link linkend="slartibartfast-entities-translated-words-ent">words.ent</link> section.
+    </para>
+    <para role="worklog">
+     This tools has not been programmed yet.
+     <itemizedlist role="worklog">
+      <listitem><para role="worklog">
+       STATUS: assigned
+      </para></listitem>
+      <listitem><para role="worklog">
+       PRIORITY: low
+      </para></listitem>
+      <listitem><para role="worklog">
+       DEPENDENCIES: none
+      </para></listitem>
+      <listitem><para role="worklog">
+       COMPLETION: September 2004
+      </para></listitem>
+     </itemizedlist>
     </para>
    </sect2> <!-- manual-contrib-literalentities.pl -->
+   <sect2 id="slartibartfast-toolset-contrib-checkall">
+    <title><literal>manual-contrib-checkall.pl</literal></title>
+   	<para>
+     After having done an environment check (<link linkend="slartibartfast-toolset-helper-checkenv"><literal>manual-helper-checkenv.pl</literal></link>) that must return without an error (otherwise the script will stop executing), this script does a <command>bk ci</command> for alle directories/files to determine which files have changed (and marks those as <emphasis>changed</emphasis>). Then it runs <link linkend="slartibartfast-toolset-helper-validate"><literal>manual-helper-validate.pl</literal></link> and <link linkend="slartibartfast-toolset-helper-prettyprint"><literal>manual-helper-prettyprint.pl</literal></link> only for the files marked as <emphasis>changed</emphasis>. (This is done for performance reasons.) If the script returns without an error for the validation part, that means that the edits made left the XML consistent. Otherwise, it prints out which errors occurred (by using <link linkend="slartibartfast-toolset-software-requirements">xmllint</link>), and ex!
 its. The script invokes the following helper scripts:
+     <itemizedlist>
+      <listitem><para>
+       <link linkend="slartibartfast-toolset-helper-checkenv"><literal>manual-helper-checkenv.pl</literal></link>
+      </para></listitem>
+      <listitem><para>
+       <link linkend="slartibartfast-toolset-helper-validate"><literal>manual-helper-validate.pl</literal></link>
+      </para></listitem>
+      <listitem><para>
+       <link linkend="slartibartfast-toolset-helper-prettyprint"><literal>manual-helper-prettyprint.pl</literal></link>
+      </para></listitem>
+     </itemizedlist>
+   	</para>
+    <para role="worklog">
+     This script might also be used for translators.
+    </para>
+    <para role="worklog">
+    	This tools has not been programmed yet.
+    	<itemizedlist>
+    		<listitem><para role="worklog">
+    			STATUS: assigned, helper tools almost completed
+    		</para></listitem>
+    		<listitem><para role="worklog">
+    			PRIORITY: high
+    		</para></listitem>
+    		<listitem><para role="worklog">
+    			DEPENDENCIES: helper tools must be completed
+    		</para></listitem>
+    		<listitem><para role="worklog">
+    			COMPLETION: April 2004
+    		</para></listitem>
+    	</itemizedlist>
+    </para>
+   </sect2> <!-- manual-contrib-checkall.pl -->
+   <sect2 id="slartibartfast-toolset-contrib-commit">
+    <title><literal>manual-contrib-commit.pl</literal></title>
+   	<para>
+     Alleviates the tasks of checking-in, committing, and pushing edits of the manual. The script first calls <link linkend="slartibartfast-toolset-contrib-checkall"><literal>manual-contrib-checkall.pl</literal></link> to make sure any edits made are in a valid and proper state. It then checks in the edits (by calling <command>bk ci</command>), commits them (by calling <command>bk commit</command>) and pushes them (by calling <command>bk push</command>). Before the push, it does a <command>bk pull</command> to make sure that the push will succeed. <remark>[SH] We need to find a way to handle resolving conflicts.</remark>
+   	</para>
+    <para role="worklog">
+    	This tools has not been programmed yet.
+    	<itemizedlist>
+    		<listitem><para role="worklog">
+    			STATUS: assigned
+    		</para></listitem>
+    		<listitem><para role="worklog">
+    			PRIORITY: medium
+    		</para></listitem>
+    		<listitem><para role="worklog">
+    			DEPENDENCIES: checkall script
+    		</para></listitem>
+    		<listitem><para role="worklog">
+    			COMPLETION: June 2004
+    		</para></listitem>
+    	</itemizedlist>
+    </para>
+   </sect2> <!-- manual-contrib-commit.pl -->
+   <sect2 id="slartibartfast-toolset-contrib-sml">
+    <title><literal>manual-contrib-sml.pl</literal></title>
+   	<para>
+     This script is based on an idea of Jim Winstead. We will probably not implement that idea, though. This script would alleviate the task of adding new content without having to learn DocBook XML, by converting text written in a Wiki-like <emphasis>Simple Markup Language</emphasis> ("SML") to DocBook.
+   	</para>
+    <para>
+     This is how "SML" text would look like:
+     <programlisting>
+* Added option --nice to mysqld_safe to allow setting the niceness of
+  the mysqld process. (Thanks to Christian Hammers for providing the
+  initial patch) (Bug #627)
+* RESET SLAVE now clears the Last_errno and Last_error fields in the
+  output of SHOW SLAVE STATUS.
+* RAND() entries were not read correctly by mysqlbinlog from the
+  binary log which caused problems when restoring a table that was
+  inserted with RAND(). INSERT INTO t1 VALUES(RAND()). In replication
+  this worked ok.
+* Fixed &lt;= and &amp;= to work correctly.
+     </programlisting>
+     The script would convert that into DocBook XML:
+     <programlisting>
+&lt;itemizedlist>
+ &lt;listitem>
+  Added option &lt;option>--nice&lt;/option> to &lt;command>mysqld_safe&lt;/command> to allow setting the niceness of the &lt;command>mysqld&lt;/command> process. (Thanks to Christian Hammers for providing the initial patch) &lt;ulink url="http://bugs.mysql.com/627">(Bug #627)&lt;/ulink>
+ &lt;/listitem>
+ &lt;listitem>
+  &lt;command>RESET SLAVE&lt;/command> now clears the &lt;literal>Last_errno&lt;/literal> and &lt;literal>Last_error&lt;/literal> fields in the output of &lt;command>SHOW SLAVE STATUS&lt;/command>.
+ &lt;/listitem>
+ &lt;listitem>
+   &lt;function>RAND()&lt;/function> entries were not read correctly by &lt;command>mysqlbinlog&lt;/command> from the binary log which caused problems when restoring a table that was inserted with &lt;function>RAND()&lt;/function>. &lt;command>INSERT INTO &lt;replaceable>t1&lt;/replaceable> VALUES(&lt;function>RAND()&lt;/function>)&lt;/command>. In replication this worked ok.
+ &lt;/listitem>
+ &lt;listitem>
+  Fixed &lt;= and &amp;= to work correctly.
+ &lt;/listitem>
+&lt;/itemizedlist>
+     </programlisting>
+    </para>
+    <para role="worklog">
+    	This tools has not been programmed yet.
+    	<itemizedlist>
+    		<listitem><para role="worklog">
+    			STATUS: cancelled
+    		</para></listitem>
+    		<listitem><para role="worklog">
+    			PRIORITY: low
+    		</para></listitem>
+    		<listitem><para role="worklog">
+    			DEPENDENCIES: none
+    		</para></listitem>
+    		<listitem><para role="worklog">
+    			COMPLETION: N/A
+    		</para></listitem>
+    	</itemizedlist>
+    </para>
+   </sect2> <!-- manual-contrib-sml.pl -->
+   <sect2 id="slartibartfast-toolset-contrib-other">
+    <title>Other Scripts</title>
+   	<para>
+     In addition to the above scripts, contributors should be given a set of tools for convenience. Most of those tools will be benefitial for translators, too, so they are listed in the <link linkend="slartibartfast-toolset-helper">Helper Tools</link>
+   	</para>
+   </sect2> <!-- Other Scripts -->
   </sect1> <!-- Tools for Contributors -->
-  <sect1 id="slartibartfast-toolset-translators">
+  <sect1 id="slartibartfast-toolset-translate">
    <title>Tools for Translators</title>
   	<para>
     The tools running on translators' machines are designed to run platform-independent. See the <link linkend="slartibartfast-toolset-software-requirements">Software Requirements</link> section for a list of the software that needs to be installed so that the tools will run.
   	</para>
+   <sect2 id="slartibartfast-toolset-translate-checkall">
+    <title><literal>manual-translate-checkall.pl</literal></title>
+   	<para>
+   	</para>
+   </sect2> <!-- manual-translate-checkall.pl -->
+   <sect2 id="slartibartfast-toolset-translate-diff">
+    <title><literal>manual-translate-diff.pl</literal></title>
+   	<para>
+   	</para>
+   </sect2> <!-- manual-translate-diff.pl -->
+   <sect2 id="slartibartfast-toolset-translate-sync">
+    <title><literal>manual-translate-sync.pl</literal></title>
+   	<para>
+   	</para>
+   </sect2> <!-- manual-translate-checkall.pl -->
   </sect1> <!-- Tools for Translators -->
   <sect1 id="slartibartfast-toolset-helper">
    <title>Helper Tools</title>
   	<para>
+    <remark>[SH] FILL IN introduction</remark>
   	</para>
+   <sect2 id="slartibartfast-toolset-helper-checkenv">
+    <title><literal>manual-helper-checkenv.pl</literal></title>
+   	<para>
+   	</para>
+   </sect2> <!-- manual-helper-checkenv.pl -->
+   <sect2 id="slartibartfast-toolset-helper-validate">
+    <title><literal>manual-helper-validate.pl</literal></title>
+   	<para>
+   	</para>
+   </sect2> <!-- manual-helper-validate.pl -->
+   <sect2 id="slartibartfast-toolset-helper-prettyprint">
+    <title><literal>manual-helper-prettyprint.pl</literal></title>
+   	<para>
+   	</para>
+   </sect2> <!-- manual-helper-prettyprint.pl -->
+   <sect2 id="slartibartfast-toolset-helper-find">
+    <title><literal>manual-helper-find.pl</literal></title>
+   	<para>
+   	</para>
+   </sect2> <!-- manual-helper-find.pl -->
+   <sect2 id="slartibartfast-toolset-helper-replace">
+    <title><literal>manual-helper-replace.pl</literal></title>
+   	<para>
+   	</para>
+   </sect2> <!-- manual-helper-replace.pl -->
+   <sect2 id="slartibartfast-toolset-helper-generatebook">
+    <title><literal>manual-helper-generatebook.pl</literal></title>
+   	<para>
+   	</para>
+   </sect2> <!-- manual-helper-generatebook.pl -->
   </sect1> <!-- Helper Tools -->
-  <sect1 id="slartibartfast-toolset-reporting">
+  <sect1 id="slartibartfast-toolset-report">
    <title>Reporting Tools</title>
   	<para>
+    <remark>[SH] FILL IN introduction</remark>
   	</para>
+   <sect2 id="slartibartfast-toolset-report-statistics">
+    <title><literal>manual-report-statistics.pl</literal></title>
+   	<para>
+   	</para>
+   </sect2> <!-- manual-report-statistics.pl -->
+   <sect2 id="slartibartfast-toolset-report-translations">
+    <title><literal>manual-report-translations.pl</literal></title>
+   	<para>
+   	</para>
+   </sect2> <!-- manual-report-translations.pl -->
+   <sect2 id="slartibartfast-toolset-report-structure">
+    <title><literal>manual-report-structure.pl</literal></title>
+   	<para>
+   	</para>
+   </sect2> <!-- manual-report-structure.pl -->
   </sect1> <!-- Reporting Tools -->
   <sect1 id="slartibartfast-toolset-output">
    <title>Output Generators</title>
@@ -1680,27 +1879,27 @@
   <title>Conventions for Working with the Manual</title>
  	<para>
  	</para>
-  <sect1 id="slartibartfast-conventions-contributors">
+  <sect1 id="slartibartfast-conventions-contrib">
    <title>Conventions for Contributors</title>
   	<para>
   	</para>
-   <sect2 id="slartibartfast-conventions-contributors-xml">
+   <sect2 id="slartibartfast-conventions-contrib-xml">
     <title>XML Consistency</title>
    	<para>
    	</para>
    </sect2> <!-- XML Consistency -->
-   <sect2 id="slartibartfast-conventions-contributors-terms">
+   <sect2 id="slartibartfast-conventions-contrib-terms">
     <title>Consistency of Terms Used</title>
    	<para>
    	</para>
    </sect2> <!-- Consistency of Terms Used -->
-   <sect2 id="slartibartfast-conventions-contributors-templates">
+   <sect2 id="slartibartfast-conventions-contrib-templates">
     <title>Templates for Adding New Contents</title>
    	<para>
    	</para>
    </sect2> <!-- Templates for Adding New Contents -->
   </sect1> <!-- Conventions for Contributors -->
-  <sect1 id="slartibartfast-conventions-translators">
+  <sect1 id="slartibartfast-conventions-translate">
    <title>Conventions for Translators</title>
   	<para>
   	</para>