diff -u moin-1.6.orig/MoinMoin/script/__init__.py moin-1.6/MoinMoin/script/__init__.py
--- moin-1.6.orig/MoinMoin/script/__init__.py	2007-12-12 05:19:45.000000000 +0200
+++ moin-1.6/MoinMoin/script/__init__.py	2007-12-30 02:09:14.000000000 +0200
@@ -112,7 +112,7 @@
 
         self.parser = optparse.OptionParser(
             usage="%(cmd)s [command] %(usage)s" % {'cmd': os.path.basename(sys.argv[0]), 'usage': usage, },
-            version=rev)
+            version=rev, add_help_option=False)
         self.parser.allow_interspersed_args = False
         if def_values:
             self.parser.set_defaults(**def_values.__dict__)
@@ -170,6 +170,11 @@
             "--page", dest="page", default='',
             help="wiki page name [default: all pages]"
         )
+        self.parser.add_option(
+            "-h", "--help",
+            action="store_true", dest="help",
+            help="Print informational messages."
+        )
 
     def init_request(self):
         """ create request """
@@ -242,5 +247,7 @@
             plugin_class = wikiutil.importBuiltinPlugin('script.%s' % cmd_module, cmd_name, 'PluginScript')
         except wikiutil.PluginMissingError:
             fatal("Command plugin %r, command %r was not found." % (cmd_module, cmd_name))
+        if self.options.help:
+            print plugin_class.__doc__
         plugin_class(args[2:], self.options).run() # all starts again there
 
diff -u moin-1.6.orig/MoinMoin/script/account/check.py moin-1.6/MoinMoin/script/account/check.py
--- moin-1.6.orig/MoinMoin/script/account/check.py	2007-12-12 05:19:45.000000000 +0200
+++ moin-1.6/MoinMoin/script/account/check.py	2007-12-30 20:10:19.000000000 +0200
@@ -1,35 +1,51 @@
 # -*- coding: iso-8859-1 -*-
-"""
-    MoinMoin - check / process user accounts
+    
+# ----------------------------------------------------------------------------
+# if a user subsribes to magicpages, it means that he wants to keep
+# exactly THIS account - this will avoid deleting it.
+magicpages = [
+    "ThisAccountIsCorrect",
+    "DieserAccountIstRichtig",
+]
 
-    @copyright: 2003-2006 MoinMoin:ThomasWaldmann
-    @license: GNU GPL, see COPYING for details.
+# ----------------------------------------------------------------------------
+       
+import os, sys
+    
+from MoinMoin.script import MoinScript
+from MoinMoin import user, wikiutil
 
-    Why is this needed?
-    ===================
-    When using ACLs, a wiki user name has to be unique, there must not be
-    multiple accounts having the same username. The problem is, that this
-    was possible before the introduction of ACLs and many users, who forgot
-    their ID, simply created a new ID using the same user name.
-
-    Because access rights (when using ACLs) depend on the NAME (not the ID),
-    this must be cleaned up before using ACLs or users will have difficulties
-    changing settings and saving their account data (system won't accept the
-    save, if the user name and email is not unique).
+class PluginScript(MoinScript):
+    """MoinMoin - check / process user accounts
 
-    How to use this tool?
-    =====================
+@copyright: 2003-2006 MoinMoin:ThomasWaldmann
+@license: GNU GPL, see COPYING for details.
+
+Purpose:
+========
+When using ACLs, a wiki user name has to be unique, there must not be
+multiple accounts having the same username. The problem is, that this
+was possible before the introduction of ACLs and many users, who forgot
+their ID, simply created a new ID using the same user name.
+
+Because access rights (when using ACLs) depend on the NAME (not the ID),
+this must be cleaned up before using ACLs or users will have difficulties
+changing settings and saving their account data (system won't accept the
+save, if the user name and email is not unique).
+
+Detailed Instructions:
+======================
+
+General syntax: moin [options] account check [check-options]
+
+[options] usually should be:
+    --config-dir=/path/to/my/cfg/ --wiki-url=wiki.example.org/
+
+[check-options] see below:
 
-    General syntax: moin [options] account check [check-options]
-    
-    [options] usually should be:
-        --config-dir=/path/to/my/cfg/ --wiki-url=wiki.example.org/
-    
-    [check-options] see below:
-    
     0. Check the settings at top of the code!
        Making a backup of your wiki might be also a great idea.
-       
+
     1. Best is to first look at duplicate user names:
        moin ... account check --usersunique
 
@@ -47,29 +63,12 @@
 
     4. After cleaning up, do 1. and 2. again. There should be no output now, if
        everything is OK.
-       
+
     5. Optionally you may want to make wikinames out of the user names
        moin ... account check --wikinames
        moin ... account check --wikinames --save
-        
 """
 
-# ----------------------------------------------------------------------------
-# if a user subsribes to magicpages, it means that he wants to keep
-# exactly THIS account - this will avoid deleting it.
-magicpages = [
-    "ThisAccountIsCorrect",
-    "DieserAccountIstRichtig",
-]
-
-# ----------------------------------------------------------------------------
-
-import os, sys
-
-from MoinMoin.script import MoinScript
-from MoinMoin import user, wikiutil
-
-class PluginScript(MoinScript):
     def __init__(self, argv, def_values):
         MoinScript.__init__(self, argv, def_values)
         self._addFlag("usersunique",
diff -u moin-1.6.orig/MoinMoin/script/account/create.py moin-1.6/MoinMoin/script/account/create.py
--- moin-1.6.orig/MoinMoin/script/account/create.py	2007-12-12 05:19:45.000000000 +0200
+++ moin-1.6/MoinMoin/script/account/create.py	2007-12-30 20:10:40.000000000 +0200
@@ -1,14 +1,35 @@
 # -*- coding: iso-8859-1 -*-
-"""
-    MoinMoin - create a user account
-
-    @copyright: 2006 MoinMoin:ThomasWaldmann
-    @license: GNU GPL, see COPYING for details.
-"""
-
 from MoinMoin.script import MoinScript
 
 class PluginScript(MoinScript):
+    """MoinMoin - create a user account
+
+@copyright: 2006 MoinMoin:ThomasWaldmann
+@license: GNU GPL, see COPYING for details.
+
+Purpose:
+========
+This tool allows you to create user accounts via a command line interface.
+
+Detailed Instructions:
+======================
+General syntax: moin [options] account create [create-options]
+
+[options] usually should be:
+    --config-dir=/path/to/my/cfg/ --wiki-url=wiki.example.org/
+
+[create-options] see below:
+    0. Verify that the account does not exist.
+       Currently this script does not check if the user exists.
+
+    1. Verify that you have specified the right options.
+       This script does no verification of email addresses or the like.
+
+    2. To create a normal user 'JohnSmith' with an alias of 'JSmith' and an
+       email of 'john@smith.com'
+       moin ... account create --name JohnSmith --alias JSmith --email john@smith.com
+"""
+
     def __init__(self, argv, def_values):
         MoinScript.__init__(self, argv, def_values)
         self.parser.add_option(
diff -u moin-1.6.orig/MoinMoin/script/account/disable.py moin-1.6/MoinMoin/script/account/disable.py
--- moin-1.6.orig/MoinMoin/script/account/disable.py	2007-12-12 05:19:45.000000000 +0200
+++ moin-1.6/MoinMoin/script/account/disable.py	2007-12-30 20:11:12.000000000 +0200
@@ -1,14 +1,37 @@
 # -*- coding: iso-8859-1 -*-
-"""
-    MoinMoin - disable a user account
-
-    @copyright: 2006 MoinMoin:ThomasWaldmann
-    @license: GNU GPL, see COPYING for details.
-"""
-
 from MoinMoin.script import MoinScript
 
 class PluginScript(MoinScript):
+    """MoinMoin - disable a user account
+
+@copyright: 2006 MoinMoin:ThomasWaldmann
+@license: GNU GPL, see COPYING for details.
+
+Purpose:
+========
+This tool allows you to disable user accounts via a command line interface.
+
+Detailed Instructions:
+======================
+General syntax: moin [options] account disable [disable-options]
+
+[options] usually should be:
+    --config-dir=/path/to/my/cfg/ --wiki-url=wiki.example.org/
+
+[disable-options] see below:
+    0. Verify that you really want to disable the account.
+       While there is a disable script, no such enable script exists.
+
+    1. If using usernames, verify that multiple usernames with the same
+       user ID do not exist.
+
+    2. To disable the user 'JohnSmith':
+       moin ... account disable --name JohnSmith
+
+    3. To disable the user 'JohnSmith', based on his UID '1198872910.78.56322':
+       moin ... account disable --uid 1198872910.78.56322
+"""
+
     def __init__(self, argv, def_values):
         MoinScript.__init__(self, argv, def_values)
         self.parser.add_option(
diff -u moin-1.6.orig/MoinMoin/script/cli/show.py moin-1.6/MoinMoin/script/cli/show.py
--- moin-1.6.orig/MoinMoin/script/cli/show.py	2007-12-12 05:19:45.000000000 +0200
+++ moin-1.6/MoinMoin/script/cli/show.py	2007-12-30 20:20:00.000000000 +0200
@@ -1,17 +1,23 @@
 # -*- coding: iso-8859-1 -*-
-"""
-    MoinMoin - cli show script
+from MoinMoin.script import MoinScript
 
-    Just run a CLI request and show the output.
+class PluginScript(MoinScript):
+    """MoinMoin - cli show script
 
-    @copyright: 2006 MoinMoin:ThomasWaldmann
-    @license: GNU GPL, see COPYING for details.
-"""
+@copyright: 2006 MoinMoin:ThomasWaldmann
+@license: GNU GPL, see COPYING for details.
 
-from MoinMoin.script import MoinScript
+Purpose:
+========
+Just run a CLI request and show the output.
 
-class PluginScript(MoinScript):
-    """ show page script class """
+Detailed Instructions:
+======================
+General syntax: moin [options] cli show
+
+[options] usually should be:
+    --config-dir=/path/to/my/cfg/ --wiki-url=wiki.example.org/
+"""
 
     def __init__(self, argv, def_values):
         MoinScript.__init__(self, argv, def_values)
diff -u moin-1.6.orig/MoinMoin/script/export/dump.py moin-1.6/MoinMoin/script/export/dump.py
--- moin-1.6.orig/MoinMoin/script/export/dump.py	2007-12-12 05:19:45.000000000 +0200
+++ moin-1.6/MoinMoin/script/export/dump.py	2007-12-30 20:12:25.000000000 +0200
@@ -1,16 +1,4 @@
 # -*- coding: iso-8859-1 -*-
-"""
-    MoinMoin - Dump a MoinMoin wiki to static pages
-
-    You must run this script as owner of the wiki files, usually this is the
-    web server user.
-
-    @copyright: 2002-2004 Juergen Hermann <jh@web.de>,
-                2005-2006 MoinMoin:ThomasWaldmann
-    @license: GNU GPL, see COPYING for details.
-
-"""
-
 import sys, os, time, codecs, shutil, re, errno
 
 from MoinMoin import config, wikiutil, Page, user
@@ -95,7 +83,34 @@
 
 
 class PluginScript(script.MoinScript):
-    """ Dump script class """
+    """MoinMoin - Dump a MoinMoin wiki to static pages
+
+@copyright: 2002-2004 Juergen Hermann <jh@web.de>,
+            2005-2006 MoinMoin:ThomasWaldmann
+@license: GNU GPL, see COPYING for details.
+
+Purpose:
+========
+This tool allows you to dump MoinMoin wiki pages to static HTML files.
+
+Detailed Instructions:
+======================
+General syntax: moin [options] export dump [dump-options]
+
+[options] usually should be:
+    --config-dir=/path/to/my/cfg/ --wiki-url=wiki.example.org/
+
+[dump-options] see below:
+    0. You must run this script as owner of the wiki files, usually this is the
+       web server user.
+
+    1. To dump all the pages on the wiki to the directory '/mywiki'
+       moin ... export dump --target-dir=/mywiki
+
+    2. To dump all the pages readable by 'JohnSmith' on the wiki to the directory
+       '/mywiki'
+       moin ... export dump --target-dir=/mywiki --username JohnSmith
+"""
 
     def __init__(self, argv=None, def_values=None):
         script.MoinScript.__init__(self, argv, def_values)
diff -u moin-1.6.orig/MoinMoin/script/export/package.py moin-1.6/MoinMoin/script/export/package.py
--- moin-1.6.orig/MoinMoin/script/export/package.py	2007-12-12 05:19:45.000000000 +0200
+++ moin-1.6/MoinMoin/script/export/package.py	2007-12-30 22:49:32.000000000 +0200
@@ -1,17 +1,4 @@
 # -*- coding: iso-8859-1 -*-
-"""
-    MoinMoin - Create a MoinMoin package from wiki pages specified.
-
-    You must run this script as owner of the wiki files, usually this is the
-    web server user.
-
-    @copyright: 2002-2004 Juergen Hermann <jh@web.de>,
-                2005-2006 MoinMoin:ThomasWaldmann,
-                2007 Federico Lorenzi
-    @license: GNU GPL, see COPYING for details.
-
-"""
-
 import codecs, errno, os, re, shutil, sys, time
 
 from MoinMoin import config, wikiutil, Page, user
@@ -19,7 +6,40 @@
 
 
 class PluginScript(script.MoinScript):
-    """ Create package class """
+    """MoinMoin - Create a MoinMoin package from wiki pages specified.
+
+@copyright: 2002-2004 Juergen Hermann <jh@web.de>
+            2005-2006 MoinMoin:ThomasWaldmann,
+            2007 Federico Lorenzi
+@license: GNU GPL, see COPYING for details.
+
+Purpose:
+========
+This tool allows you to create a package of certain wiki pages.
+
+Detailed Instructions:
+======================
+General syntax: moin [options] export package [package-options]
+
+[options] usually should be:
+    --config-dir=/path/to/my/cfg/ --wiki-url=wiki.example.org/
+
+[package-options] see below:
+    0. You must run this script as owner of the wiki files, usually this is the
+       web server user.
+
+    1. To package all non-system and non-underlay pages on a wiki to the file '~/mywiki.zip'
+       moin ... export package --output ~/mywiki.zip
+
+    2. To package the pages 'FooBar' and 'TestPage' on a wiki to the file '~/mywiki.zip'
+       moin ... export package --pages FooBar,TestPage --output ~/mywiki.zip
+
+    3. To package all pages matching the search term 'MoinMoin' on a wiki to the file '~/mywiki.zip'
+       moin ... export package --search MoinMoin --output ~/mywiki.zip
+
+    4. Optionally, the --user argument could be added to any of the above examples,
+       causing the script to respect ACLs.
+"""
 
     def __init__(self, argv=None, def_values=None):
         script.MoinScript.__init__(self, argv, def_values)
diff -u moin-1.6.orig/MoinMoin/script/import/irclog.py moin-1.6/MoinMoin/script/import/irclog.py
--- moin-1.6.orig/MoinMoin/script/import/irclog.py	2007-12-12 05:19:45.000000000 +0200
+++ moin-1.6/MoinMoin/script/import/irclog.py	2007-12-30 20:14:35.000000000 +0200
@@ -1,20 +1,4 @@
 # -*- coding: iso-8859-1 -*-
-"""
-    MoinMoin - Push files into the wiki.
-
-    This script pushes files from a directory into the wiki (to be exact: it
-    pushes all except the last file, as this is maybe still written to in
-    case of irc logs).
-    One application is to use it to store IRC logs into the wiki.
-
-    Usage:
-    moin --config-dir=... --wiki-url=... import irclog --author=IrcLogImporter --file-dir=.
-    
-    @copyright: 2005-2007 MoinMoin:AlexanderSchremmer
-                2006 MoinMoin:ThomasWaldmann
-    @license: GNU GPL, see COPYING for details.
-"""
-
 # this function generates a pagename from the file name
 def filename_function(filename):
     filename = filename.lstrip('#')
@@ -43,7 +27,30 @@
 
 
 class PluginScript(MoinScript):
-    """ irclog importer script class """
+    """MoinMoin - Push files into the wiki.
+
+@copyright: 2005-2007 MoinMoin:AlexanderSchremmer
+            2006 MoinMoin:ThomasWaldmann
+@license: GNU GPL, see COPYING for details.
+
+Purpose:
+========
+This script pushes files from a directory into the wiki (to be exact: it
+pushes all except the last file, as this is maybe still written to in
+case of irc logs).
+One application is to use it to store IRC logs into the wiki.
+
+Detailed Instructions:
+======================
+General syntax: moin [options] import irclog [irclog-options]
+
+[options] usually should be:
+    --config-dir=/path/to/my/cfg/ --wiki-url=wiki.example.org/
+
+[irclog-options] see below:
+    0. To add all the files in the current directory to the wiki as the user 'JohnSmith'
+       moin ... import irclog --author=JohnSmirh --file-dir=.
+"""
 
     def __init__(self, argv, def_values):
         MoinScript.__init__(self, argv, def_values)
diff -u moin-1.6.orig/MoinMoin/script/index/build.py moin-1.6/MoinMoin/script/index/build.py
--- moin-1.6.orig/MoinMoin/script/index/build.py	2007-12-12 05:19:45.000000000 +0200
+++ moin-1.6/MoinMoin/script/index/build.py	2007-12-30 20:15:10.000000000 +0200
@@ -1,18 +1,36 @@
 # -*- coding: iso-8859-1 -*-
-"""
-    MoinMoin - build xapian search engine's index
+from MoinMoin.script import MoinScript
 
-    You must run this script as owner of the wiki files, usually this is the
-    web server user.
+class IndexScript(MoinScript):
+    """MoinMoin - build xapian search engine's index
 
-    @copyright: 2006 MoinMoin:ThomasWaldmann
-    @license: GNU GPL, see COPYING for details.
-"""
+@copyright: 2006 MoinMoin:ThomasWaldmann
+@license: GNU GPL, see COPYING for details.
 
-from MoinMoin.script import MoinScript
+Purpose:
+========
+This tool allows you to control xapian's index of Moin.
 
-class IndexScript(MoinScript):
-    """ Xapian general index script class """
+Detailed Instructions:
+======================
+General syntax: moin [options] index build [build-options]
+
+[options] usually should be:
+    --config-dir=/path/to/my/cfg/ --wiki-url=wiki.example.org/
+
+[build-options] see below:
+    0. You must run this script as owner of the wiki files, usually this is the
+       web server user.
+
+    1. To add the files from '/files.lst' to the index
+       moin ... index build --files /files.lst --mode add
+
+    2. To update the index with the files from '/files.lst'
+       moin ... index build --files /files.lst --mode update
+
+    3. To rebuild the index with the files from '/files.lst'
+       moin ... index build --files /files.lst --mode rebuild
+"""
 
     def __init__(self, argv, def_values):
         MoinScript.__init__(self, argv, def_values)
diff -u moin-1.6.orig/MoinMoin/script/xmlrpc/mailimport.py moin-1.6/MoinMoin/script/xmlrpc/mailimport.py
--- moin-1.6.orig/MoinMoin/script/xmlrpc/mailimport.py	2007-12-12 05:19:45.000000000 +0200
+++ moin-1.6/MoinMoin/script/xmlrpc/mailimport.py	2007-12-30 20:17:24.000000000 +0200
@@ -1,13 +1,4 @@
 # -*- coding: iso-8859-1 -*-
-"""
-    MoinMoin - MailImport script
-
-    Imports a mail into the wiki.
-
-    @copyright: 2006 MoinMoin:AlexanderSchremmer
-    @license: GNU GPL, see COPYING for details.
-"""
-
 import sys
 import xmlrpclib
 
@@ -16,7 +7,30 @@
 input = sys.stdin
 
 class PluginScript(MoinScript):
-    """ Mail Importer """
+    """MoinMoin - MailImport script
+
+@copyright: 2006 MoinMoin:AlexanderSchremmer
+@license: GNU GPL, see COPYING for details.
+
+Purpose:
+========
+This tool allows you to import mail into the wiki.
+
+Detailed Instructions:
+======================
+General syntax: moin [options] maint mailimport [mailimport-options]
+
+[options] usually should be:
+    --config-dir=/path/to/my/cfg/ --wiki-url=wiki.example.org/
+
+[mailimport-options] see below:
+    0. Verify that you have a mailimportconf.py configuration file.
+
+    1. To import mail from the file '/mymail'
+       moin ... xmlrpc mailimport << /mymail
+       OR
+       cat /mymail | moin ... xmlrpc mailimport
+"""
 
     def __init__(self, argv, def_values):
         MoinScript.__init__(self, argv, def_values)
diff -u moin-1.6.orig/MoinMoin/script/xmlrpc/remote.py moin-1.6/MoinMoin/script/xmlrpc/remote.py
--- moin-1.6.orig/MoinMoin/script/xmlrpc/remote.py	2007-12-12 05:19:45.000000000 +0200
+++ moin-1.6/MoinMoin/script/xmlrpc/remote.py	2007-12-30 21:00:16.000000000 +0200
@@ -1,20 +1,32 @@
 # -*- coding: iso-8859-1 -*-
-"""
-    MoinMoin - remote command execution, client part
-
-    This can be used as client to execute moin scripts remotely.
-
-    @copyright: 2006 MoinMoin:ThomasWaldmann
-    @license: GNU GPL, see COPYING for details.
-"""
-
 import sys
 import xmlrpclib
 
 from MoinMoin.script import MoinScript, fatal
 
 class PluginScript(MoinScript):
-    """ Remote Script Execution Client """
+    """MoinMoin - remote command execution, client part
+
+@copyright: 2006 MoinMoin:ThomasWaldmann
+@license: GNU GPL, see COPYING for details.
+
+Purpose:
+========
+This tool allows you to execute moin scripts remotely.
+
+Detailed Instructions:
+======================
+General syntax: moin [options] xmlrpc remote [remote-options]
+
+[options] usually should be:
+    --config-dir=/path/to/my/cfg/ --wiki-url=wiki.example.org/
+
+[remote-options] see below:
+    0. Verify that you have a remotescriptconf.py configuration file.
+
+    1. To run the script 'account check' remotely.
+       moin ... xmlrpc remote account check
+"""
 
     def __init__(self, argv, def_values):
         MoinScript.__init__(self, argv, def_values)
diff -u moin-1.6.orig/MoinMoin/script/xmlrpc/retrieve.py moin-1.6/MoinMoin/script/xmlrpc/retrieve.py
--- moin-1.6.orig/MoinMoin/script/xmlrpc/retrieve.py	2007-12-12 05:19:45.000000000 +0200
+++ moin-1.6/MoinMoin/script/xmlrpc/retrieve.py	2007-12-30 21:06:55.000000000 +0200
@@ -1,16 +1,31 @@
 # -*- coding: iso-8859-1 -*-
-"""
-    MoinMoin - page contents retriever
-
-    @copyright: 2007 MoinMoin:JohannesBerg
-    @license: GNU GPL, see COPYING for details.
-"""
-
 import xmlrpclib
 
 from MoinMoin.script import MoinScript
 
 class PluginScript(MoinScript):
+    """MoinMoin - page contents retriever
+
+@copyright: 2006 MoinMoin:ThomasWaldmann
+@license: GNU GPL, see COPYING for details.
+
+Purpose:
+========
+This tool allows you to print out the contents of a page via xmlrpc.
+
+Detailed Instructions:
+======================
+General syntax: moin [options] xmlrpc retrieve [retrieve-options]
+
+[options] usually should be:
+    --config-dir=/path/to/my/cfg/ --wiki-url=wiki.example.org/
+
+[retrieve-options] see below:
+    0. To retrieve the page 'FrontPage' from the wiki '192.168.0.1' which is
+       running xmlrpc
+       moin ... xmlrpc retrieve 192.168.0.1 FrontPage
+"""
+
     def __init__(self, argv, def_values):
         MoinScript.__init__(self, argv, def_values)
         self.argv = argv
diff -u moin-1.6.orig/MoinMoin/script/xmlrpc/write.py moin-1.6/MoinMoin/script/xmlrpc/write.py
--- moin-1.6.orig/MoinMoin/script/xmlrpc/write.py	2007-12-12 05:19:45.000000000 +0200
+++ moin-1.6/MoinMoin/script/xmlrpc/write.py	2007-12-30 21:28:40.000000000 +0200
@@ -1,13 +1,4 @@
 # -*- coding: iso-8859-1 -*-
-"""
-    MoinMoin - page contents writer
-
-    Commented example of how to edit a page with xmlrpc.
-
-    @copyright: 2007 MoinMoin:JohannesBerg
-    @license: GNU GPL, see COPYING for details.
-"""
-
 import xmlrpclib
 import sys
 
@@ -15,6 +6,32 @@
 from MoinMoin.support.multicall import MultiCall
 
 class PluginScript(MoinScript):
+    """MoinMoin - page contents writer
+
+    @copyright: 2007 MoinMoin:JohannesBerg
+    @license: GNU GPL, see COPYING for details.
+
+Purpose:
+========
+This tool allows you to edit a page with xmlrpc. It is more of a commented
+example then an actual script.
+
+Detailed Instructions:
+======================
+General syntax: moin [options] xmlrpc write [write-options]
+
+[options] usually should be:
+    --config-dir=/path/to/my/cfg/ --wiki-url=wiki.example.org/
+
+[write-options] see below:
+    0. To edit the page 'FrontPage' on '192.168.0.1' using the username
+       'JohnSmith' and the password 'MyPass', changing the page contents
+       to 'This will be the new contents of the page!'
+       moin ... xmlrpc write 192.168.0.1 JohnSmith MyPass FrontPage
+       This will be the new contents of the page!
+       ^D
+"""
+
     def __init__(self, argv, def_values):
         MoinScript.__init__(self, argv, def_values)
         self.argv = argv