diff --git a/subcmds/status.py b/subcmds/status.py index 853f1508..0b6006ff 100644 --- a/subcmds/status.py +++ b/subcmds/status.py @@ -20,6 +20,44 @@ class Status(PagedCommand): helpSummary = "Show the working tree status" helpUsage = """ %prog [...] +""" + helpDescription = """ +'%prog' 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 states. + +Status Display +-------------- + +The status display is organized into three columns of information, +for example if the file 'subcmds/status.py' is modified in the +project 'repo' on branch 'devwork': + + project repo/ branch devwork + -m subcmds/status.py + +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 + A: added (not in HEAD, in index ) + M: modified ( in HEAD, in index, different content ) + D: deleted ( in HEAD, not in index ) + R: renamed (not in HEAD, in index, path changed ) + C: copied (not in HEAD, in index, copied from another) + T: mode changed ( in HEAD, in index, same content ) + U: 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 ) + m: modified ( in index, in work tree, modified ) + d: deleted ( in index, not in work tree ) + """ def Execute(self, opt, args):