Rectify bup-split documentation for the fanout option.

[bup.git] / Documentation / bup-meta.md

diff --git a/Documentation/bup-meta.md b/Documentation/bup-meta.md
index 2c2ea67f1c30ccb76f60839cad25a1a356a15fcd..853d0977de67219c5a88bab7ceb9f87a464dbcab 100644 (file)
--- a/Documentation/bup-meta.md
+++ b/Documentation/bup-meta.md
@@ -8,20 +8,20 @@ bup-meta - create or extract a metadata archive
 
 # SYNOPSIS
 
-bup meta \-\-create
-  ~ [-R] [-v] [-q] [\-\-no-symlinks] [\-\-no-paths] [-f *file*] \<*paths*...\>
+bup meta \--create
+  ~ [-R] [-v] [-q] [\--no-symlinks] [\--no-paths] [-f *file*] \<*paths*...\>
   
-bup meta \-\-list
+bup meta \--list
   ~ [-v] [-q] [-f *file*]
   
-bup meta \-\-extract
-  ~ [-v] [-q] [\-\-numeric-ids] [\-\-no-symlinks] [-f *file*]
+bup meta \--extract
+  ~ [-v] [-q] [\--numeric-ids] [\--no-symlinks] [-f *file*]
   
-bup meta \-\-start-extract
-  ~ [-v] [-q] [\-\-numeric-ids] [\-\-no-symlinks] [-f *file*]
+bup meta \--start-extract
+  ~ [-v] [-q] [\--numeric-ids] [\--no-symlinks] [-f *file*]
   
-bup meta \-\-finish-extract
-  ~ [-v] [-q] [\-\-numeric-ids] [-f *file*]
+bup meta \--finish-extract
+  ~ [-v] [-q] [\--numeric-ids] [-f *file*]
 
 # DESCRIPTION
 
@@ -31,62 +31,62 @@ access permissions, etc.) for a set of filesystem paths.
 
 # OPTIONS
 
--c, \-\-create
+-c, \--create
 :   Create a metadata archive for the specified *path*s.  Write the
-    archive to standard output unless **\-\-file** is specified.
+    archive to standard output unless `--file` is specified.
 
--t, \-\-list
+-t, \--list
 :   Display information about the metadata in an archive.  Read the
-    archive from standard output unless **\-\-file** is specified.
+    archive from standard output unless `--file` is specified.
 
--x, \-\-extract
-:   Extract a metadata archive.  Conceptually, perform **\-\-start-extract**
-    followed by **\-\-finish-extract**.  Read the archive from standard input
-    unless **\-\-file** is specified.
+-x, \--extract
+:   Extract a metadata archive.  Conceptually, perform `--start-extract`
+    followed by `--finish-extract`.  Read the archive from standard input
+    unless `--file` is specified.
 
-\-\-start-extract
+\--start-extract
 :   Build a filesystem tree matching the paths stored in a metadata
     archive.  By itself, this command does not produce a full
     restoration of the metadata.  For a full restoration, this command
-    must be followed by a call to **\-\-finish-extract**.  Once this
+    must be followed by a call to `--finish-extract`.  Once this
     command has finished, all of the normal files described by the
     metadata will exist and be empty.  Restoring the data in those
-    files, and then calling **\-\-finish-extract** should restore the
+    files, and then calling `--finish-extract` should restore the
     original tree.  The archive will be read from standard input
-    unless **\-\-file** is specified.
+    unless `--file` is specified.
 
-\-\-finish-extract
+\--finish-extract
 :   Finish applying the metadata stored in an archive to the
     filesystem.  Normally, this command should follow a call to
-    **\-\-start-extract**.  The archive will be read from standard input
-    unless **\-\-file** is specified.
+    `--start-extract`.  The archive will be read from standard input
+    unless `--file` is specified.
 
--f, \-\-file=*filename*
+-f, \--file=*filename*
 :   Read the metadata archive from *filename* or write it to
     *filename* as appropriate.  If *filename* is "-", then read from
     standard input or write to standard output.
 
--R, \-\-recurse
-:   Recursively descend into subdirectories during **\-\-create**.
+-R, \--recurse
+:   Recursively descend into subdirectories during `--create`.
 
-\-\-numeric-ids
+\--numeric-ids
 :   Apply numeric user and group IDs (rather than text IDs) during
-    **\-\-extract** or **\-\-finish-extract**.
+    `--extract` or `--finish-extract`.
 
-\-\-symlinks
+\--symlinks
 :   Record symbolic link targets when creating an archive, or restore
-    symbolic links when extracting an archive (during **\-\-extract**
-    or **\-\-start-extract**).  This option is enabled by default.
-    Specify **\-\-no-symlinks** to disable it.
+    symbolic links when extracting an archive (during `--extract`
+    or `--start-extract`).  This option is enabled by default.
+    Specify `--no-symlinks` to disable it.
 
-\-\-paths
+\--paths
 :   Record pathnames when creating an archive.  This option is enabled
-    by default.  Specify **\-\-no-paths** to disable it.
+    by default.  Specify `--no-paths` to disable it.
 
--v, --verbose
+-v, \--verbose
 :   Be more verbose (can be used more than once).
 
--q, --quiet
+-q, \--quiet
 :   Be quiet.
 
 # EXAMPLES
@@ -103,9 +103,9 @@ access permissions, etc.) for a set of filesystem paths.
 
     # Restore /etc completely.
     $ mkdir tmp && cd tmp
-    $ bup meta \-\-start-extract -f ../etc.meta
+    $ bup meta --start-extract -f ../etc.meta
     ...fill in all regular file contents using some other tool...
-    $ bup meta \-\-finish-extract -f ../etc.meta
+    $ bup meta --finish-extract -f ../etc.meta
 
 # BUGS