Re: [PATCH 10/10] evolve: add documentation for `git change`
- From
- Phillip Wood <phillip.wood123@gmail.com>
- Date
- Sep 25, 2022, 08:41 UTC
- Message-ID
- <edad7b00-cf77-4538-9a1d-4e0e7e5d4261@gmail.com>
- In-Reply-To
- <811d516e5d272acc40835aa6bdd4f79a001f72c0.1663959325.git.gitgitgadget@gmail.com>
Hi Chris
On 23/09/2022 19:55, Chris Poucet via GitGitGadget wrote:
Show 42 quoted lines
> From: Chris Poucet <poucet@google.com> > > Signed-off-by: Chris Poucet <poucet@google.com> > --- > Documentation/git-change.txt | 55 ++++++++++++++++++++++++++++++++++++ > 1 file changed, 55 insertions(+) > create mode 100644 Documentation/git-change.txt > > diff --git a/Documentation/git-change.txt b/Documentation/git-change.txt > new file mode 100644 > index 00000000000..ea9a8e619b9 > --- /dev/null > +++ b/Documentation/git-change.txt > @@ -0,0 +1,55 @@ > +git-change(1) > +============= > + > +NAME > +---- > +git-change - Create, list, update or delete changes > + > +SYNOPSIS > +-------- > +[verse] > +'git change' list [<pattern>...] > +'git change' update [-g <change-name> | -n] [--force] [--replace <treeish>...] [--origin <treeish>...] [--content <newtreeish>] > +'git change' delete <change-name>... > + > +DESCRIPTION > +----------- > + > +`git change list`: lists all existing <change-name>s. > + > +`git change delete`: deletes the given <change-name>s. > + > +`git change update`: creates or updates a <change-name>. > + > +If no arguments are given to `update` then a change is added to the > +`refs/metas/` directory, unless a change already exists for the given commit. > + > +A <change-name> starts with `metas/` and represents the current change that is > +being worked on.
It would be really useful for users if this documentation included an introduction to the concepts behind the command and examples of how they should use it to track changes to a patch series.
Best Wishes
Phillip
Show 26 quoted lines
> +OPTIONS > +------- > +-c:: > +--content:: > + Identifies the content commit for the change > + > +-o:: > +--origin:: > + Marks the given commit as being the origin of this commit. > + > +-r:: > +--replace:: > + Marks the given commit as being obsoleted by the new commit. > + > +-g:: > + <change-name> to update > + > +-n:: > + Indicates that the change is new and an existing change should not be updated. > + > +--force:: > + Overwite an existing change of the same name. > + > +GIT > +--- > +Part of the linkgit:git[1] suite