From 7da73d6f3ba579c67e58499b785dc4ac5beb9391 Mon Sep 17 00:00:00 2001 From: "Shawn O. Pearce" Date: Fri, 12 Jun 2009 17:35:43 -0700 Subject: [PATCH] branches: Describe output format in `repo help branches` Signed-off-by: Shawn O. Pearce --- subcmds/branches.py | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/subcmds/branches.py b/subcmds/branches.py index 87c4f9b..0e3ab3c 100644 --- a/subcmds/branches.py +++ b/subcmds/branches.py @@ -61,6 +61,33 @@ class Branches(Command): %prog [...] Summarizes the currently available topic branches. + +Branch Display +-------------- + +The branch display output by this command is organized into four +columns of information; for example: + + *P nocolor | in repo + repo2 | + +The first column contains a * if the branch is the currently +checked out branch in any of the specified projects, or a blank +if no project has the branch checked out. + +The second column contains either blank, p or P, depending upon +the upload status of the branch. + + (blank): branch not yet published by repo upload + P: all commits were published by repo upload + p: only some commits were published by repo upload + +The third column contains the branch name. + +The fourth column (after the | separator) lists the projects that +the branch appears in, or does not appear in. If no project list +is shown, then the branch appears in all projects. + """ def Execute(self, opt, args):