From: Christian Meder <chris@absolutegiganten.org>
To: Junio C Hamano <junkio@cox.net>
Cc: git@vger.kernel.org
Subject: Re: Notes and questions while reading the documentation
Date: Mon, 10 Oct 2005 23:22:35 +0200 [thread overview]
Message-ID: <1128979355.7097.33.camel@localhost> (raw)
In-Reply-To: <7v1x2zfsp2.fsf@assigned-by-dhcp.cox.net>
Sorry for being slow.
On Wed, 2005-10-05 at 16:30 -0700, Junio C Hamano wrote:
> Christian Meder <chris@absolutegiganten.org> writes:
>
> > * a lot of the manpages include something like "v0.1, June 2005" in the
> > header; these versions tags are pretty obscure to interpret, timestamp
> > when last edited ? version of the manpage ? version of git when the
> > manpage was included ? maturity the author assigned to the content ?
> > If these tags don't follow some sane schema they should be removed.
>
> I think the original intent was the last modification datestamp
> and the version of the documentation, but I agree it should be
> removed. I do not think they show on the HTML version, nor man
> pages, although I have to admit that I haven't looked at
> generated manpages for some time.
Ok. I've done a patch to remove them in a separate email.
> > * the usage of git, Git and GIT isn't consistent in the documentation.
> > I'd vote for only using git.
>
> Sounds sane. What would we do if we need to start sentences with it?
I prepared a patch which changes all usages to git even at the beginning
of sentences.
> > * git-clone says that http transport is not supported yet I used it to
> > clone the git repo from kernel.org yesterday. Should the documentation
> > get updated ?
>
> Thanks for noticing. Yes, now HTTP can handle both of the
> trickier setups (packed, and alternates); credit goes to Daniel.
I noted it down for my second sweep.
> > * the manpage synopsises aren't consistent wrt command naming; it's "git
> > commit" but "git-branch"; I guess all the manpages should reference
> > their commands as "git-x" and not "git x"
>
> Agreed.
>
Ok. Patch in separate email.
Christian
--
Christian Meder, email: chris@absolutegiganten.org
The Way-Seeking Mind of a tenzo is actualized
by rolling up your sleeves.
(Eihei Dogen Zenji)
prev parent reply other threads:[~2005-10-10 21:23 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2005-10-05 22:06 Notes and questions while reading the documentation Christian Meder
2005-10-05 23:30 ` Junio C Hamano
2005-10-10 21:22 ` Christian Meder [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1128979355.7097.33.camel@localhost \
--to=chris@absolutegiganten.org \
--cc=git@vger.kernel.org \
--cc=junkio@cox.net \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).