[darwinbuild-changes] [809] branches/PR-6973110/darwinup/darwinup.1

[source_changes at macosforge.org]

Revision: 809
          http://trac.macosforge.org/projects/darwinbuild/changeset/809
Author:   wsiegrist at apple.com
Date:     2010-04-15 15:52:22 -0700 (Thu, 15 Apr 2010)
Log Message:
-----------
Add OPTIONS section to man page.

Modified Paths:
--------------
    branches/PR-6973110/darwinup/darwinup.1

Modified: branches/PR-6973110/darwinup/darwinup.1
===================================================================
--- branches/PR-6973110/darwinup/darwinup.1	2010-04-15 16:09:25 UTC (rev 808)
+++ branches/PR-6973110/darwinup/darwinup.1	2010-04-15 22:52:22 UTC (rev 809)
@@ -43,7 +43,37 @@
 for installing a new version of a library or tool on your system while 
 allowing you to uninstall the files and revert back to the originals 
 safely and easily.
+.Sh OPTIONS
+.Bl -tag -width -indent
+.It \-d
+Do not update dyld cache. Darwinup normally runs update_dyld_shared_cache 
+if the operation actually changes files on disk. To ensure this does not 
+happen, you can provide this option.
+.It \-f
+Force. Some operations will fail gracefully due to potentially unsafe 
+situations, such as a root that installs a file where a directory is.
+In order to have darwinup continue through such a situation, you can
+pass the -f option.
+.It \-n
+Dry run. Darwinup will go through an operation, including analyzing
+the root(s) and printing the state/change symbol, but no files will
+be modified on your system and no records will be added to the depot.
+.It \-p Op Ar path
+Prefix path. Normally, darwinup will operate on the boot partition. You
+can use the -p option to have darwinup work on another partition. You
+can provide any arbitrary path, it does not need to be a mount point.
+.It \-v
+Verbose. This option causes darwinup to print extra information. You can
+pass 2 or 3 v's for even more information, but that is usually only needed
+for development and debugging of darwinup itself.
+.El
 .Sh SUBCOMMANDS
+Note that the
+.Ar path
+and
+.Ar archive
+options listed below support globbing and multiple items. See the EXAMPLES 
+section below for more details.
 .Bl -tag -width -indent
 .It Ar files Ar archives
 List the files and directories in the 
@@ -66,7 +96,7 @@
 This includes status letters
 detailing how the archive differs from whats on disk
 .El
-.Sh STATUS SYMBOLS
+.Sh STATE/CHANGE SYMBOLS
 .Bl -tag -width -indent
 .It ? 
 Unknown state. Probably a bug.
@@ -97,6 +127,8 @@
 Updated. During installation, the file or directory replaces an existing 
 object at the same path. During uninstallation, the previous version of
 the file was restored. 
+.El
 .Sh SUPPORTED PATHS
 .Sh ARCHIVE SPECIFICATIONS
 .Sh FORCING OPERATIONS
+.Sh EXAMPLES
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/darwinbuild-changes/attachments/20100415/48864dfc/attachment.html>