[mirrorbrain-commits] r8119 - /trunk/mb/mb.py

Author: poeml
Date: Mon Sep  6 18:13:25 2010
New Revision: 8119

URL: http://svn.mirrorbrain.org/viewvc/mirrorbrain?rev=8119&view=rev
Log:
mb makehashes:
- fulfill my promise that the mb makehashes usage examples were improved
  (good documentation still lacking)

Modified:
    trunk/mb/mb.py

Modified: trunk/mb/mb.py
URL: http://svn.mirrorbrain.org/viewvc/mirrorbrain/trunk/mb/mb.py?rev=8119&r1=8118&r2=8119&view=diff
==============================================================================
--- trunk/mb/mb.py (original)
+++ trunk/mb/mb.py Mon Sep  6 18:13:25 2010
_at_@ -901,27 +901,29 @@
                         help='set the base directory (so that you can work on a '
                              'subdirectory -- see examples)')
     _at_cmdln.option('-t', '--target-dir', metavar='PATH',
-                        help='set a different target directory')
+                        help='set the target directory (required)')
     _at_cmdln.option('-v', '--verbose', action='store_true',
                         help='show more information')
     def do_makehashes(self, subcmd, opts, startdir):
-        """${cmd_name}: Update the verification hashes, e.g. for inclusion into Metalinks
-
-        Examples:
-
-        mb makehashes /srv/mirrors/mozilla -t /srv/metalink-hashes/srv/mirrors/mozilla
-
-        mb makehashes \\
+        """${cmd_name}: Create or update verification hashes, e.g. for
+        inclusion into Metalinks and Torrents, or to be requested by appending
+        .md5 or .sha1 to an URL.
+
+        Simplest Examples:
+            mb makehashes -t /srv/metalink-hashes/srv/ooo /srv/ooo
+
+        This is aequivalent:
+            mb makehashes -t /srv/metalink-hashes/srv/ooo -b /srv/ooo /srv/ooo
+
+        Hash only the subdirectory extended/iso/de:
+            mb makehashes -t /srv/metalink-hashes/srv/ooo -b /srv/ooo /srv/ooo/extended/iso/de
+        
+        Further examples:
+            mb makehashes \\
             -t /srv/metalink-hashes/srv/ftp/pub/opensuse/repositories/home:/poeml \\
             /srv/ftp-stage/pub/opensuse/repositories/home:/poeml \\
             -i '^.*/repoview/.*$'
-
-        mb makehashes \\
-            -t /srv/metalink-hashes/samba/srv/mirrors/samba \\
-            -b /srv/mirrors/samba \\
-            /srv/mirrors/samba/pub/samba/xfertest
-
-        mb makehashes \\
+            mb makehashes \\
             -f '.*.(torrent|iso)$' \\
             -t /var/lib/apache2/metalink-hashes/srv/ftp/pub/opensuse \\
             -b /srv/ftp-stage/pub/opensuse \\




_______________________________________________
mirrorbrain-commits mailing list
Archive: http://mirrorbrain.org/archive/mirrorbrain-commits/

Note: To remove yourself from this list, send a mail with the content
 	unsubscribe
to the address mirrorbrain-commits-request_at_mirrorbrain.org