'dim status' is intended to be used by maintainers and not by commiters. Move the description of the subcommand into the 'COMMANDS FOR MAINTAINERS' area and clarify in the COMMITERS area that they should use vanilla 'git status' for checking the health of the branch.
Signed-off-by: Liviu Dudau <liviu.du...@arm.com> --- dim.rst | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/dim.rst b/dim.rst index f7ca4ebdf0ebe..c24253b4d8cfb 100644 --- a/dim.rst +++ b/dim.rst @@ -110,7 +110,8 @@ maintainers and committers pushed patches meanwhile. status ------ -Lists all branches with unmerged patches, and how many patches are unmerged. +This command is for maintainers use. Commiters that want to check the status +of their current branch should use normal **git status** commands. cd -- @@ -288,6 +289,13 @@ cherry-pick them to drm-intel-fixes or drm-intel-next-fixes. These commands use dim cherry-pick internally to make sure bugfixes for fixes are cherry-picked too. +status +------ +Lists all branches with unmerged patches, and how many patches are unmerged. It +will show how the overall subsystem tree looks like and where patches waiting to +be merged have been added, in order to help maintainers with deciding which tree +is in need of a pull request. + pull-request *branch* *upstream* -------------------------------- Fetch the *upstream* remote to make sure it's up-to-date, create and push a date -- 2.17.1 _______________________________________________ dim-tools mailing list dim-tools@lists.freedesktop.org https://lists.freedesktop.org/mailman/listinfo/dim-tools