[Monotone-commits-diffs] net.venge.monotone: 57ae927ea921cc6912f418a64527e0946399654d

[code]

revision:            57ae927ea921cc6912f418a64527e0946399654d
date:                2011-01-08T18:47:49
author:              address@hidden
branch:              net.venge.monotone
changelog:
* monotone.texi: add section on global options

manifest:
format_version "1"

new_manifest [7a08f76c3407c09ad25f5657b840f7d8fe7efd78]

old_revision [4ef30c0249bf56ebf039161fac59fa34416415a9]

patch "monotone.texi"
 from [2e05caa81b3a3b84c86c39e3f9f4b8f8d7f5f20e]
   to [29d82ea992ffe0e5644d4e765707c5ecac0f683c]
============================================================
--- monotone.texi	2e05caa81b3a3b84c86c39e3f9f4b8f8d7f5f20e
+++ monotone.texi	29d82ea992ffe0e5644d4e765707c5ecac0f683c
@@ -39,7 +39,7 @@
 Copyright @copyright{} 2006 Alex Queiroz @*
 Copyright @copyright{} 2006, 2007 William Uther @*
 Copyright @copyright{} 2006 - 2010 Thomas Keller @*
-Copyright @copyright{} 2007 - 2010 Stephen Leake @*
+Copyright @copyright{} 2007 - 2011 Stephen Leake @*
 
 This manual is made available under the GNU GPL version 2.0 or
 greater.  See the accompanying file COPYING for details.
@@ -4439,7 +4439,7 @@ @section Using packets
 
 
 @page
address@hidden    Bisecting, , Using packets, Advanced Uses
address@hidden    Bisecting,  , Using packets, Advanced Uses
 @section Bisecting
 
 Bisecting is an efficient means of finding the earliest revision that
@@ -4859,7 +4859,8 @@ @chapter Command Reference
 @chapter Command Reference
 
 Monotone has a large number of commands. To help navigate through them
-all, commands are grouped into logical categories.
+all, commands are grouped into logical categories. In addition, there
+are global options that apply to all commands.
 
 Many command options come in pairs that affect the same value. For example,
 @command{mtn log} takes a @var{brief} option; this can be reversed by
@@ -4880,6 +4881,7 @@ @chapter Command Reference
 
 
 @menu
+* Global Options::              Options that affect all commands
 * Tree::                        Operations on tree states in your database
 * Workspace::                   Operations on your workspace
 * Network::                     Communication with the network
@@ -4895,7 +4897,141 @@ @chapter Command Reference
 
 
 @page
address@hidden    Tree, Workspace, Command Reference, Command Reference
address@hidden    Global Options, Tree, Command Reference, Command Reference
address@hidden Global Options
address@hidden @command
address@hidden --confdir <arg>
+Set the location of the configuration directory (default
address@hidden/.monotone} on Unix and Cygwin, @file{%APPDATA%\monotone%} on
+Windows MinGW). This is where monotone finds:
+
address@hidden
address@hidden keys, in @file{conf_dir/keys}; @ref{Certificates},
address@hidden Keys}. The location of the keys directory can be
+overridden separately with the @command{--keydir} option.
+
address@hidden rcfiles, which are per-user configuration files containing Lua code
+(@ref{Lua Reference}) that are run each time monotone starts up.
+
address@hidden default database
+See option @command{--db} below.
+
address@hidden itemize
+
+In addition, monotone writes a dump file to the configuration
+directory when it fails.
+
address@hidden --date-format <arg>
+strftime(3) format specification for printing dates. The default
+format is @code{%x} for dates, @code{%X} for times, @code{%x %X} for
+both. This can also be overridden by the @code{get_date_format_spec}
+hook; @ref{Hooks}.
+
address@hidden --db <arg>
+Set the database to use; defaults to the database specified in the
+current workspace (stored in @file{_MTN/options}; @ref{Storage and
+workflow}), or to nothing if not in a workspace.
+
+An argument of @code{:memory:} specifies a memory-only database; any
+changes are not saved to a file. @c what is this useful for?
+
address@hidden --dump <arg>
+File to dump debugging log to, on failure; default
address@hidden/dump} if not in a workspace, @file{_MTN/debug} if in a
+workspace.
+
address@hidden --help
+Display help information. This is the same as the @command{mtn help}
+command.
+
address@hidden --ignore-suspend-certs
address@hidden --no-ignore-suspend-certs
+Do not ignore revisions marked as suspended; see the @command{mtn
+suspend} command.
+
address@hidden --key <arg>
address@hidden --use-default-key
+Set the key for signatures, using either the key name or the key hash
+(@ref{Generating Keys}).  If there is only one key in the keydir, then
+that is the default key. Otherwise there is no default key.
+
address@hidden --keydir <arg>
+Set the key directory (where the ``key store'' is located); default is
address@hidden/keys}.
+
address@hidden --log <arg>
+Specifiy a file to which the log (consisting of all debug,
+informational, and warning messages) is written; default is the
address@hidden process output.
+
address@hidden --no-builtin-rcfile
address@hidden --builtin-rcfile
+Do not load the built-in rcfile with the default hooks. This means
+all hooks will have null definitions (unless overridden by other
+rcfiles). @ref{Hooks}.
+
address@hidden --no-default-confdir
address@hidden --allow-default-confdir
+Don't use a default confdir; @command{--confdir} must be specified if
+a configuration file is needed.
+
address@hidden --no-format-dates
+Print date certs exactly as stored in the database.
+
address@hidden --no-standard-rcfiles
address@hidden --standard-rcfiles
+Do not load the standard rcfiles, which are
address@hidden/.monotone/monotonerc} on Unix or
address@hidden on Windows, and
address@hidden/monotonerc} in the current workspace.
+
address@hidden --no-workspace
address@hidden --allow-workspace
+Don't look for a workspace; this means options that normally get their
+default values from the workspace will not have those default values.
+
address@hidden --non-interactive
address@hidden --interactive
+Do not prompt the user for input; fail instead. For example, don't
+prompt for a key passphrase, or when doing a merge, do not start the
+external merger to resolve a conflict.
+
address@hidden --quiet
address@hidden --verbose
+Decrease or increase verbosity. There are four levels of verbosity;
+debug, information, warning, and none. The default is information.
+
address@hidden --rcfile <arg>
+Specify an extra rcfile to load.
+
address@hidden --clear-rcfiles
+Cancel all previous @command{rcfile} options (standard rcfiles are
+still loaded).
+
address@hidden --root <arg>
+Limit the search for a workspace to the specified root directory
+
address@hidden --ssh-sign <arg>
+Controls use of ssh-agent. Valid arguments are: 'yes' to use ssh-agent
+to make signatures if possible, 'no' to force use of monotone's
+internal code, 'only' to force use of ssh-agent, 'check' to sign with
+both and compare.
+
address@hidden --ticker <arg>
+Set ticker style; one of 'count', 'dot', or 'none'
+
address@hidden --timestamps
+Show timestamps in front of error, warning, and progress messages.
+
address@hidden --version
+Print version number, then exit; same as @command{mtn version}.
+
address@hidden --xargs <arg>
address@hidden -@@ <arg>
+Insert command line arguments taken from the given file.
address@hidden ftable
+
address@hidden    Tree, Workspace, Global Options, Command Reference
 @section Tree
 
 @ftable @command