update docs, set version

README

@@ -8,23 +8,25 @@ A script for converting MoinMoin version 1.3+ wiki data to DokuWiki format.
 Call with the name of the directory containing the MoinMoin pages and that
 of the directory to receive the DokuWiki pages on the command line.
 
+Tested with MoinMoin 1.5 and DokuWiki 2012-09-10 releases
+
 You need to run this on host where MoinMoin is configured and DokuWiki is
 configured, it will use current configuration from both wikis.
 
 Edit doku.php if your DokuWiki installation is other than /usr/share/dokuwiki
 
-$ ./moin2doku.py ./moin/data/pages/
+To convert moinmoin all pages with history, invoke:
+$ ./moin2doku.py -a -d /var/lib/dokuwiki
+
+To convert single page (FrontPage):
+$ ./moin2doku.py -F moinmoin/data/pages/FrontPage -d out
 
 after conversion be sure to fix ownership
 (www-data:www-data being your uid/gid webserver runs):
 # chown -R www-data:www-data /var/lib/dokuwiki/pages/*
 # chown -R www-data:www-data /var/lib/dokuwiki/media/*
 
-This script doesn't do all the work, and some of the work it does is
-wrong. For instance attachment links end up with the trailing "|}}"
-on the line following the link. This works, but doesn't look good.
-The script interprets a "/" in a pagename as a namespace delimiter and
-creates and fills namespace subdirectories accordingly.
+also, depending on your configuration, you may need to gzip the attic pages.
 
 History:
 version 0.1  2010-02  Slim Gaillard, based on the "extended python"
@@ -32,3 +34,6 @@ version 0.1  2010-02  Slim Gaillard, based on the "extended python"
                       http://www.dokuwiki.org/tips:moinmoin2doku
 version 0.2  2011     Elan Ruusamäe, moved to github, track history there
                       https://github.com/glensc/moin2doku
+version 1.0  2012     Complete moinmoin to dokuiki converter, uses native
+                      moinmoin code to handle converting and translating paths.
+                      Converts also page history and edit-log.