diff options
Diffstat (limited to 'man/repo-status.1')
| -rw-r--r-- | man/repo-status.1 | 97 |
1 files changed, 97 insertions, 0 deletions
diff --git a/man/repo-status.1 b/man/repo-status.1 new file mode 100644 index 00000000..6037ae1a --- /dev/null +++ b/man/repo-status.1 | |||
| @@ -0,0 +1,97 @@ | |||
| 1 | .\" DO NOT MODIFY THIS FILE! It was generated by help2man. | ||
| 2 | .TH REPO "1" "July 2021" "repo status" "Repo Manual" | ||
| 3 | .SH NAME | ||
| 4 | repo \- repo status - manual page for repo status | ||
| 5 | .SH SYNOPSIS | ||
| 6 | .B repo | ||
| 7 | \fI\,status \/\fR[\fI\,<project>\/\fR...] | ||
| 8 | .SH DESCRIPTION | ||
| 9 | Summary | ||
| 10 | .PP | ||
| 11 | Show the working tree status | ||
| 12 | .SH OPTIONS | ||
| 13 | .TP | ||
| 14 | \fB\-h\fR, \fB\-\-help\fR | ||
| 15 | show this help message and exit | ||
| 16 | .TP | ||
| 17 | \fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR | ||
| 18 | number of jobs to run in parallel (default: 4) | ||
| 19 | .TP | ||
| 20 | \fB\-o\fR, \fB\-\-orphans\fR | ||
| 21 | include objects in working directory outside of repo | ||
| 22 | projects | ||
| 23 | .SS Logging options: | ||
| 24 | .TP | ||
| 25 | \fB\-v\fR, \fB\-\-verbose\fR | ||
| 26 | show all output | ||
| 27 | .TP | ||
| 28 | \fB\-q\fR, \fB\-\-quiet\fR | ||
| 29 | only show errors | ||
| 30 | .PP | ||
| 31 | Run `repo help status` to view the detailed manual. | ||
| 32 | .SH DETAILS | ||
| 33 | .PP | ||
| 34 | \&'repo status' compares the working tree to the staging area (aka index), and the | ||
| 35 | most recent commit on this branch (HEAD), in each project specified. A summary | ||
| 36 | is displayed, one line per file where there is a difference between these three | ||
| 37 | states. | ||
| 38 | .PP | ||
| 39 | The \fB\-j\fR/\-\-jobs option can be used to run multiple status queries in parallel. | ||
| 40 | .PP | ||
| 41 | The \fB\-o\fR/\-\-orphans option can be used to show objects that are in the working | ||
| 42 | directory, but not associated with a repo project. This includes unmanaged | ||
| 43 | top\-level files and directories, but also includes deeper items. For example, if | ||
| 44 | dir/subdir/proj1 and dir/subdir/proj2 are repo projects, dir/subdir/proj3 will | ||
| 45 | be shown if it is not known to repo. | ||
| 46 | .PP | ||
| 47 | Status Display | ||
| 48 | .PP | ||
| 49 | The status display is organized into three columns of information, for example | ||
| 50 | if the file 'subcmds/status.py' is modified in the project 'repo' on branch | ||
| 51 | \&'devwork': | ||
| 52 | .TP | ||
| 53 | project repo/ | ||
| 54 | branch devwork | ||
| 55 | .TP | ||
| 56 | \fB\-m\fR | ||
| 57 | subcmds/status.py | ||
| 58 | .PP | ||
| 59 | The first column explains how the staging area (index) differs from the last | ||
| 60 | commit (HEAD). Its values are always displayed in upper case and have the | ||
| 61 | following meanings: | ||
| 62 | .TP | ||
| 63 | \-: | ||
| 64 | no difference | ||
| 65 | .TP | ||
| 66 | A: | ||
| 67 | added (not in HEAD, in index ) | ||
| 68 | .TP | ||
| 69 | M: | ||
| 70 | modified ( in HEAD, in index, different content ) | ||
| 71 | .TP | ||
| 72 | D: | ||
| 73 | deleted ( in HEAD, not in index ) | ||
| 74 | .TP | ||
| 75 | R: | ||
| 76 | renamed (not in HEAD, in index, path changed ) | ||
| 77 | .TP | ||
| 78 | C: | ||
| 79 | copied (not in HEAD, in index, copied from another) | ||
| 80 | .TP | ||
| 81 | T: | ||
| 82 | mode changed ( in HEAD, in index, same content ) | ||
| 83 | .TP | ||
| 84 | U: | ||
| 85 | unmerged; conflict resolution required | ||
| 86 | .PP | ||
| 87 | The second column explains how the working directory differs from the index. Its | ||
| 88 | values are always displayed in lower case and have the following meanings: | ||
| 89 | .TP | ||
| 90 | \-: | ||
| 91 | new / unknown (not in index, in work tree ) | ||
| 92 | .TP | ||
| 93 | m: | ||
| 94 | modified ( in index, in work tree, modified ) | ||
| 95 | .TP | ||
| 96 | d: | ||
| 97 | deleted ( in index, not in work tree ) | ||
