List:Commits« Previous MessageNext Message »
From:paul Date:January 13 2006 8:11pm
Subject:svn commit - mysqldoc@docsrva: r815 - in trunk: . refman-4.1 refman-5.0 refman-5.1
View as plain text  
Author: paul
Date: 2006-01-13 21:11:16 +0100 (Fri, 13 Jan 2006)
New Revision: 815

Log:
 r2168@kite-hub:  paul | 2006-01-13 14:10:46 -0600
 Move myisamlog section.
 More consistent descriptions for --password.
 Update password security section.


Modified:
   trunk/
   trunk/refman-4.1/client-utility-programs.xml
   trunk/refman-4.1/database-administration.xml
   trunk/refman-5.0/client-utility-programs.xml
   trunk/refman-5.0/database-administration.xml
   trunk/refman-5.1/client-utility-programs.xml
   trunk/refman-5.1/database-administration.xml


Property changes on: trunk
___________________________________________________________________
Name: svk:merge
   - b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:6161
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:2162
   + b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:6161
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:2168

Modified: trunk/refman-4.1/client-utility-programs.xml
===================================================================
--- trunk/refman-4.1/client-utility-programs.xml	2006-01-13 20:10:16 UTC (rev 814)
+++ trunk/refman-4.1/client-utility-programs.xml	2006-01-13 20:11:16 UTC (rev 815)
@@ -51,16 +51,40 @@
       <listitem>
         <para>
           <indexterm>
+            <primary><command>myisamlog</command></primary>
+          </indexterm>
+
+          <indexterm>
+            <primary><command>isamlog</command></primary>
+          </indexterm>
+
+          <command>myisamlog</command>, <command>isamlog</command>
+        </para>
+
+        <para>
+          Utilities that process the contents of a
+          <literal>MyISAM</literal> or <literal>ISAM</literal> log file.
+          See <xref linkend="myisampack"/>.
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+          <indexterm>
             <primary><command>myisampack</command></primary>
           </indexterm>
 
-          <command>myisampack</command>
+          <indexterm>
+            <primary><command>pack_isam</command></primary>
+          </indexterm>
+
+          <command>myisampack</command>, <command>pack_isam</command>
         </para>
 
         <para>
-          A utility that compresses <literal>MyISAM</literal> tables to
-          produce smaller read-only tables. See
-          <xref linkend="myisampack"/>.
+          Utilities that compress <literal>MyISAM</literal> or
+          <literal>ISAM</literal> tables to produce smaller read-only
+          tables. See <xref linkend="myisampack"/>.
         </para>
       </listitem>
 
@@ -91,7 +115,8 @@
 
         <para>
           A script that checks the access privileges for a hostname,
-          username, and database combination.
+          username, and database combination. See
+          <xref linkend="mysqlaccess"/>.
         </para>
       </listitem>
 
@@ -360,6 +385,243 @@
 
   </section>
 
+  <section id="fake-id-for-myisamlog-manpage-section-wrapper">
+
+    <title>fake title for myisamlog manpage section wrapper</title>
+
+    <refentry id="myisamlog">
+
+      <indexterm>
+        <primary><command>myisamlog</command></primary>
+      </indexterm>
+
+      <indexterm>
+        <primary><command>isamlog</command></primary>
+      </indexterm>
+
+      <refmeta>
+        <refentrytitle><command>myisamlog</command></refentrytitle>
+         
+        <manvolnum>1</manvolnum>
+        <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
+        <refmiscinfo class="source">MySQL</refmiscinfo>
+        <refmiscinfo class="version">&current-series;</refmiscinfo>
+        <refmiscinfo class="refman">&title-myisamlog-for-manual;</refmiscinfo>
+      </refmeta>
+
+      <refnamediv>
+        <refname>myisamlog</refname>
+         
+        <refpurpose>&title-myisamlog-for-manpage;</refpurpose>
+      </refnamediv>
+
+      <refnamediv>
+        <refname>isamlog</refname>
+         
+        <refpurpose>&title-isamlog-for-manpage;</refpurpose>
+      </refnamediv>
+
+      <refsynopsisdiv>
+        <cmdsynopsis>
+          <command>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
+        </cmdsynopsis>
+         
+        <cmdsynopsis>
+          <command>isamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
+        </cmdsynopsis>
+      </refsynopsisdiv>
+
+      <refsection id="myisamlog-description">
+
+        <title>Description</title>
+
+        <para>
+          <command>myisamlog</command> processes the contents of a
+          <literal>MyISAM</literal> log file. <command>isamlog</command>
+          is similar, but is used with <literal>ISAM</literal> log
+          files.
+        </para>
+
+        <para>
+          Invoke <command>myisamlog</command> or
+          <command>isamlog</command>like this:
+        </para>
+
+<programlisting>
+shell&gt; <userinput>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
+shell&gt; <userinput>isamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
+</programlisting>
+
+        <para>
+          The normal operation is update (<option>-u</option>). If a
+          recovery is done (<option>-r</option>), all writes and
+          possibly updates and deletes are done and errors are only
+          counted. If no logfile name is given,
+          <filename>myisam.log</filename> is used for
+          <command>myisamlog</command> and <filename>isam.log</filename>
+          for <command>isamlog</command>. If table names are named on
+          the command line, only those tables are updated.
+        </para>
+
+        <para>
+          <command>myisamlog</command> and <command>isamlog</command>
+          understand the following options:
+        </para>
+
+        <itemizedlist>
+
+          <listitem>
+            <para>
+              <option>-?</option>, <option>-I</option>
+            </para>
+
+            <para>
+              Display a help message and exit.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-c <replaceable>N</replaceable></option>
+            </para>
+
+            <para>
+              Do only <replaceable>N</replaceable> commands.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-f <replaceable>N</replaceable></option>
+            </para>
+
+            <para>
+              Specify the maximum number of open files.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-F <replaceable>filepath/</replaceable></option>
+            </para>
+
+            <para>
+              TODO
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-i</option>
+            </para>
+
+            <para>
+              Display extra information before exiting.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-o <replaceable>offset</replaceable></option>
+            </para>
+
+            <para>
+              Specify the starting offset.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-p <replaceable>N</replaceable></option>
+            </para>
+
+            <para>
+              Remove <replaceable>N</replaceable> components from path.
+            </para>
+          </listitem>
+
+<!--
+        <listitem>
+          <para>
+            <option>-P</option>
+          </para>
+
+          <para>
+            UNKNOWN
+          </para>
+        </listitem>
+-->
+
+          <listitem>
+            <para>
+              <option>-r</option>
+            </para>
+
+            <para>
+              Recover.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-R <replaceable>record-pos-file
+              record-pos</replaceable></option>
+            </para>
+
+            <para>
+              Specify record position file and record position.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-u</option>
+            </para>
+
+            <para>
+              Update.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-v</option>
+            </para>
+
+            <para>
+              Verbose mode. Produce more output. This option can be
+              given multiple times to produce more and more output.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-w <replaceable>write-file</replaceable></option>
+            </para>
+
+            <para>
+              Specify write file.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-V</option>
+            </para>
+
+            <para>
+              Display version information.
+            </para>
+          </listitem>
+
+        </itemizedlist>
+
+      </refsection>
+
+    </refentry>
+
+  </section>
+
   <section id="fake-id-for-myisampack-manpage-section-wrapper">
 
     <title>fake title for myisampack manpage section wrapper</title>
@@ -406,6 +668,7 @@
 
       <refnamediv>
         <refname>pack_isam</refname>
+         
         <refpurpose>&title-pack-isam-for-manpage;</refpurpose>
       </refnamediv>
 
@@ -1702,11 +1965,14 @@
               option and the password. If you omit the
               <replaceable>password</replaceable> value following the
               <option>--password</option> or <option>-p</option> option
-              on the command line, you are prompted for one. The
-              password should be omitted on SysV-based UNIX systems, as
-              the password may be displayed in the output of
-              <literal>ps</literal>.
+              on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -3159,6 +3425,12 @@
               <option>-p</option> option on the command line, you are
               prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -3227,6 +3499,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -3953,6 +4231,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -4335,6 +4619,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -5100,6 +5390,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -5909,6 +6205,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -6551,8 +6853,15 @@
             <para>
               The password to use when connecting to the server. Note
               that the password value is not optional for this option,
-              unlike for other MySQL programs.
+              unlike for other MySQL programs. You can use an option
+              file to avoid giving the password on the command line.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -6912,6 +7221,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -7281,6 +7596,18 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -7492,242 +7819,6 @@
 
   </section>
 
-  <section id="fake-id-for-myisamlog-manpage-section-wrapper">
-
-    <title>fake title for myisamlog manpage section wrapper</title>
-
-    <refentry id="myisamlog">
-
-      <indexterm>
-        <primary><command>myisamlog</command></primary>
-      </indexterm>
-
-      <indexterm>
-        <primary><command>isamlog</command></primary>
-      </indexterm>
-
-      <refmeta>
-        <refentrytitle><command>myisamlog</command></refentrytitle>
-         
-        <manvolnum>1</manvolnum>
-        <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
-        <refmiscinfo class="source">MySQL</refmiscinfo>
-        <refmiscinfo class="version">&current-series;</refmiscinfo>
-        <refmiscinfo class="refman">&title-myisamlog-for-manual;</refmiscinfo>
-      </refmeta>
-
-      <refnamediv>
-        <refname>myisamlog</refname>
-         
-        <refpurpose>&title-myisamlog-for-manpage;</refpurpose>
-      </refnamediv>
-
-      <refnamediv>
-        <refname>isamlog</refname>
-        <refpurpose>&title-isamlog-for-manpage;</refpurpose>
-      </refnamediv>
-
-      <refsynopsisdiv>
-        <cmdsynopsis>
-          <command>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
-        </cmdsynopsis>
-         
-        <cmdsynopsis>
-          <command>isamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
-        </cmdsynopsis>
-      </refsynopsisdiv>
-
-      <refsection id="myisamlog-description">
-
-        <title>Description</title>
-
-        <para>
-          <command>myisamlog</command> processes the contents of a
-          <literal>MyISAM</literal> log file. <command>isamlog</command>
-          is similar, but is used with <literal>ISAM</literal> log
-          files.
-        </para>
-
-        <para>
-          Invoke <command>myisamlog</command> or
-          <command>isamlog</command>like this:
-        </para>
-
-<programlisting>
-shell&gt; <userinput>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
-shell&gt; <userinput>isamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
-</programlisting>
-
-        <para>
-          The normal operation is update (<option>-u</option>). If a
-          recovery is done (<option>-r</option>), all writes and
-          possibly updates and deletes are done and errors are only
-          counted. If no logfile name is given,
-          <filename>myisam.log</filename> is used for
-          <command>myisamlog</command> and <filename>isam.log</filename>
-          for <command>isamlog</command>. If table names are named on
-          the command line, only those tables are updated.
-        </para>
-
-        <para>
-          <command>myisamlog</command> and <command>isamlog</command>
-          understand the following options:
-        </para>
-
-        <itemizedlist>
-
-          <listitem>
-            <para>
-              <option>-?</option>, <option>-I</option>
-            </para>
-
-            <para>
-              Display a help message and exit.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-c <replaceable>N</replaceable></option>
-            </para>
-
-            <para>
-              Do only <replaceable>N</replaceable> commands.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-f <replaceable>N</replaceable></option>
-            </para>
-
-            <para>
-              Specify the maximum number of open files.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-F <replaceable>filepath/</replaceable></option>
-            </para>
-
-            <para>
-              TODO
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-i</option>
-            </para>
-
-            <para>
-              Display extra information before exiting.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-o <replaceable>offset</replaceable></option>
-            </para>
-
-            <para>
-              Specify the starting offset.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-p <replaceable>N</replaceable></option>
-            </para>
-
-            <para>
-              Remove <replaceable>N</replaceable> components from path.
-            </para>
-          </listitem>
-
-<!--
-        <listitem>
-          <para>
-            <option>-P</option>
-          </para>
-
-          <para>
-            UNKNOWN
-          </para>
-        </listitem>
--->
-
-          <listitem>
-            <para>
-              <option>-r</option>
-            </para>
-
-            <para>
-              Recover.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-R <replaceable>record-pos-file
-              record-pos</replaceable></option>
-            </para>
-
-            <para>
-              Specify record position file and record position.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-u</option>
-            </para>
-
-            <para>
-              Update.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-v</option>
-            </para>
-
-            <para>
-              Verbose mode. Produce more output. This option can be
-              given multiple times to produce more and more output.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-w <replaceable>write-file</replaceable></option>
-            </para>
-
-            <para>
-              Specify write file.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-V</option>
-            </para>
-
-            <para>
-              Display version information.
-            </para>
-          </listitem>
-
-        </itemizedlist>
-
-      </refsection>
-
-    </refentry>
-
-  </section>
-
   <section id="fake-id-for-perror-manpage-section-wrapper">
 
     <title>fake title for perror manpage section wrapper</title>

Modified: trunk/refman-4.1/database-administration.xml
===================================================================
--- trunk/refman-4.1/database-administration.xml	2006-01-13 20:10:16 UTC (rev 814)
+++ trunk/refman-4.1/database-administration.xml	2006-01-13 20:11:16 UTC (rev 815)
@@ -708,6 +708,7 @@
 
         <refmeta>
           <refentrytitle><command>mysqld_safe</command></refentrytitle>
+           
           <manvolnum>1</manvolnum>
           <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
           <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -717,11 +718,13 @@
 
         <refnamediv>
           <refname>mysqld_safe</refname>
+           
           <refpurpose>&title-mysqld-safe-for-manpage;</refpurpose>
         </refnamediv>
 
         <refnamediv>
           <refname>safe_mysqld</refname>
+           
           <refpurpose>&title-safe-mysqld-for-manpage;</refpurpose>
         </refnamediv>
 
@@ -1268,6 +1271,7 @@
 
         <refmeta>
           <refentrytitle><command>mysql.server</command></refentrytitle>
+           
           <manvolnum>1</manvolnum>
           <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
           <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1277,6 +1281,7 @@
 
         <refnamediv>
           <refname>mysql.server</refname>
+           
           <refpurpose>&title-mysql-server-for-manpage;</refpurpose>
         </refnamediv>
 
@@ -1370,6 +1375,7 @@
 
         <refmeta>
           <refentrytitle><command>mysqld_multi</command></refentrytitle>
+           
           <manvolnum>1</manvolnum>
           <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
           <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1379,6 +1385,7 @@
 
         <refnamediv>
           <refname>mysqld_multi</refname>
+           
           <refpurpose>&title-mysqld-multi-for-manpage;</refpurpose>
         </refnamediv>
 
@@ -1938,6 +1945,7 @@
 
       <refmeta>
         <refentrytitle><command>mysqld</command></refentrytitle>
+         
         <manvolnum>1</manvolnum>
         <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
         <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1947,6 +1955,7 @@
 
       <refnamediv>
         <refname>mysqld</refname>
+         
         <refpurpose>&title-mysqld-for-manpage;</refpurpose>
       </refnamediv>
 
@@ -9196,6 +9205,7 @@
 
       <refmeta>
         <refentrytitle><command>mysql_fix_privilege_tables</command></refentrytitle>
+         
         <manvolnum>1</manvolnum>
         <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
         <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -9205,6 +9215,7 @@
 
       <refnamediv>
         <refname>mysql_fix_privilege_tables</refname>
+         
         <refpurpose>&title-mysql-fix-privilege-tables-for-manpage;</refpurpose>
       </refnamediv>
 
@@ -15284,13 +15295,17 @@
 </programlisting>
 
           <para>
-            This is convenient but insecure, because your password
-            becomes visible to system status programs such as
-            <command>ps</command> that may be invoked by other users to
-            display command lines. MySQL clients typically overwrite the
-            command-line password argument with zeros during their
-            initialization sequence, but there is still a brief interval
-            during which the value is visible.
+            This is convenient <emphasis>but insecure</emphasis>,
+            because your password becomes visible to system status
+            programs such as <command>ps</command> that may be invoked
+            by other users to display command lines. MySQL clients
+            typically overwrite the command-line password argument with
+            zeros during their initialization sequence. However, there
+            is still a brief interval during which the value is visible.
+            On some systems this strategy is ineffective, anyway, and
+            the password remains visible to <command>ps</command>.
+            (SystemV Unix systems and perhaps others are subject to this
+            problem.)
           </para>
         </listitem>
 
@@ -15364,15 +15379,16 @@
           <para>
             Store your password in the <literal>MYSQL_PWD</literal>
             environment variable. This method of specifying your MySQL
-            password must be considered extremely insecure and should
-            not be used. Some versions of <command>ps</command> include
-            an option to display the environment of running processes.
-            If you set <literal>MYSQL_PWD</literal>, your password is
-            exposed to any other user who runs <command>ps</command>.
-            Even on systems without such a version of
-            <command>ps</command>, it is unwise to assume that there are
-            no other methods by which users can examine process
-            environments. See <xref linkend="environment-variables"/>.
+            password must be considered <emphasis>extremely
+            insecure</emphasis> and should not be used. Some versions of
+            <command>ps</command> include an option to display the
+            environment of running processes. If you set
+            <literal>MYSQL_PWD</literal>, your password is exposed to
+            any other user who runs <command>ps</command>. Even on
+            systems without such a version of <command>ps</command>, it
+            is unwise to assume that there are no other methods by which
+            users can examine process environments. See
+            <xref linkend="environment-variables"/>.
           </para>
         </listitem>
 
@@ -17172,6 +17188,7 @@
 
         <refmeta>
           <refentrytitle><command>myisamchk</command></refentrytitle>
+           
           <manvolnum>1</manvolnum>
           <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
           <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -17181,6 +17198,7 @@
 
         <refnamediv>
           <refname>myisamchk</refname>
+           
           <refpurpose>&title-myisamchk-for-manpage;</refpurpose>
         </refnamediv>
 

Modified: trunk/refman-5.0/client-utility-programs.xml
===================================================================
--- trunk/refman-5.0/client-utility-programs.xml	2006-01-13 20:10:16 UTC (rev 814)
+++ trunk/refman-5.0/client-utility-programs.xml	2006-01-13 20:11:16 UTC (rev 815)
@@ -51,6 +51,22 @@
       <listitem>
         <para>
           <indexterm>
+            <primary><command>myisamlog</command></primary>
+          </indexterm>
+
+          <command>myisamlog</command>
+        </para>
+
+        <para>
+          A utility that processes the contents of a
+          <literal>MyISAM</literal> log file. See
+          <xref linkend="myisampack"/>.
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+          <indexterm>
             <primary><command>myisampack</command></primary>
           </indexterm>
 
@@ -91,7 +107,8 @@
 
         <para>
           A script that checks the access privileges for a hostname,
-          username, and database combination.
+          username, and database combination. See
+          <xref linkend="mysqlaccess"/>.
         </para>
       </listitem>
 
@@ -360,6 +377,223 @@
 
   </section>
 
+  <section id="fake-id-for-myisamlog-manpage-section-wrapper">
+
+    <title>fake title for myisamlog manpage section wrapper</title>
+
+    <refentry id="myisamlog">
+
+      <indexterm>
+        <primary><command>myisamlog</command></primary>
+      </indexterm>
+
+      <refmeta>
+        <refentrytitle><command>myisamlog</command></refentrytitle>
+         
+        <manvolnum>1</manvolnum>
+        <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
+        <refmiscinfo class="source">MySQL</refmiscinfo>
+        <refmiscinfo class="version">&current-series;</refmiscinfo>
+        <refmiscinfo class="refman">&title-myisamlog-for-manual;</refmiscinfo>
+      </refmeta>
+
+      <refnamediv>
+        <refname>myisamlog</refname>
+         
+        <refpurpose>&title-myisamlog-for-manpage;</refpurpose>
+      </refnamediv>
+
+      <refsynopsisdiv>
+        <cmdsynopsis>
+          <command>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
+        </cmdsynopsis>
+      </refsynopsisdiv>
+
+      <refsection id="myisamlog-description">
+
+        <title>Description</title>
+
+        <para>
+          <command>myisamlog</command> processes the contents of a
+          <literal>MyISAM</literal> log file.
+        </para>
+
+        <para>
+          Invoke <command>myisamlog</command> like this:
+        </para>
+
+<programlisting>
+shell&gt; <userinput>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
+</programlisting>
+
+        <para>
+          The normal operation is update (<option>-u</option>). If a
+          recovery is done (<option>-r</option>), all writes and
+          possibly updates and deletes are done and errors are only
+          counted. If no logfile name is given,
+          <filename>myisam.log</filename> is used. If table names are
+          named on the command line, only those tables are updated.
+        </para>
+
+        <para>
+          <command>myisamlog</command> understands the following
+          options:
+        </para>
+
+        <itemizedlist>
+
+          <listitem>
+            <para>
+              <option>-?</option>, <option>-I</option>
+            </para>
+
+            <para>
+              Display a help message and exit.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-c <replaceable>N</replaceable></option>
+            </para>
+
+            <para>
+              Do only <replaceable>N</replaceable> commands.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-f <replaceable>N</replaceable></option>
+            </para>
+
+            <para>
+              Specify the maximum number of open files.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-F <replaceable>filepath/</replaceable></option>
+            </para>
+
+            <para>
+              TODO
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-i</option>
+            </para>
+
+            <para>
+              Display extra information before exiting.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-o <replaceable>offset</replaceable></option>
+            </para>
+
+            <para>
+              Specify the starting offset.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-p <replaceable>N</replaceable></option>
+            </para>
+
+            <para>
+              Remove <replaceable>N</replaceable> components from path.
+            </para>
+          </listitem>
+
+<!--
+        <listitem>
+          <para>
+            <option>-P</option>
+          </para>
+
+          <para>
+            UNKNOWN
+          </para>
+        </listitem>
+-->
+
+          <listitem>
+            <para>
+              <option>-r</option>
+            </para>
+
+            <para>
+              Recover.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-R <replaceable>record-pos-file
+              record-pos</replaceable></option>
+            </para>
+
+            <para>
+              Specify record position file and record position.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-u</option>
+            </para>
+
+            <para>
+              Update.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-v</option>
+            </para>
+
+            <para>
+              Verbose mode. Produce more output. This option can be
+              given multiple times to produce more and more output.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-w <replaceable>write-file</replaceable></option>
+            </para>
+
+            <para>
+              Specify write file.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-V</option>
+            </para>
+
+            <para>
+              Display version information.
+            </para>
+          </listitem>
+
+        </itemizedlist>
+
+      </refsection>
+
+    </refentry>
+
+  </section>
+
   <section id="fake-id-for-myisampack-manpage-section-wrapper">
 
     <title>fake title for myisampack manpage section wrapper</title>
@@ -1673,11 +1907,14 @@
               option and the password. If you omit the
               <replaceable>password</replaceable> value following the
               <option>--password</option> or <option>-p</option> option
-              on the command line, you are prompted for one. The
-              password should be omitted on SysV-based UNIX systems, as
-              the password may be displayed in the output of
-              <literal>ps</literal>.
+              on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -3146,6 +3383,12 @@
               <option>-p</option> option on the command line, you are
               prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -3214,6 +3457,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -3938,6 +4187,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -4332,6 +4587,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -5247,6 +5508,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -5992,6 +6259,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -6693,8 +6966,15 @@
             <para>
               The password to use when connecting to the server. Note
               that the password value is not optional for this option,
-              unlike for other MySQL programs.
+              unlike for other MySQL programs. You can use an option
+              file to avoid giving the password on the command line.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -7054,6 +7334,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -7423,6 +7709,18 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -7647,223 +7945,6 @@
 
   </section>
 
-  <section id="fake-id-for-myisamlog-manpage-section-wrapper">
-
-    <title>fake title for myisamlog manpage section wrapper</title>
-
-    <refentry id="myisamlog">
-
-      <indexterm>
-        <primary><command>myisamlog</command></primary>
-      </indexterm>
-
-      <refmeta>
-        <refentrytitle><command>myisamlog</command></refentrytitle>
-         
-        <manvolnum>1</manvolnum>
-        <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
-        <refmiscinfo class="source">MySQL</refmiscinfo>
-        <refmiscinfo class="version">&current-series;</refmiscinfo>
-        <refmiscinfo class="refman">&title-myisamlog-for-manual;</refmiscinfo>
-      </refmeta>
-
-      <refnamediv>
-        <refname>myisamlog</refname>
-         
-        <refpurpose>&title-myisamlog-for-manpage;</refpurpose>
-      </refnamediv>
-
-      <refsynopsisdiv>
-        <cmdsynopsis>
-          <command>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
-        </cmdsynopsis>
-      </refsynopsisdiv>
-
-      <refsection id="myisamlog-description">
-
-        <title>Description</title>
-
-        <para>
-          <command>myisamlog</command> processes the contents of a
-          <literal>MyISAM</literal> log file.
-        </para>
-
-        <para>
-          Invoke <command>myisamlog</command> like this:
-        </para>
-
-<programlisting>
-shell&gt; <userinput>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
-</programlisting>
-
-        <para>
-          The normal operation is update (<option>-u</option>). If a
-          recovery is done (<option>-r</option>), all writes and
-          possibly updates and deletes are done and errors are only
-          counted. If no logfile name is given,
-          <filename>myisam.log</filename> is used. If table names are
-          named on the command line, only those tables are updated.
-        </para>
-
-        <para>
-          <command>myisamlog</command> understands the following
-          options:
-        </para>
-
-        <itemizedlist>
-
-          <listitem>
-            <para>
-              <option>-?</option>, <option>-I</option>
-            </para>
-
-            <para>
-              Display a help message and exit.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-c <replaceable>N</replaceable></option>
-            </para>
-
-            <para>
-              Do only <replaceable>N</replaceable> commands.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-f <replaceable>N</replaceable></option>
-            </para>
-
-            <para>
-              Specify the maximum number of open files.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-F <replaceable>filepath/</replaceable></option>
-            </para>
-
-            <para>
-              TODO
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-i</option>
-            </para>
-
-            <para>
-              Display extra information before exiting.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-o <replaceable>offset</replaceable></option>
-            </para>
-
-            <para>
-              Specify the starting offset.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-p <replaceable>N</replaceable></option>
-            </para>
-
-            <para>
-              Remove <replaceable>N</replaceable> components from path.
-            </para>
-          </listitem>
-
-<!--
-        <listitem>
-          <para>
-            <option>-P</option>
-          </para>
-
-          <para>
-            UNKNOWN
-          </para>
-        </listitem>
--->
-
-          <listitem>
-            <para>
-              <option>-r</option>
-            </para>
-
-            <para>
-              Recover.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-R <replaceable>record-pos-file
-              record-pos</replaceable></option>
-            </para>
-
-            <para>
-              Specify record position file and record position.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-u</option>
-            </para>
-
-            <para>
-              Update.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-v</option>
-            </para>
-
-            <para>
-              Verbose mode. Produce more output. This option can be
-              given multiple times to produce more and more output.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-w <replaceable>write-file</replaceable></option>
-            </para>
-
-            <para>
-              Specify write file.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-V</option>
-            </para>
-
-            <para>
-              Display version information.
-            </para>
-          </listitem>
-
-        </itemizedlist>
-
-      </refsection>
-
-    </refentry>
-
-  </section>
-
   <section id="fake-id-for-perror-manpage-section-wrapper">
 
     <title>fake title for perror manpage section wrapper</title>

Modified: trunk/refman-5.0/database-administration.xml
===================================================================
--- trunk/refman-5.0/database-administration.xml	2006-01-13 20:10:16 UTC (rev 814)
+++ trunk/refman-5.0/database-administration.xml	2006-01-13 20:11:16 UTC (rev 815)
@@ -717,6 +717,7 @@
 
         <refmeta>
           <refentrytitle><command>mysqld_safe</command></refentrytitle>
+           
           <manvolnum>1</manvolnum>
           <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
           <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -726,11 +727,13 @@
 
         <refnamediv>
           <refname>mysqld_safe</refname>
+           
           <refpurpose>&title-mysqld-safe-for-manpage;</refpurpose>
         </refnamediv>
 
         <refnamediv>
           <refname>safe_mysqld</refname>
+           
           <refpurpose>&title-safe-mysqld-for-manpage;</refpurpose>
         </refnamediv>
 
@@ -1274,6 +1277,7 @@
 
         <refmeta>
           <refentrytitle><command>mysql.server</command></refentrytitle>
+           
           <manvolnum>1</manvolnum>
           <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
           <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1283,6 +1287,7 @@
 
         <refnamediv>
           <refname>mysql.server</refname>
+           
           <refpurpose>&title-mysql-server-for-manpage;</refpurpose>
         </refnamediv>
 
@@ -1376,6 +1381,7 @@
 
         <refmeta>
           <refentrytitle><command>mysqld_multi</command></refentrytitle>
+           
           <manvolnum>1</manvolnum>
           <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
           <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1385,6 +1391,7 @@
 
         <refnamediv>
           <refname>mysqld_multi</refname>
+           
           <refpurpose>&title-mysqld-multi-for-manpage;</refpurpose>
         </refnamediv>
 
@@ -1941,6 +1948,7 @@
 
       <refmeta>
         <refentrytitle><command>mysqlmanager</command></refentrytitle>
+         
         <manvolnum>1</manvolnum>
         <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
         <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1950,6 +1958,7 @@
 
       <refnamediv>
         <refname>mysqlmanager</refname>
+         
         <refpurpose>&title-instance-manager-for-manpage;</refpurpose>
       </refnamediv>
 
@@ -2794,6 +2803,7 @@
 
       <refmeta>
         <refentrytitle><command>mysqld</command></refentrytitle>
+         
         <manvolnum>1</manvolnum>
         <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
         <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -2803,6 +2813,7 @@
 
       <refnamediv>
         <refname>mysqld</refname>
+         
         <refpurpose>&title-mysqld-for-manpage;</refpurpose>
       </refnamediv>
 
@@ -11228,6 +11239,7 @@
 
       <refmeta>
         <refentrytitle><command>mysql_fix_privilege_tables</command></refentrytitle>
+         
         <manvolnum>1</manvolnum>
         <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
         <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -11237,6 +11249,7 @@
 
       <refnamediv>
         <refname>mysql_fix_privilege_tables</refname>
+         
         <refpurpose>&title-mysql-fix-privilege-tables-for-manpage;</refpurpose>
       </refnamediv>
 
@@ -17433,13 +17446,17 @@
 </programlisting>
 
           <para>
-            This is convenient but insecure, because your password
-            becomes visible to system status programs such as
-            <command>ps</command> that may be invoked by other users to
-            display command lines. MySQL clients typically overwrite the
-            command-line password argument with zeros during their
-            initialization sequence, but there is still a brief interval
-            during which the value is visible.
+            This is convenient <emphasis>but insecure</emphasis>,
+            because your password becomes visible to system status
+            programs such as <command>ps</command> that may be invoked
+            by other users to display command lines. MySQL clients
+            typically overwrite the command-line password argument with
+            zeros during their initialization sequence. However, there
+            is still a brief interval during which the value is visible.
+            On some systems this strategy is ineffective, anyway, and
+            the password remains visible to <command>ps</command>.
+            (SystemV Unix systems and perhaps others are subject to this
+            problem.)
           </para>
         </listitem>
 
@@ -17513,15 +17530,16 @@
           <para>
             Store your password in the <literal>MYSQL_PWD</literal>
             environment variable. This method of specifying your MySQL
-            password must be considered extremely insecure and should
-            not be used. Some versions of <command>ps</command> include
-            an option to display the environment of running processes.
-            If you set <literal>MYSQL_PWD</literal>, your password is
-            exposed to any other user who runs <command>ps</command>.
-            Even on systems without such a version of
-            <command>ps</command>, it is unwise to assume that there are
-            no other methods by which users can examine process
-            environments. See <xref linkend="environment-variables"/>.
+            password must be considered <emphasis>extremely
+            insecure</emphasis> and should not be used. Some versions of
+            <command>ps</command> include an option to display the
+            environment of running processes. If you set
+            <literal>MYSQL_PWD</literal>, your password is exposed to
+            any other user who runs <command>ps</command>. Even on
+            systems without such a version of <command>ps</command>, it
+            is unwise to assume that there are no other methods by which
+            users can examine process environments. See
+            <xref linkend="environment-variables"/>.
           </para>
         </listitem>
 
@@ -19423,6 +19441,7 @@
 
         <refmeta>
           <refentrytitle><command>myisamchk</command></refentrytitle>
+           
           <manvolnum>1</manvolnum>
           <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
           <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -19432,6 +19451,7 @@
 
         <refnamediv>
           <refname>myisamchk</refname>
+           
           <refpurpose>&title-myisamchk-for-manpage;</refpurpose>
         </refnamediv>
 

Modified: trunk/refman-5.1/client-utility-programs.xml
===================================================================
--- trunk/refman-5.1/client-utility-programs.xml	2006-01-13 20:10:16 UTC (rev 814)
+++ trunk/refman-5.1/client-utility-programs.xml	2006-01-13 20:11:16 UTC (rev 815)
@@ -51,6 +51,22 @@
       <listitem>
         <para>
           <indexterm>
+            <primary><command>myisamlog</command></primary>
+          </indexterm>
+
+          <command>myisamlog</command>
+        </para>
+
+        <para>
+          A utility that processes the contents of a
+          <literal>MyISAM</literal> log file. See
+          <xref linkend="myisampack"/>.
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+          <indexterm>
             <primary><command>myisampack</command></primary>
           </indexterm>
 
@@ -91,7 +107,8 @@
 
         <para>
           A script that checks the access privileges for a hostname,
-          username, and database combination.
+          username, and database combination. See
+          <xref linkend="mysqlaccess"/>.
         </para>
       </listitem>
 
@@ -360,6 +377,223 @@
 
   </section>
 
+  <section id="fake-id-for-myisamlog-manpage-section-wrapper">
+
+    <title>fake title for myisamlog manpage section wrapper</title>
+
+    <refentry id="myisamlog">
+
+      <indexterm>
+        <primary><command>myisamlog</command></primary>
+      </indexterm>
+
+      <refmeta>
+        <refentrytitle><command>myisamlog</command></refentrytitle>
+         
+        <manvolnum>1</manvolnum>
+        <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
+        <refmiscinfo class="source">MySQL</refmiscinfo>
+        <refmiscinfo class="version">&current-series;</refmiscinfo>
+        <refmiscinfo class="refman">&title-myisamlog-for-manual;</refmiscinfo>
+      </refmeta>
+
+      <refnamediv>
+        <refname>myisamlog</refname>
+         
+        <refpurpose>&title-myisamlog-for-manpage;</refpurpose>
+      </refnamediv>
+
+      <refsynopsisdiv>
+        <cmdsynopsis>
+          <command>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
+        </cmdsynopsis>
+      </refsynopsisdiv>
+
+      <refsection id="myisamlog-description">
+
+        <title>Description</title>
+
+        <para>
+          <command>myisamlog</command> processes the contents of a
+          <literal>MyISAM</literal> log file.
+        </para>
+
+        <para>
+          Invoke <command>myisamlog</command> like this:
+        </para>
+
+<programlisting>
+shell&gt; <userinput>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
+</programlisting>
+
+        <para>
+          The normal operation is update (<option>-u</option>). If a
+          recovery is done (<option>-r</option>), all writes and
+          possibly updates and deletes are done and errors are only
+          counted. If no logfile name is given,
+          <filename>myisam.log</filename> is used. If table names are
+          named on the command line, only those tables are updated.
+        </para>
+
+        <para>
+          <command>myisamlog</command> understands the following
+          options:
+        </para>
+
+        <itemizedlist>
+
+          <listitem>
+            <para>
+              <option>-?</option>, <option>-I</option>
+            </para>
+
+            <para>
+              Display a help message and exit.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-c <replaceable>N</replaceable></option>
+            </para>
+
+            <para>
+              Do only <replaceable>N</replaceable> commands.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-f <replaceable>N</replaceable></option>
+            </para>
+
+            <para>
+              Specify the maximum number of open files.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-F <replaceable>filepath/</replaceable></option>
+            </para>
+
+            <para>
+              TODO
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-i</option>
+            </para>
+
+            <para>
+              Display extra information before exiting.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-o <replaceable>offset</replaceable></option>
+            </para>
+
+            <para>
+              Specify the starting offset.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-p <replaceable>N</replaceable></option>
+            </para>
+
+            <para>
+              Remove <replaceable>N</replaceable> components from path.
+            </para>
+          </listitem>
+
+<!--
+        <listitem>
+          <para>
+            <option>-P</option>
+          </para>
+
+          <para>
+            UNKNOWN
+          </para>
+        </listitem>
+-->
+
+          <listitem>
+            <para>
+              <option>-r</option>
+            </para>
+
+            <para>
+              Recover.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-R <replaceable>record-pos-file
+              record-pos</replaceable></option>
+            </para>
+
+            <para>
+              Specify record position file and record position.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-u</option>
+            </para>
+
+            <para>
+              Update.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-v</option>
+            </para>
+
+            <para>
+              Verbose mode. Produce more output. This option can be
+              given multiple times to produce more and more output.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-w <replaceable>write-file</replaceable></option>
+            </para>
+
+            <para>
+              Specify write file.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>-V</option>
+            </para>
+
+            <para>
+              Display version information.
+            </para>
+          </listitem>
+
+        </itemizedlist>
+
+      </refsection>
+
+    </refentry>
+
+  </section>
+
   <section id="fake-id-for-myisampack-manpage-section-wrapper">
 
     <title>fake title for myisampack manpage section wrapper</title>
@@ -1673,11 +1907,14 @@
               option and the password. If you omit the
               <replaceable>password</replaceable> value following the
               <option>--password</option> or <option>-p</option> option
-              on the command line, you are prompted for one. The
-              password should be omitted on SysV-based UNIX systems, as
-              the password may be displayed in the output of
-              <literal>ps</literal>.
+              on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -3145,6 +3382,12 @@
               <option>-p</option> option on the command line, you are
               prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -3213,6 +3456,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -3937,6 +4186,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -4344,6 +4599,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -5271,6 +5532,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -6015,6 +6282,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -6726,8 +6999,15 @@
             <para>
               The password to use when connecting to the server. Note
               that the password value is not optional for this option,
-              unlike for other MySQL programs.
+              unlike for other MySQL programs. You can use an option
+              file to avoid giving the password on the command line.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -7087,6 +7367,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -7456,6 +7742,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -7815,6 +8107,12 @@
               <option>--password</option> or <option>-p</option> option
               on the command line, you are prompted for one.
             </para>
+
+            <para>
+              Specifying a password on the command line should be
+              considered insecure. See
+              <xref linkend="password-security"/>.
+            </para>
           </listitem>
 
           <listitem>
@@ -8068,223 +8366,6 @@
 
   </section>
 
-  <section id="fake-id-for-myisamlog-manpage-section-wrapper">
-
-    <title>fake title for myisamlog manpage section wrapper</title>
-
-    <refentry id="myisamlog">
-
-      <indexterm>
-        <primary><command>myisamlog</command></primary>
-      </indexterm>
-
-      <refmeta>
-        <refentrytitle><command>myisamlog</command></refentrytitle>
-         
-        <manvolnum>1</manvolnum>
-        <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
-        <refmiscinfo class="source">MySQL</refmiscinfo>
-        <refmiscinfo class="version">&current-series;</refmiscinfo>
-        <refmiscinfo class="refman">&title-myisamlog-for-manual;</refmiscinfo>
-      </refmeta>
-
-      <refnamediv>
-        <refname>myisamlog</refname>
-         
-        <refpurpose>&title-myisamlog-for-manpage;</refpurpose>
-      </refnamediv>
-
-      <refsynopsisdiv>
-        <cmdsynopsis>
-          <command>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
-        </cmdsynopsis>
-      </refsynopsisdiv>
-
-      <refsection id="myisamlog-description">
-
-        <title>Description</title>
-
-        <para>
-          <command>myisamlog</command> processes the contents of a
-          <literal>MyISAM</literal> log file.
-        </para>
-
-        <para>
-          Invoke <command>myisamlog</command> like this:
-        </para>
-
-<programlisting>
-shell&gt; <userinput>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
-</programlisting>
-
-        <para>
-          The normal operation is update (<option>-u</option>). If a
-          recovery is done (<option>-r</option>), all writes and
-          possibly updates and deletes are done and errors are only
-          counted. If no logfile name is given,
-          <filename>myisam.log</filename> is used. If table names are
-          named on the command line, only those tables are updated.
-        </para>
-
-        <para>
-          <command>myisamlog</command> understands the following
-          options:
-        </para>
-
-        <itemizedlist>
-
-          <listitem>
-            <para>
-              <option>-?</option>, <option>-I</option>
-            </para>
-
-            <para>
-              Display a help message and exit.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-c <replaceable>N</replaceable></option>
-            </para>
-
-            <para>
-              Do only <replaceable>N</replaceable> commands.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-f <replaceable>N</replaceable></option>
-            </para>
-
-            <para>
-              Specify the maximum number of open files.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-F <replaceable>filepath/</replaceable></option>
-            </para>
-
-            <para>
-              TODO
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-i</option>
-            </para>
-
-            <para>
-              Display extra information before exiting.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-o <replaceable>offset</replaceable></option>
-            </para>
-
-            <para>
-              Specify the starting offset.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-p <replaceable>N</replaceable></option>
-            </para>
-
-            <para>
-              Remove <replaceable>N</replaceable> components from path.
-            </para>
-          </listitem>
-
-<!--
-        <listitem>
-          <para>
-            <option>-P</option>
-          </para>
-
-          <para>
-            UNKNOWN
-          </para>
-        </listitem>
--->
-
-          <listitem>
-            <para>
-              <option>-r</option>
-            </para>
-
-            <para>
-              Recover.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-R <replaceable>record-pos-file
-              record-pos</replaceable></option>
-            </para>
-
-            <para>
-              Specify record position file and record position.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-u</option>
-            </para>
-
-            <para>
-              Update.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-v</option>
-            </para>
-
-            <para>
-              Verbose mode. Produce more output. This option can be
-              given multiple times to produce more and more output.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-w <replaceable>write-file</replaceable></option>
-            </para>
-
-            <para>
-              Specify write file.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <option>-V</option>
-            </para>
-
-            <para>
-              Display version information.
-            </para>
-          </listitem>
-
-        </itemizedlist>
-
-      </refsection>
-
-    </refentry>
-
-  </section>
-
   <section id="fake-id-for-perror-manpage-section-wrapper">
 
     <title>fake title for perror manpage section wrapper</title>

Modified: trunk/refman-5.1/database-administration.xml
===================================================================
--- trunk/refman-5.1/database-administration.xml	2006-01-13 20:10:16 UTC (rev 814)
+++ trunk/refman-5.1/database-administration.xml	2006-01-13 20:11:16 UTC (rev 815)
@@ -717,6 +717,7 @@
 
         <refmeta>
           <refentrytitle><command>mysqld_safe</command></refentrytitle>
+           
           <manvolnum>1</manvolnum>
           <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
           <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -726,11 +727,13 @@
 
         <refnamediv>
           <refname>mysqld_safe</refname>
+           
           <refpurpose>&title-mysqld-safe-for-manpage;</refpurpose>
         </refnamediv>
 
         <refnamediv>
           <refname>safe_mysqld</refname>
+           
           <refpurpose>&title-safe-mysqld-for-manpage;</refpurpose>
         </refnamediv>
 
@@ -1274,6 +1277,7 @@
 
         <refmeta>
           <refentrytitle><command>mysql.server</command></refentrytitle>
+           
           <manvolnum>1</manvolnum>
           <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
           <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1283,6 +1287,7 @@
 
         <refnamediv>
           <refname>mysql.server</refname>
+           
           <refpurpose>&title-mysql-server-for-manpage;</refpurpose>
         </refnamediv>
 
@@ -1376,6 +1381,7 @@
 
         <refmeta>
           <refentrytitle><command>mysqld_multi</command></refentrytitle>
+           
           <manvolnum>1</manvolnum>
           <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
           <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1385,6 +1391,7 @@
 
         <refnamediv>
           <refname>mysqld_multi</refname>
+           
           <refpurpose>&title-mysqld-multi-for-manpage;</refpurpose>
         </refnamediv>
 
@@ -1941,6 +1948,7 @@
 
       <refmeta>
         <refentrytitle><command>mysqlmanager</command></refentrytitle>
+         
         <manvolnum>1</manvolnum>
         <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
         <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1950,6 +1958,7 @@
 
       <refnamediv>
         <refname>mysqlmanager</refname>
+         
         <refpurpose>&title-instance-manager-for-manpage;</refpurpose>
       </refnamediv>
 
@@ -2778,6 +2787,7 @@
 
       <refmeta>
         <refentrytitle><command>mysqld</command></refentrytitle>
+         
         <manvolnum>1</manvolnum>
         <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
         <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -2787,6 +2797,7 @@
 
       <refnamediv>
         <refname>mysqld</refname>
+         
         <refpurpose>&title-mysqld-for-manpage;</refpurpose>
       </refnamediv>
 
@@ -11205,6 +11216,7 @@
 
       <refmeta>
         <refentrytitle><command>mysql_fix_privilege_tables</command></refentrytitle>
+         
         <manvolnum>1</manvolnum>
         <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
         <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -11214,6 +11226,7 @@
 
       <refnamediv>
         <refname>mysql_fix_privilege_tables</refname>
+         
         <refpurpose>&title-mysql-fix-privilege-tables-for-manpage;</refpurpose>
       </refnamediv>
 
@@ -17382,13 +17395,17 @@
 </programlisting>
 
           <para>
-            This is convenient but insecure, because your password
-            becomes visible to system status programs such as
-            <command>ps</command> that may be invoked by other users to
-            display command lines. MySQL clients typically overwrite the
-            command-line password argument with zeros during their
-            initialization sequence, but there is still a brief interval
-            during which the value is visible.
+            This is convenient <emphasis>but insecure</emphasis>,
+            because your password becomes visible to system status
+            programs such as <command>ps</command> that may be invoked
+            by other users to display command lines. MySQL clients
+            typically overwrite the command-line password argument with
+            zeros during their initialization sequence. However, there
+            is still a brief interval during which the value is visible.
+            On some systems this strategy is ineffective, anyway, and
+            the password remains visible to <command>ps</command>.
+            (SystemV Unix systems and perhaps others are subject to this
+            problem.)
           </para>
         </listitem>
 
@@ -17462,15 +17479,16 @@
           <para>
             Store your password in the <literal>MYSQL_PWD</literal>
             environment variable. This method of specifying your MySQL
-            password must be considered extremely insecure and should
-            not be used. Some versions of <command>ps</command> include
-            an option to display the environment of running processes.
-            If you set <literal>MYSQL_PWD</literal>, your password is
-            exposed to any other user who runs <command>ps</command>.
-            Even on systems without such a version of
-            <command>ps</command>, it is unwise to assume that there are
-            no other methods by which users can examine process
-            environments. See <xref linkend="environment-variables"/>.
+            password must be considered <emphasis>extremely
+            insecure</emphasis> and should not be used. Some versions of
+            <command>ps</command> include an option to display the
+            environment of running processes. If you set
+            <literal>MYSQL_PWD</literal>, your password is exposed to
+            any other user who runs <command>ps</command>. Even on
+            systems without such a version of <command>ps</command>, it
+            is unwise to assume that there are no other methods by which
+            users can examine process environments. See
+            <xref linkend="environment-variables"/>.
           </para>
         </listitem>
 
@@ -19372,6 +19390,7 @@
 
         <refmeta>
           <refentrytitle><command>myisamchk</command></refentrytitle>
+           
           <manvolnum>1</manvolnum>
           <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
           <refmiscinfo class="source">MySQL</refmiscinfo>
@@ -19381,6 +19400,7 @@
 
         <refnamediv>
           <refname>myisamchk</refname>
+           
           <refpurpose>&title-myisamchk-for-manpage;</refpurpose>
         </refnamediv>
 

Thread
svn commit - mysqldoc@docsrva: r815 - in trunk: . refman-4.1 refman-5.0 refman-5.1paul13 Jan