Mercurial > hg
changeset 34582:6ce2d81968aa
status: copy-edit and improve --terse and --verbose help
| author | Kevin Bullock <kbullock+mercurial@ringworld.org> |
|---|---|
| date | Tue, 10 Oct 2017 10:27:35 -0500 |
| parents | ee0d74083a22 |
| children | 19b2c062654c |
| files | mercurial/commands.py |
| diffstat | 1 files changed, 23 insertions(+), 22 deletions(-) [+] |
line wrap: on
line diff
--- a/mercurial/commands.py Tue Sep 19 23:13:46 2017 +0900 +++ b/mercurial/commands.py Tue Oct 10 10:27:35 2017 -0500 @@ -4719,28 +4719,23 @@ .. container:: verbose - The -t/--terse option abbreviates the output by showing directory name - if all the files in it share the same status. The option expects a value - which can be a string formed by using 'm', 'a', 'r', 'd', 'u', 'i', 'c' - where, 'm' stands for 'modified', 'a' for 'added', 'r' for 'removed', - 'd' for 'deleted', 'u' for 'unknown', 'i' for 'ignored' and 'c' for clean. - - It terses the output of only those status which are passed. The ignored - files are not considered while tersing until 'i' is there in --terse value - or the --ignored option is used. - - --verbose option shows more context about the state of the repo - like the repository is in unfinised merge, shelve, rebase state etc. - You can have this behaviour turned on by default by following config: - - [commands] - status.verbose = true - - You can also skip some states like bisect by adding following in - configuration file. - - [commands] - status.skipstates = bisect + The -t/--terse option abbreviates the output by showing only the directory + name if all the files in it share the same status. The option takes an + argument indicating the statuses to abbreviate: 'm' for 'modified', 'a' + for 'added', 'r' for 'removed', 'd' for 'deleted', 'u' for 'unknown', 'i' + for 'ignored' and 'c' for clean. + + It abbreviates only those statuses which are passed. Note that ignored + files are not displayed with '--terse i' unless the -i/--ignored option is + also used. + + The -v/--verbose option shows information when the repository is in an + unfinished merge, shelve, rebase state etc. You can have this behavior + turned on by default by enabling the ``commands.status.verbose`` option. + + You can skip displaying some of these states by setting + ``commands.status.skipstates`` to one or more of: 'bisect', 'graft', + 'histedit', 'merge', 'rebase', or 'unshelve'. Examples: @@ -4762,7 +4757,13 @@ hg status -an0 + - show more information about the repository status, abbreviating + added, removed, modified, deleted, and untracked paths:: + + hg status -v -t mardu + Returns 0 on success. + """ opts = pycompat.byteskwargs(opts)