git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* Command-line options that lack documentation
@ 2011-07-21 12:07 Nikolai Weibull
  2011-07-21 12:34 ` Thomas Rast
  2011-07-21 20:18 ` Jens Lehmann
  0 siblings, 2 replies; 4+ messages in thread
From: Nikolai Weibull @ 2011-07-21 12:07 UTC (permalink / raw)
  To: Git List

Hi!

The following options lack (full) documentation in the manual pages:

git-am:
  --patch-format
  --rerere-autoupdate

git-bisect:
  next subcommand

git-commit:
  --null
  --interactive

git-notes copy:
  --for-rewrite

git-submodule update:
  --init

git-config:
  --local

git-reflog expire:
  -n, --dry-run

git-reflog delete:
  -n, --dry-run

git-repack:
  --quiet

git-cherry:
  --abbrev

git-fsck:
  -v

git-rerere:
  --rerere-autoupdate

git-verify-tag:
  -v, --verbose

git-svn init | fetch | clone | rebase | dcommit:
  --no-auth-cache
  --config-dir

git-svn fetch | clone | rebase | dcommit:
  --noMetadata
  --useSvmProps
  --useSvnsyncProps
  --log-window-size
  --no-checkout

git-svn fetch | rebase | dcommit:
  --fetch-all, --all

git-svn dcommit:
  -C, --copy-similarity

git-svn log:
  --color
  --pager
  --non-recursive

git-svn show-ignore | mkdirs:
  -r, --revision

git-svn commit-diff:
  -m, --message
  -F, --file
  -r, --revision

git-index-pack:
  --pack_header

git-merge-file:
  --marker-size
  --diff3

git-pack-objects:
  --reflog
  --keep-unreachable
  --unpack-unreachable

git-ls-files:
  --resolve-undo

git-send-pack:
  --mirror
  --stateless-rpc
  --helper-status

git-receive-pack:
  --advertise-refs
  --stateless-rpc

git-upload-pack:
  --advertise-refs
  --stateless-rpc

git-mailinfo:
  --no-inbody-headers

Furthermore, the fact that most commands take -h and --help is
undocumented, but perhaps not of any real importance.

I would provide patches to the documentation, but most of these
options are beyond my grasp of Git.

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: Command-line options that lack documentation
  2011-07-21 12:07 Command-line options that lack documentation Nikolai Weibull
@ 2011-07-21 12:34 ` Thomas Rast
  2011-07-21 20:18 ` Jens Lehmann
  1 sibling, 0 replies; 4+ messages in thread
From: Thomas Rast @ 2011-07-21 12:34 UTC (permalink / raw)
  To: Nikolai Weibull; +Cc: Git List

Nikolai Weibull wrote:
> 
> The following options lack (full) documentation in the manual pages:
[...]
> git-notes copy:
>   --for-rewrite

Intentional, cf. 6956f85 (notes: implement helpers needed for note
copying during rewrite, 2010-03-12).

> Furthermore, the fact that most commands take -h and --help is
> undocumented, but perhaps not of any real importance.

It's actually in gitcli(7).

-- 
Thomas Rast
trast@{inf,student}.ethz.ch

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: Command-line options that lack documentation
  2011-07-21 12:07 Command-line options that lack documentation Nikolai Weibull
  2011-07-21 12:34 ` Thomas Rast
@ 2011-07-21 20:18 ` Jens Lehmann
  2011-07-21 21:09   ` Nikolai Weibull
  1 sibling, 1 reply; 4+ messages in thread
From: Jens Lehmann @ 2011-07-21 20:18 UTC (permalink / raw)
  To: Nikolai Weibull; +Cc: Git List

Am 21.07.2011 14:07, schrieb Nikolai Weibull:
> Hi!
> 
> The following options lack (full) documentation in the manual pages:

<snip>

> git-submodule update:
>   --init

"--init" is documented in the synopsis and under the "init" and "update"
commands. The only shortcoming is that the "--init" option isn't quoted
properly and thus doesn't get decorated like other options in the html
pages, is that what you mean?

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: Command-line options that lack documentation
  2011-07-21 20:18 ` Jens Lehmann
@ 2011-07-21 21:09   ` Nikolai Weibull
  0 siblings, 0 replies; 4+ messages in thread
From: Nikolai Weibull @ 2011-07-21 21:09 UTC (permalink / raw)
  To: Jens Lehmann; +Cc: Git List

On Thu, Jul 21, 2011 at 22:18, Jens Lehmann <Jens.Lehmann@web.de> wrote:
> Am 21.07.2011 14:07, schrieb Nikolai Weibull:

>> The following options lack (full) documentation in the manual pages:

>> git-submodule update:
>>   --init

> "--init" is documented in the synopsis and under the "init" and "update"
> commands.

While that’s true, It’s not documented under the OPTIONS header.

^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2011-07-21 21:09 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2011-07-21 12:07 Command-line options that lack documentation Nikolai Weibull
2011-07-21 12:34 ` Thomas Rast
2011-07-21 20:18 ` Jens Lehmann
2011-07-21 21:09   ` Nikolai Weibull

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).