Re: [PATCH 1/3] git-archimport.1: specify what kind of Arch we're talking about
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Sep 19, 2018, 22:59 UTC
- Message-ID
- <xmqqsh252iwp.fsf@gitster-ct.c.googlers.com>
- In-Reply-To
- <20180919201231.609-2-frederik@ofb.net>
Frederick Eaton <frederik@ofb.net> writes:
Show 8 quoted lines
> Is it a CPU architecture? Is it Arch Linux? If you search for "arch > repository", nothing relevant comes up. Let's call it GNU Arch so > people can find it with search engines. > > Signed-off-by: Frederick Eaton <frederik@ofb.net> > --- > Documentation/git-archimport.txt | 5 +++-- > 1 file changed, 3 insertions(+), 2 deletions(-)
I think "Is it a CPU archtecture?" is a red-herring, but between "What is an Arch Repository?" and "What is GNU Arch?" there indeed is a vast difference in the quality of information readers would get; with the proposed commit log message that ends with "so people can find it with search engines", I am reasonably sure this is an improvement worth having.
Thanks.
Show 24 quoted lines
> > diff --git a/Documentation/git-archimport.txt b/Documentation/git-archimport.txt > index ea7065336..a595a0ffe 100644 > --- a/Documentation/git-archimport.txt > +++ b/Documentation/git-archimport.txt > @@ -3,7 +3,7 @@ git-archimport(1) > > NAME > ---- > -git-archimport - Import an Arch repository into Git > +git-archimport - Import a GNU Arch repository into Git > > > SYNOPSIS > @@ -14,7 +14,8 @@ SYNOPSIS > > DESCRIPTION > ----------- > -Imports a project from one or more Arch repositories. It will follow branches > +Imports a project from one or more GNU Arch repositories. > +It will follow branches > and repositories within the namespaces defined by the <archive/branch> > parameters supplied. If it cannot find the remote branch a merge comes from > it will just import it as a regular commit. If it can find it, it will mark it