blob: db8723fb22009058a218effae8dbcb05eaa27b66 [file] [log] [blame]
.\" DO NOT MODIFY THIS FILE! It was generated by help2man.
.TH REPO "1" "July 2022" "repo status" "Repo Manual"
repo \- repo status - manual page for repo status
.B repo
\fI\,status \/\fR[\fI\,<project>\/\fR...]
Show the working tree status
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
\fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR
number of jobs to run in parallel (default: based on
number of CPU cores)
\fB\-o\fR, \fB\-\-orphans\fR
include objects in working directory outside of repo
.SS Logging options:
\fB\-v\fR, \fB\-\-verbose\fR
show all output
\fB\-q\fR, \fB\-\-quiet\fR
only show errors
.SS Multi\-manifest options:
operate starting at the outermost manifest
do not operate on outer manifests
only operate on this (sub)manifest
\fB\-\-no\-this\-manifest\-only\fR, \fB\-\-all\-manifests\fR
operate on this manifest and its submanifests
Run `repo help status` to view the detailed manual.
\&'repo status' compares the working tree to the staging area (aka index), and the
most recent commit on this branch (HEAD), in each project specified. A summary
is displayed, one line per file where there is a difference between these three
The \fB\-j\fR/\-\-jobs option can be used to run multiple status queries in parallel.
The \fB\-o\fR/\-\-orphans option can be used to show objects that are in the working
directory, but not associated with a repo project. This includes unmanaged
top\-level files and directories, but also includes deeper items. For example, if
dir/subdir/proj1 and dir/subdir/proj2 are repo projects, dir/subdir/proj3 will
be shown if it is not known to repo.
Status Display
The status display is organized into three columns of information, for example
if the file 'subcmds/' is modified in the project 'repo' on branch
project repo/
branch devwork
The first column explains how the staging area (index) differs from the last
commit (HEAD). Its values are always displayed in upper case and have the
following meanings:
no difference
added (not in HEAD, in index )
modified ( in HEAD, in index, different content )
deleted ( in HEAD, not in index )
renamed (not in HEAD, in index, path changed )
copied (not in HEAD, in index, copied from another)
mode changed ( in HEAD, in index, same content )
unmerged; conflict resolution required
The second column explains how the working directory differs from the index. Its
values are always displayed in lower case and have the following meanings:
new / unknown (not in index, in work tree )
modified ( in index, in work tree, modified )
deleted ( in index, not in work tree )