monotone(1)monotone(1)NAME
monotone - a distributed version control system
SYNOPSISmtn [options...] command [arguments...]
DESCRIPTION
monotone is a highly reliable, very customizable distributed version
control system that provides lightweight branches, history-sensitive
merging and a flexible trust setup. monotone has an easy-to-learn com‐
mand set and comes with a rich interface for scripting purposes and
thorough documentation.
For more information on monotone, visit http://www.monotone.ca.
The complete documentation, including a tutorial for a quick start with
the system, can be found online on http://www.monotone.ca/docs.
GLOBAL OPTIONS--confdir <arg> set location of configuration directory
--date-format <arg> strftime(3) format specification for printing
dates
--db [ -d ] <arg> set name of database
--dump <arg> file to dump debugging log to, on failure
--help [ -h ] display help message
--ignore-suspend-certs / --no-ignore-suspend-certs
do not ignore revisions marked as suspended
--key [ -k ] <arg> / --use-default-key
sets the key for signatures, using either the
key name or the key hash
--keydir <arg> set location of key store
--log <arg> file to write the log to
--no-builtin-rcfile / --builtin-rcfile
do not load the built-in lua file with the
default hooks
--no-default-confdir / --allow-default-confdir
forbid use of the default confdir
--no-format-dates print date certs exactly as stored in the
database
--no-standard-rcfiles / --standard-rcfiles
do not load '~/.monotone/monotonerc' or
'_MTN/monotonerc' lua files
--no-workspace / --allow-workspace
don't look for a workspace
--non-interactive / --interactive
do not prompt the user for input
--quiet [ -q ] decrease verbosity (undo previous '-v', then
disable informational output, then disable
warnings)
--rcfile <arg> / --clear-rcfiles
load extra lua file
--root <arg> limit search for workspace to specified root
--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 com‐
pare
--ticker <arg> set ticker style (count|dot|none)
--timestamps show timestamps in front of errors, warnings
and progress messages
--verbose [ -v ] increase verbosity (undo previous '-q', and
then enable debug output)
--version print version number, then exit
--xargs [ -@ ] <arg> insert command line arguments taken from the
given file
COMMANDS
command group 'automation'
Commands that aid in scripted execution.
automate ancestors REV1 [REV2 [REV3 [...]]]
Prints the ancestors of the given revisions.
automate ancestry_difference NEW_REV [OLD_REV1 [OLD_REV2 [...]]]
Lists the ancestors of the first revision given, not in the others.
automate branches
Prints all branch certs in the revision graph.
automate cert REVISION-ID NAME VALUE
Adds a revision certificate.
automate certs REV
Prints all certificates attached to a revision.
automate checkout [DIRECTORY]
Checks out a revision from the database into a directory. If a
revision is given, that's the one that will be checked out. Other‐
wise, it will be the head of the branch (given or implicit). If no
directory is given, the branch name will be used as directory.
--branch [ -b ] <arg>
select branch cert for operation
--move-conflicting-paths / --no-move-conflicting-paths
move conflicting, unversioned paths into '_MTN/resolutions'
before proceeding with any workspace change
--revision [ -r ] <arg>
select revision id for operation
automate children REV
Prints the children of a revision.
automate common_ancestors REV1 [REV2 [REV3 [...]]]
Prints revisions that are common ancestors of a list of revisions.
automate content_diff [FILE [...]]
Calculates diffs of files.
--depth <arg>
limit the number of levels of directories to descend
--exclude <arg>
leave out anything described by its argument
--reverse
reverse order of diff
--revision [ -r ] <arg>
select revision id for operation
--with-header / --without-header
show the matching cset in the diff header
automate descendents REV1 [REV2 [REV3 [...]]]
Prints the descendents of the given revisions.
automate drop_attribute PATH [KEY]
Drops an attribute or all of them from a certain path.
automate drop_db_variables DOMAIN [NAME]
Drops a database variable.
automate drop_public_key KEY_NAME_OR_HASH
Drops a public key.
automate erase_ancestors [REV1 [REV2 [REV3 [...]]]]
Erases the ancestors in a list of revisions.
automate file_merge LEFT_REVID LEFT_FILENAME RIGHT_REVID RIGHT_FILE‐
NAME
Prints the results of the internal line merger, given two child
revisions and file names.
automate generate_key KEY_NAME PASSPHRASE
Generates an RSA key-pair.
--force-duplicate-key
force genkey to not error out when the named key already exists
automate get_attributes PATH
Prints all attributes for the specified path.
automate get_base_revision_id
Shows the revision on which the workspace is based.
automate get_content_changed REV FILE
Lists the revisions that changed the content relative to another
revision.
automate get_corresponding_path REV1 FILE REV2
Prints the name of a file in a target revision relative to a given
revision.
automate get_current_revision [PATHS ...]
Shows change information for a workspace.
--depth <arg>
limit the number of levels of directories to descend
--exclude <arg>
leave out anything described by its argument
automate get_current_revision_id
Shows the revision of the current workspace.
automate get_db_variables [DOMAIN]
Retrieve database variables.
automate get_extended_manifest_of REVISION
Prints the extended manifest for the given identifier.
automate get_file FILEID
Prints the contents of a file (given an identifier).
automate get_file_of FILENAME
Prints the contents of a file (given a name).
--revision [ -r ] <arg>
select revision id for operation
automate get_file_size FILEID
Prints the size of a file (given an identifier).
automate get_manifest_of [REVID]
Shows the manifest associated with a revision.
automate get_option OPTION
Shows the value of an option.
automate get_public_key KEY_NAME_OR_HASH
Prints a public key packet.
automate get_revision REVID
Shows change information for a revision.
automate get_workspace_root
Prints the workspace root for the current directory.
automate graph
Prints the complete ancestry graph.
automate heads [BRANCH]
Prints the heads of the given branch.
automate identify PATH
Prints the file identifier of a file.
automate interface_version
Prints the automation interface's version.
automate inventory [PATH]...
Prints a summary of files found in the workspace.
--depth <arg>
limit the number of levels of directories to descend
--exclude <arg>
leave out anything described by its argument
--no-corresponding-renames / --corresponding-renames
don't output corresponding renames if restricted on such nodes
--no-ignored / --ignored
don't output ignored files
--no-unchanged / --unchanged
don't output unchanged files
--no-unknown / --unknown
don't output unknown files
automate keys
Lists all keys in the keystore.
automate leaves
Lists the leaves of the revision graph.
automate log [PATH] ...
Lists the selected revision history.
--depth <arg>
limit the number of levels of directories to descend
--exclude <arg>
leave out anything described by its argument
--from <arg> / --clear-from
revision(s) to start logging at
--last <arg>
limit log output to the last number of entries
--next <arg>
limit log output to the next number of entries
--no-merges / --merges
exclude merges when printing logs
--to <arg> / --clear-to
revision(s) to stop logging at
automate lua LUA_FUNCTION [ARG1 [ARG2 [...]]]
Executes the given lua function and returns the result.
automate packet_for_fdata FILEID
Prints the file data in packet format.
automate packet_for_fdelta OLD_FILE NEW_FILE
Prints the file delta in packet format.
automate packet_for_rdata REVID
Prints the revision data in packet format.
automate packets_for_certs REVID
Prints the certs associated with a revision in packet format.
automate parents REV
Prints the parents of a revision.
automate pull [URI]
automate pull [ADDRESS[:PORTNUMBER] [PATTERN ...]]
Pulls branches from a netsync server.
--dry-run / --no-dry-run
don't perform the operation, just show what would have happened
--exclude <arg>
leave out anything described by its argument
--set-default / --no-set-default
use the current netsync arguments and options as the future
default
automate push [URI]
automate push [ADDRESS[:PORTNUMBER] [PATTERN ...]]
Pushes branches to a netsync server.
--dry-run / --no-dry-run
don't perform the operation, just show what would have happened
--exclude <arg>
leave out anything described by its argument
--key-to-push <arg>
push the specified key even if it hasn't signed anything
--set-default / --no-set-default
use the current netsync arguments and options as the future
default
automate put_file [FILEID] CONTENTS
Stores a file in the database.
automate put_public_key KEY-PACKET-DATA
Store the public key in the database.
automate put_revision REVISION-DATA
Stores a revision into the database.
automate read_packets PACKET-DATA
Load the given packets into the database.
automate remote COMMAND [ARGS]
Executes COMMAND on a remote server.
--remote-stdio-host <arg>
sets the host (and optionally the port) for a remote netsync
action
--set-default / --no-set-default
use the current netsync arguments and options as the future
default
automate remote_stdio [URI]
automate remote_stdio [ADDRESS[:PORTNUMBER]]
Opens an 'automate stdio' connection to a remote server.
--set-default / --no-set-default
use the current netsync arguments and options as the future
default
automate roots
Lists the roots of the revision graph.
automate select SELECTOR
Lists the revisions that match a selector.
automate set_attribute PATH KEY VALUE
Sets an attribute on a certain path.
automate set_db_variable DOMAIN NAME VALUE
Sets a database variable.
automate show_conflicts [LEFT_REVID RIGHT_REVID]
Shows the conflicts between two revisions. If no arguments are
given, LEFT_REVID and RIGHT_REVID default to the first two heads
that would be chosen by the 'merge' command.
--branch [ -b ] <arg>
select branch cert for operation
--ignore-suspend-certs / --no-ignore-suspend-certs
do not ignore revisions marked as suspended
automate stdio
Automates several commands in one run.
--automate-stdio-size <arg>
block size in bytes for 'automate stdio' output
automate sync [URI]
automate sync [ADDRESS[:PORTNUMBER] [PATTERN ...]]
Synchronizes branches with a netsync server.
--dry-run / --no-dry-run
don't perform the operation, just show what would have happened
--exclude <arg>
leave out anything described by its argument
--key-to-push <arg>
push the specified key even if it hasn't signed anything
--set-default / --no-set-default
use the current netsync arguments and options as the future
default
automate tags [BRANCH_PATTERN]
Prints all tags attached to a set of branches.
automate toposort [REV1 [REV2 [REV3 [...]]]]
Topologically sorts a list of revisions.
automate update
Updates the workspace.
--branch [ -b ] <arg>
select branch cert for operation
--move-conflicting-paths / --no-move-conflicting-paths
move conflicting, unversioned paths into '_MTN/resolutions'
before proceeding with any workspace change
--revision [ -r ] <arg>
select revision id for operation
command group 'database'
Commands that manipulate the database.
db changesetify
Converts the database to the changeset format.
db check
Does some sanity checks on the database. Ensures that the database
is consistent by issuing multiple checks.
db dump
Dumps the contents of the database. Generates a list of SQL
instructions that represent the whole contents of the database.
The resulting output is useful to later restore the database from a
text file that serves as a backup.
db execute
Executes an SQL command on the database. Directly executes the
given SQL command on the database
db fix_certs
Attempt to fix bad certs. Older monotone versions could sometimes
associate certs with the wrong key. This fixes such certs if you
have the correct key, and can optionally drop any certs that you
don't have the correct key for. This should only be needed if you
had such certs in your db when upgrading from 0.44 or earlier, or
if you loaded such certs with 'mtn read'.
--drop-bad-certs
drop certs signed by keys we don't know about
db info
Shows information about the database.
--full / --concise
print detailed information
db init
Initializes a database. Creates a new database file and initial‐
izes it.
db load
Loads the contents of the database. Reads a list of SQL instruc‐
tions that regenerate the contents of the database. This is sup‐
posed to be used in conjunction with the output generated by the
'dump' command.
db migrate
Migrates the database to a newer schema. Updates the database's
internal schema to the most recent one. Needed to automatically
resolve incompatibilities that may be introduced in newer versions
of monotone.
db regenerate_caches
Regenerates the caches stored in the database.
db rosterify
Converts the database to the rosters format.
--drop-attr <arg>
when rosterifying, drop attrs entries with the given key
db set_epoch BRANCH EPOCH
Sets the branch's epoch.
db version
Shows the database's version.
local kill_certs SELECTOR CERTNAME [CERTVAL]
Deletes the specified certs from the local database. Deletes all
certs which are on the given revision(s) and have the given name
and if a value is specified then also the given value.
local kill_revision REVID
Kills a revision from the local database.
command group 'debug'
Commands that aid in program debugging.
asciik SELECTOR
Prints an ASCII representation of the revisions' graph.
fdiff SRCNAME DESTNAME SRCID DESTID
Differences 2 files and outputs the result.
--context
use context diff format
--diff-args <arg>
argument to pass external diff hook
--external
use external diff hook for generating diffs
--no-show-encloser / --show-encloser
do not show the function containing each block of changes
--reverse
reverse order of diff
--unified
use unified diff format
--with-header / --without-header
show the matching cset in the diff header
fload
Loads a file's contents into the database.
fmerge PARENT_FILEID LEFT_FILEID RIGHT_FILEID
Merges 3 files and outputs the result.
get_roster [REVID]
Dumps the roster associated with a given identifier. If no REVID
is given, the workspace is used.
identify [PATH]
Calculates the identity of a file or stdin. If any PATH is given,
calculates their identity; otherwise, the one from the standard
input is calculated.
rcs_import RCSFILE...
Parses versions in RCS files. This command doesn't reconstruct or
import revisions. You probably want to use cvs_import.
--branch [ -b ] <arg>
select branch cert for operation
command group 'informative'
Commands for information retrieval.
annotate PATH
Prints an annotated copy of a file. Calculates and prints an anno‐
tated copy of the given file from the specified REVISION.
--revision [ -r ] <arg>
select revision id for operation
--revs-only
annotate using full revision ids only
bisect bad
Marks the current revision or specified revisions as bad. Known
bad revisions are removed from the set being searched.
--move-conflicting-paths / --no-move-conflicting-paths
move conflicting, unversioned paths into '_MTN/resolutions'
before proceeding with any workspace change
--revision [ -r ] <arg>
select revision id for operation
bisect good
Marks the current revision or specified revisions as good. Known
good revisions are removed from the set being searched.
--move-conflicting-paths / --no-move-conflicting-paths
move conflicting, unversioned paths into '_MTN/resolutions'
before proceeding with any workspace change
--revision [ -r ] <arg>
select revision id for operation
bisect reset
Reset the current bisection search. Update the workspace back to
the revision from which the bisection was started and remove all
current search information, allowing a new search to be started.
bisect skip
Excludes the current revision or specified revisions from the
search. Skipped revisions are removed from the set being searched.
Revisions that cannot be tested for some reason should be skipped.
--move-conflicting-paths / --no-move-conflicting-paths
move conflicting, unversioned paths into '_MTN/resolutions'
before proceeding with any workspace change
--revision [ -r ] <arg>
select revision id for operation
bisect status
Reports on the current status of the bisection search. Lists the
total number of revisions in the search set, the number of revi‐
sions that have been determined to be good or bad, the number of
revisions that have been skipped and the number of revisions
remaining to be tested.
bisect update
Updates the workspace to the next revision to be tested by bisec‐
tion. This command can be used if updates by good, bad or skip
commands fail due to blocked paths or other problems.
--move-conflicting-paths / --no-move-conflicting-paths
move conflicting, unversioned paths into '_MTN/resolutions'
before proceeding with any workspace change
cat FILENAME
Prints a file from the database. Fetches the given file FILENAME
from the database and prints it to the standard output.
--revision [ -r ] <arg>
select revision id for operation
complete (revision|file|key) PARTIAL-ID
Completes a partial identifier.
di [PATH]...
diff [PATH]...
Shows current differences. Compares the current tree with the
files in the repository and prints the differences on the standard
output. If one revision is given, the diff between the workspace
and that revision is shown. If two revisions are given, the diff
between them is given. If no format is specified, unified is used
by default.
--context
use context diff format
--depth <arg>
limit the number of levels of directories to descend
--diff-args <arg>
argument to pass external diff hook
--exclude <arg>
leave out anything described by its argument
--external
use external diff hook for generating diffs
--no-show-encloser / --show-encloser
do not show the function containing each block of changes
--reverse
reverse order of diff
--revision [ -r ] <arg>
select revision id for operation
--unified
use unified diff format
--with-header / --without-header
show the matching cset in the diff header
help command [ARGS...]
Displays help about commands and options.
--hidden / --no-hidden
show hidden commands and options
list branches [PATTERN]
Lists branches in the database that match a pattern.
--exclude <arg>
leave out anything described by its argument
list certs REVID
Lists certificates attached to a revision.
list changed [PATH...]
Lists files that have changed with respect to the current revision.
--depth <arg>
limit the number of levels of directories to descend
--exclude <arg>
leave out anything described by its argument
list databases
list dbs
Lists managed databases and their known workspaces.
list duplicates
Lists duplicate files in the specified revision. If no revision is
specified, use the workspace.
--revision [ -r ] <arg>
select revision id for operation
list epochs [BRANCH [...]]
Lists the current epoch of branches that match a pattern.
list ignored [PATH]
Lists workspace files that are ignored in the current branch.
--depth <arg>
limit the number of levels of directories to descend
--exclude <arg>
leave out anything described by its argument
list keys [PATTERN]
Lists keys that match a pattern.
list known
Lists workspace files that belong to the current branch.
--depth <arg>
limit the number of levels of directories to descend
--exclude <arg>
leave out anything described by its argument
list missing
Lists files that belong to the branch but are not in the workspace.
--depth <arg>
limit the number of levels of directories to descend
--exclude <arg>
leave out anything described by its argument
list tags [PATTERN]
Lists all tags in the database.
--exclude <arg>
leave out anything described by its argument
list unknown [PATH]
Lists workspace files that are unknown in the current branch.
--depth <arg>
limit the number of levels of directories to descend
--exclude <arg>
leave out anything described by its argument
list vars [DOMAIN]
Lists variables in the whole database or a domain.
list workspaces
Lists known workspaces of a specified database.
log [PATH] ...
Prints selected history in forward or reverse order. This command
prints selected history in forward or reverse order, filtering it
by PATH if given.
--brief / --no-brief
print a brief version of the normal output
--depth <arg>
limit the number of levels of directories to descend
--diffs / --no-diffs
print diffs along with logs
--exclude <arg>
leave out anything described by its argument
--from <arg> / --clear-from
revision(s) to start logging at
--last <arg>
limit log output to the last number of entries
--next <arg>
limit log output to the next number of entries
--no-files / --files
exclude files when printing logs
--no-graph / --graph
do not use ASCII graph to display ancestry
--no-merges / --merges
exclude merges when printing logs
--revision [ -r ] <arg>
select revision id for operation
--to <arg> / --clear-to
revision(s) to stop logging at
manpage
Generate a manual page from monotone's command help.
--formatted / --plain
automatically run the output through nroff (default if the out‐
put is a terminal)
--hidden / --no-hidden
show hidden commands and options
show_conflicts REV REV
Shows what conflicts need resolution between two revisions. The
conflicts are calculated based on the two revisions given in the
REV parameters.
status [PATH]...
Shows workspace's status information.
--depth <arg>
limit the number of levels of directories to descend
--exclude <arg>
leave out anything described by its argument
version
Shows the program version.
--full / --concise
print detailed information
command group 'key_and_cert'
Commands to manage keys and certificates.
cert SELECTOR CERTNAME [CERTVAL]
Creates a certificate for a revision or set of revisions. Creates
a certificate with the given name and value on each revision that
matches the given selector
dropkey KEY_NAME_OR_HASH
Drops a public and/or private key.
genkey KEY_NAME
Generates an RSA key-pair.
--force-duplicate-key
force genkey to not error out when the named key already exists
passphrase KEY_NAME_OR_HASH
Changes the passphrase of a private RSA key.
ssh_agent_add
Adds a private key to ssh-agent.
ssh_agent_export [FILENAME]
Exports a private key for use with ssh-agent.
trusted REVISION NAME VALUE SIGNER1 [SIGNER2 [...]]
Tests whether a hypothetical certificate would be trusted. The
current settings are used to run the test.
command group 'network'
Commands that access the network.
clone URI [DIRECTORY]
clone HOST[:PORTNUMBER] BRANCH [DIRECTORY]
Checks out a revision from a remote database into a directory. If
a revision is given, that's the one that will be checked out. Oth‐
erwise, it will be the head of the branch supplied. If no direc‐
tory is given, the branch name will be used as directory
--branch [ -b ] <arg>
select branch cert for operation
--revision [ -r ] <arg>
select revision id for operation
pull [URI]
pull [ADDRESS[:PORTNUMBER] [PATTERN ...]]
Pulls branches from a netsync server. This pulls all branches that
match the pattern given in PATTERN from the netsync server at the
address ADDRESS.
--dry-run / --no-dry-run
don't perform the operation, just show what would have happened
--exclude <arg>
leave out anything described by its argument
--set-default / --no-set-default
use the current netsync arguments and options as the future
default
--update / --no-update
automatically update the workspace, if it was at a head and the
command creates a new head
push [URI]
push [ADDRESS[:PORTNUMBER] [PATTERN ...]]
Pushes branches to a netsync server. This will push all branches
that match the pattern given in PATTERN to the netsync server at
the address ADDRESS.
--dry-run / --no-dry-run
don't perform the operation, just show what would have happened
--exclude <arg>
leave out anything described by its argument
--key-to-push <arg>
push the specified key even if it hasn't signed anything
--set-default / --no-set-default
use the current netsync arguments and options as the future
default
serve
Serves the database to connecting clients.
--bind <arg>
address:port to listen on (default :4691)
--pid-file <arg> / --no-pid-file
record process id of server
sync [URI]
sync [ADDRESS[:PORTNUMBER] [PATTERN ...]]
Synchronizes branches with a netsync server. This synchronizes
branches that match the pattern given in PATTERN with the netsync
server at the address ADDRESS.
--dry-run / --no-dry-run
don't perform the operation, just show what would have happened
--exclude <arg>
leave out anything described by its argument
--key-to-push <arg>
push the specified key even if it hasn't signed anything
--set-default / --no-set-default
use the current netsync arguments and options as the future
default
--update / --no-update
automatically update the workspace, if it was at a head and the
command creates a new head
command group 'packet_io'
Commands for packet reading and writing.
privkey KEY_NAME_OR_HASH
Prints a private key packet.
pubkey KEY_NAME_OR_HASH
Prints a public key packet.
read [FILE1 [FILE2 [...]]]
Reads packets from files. If no files are provided, the standard
input is used.
command group 'review'
Commands to review revisions.
approve REVISION
Approves a particular revision.
--branch [ -b ] <arg>
select branch cert for operation
--update / --no-update
automatically update the workspace, if it was at a head and the
command creates a new head
comment REVISION [COMMENT]
Comments on a particular revision.
disapprove [PARENT-REVISION] CHILD-REVISION
Disapproves a particular revision or revision range.
--author <arg>
override author for commit
--branch [ -b ] <arg>
select branch cert for operation
--date <arg>
override date/time for commit
--message [ -m ] <arg>
set commit changelog message
--message-file <arg>
set filename containing commit changelog message
--update / --no-update
automatically update the workspace, if it was at a head and the
command creates a new head
suspend REVISION
Suspends a particular revision.
--branch [ -b ] <arg>
select branch cert for operation
--update / --no-update
automatically update the workspace, if it was at a head and the
command creates a new head
tag REVISION TAGNAME
Puts a symbolic tag certificate on a revision.
testresult REV (pass|fail|true|false|yes|no|1|0)
Notes the results of running a test on a revision.
command group 'tree'
Commands to manipulate the tree.
checkout [DIRECTORY]
co [DIRECTORY]
Checks out a revision from the database into a directory. If a
revision is given, that's the one that will be checked out. Other‐
wise, it will be the head of the branch (given or implicit). If no
directory is given, the branch name will be used as directory.
--branch [ -b ] <arg>
select branch cert for operation
--move-conflicting-paths / --no-move-conflicting-paths
move conflicting, unversioned paths into '_MTN/resolutions'
before proceeding with any workspace change
--revision [ -r ] <arg>
select revision id for operation
conflicts clean
Delete any bookkeeping files related to conflict resolution.
conflicts resolve_first RESOLUTION
Set the resolution for the first unresolved single-file conflict..
Use 'mtn conflicts show_first' to see possible resolutions.
--conflicts-file <arg>
file in which to store conflicts
conflicts resolve_first_left RESOLUTION
Set the left resolution for the first unresolved two-file conflict.
--conflicts-file <arg>
file in which to store conflicts
conflicts resolve_first_right RESOLUTION
Set the right resolution for the first unresolved two-file con‐
flict.
--conflicts-file <arg>
file in which to store conflicts
conflicts show_first
Show the first unresolved conflict in the conflicts file, and pos‐
sible resolutions.
--conflicts-file <arg>
file in which to store conflicts
conflicts show_remaining
Show the remaining unresolved conflicts in the conflicts file.
--conflicts-file <arg>
file in which to store conflicts
conflicts store [LEFT_REVID RIGHT_REVID]
Store the conflicts from merging two revisions. If no arguments
are given, LEFT_REVID and RIGHT_REVID default to the first two
heads that would be chosen by the 'merge' command. If '--con‐
flicts-file' is not given, '_MTN/conflicts' is used.
--branch [ -b ] <arg>
select branch cert for operation
--conflicts-file <arg>
file in which to store conflicts
explicit_merge LEFT-REVISION RIGHT-REVISION DEST-BRANCH
Merges two explicitly given revisions. The results of the merge
are placed on the branch specified by DEST-BRANCH.
--author <arg>
override author for commit
--date <arg>
override date/time for commit
--message [ -m ] <arg>
set commit changelog message
--message-file <arg>
set filename containing commit changelog message
--resolve-conflicts / --no-resolve-conflicts
specify conflict resolutions in a file, instead of interac‐
tively
--resolve-conflicts-file <arg>
use file to resolve conflicts
--update / --no-update
automatically update the workspace, if it was at a head and the
command creates a new head
heads
Shows unmerged head revisions of a branch.
--branch [ -b ] <arg>
select branch cert for operation
import DIRECTORY
Imports the contents of a directory into a branch.
--author <arg>
override author for commit
--branch [ -b ] <arg>
select branch cert for operation
--date <arg>
override date/time for commit
--dry-run / --no-dry-run
don't perform the operation, just show what would have happened
--exclude <arg>
leave out anything described by its argument
--message [ -m ] <arg>
set commit changelog message
--message-file <arg>
set filename containing commit changelog message
--no-respect-ignore / --respect-ignore
do not ignore any files
--revision [ -r ] <arg>
select revision id for operation
merge
Merges unmerged heads of a branch.
--author <arg>
override author for commit
--branch [ -b ] <arg>
select branch cert for operation
--date <arg>
override date/time for commit
--message [ -m ] <arg>
set commit changelog message
--message-file <arg>
set filename containing commit changelog message
--resolve-conflicts / --no-resolve-conflicts
specify conflict resolutions in a file, instead of interac‐
tively
--resolve-conflicts-file <arg>
use file to resolve conflicts
--update / --no-update
automatically update the workspace, if it was at a head and the
command creates a new head
merge_into_dir SOURCE-BRANCH DEST-BRANCH DIR
Merges one branch into a subdirectory in another branch.
--author <arg>
override author for commit
--date <arg>
override date/time for commit
--message [ -m ] <arg>
set commit changelog message
--message-file <arg>
set filename containing commit changelog message
--resolve-conflicts / --no-resolve-conflicts
specify conflict resolutions in a file, instead of interac‐
tively
--resolve-conflicts-file <arg>
use file to resolve conflicts
--update / --no-update
automatically update the workspace, if it was at a head and the
command creates a new head
merge_into_workspace OTHER-REVISION
Merges a revision into the current workspace's base revision.
Merges OTHER-REVISION into the current workspace's base revision,
and update the current workspace with the result. There can be no
pending changes in the current workspace. Both OTHER-REVISION and
the workspace's base revision will be recorded as parents on com‐
mit. The workspace's selected branch is not changed.
--move-conflicting-paths / --no-move-conflicting-paths
move conflicting, unversioned paths into '_MTN/resolutions'
before proceeding with any workspace change
migrate_workspace [DIRECTORY]
Migrates a workspace directory's metadata to the latest format. If
no directory is given, defaults to the current workspace.
propagate SOURCE-BRANCH DEST-BRANCH
Merges from one branch to another asymmetrically.
--author <arg>
override author for commit
--date <arg>
override date/time for commit
--message [ -m ] <arg>
set commit changelog message
--message-file <arg>
set filename containing commit changelog message
--resolve-conflicts / --no-resolve-conflicts
specify conflict resolutions in a file, instead of interac‐
tively
--resolve-conflicts-file <arg>
use file to resolve conflicts
refresh_inodeprints
Refreshes the inodeprint cache.
setup [DIRECTORY]
Sets up a new workspace directory. If no directory is specified,
uses the current directory.
--branch [ -b ] <arg>
select branch cert for operation
command group 'variables'
Commands to manage persistent variables.
cleanup_workspace_list
Removes all invalid, registered workspace paths for the current
database.
register_workspace [WORKSPACE_PATH]
Registers a new workspace for the current database. This command
adds WORKSPACE_PATH to the list of `known-workspaces'.
set DOMAIN NAME VALUE
Sets a database variable. This command modifies (or adds if it did
not exist before) the variable named NAME, stored in the database,
and sets it to the given value in VALUE. The variable is placed in
the domain DOMAIN.
unregister_workspace [WORKSPACE_PATH]
Unregisters an existing workspace for the current database. This
command removes WORKSPACE_PATH to the list of `known-workspaces'.
unset DOMAIN NAME
Unsets a database variable. This command removes the variable NAME
from domain DOMAIN, which was previously stored in the database.
command group 'vcs'
Commands for interaction with other version control systems.
cvs_import CVSROOT
Imports all versions in a CVS repository.
--branch [ -b ] <arg>
select branch cert for operation
git_export
Produces a git fast-export data stream on stdout.
--authors-file <arg>
file mapping author names from original to new values
--branches-file <arg>
file mapping branch names from original to new values
--export-marks <arg>
save the internal marks table after exporting revisions
--import-marks <arg>
load the internal marks table before exporting revisions
--log-certs / --no-log-certs
include standard cert values in commit logs
--log-revids / --no-log-revids
include revision ids in commit logs
--refs <arg>
include git refs for 'revs', 'roots' or 'leaves'
--use-one-changelog
use only one changelog cert for the git commit message
command group 'workspace'
Commands that deal with the workspace.
add [PATH]...
Adds files to the workspace.
--no-respect-ignore / --respect-ignore
do not ignore any files
--recursive [ -R ] / --no-recursive
also operate on the contents of any listed directories
--unknown / --no-unknown
perform the operations for unknown files from workspace
attr drop PATH [ATTR]
Removes attributes from a file. If no attribute is specified, this
command removes all attributes attached to the file given in PATH.
Otherwise only removes the attribute specified in ATTR.
attr get PATH [ATTR]
Gets the values of a file's attributes. If no attribute is speci‐
fied, this command prints all attributes attached to the file given
in PATH. Otherwise it only prints the attribute specified in ATTR.
attr set PATH ATTR VALUE
Sets an attribute on a file. Sets the attribute given on ATTR to
the value specified in VALUE for the file mentioned in PATH.
ci [PATH]...
commit [PATH]...
Commits workspace changes to the database.
--author <arg>
override author for commit
--branch [ -b ] <arg>
select branch cert for operation
--date <arg>
override date/time for commit
--depth <arg>
limit the number of levels of directories to descend
--exclude <arg>
leave out anything described by its argument
--message [ -m ] <arg>
set commit changelog message
--message-file <arg>
set filename containing commit changelog message
drop [PATH]...
rm [PATH]...
Drops files from the workspace.
--bookkeep-only
only update monotone's internal bookkeeping, not the filesystem
--missing
perform the operations for files missing from workspace
--recursive [ -R ] / --no-recursive
also operate on the contents of any listed directories
mkdir [DIRECTORY...]
Creates directories and adds them to the workspace.
--no-respect-ignore / --respect-ignore
do not ignore any files
pivot_root NEW_ROOT PUT_OLD
Renames the root directory. After this command, the directory that
currently has the name NEW_ROOT will be the root directory, and the
directory that is currently the root directory will have name
PUT_OLD. Use of '--bookkeep-only' is NOT recommended.
--bookkeep-only
only update monotone's internal bookkeeping, not the filesystem
--move-conflicting-paths / --no-move-conflicting-paths
move conflicting, unversioned paths into '_MTN/resolutions'
before proceeding with any workspace change
pluck [PATH...]
Applies changes made at arbitrary places in history. This command
takes changes made at any point in history, and edits your current
workspace to include those changes. The end result is identical to
'mtn diff -r FROM -r TO | patch -p0', except that this command uses
monotone's merger, and thus intelligently handles renames, con‐
flicts, and so on. If one revision is given, applies the changes
made in that revision compared to its parent. If two revisions are
given, applies the changes made to get from the first revision to
the second.
--depth <arg>
limit the number of levels of directories to descend
--exclude <arg>
leave out anything described by its argument
--move-conflicting-paths / --no-move-conflicting-paths
move conflicting, unversioned paths into '_MTN/resolutions'
before proceeding with any workspace change
--revision [ -r ] <arg>
select revision id for operation
mv SRC DEST
mv SRC1 [SRC2 [...]] DEST_DIR
rename SRC DEST
rename SRC1 [SRC2 [...]] DEST_DIR
Renames entries in the workspace.
--bookkeep-only
only update monotone's internal bookkeeping, not the filesystem
revert [PATH]...
Reverts files and/or directories. In order to revert the entire
workspace, specify '.' as the file name.
--depth <arg>
limit the number of levels of directories to descend
--exclude <arg>
leave out anything described by its argument
--missing
perform the operations for files missing from workspace
undrop PATH...
Reverses a mistaken 'drop'. If the file was deleted from the
workspace, this is the same as 'revert'. Otherwise, it just removes
the 'drop' from the manifest.
update
Updates the workspace. This command modifies your workspace to be
based off of a different revision, preserving uncommitted changes
as it does so. If a revision is given, update the workspace to
that revision. If not, update the workspace to the head of the
branch.
--branch [ -b ] <arg>
select branch cert for operation
--move-conflicting-paths / --no-move-conflicting-paths
move conflicting, unversioned paths into '_MTN/resolutions'
before proceeding with any workspace change
--revision [ -r ] <arg>
select revision id for operation
SEE ALSO
info mtn and the documentation on http://www.monotone.ca/docs
BUGS
Please report bugs to https://code.monotone.ca/p/monotone/issues/.
AUTHORS
monotone was written originally by Graydon Hoare <graydon@pobox.com> in
2003 and has since then received numerous contributions from many indi‐
viduals. A complete list of authors can be found in AUTHORS.
Nowadays, monotone is maintained by a collective of enthusiastic pro‐
grammers, known as the monotone development team.
COPYRIGHT
monotone and this man page is Copyright (c) 2003 - 2011 by the monotone
development team.
monotone 1.0 2011-06-20 monotone(1)
