From mboxrd@z Thu Jan  1 00:00:00 1970
X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org
X-Spam-Level: 
X-Spam-Status: No, score=0.0 required=5.0 tests=DKIM_SIGNED,DKIM_VALID
	autolearn=ham autolearn_force=no version=3.4.4
Received: (qmail 5434 invoked from network); 1 Oct 2023 15:54:28 -0000
Received: from 9front.inri.net (168.235.81.73)
  by inbox.vuxu.org with ESMTPUTF8; 1 Oct 2023 15:54:28 -0000
Received: from pb-smtp1.pobox.com ([64.147.108.70]) by 9front; Sun Oct  1 11:49:42 -0400 2023
Received: from pb-smtp1.pobox.com (unknown [127.0.0.1])
	by pb-smtp1.pobox.com (Postfix) with ESMTP id 19DE11B4462
	for <9front@9front.org>; Sun,  1 Oct 2023 11:49:38 -0400 (EDT)
	(envelope-from unobe@cpan.org)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=pobox.com; h=message-id
	:to:subject:date:from:in-reply-to:mime-version:content-type
	:content-transfer-encoding; s=sasl; bh=750A4RbPwsgs3coAvZ8BhL8Pq
	XhfX8KtTQpChqZNbJE=; b=xU+QQe79YAoZe73Nolsh9SwLlHYb3TCns2ZiX9CDg
	bZlUZowo5WddlP9LdkYLvvs1PTcEo/n5aJQtnJumPe+gr+uxYF6kXZN1rSHePreI
	RaxFKlqHppq5l6PaciS01EKGn/Y9Hnd25oPXiidA6AINSyLO6qt9WXpjXhwRZ3Yt
	ls=
Received: from pb-smtp1.nyi.icgroup.com (unknown [127.0.0.1])
	by pb-smtp1.pobox.com (Postfix) with ESMTP id 128E81B4461
	for <9front@9front.org>; Sun,  1 Oct 2023 11:49:38 -0400 (EDT)
	(envelope-from unobe@cpan.org)
Received: from strider.localdomain (unknown [75.237.252.53])
	(using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))
	(No client certificate requested)
	by pb-smtp1.pobox.com (Postfix) with ESMTPSA id 559551B445F
	for <9front@9front.org>; Sun,  1 Oct 2023 11:49:37 -0400 (EDT)
	(envelope-from unobe@cpan.org)
Message-ID: <96670F28F4330D15582F2FEA03722ACF@smtp.pobox.com>
To: 9front@9front.org
Date: Sun, 01 Oct 2023 08:49:35 -0700
From: unobe@cpan.org
In-Reply-To: <1427BD937CD79DC163DBD72D08F63946@eigenstate.org>
MIME-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
X-Pobox-Relay-ID:
 2002CDFC-6072-11EE-A9E5-78DCEB2EC81B-09620299!pb-smtp1.pobox.com
Content-Transfer-Encoding: quoted-printable
List-ID: <9front.9front.org>
List-Help: <http://lists.9front.org>
X-Glyph: ➈
X-Bullshit: distributed anonymous blockchain-oriented content-driven interface 
Subject: Re: [9front] [PATCH] git: add missing usages for subcommands
Reply-To: 9front@9front.org
Precedence: bulk

Quoth ori@eigenstate.org:
> these were intentionally ommitted; you shouldn't need to use
> them. They exist for scripts like 'git/commit', 'git/push', and
> 'git/pull'.

Thanks, Ori.  I didn't realize that programs existing in the
distribution shouldn't be documented.

Two follow-ups:

1) Is that something that is standard and I've just never realized it?

2) I didn't include git/hist in the doc patch: that's a "shouldn't
   need to use" program as well?

>=20
> Quoth Romano <unobe@cpan.org>:
> > ---
> > diff db2177614df64fa9ccf3dae30cdf24df1ce0a0be 405b4e7cff97415ef62ed44=
8de0eb33f981a8333
> > --- a/sys/man/1/git
> > +++ b/sys/man/1/git
> > @@ -71,6 +71,25 @@
> >  .I commits...
> >  ]
> >  .PP
> > +.B git/get
> > +[
> > +.B -dl
> > +]
> > +[
> > +.B -b
> > +.I branch
> > +]
> > +[
> > +.B -u
> > +.I upstream
> > +]
> > +.I remote
> > +.PP
> > +.B git/fs
> > +[
> > +.B -d
> > +]
> > +.PP
> >  .B git/import
> >  [
> >  .B -n
> > @@ -152,6 +171,11 @@
> >  ]
> >  .I query
> >  .PP
> > +.B git/repack
> > +[
> > +.B -d
> > +]
> > +.PP
> >  .B git/revert
> >  [
> >  .B -c
> > @@ -161,6 +185,61 @@
> >  .PP
> >  .B git/rm
> >  .I path...
> > +.PP
> > +.B git/save
> > +.B -n
> > +.I name
> > +.B -e
> > +.I email
> > +.B -m
> > +.I message
> > +.B -d
> > +.I date
> > +[
> > +.B -N
> > +.I committer-name
> > +.B -E
> > +.I committer-email
> > +]
> > +[
> > +.B -p
> > +.I parent1
> > +[
> > +.B -p
> > +.I parent2
> > +]
> > +=E2=80=A6
> > +]
> > +[
> > +.I files=E2=80=A6
> > +]
> > +.PP
> > +.B git/send
> > +[
> > +.B -adf
> > +]
> > +[
> > +.B -b
> > +.I branch1
> > +[
> > +.B -b
> > +.I branch2
> > +]
> > +=E2=80=A6
> > +]
> > +[
> > +.B -r
> > +.I branch1
> > +[
> > +.B -r
> > +.I branch2
> > +]
> > +=E2=80=A6
> > +]
> > +.I remote
> > +[
> > +.I reponame
> > +]
> >  .PP
> >  .B git/serve
> >  [
> >=20
>=20