Next: , Previous: Network, Up: Command Reference



5.4 Informative

monotone status
monotone status pathname...
This command prints a description of the “status” of your working copy. In particular, it prints:

Specifying optional pathname... arguments to the status command restricts the set of changes that are visible and results in only a partial status of the working copy. Changes to files not included in the specified set of pathnames will be ignored.

From within a subdirectory of the working copy the status command will, by default, include all changes in the working copy. Specifying only the pathname "." will restrict status to files changed within the current subdirectory of the working copy.

monotone log
monotone log id
This command prints out a log, in reverse-ancestry order, of small history summaries. Each summary contains author, date, changelog and comment information associated with a revision. If id is given, the command starts tracing back through history from the revision id, otherwise it starts from the base revision of your working copy.
monotone complete file partial-id
monotone complete manifest partial-id
monotone complete revision partial-id
These commands print out all known completions of a partial sha1 value, listing completions which are file, manifest or revision IDs depending on which variant is used. For example, suppose you enter this command and get this result:
          $ monotone complete manifest fa36
          fa36deead87811b0e15208da2853c39d2f6ebe90
          fa36b76dd0139177b28b379fe1d56b22342e5306
          fa36965ec190bee14c5afcac235f1b8e2239bb2a
     

Then monotone is telling you that there are 3 manifests it knows about, in its database, which begin with the 4 hex digits fa36. This command is intended to be used by programmable completion systems, such as those in bash and zsh.

monotone diff
monotone diff pathname...
monotone diff --revision=id
monotone diff --revision=id pathname...
monotone diff --revision=id1 --revision=id2
These commands print out GNU “unified diff format” textual difference listings between various manifest versions. With no --revision options, diff will print the differences between the base revision and the current revision in the working copy.

With one --revision option, diff will print the differences between the revision id and the current revision in the working copy. With two --revision options diff will print the differences between revisions id1 and id2, ignoring any working copy. Note that no pathname... arguments may be specified to restrict the diff output in this case. Restrictions may only be applied to the current, in-progress, working copy revision.

In all cases, monotone will print a textual summary – identical to the summary presented by monotone status – of the logical differences between revisions in lines proceeding the diff. These lines begin with a single hash mark #, and should be ignored by a program processing the diff, such as patch.

Specifying pathnames to the diff command restricts the set of changes that are visible and results in only a partial diff of the working copy. Changes to files not included in the specified set of pathnames will be ignored.

From within a subdirectory of the working copy the diff command will, by default, include all changes in the working copy. Specifying only the pathname "." will restrict diff to files changed within the current subdirectory of the working copy.

monotone list certs id
These commands will print out a list of certificates associated with a particular revision id. Each line of the print out will indicate:

For example, this command lists the certificates associated with a particular version of monotone itself, in the monotone development branch:

          $ ./monotone list certs 4a96
          monotone: expandeding partial id '4a96'
          monotone: expanded to '4a96a230293456baa9c6e7167cafb3c5b52a8e7f'
          -----------------------------------------------------------------
          Key   : graydon@pobox.com
          Sig   : ok
          Name  : author
          Value : graydon@dub.venge.net
          -----------------------------------------------------------------
          Key   : graydon@pobox.com
          Sig   : ok
          Name  : branch
          Value : monotone
          -----------------------------------------------------------------
          Key   : graydon@pobox.com
          Sig   : ok
          Name  : date
          Value : 2003-10-17T03:20:27
          -----------------------------------------------------------------
          Key   : graydon@pobox.com
          Sig   : ok
          Name  : changelog
          Value : 2003-10-16  graydon hoare  <graydon@pobox.com>
                :
                :         * sanity.hh: Add a const version of idx().
                :         * diff_patch.cc: Change to using idx() everywhere.
                :         * cert.cc (find_common_ancestor): Rewrite to recursive
                :         form, stepping over historic merges.
                :         * tests/t_cross.at: New test for merging merges.
                :         * testsuite.at: Call t_cross.at.
                :
     

monotone list keys
monotone list keys pattern
These commands list rsa keys held in your current database. They do not print out any cryptographic information; they simply list the names of public and private keys you have on hand.

If pattern is provided, it is used as a glob to limit the keys listed. Otherwise all keys in your database are listed.

monotone list branches
This command lists all known branches in your database.
monotone list unknown
monotone list unknown pathname...
This command lists all files in your working copy that monotone is either ignoring or knows nothing about.

Specifying pathnames to the list unknown command restricts the set of paths that are searched for unknown files. Unknown files not included in the specified set of pathnames will not be listed.

From within a subdirectory of the working copy the list unknown command will, by default, search the entire working copy. Specifying only the pathname "." will restrict the search for unknown files to the current subdirectory of the working copy.

monotone list ignored
monotone list ignored pathname...
This command lists all files in your working copy that monotone is intentionally ignoring, due to the results of the ignore_file (filename) hook.

Specifying pathnames to the list ignored command restricts the set of paths that are searched for ignored files. Ignored files not included in the specified set of pathnames will not be listed.

From within a subdirectory of the working copy the list ignored command will, by default, search the entire working copy. Specifying only the pathname "." will restrict the search for ignored files to the current subdirectory of the working copy.

monotone list missing
monotone list missing pathname...
This command lists all files in your working copy's base manifest, which are not present in the working copy.

Specifying pathnames to the list missing command restricts the set of paths that are searched for missing files. Missing files not included in the specified set of pathnames will not be listed.

From within a subdirectory of the working copy the list missing command will, by default, search the entire working copy. Specifying only the pathname "." will restrict the search for missing files to the current subdirectory of the working copy.