{"thread":{"id":"27878","subject":"Command-line options that lack documentation","startedAt":"2011-07-21T12:07:05Z","lastAt":"2011-07-21T21:09:18Z","messageCount":4,"participants":["Nikolai Weibull","Thomas Rast","Jens Lehmann"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"171793","messageId":"CADdV=MsNyhOg7r9NV67e0V1_7FCvdBu4YA=7gAEjPLagP0r9yw@mail.gmail.com","threadId":"27878","inReplyTo":null,"subject":"Command-line options that lack documentation","fromName":"Nikolai Weibull","fromEmail":"now@bitwi.se","sentAt":"2011-07-21T12:07:05Z","receivedAt":"2011-07-21T12:07:05Z","isPatch":false,"sender":{"key":"now@bitwi.se","avatar":"https://gravatar.com/avatar/d9242f067845cf9a72be23e4213c3b6e53492178e5df97372088a441af846133?d=mp&s=160"},"body":"Hi!\n\nThe following options lack (full) documentation in the manual pages:\n\ngit-am:\n  --patch-format\n  --rerere-autoupdate\n\ngit-bisect:\n  next subcommand\n\ngit-commit:\n  --null\n  --interactive\n\ngit-notes copy:\n  --for-rewrite\n\ngit-submodule update:\n  --init\n\ngit-config:\n  --local\n\ngit-reflog expire:\n  -n, --dry-run\n\ngit-reflog delete:\n  -n, --dry-run\n\ngit-repack:\n  --quiet\n\ngit-cherry:\n  --abbrev\n\ngit-fsck:\n  -v\n\ngit-rerere:\n  --rerere-autoupdate\n\ngit-verify-tag:\n  -v, --verbose\n\ngit-svn init | fetch | clone | rebase | dcommit:\n  --no-auth-cache\n  --config-dir\n\ngit-svn fetch | clone | rebase | dcommit:\n  --noMetadata\n  --useSvmProps\n  --useSvnsyncProps\n  --log-window-size\n  --no-checkout\n\ngit-svn fetch | rebase | dcommit:\n  --fetch-all, --all\n\ngit-svn dcommit:\n  -C, --copy-similarity\n\ngit-svn log:\n  --color\n  --pager\n  --non-recursive\n\ngit-svn show-ignore | mkdirs:\n  -r, --revision\n\ngit-svn commit-diff:\n  -m, --message\n  -F, --file\n  -r, --revision\n\ngit-index-pack:\n  --pack_header\n\ngit-merge-file:\n  --marker-size\n  --diff3\n\ngit-pack-objects:\n  --reflog\n  --keep-unreachable\n  --unpack-unreachable\n\ngit-ls-files:\n  --resolve-undo\n\ngit-send-pack:\n  --mirror\n  --stateless-rpc\n  --helper-status\n\ngit-receive-pack:\n  --advertise-refs\n  --stateless-rpc\n\ngit-upload-pack:\n  --advertise-refs\n  --stateless-rpc\n\ngit-mailinfo:\n  --no-inbody-headers\n\nFurthermore, the fact that most commands take -h and --help is\nundocumented, but perhaps not of any real importance.\n\nI would provide patches to the documentation, but most of these\noptions are beyond my grasp of Git.\n"},{"id":"171794","messageId":"201107211434.29677.trast@student.ethz.ch","threadId":"27878","inReplyTo":"CADdV=MsNyhOg7r9NV67e0V1_7FCvdBu4YA=7gAEjPLagP0r9yw@mail.gmail.com","subject":"Re: Command-line options that lack documentation","fromName":"Thomas Rast","fromEmail":"trast@student.ethz.ch","sentAt":"2011-07-21T12:34:29Z","receivedAt":"2011-07-21T12:34:29Z","isPatch":false,"sender":{"key":"tr@thomasrast.ch","avatar":"https://avatars.githubusercontent.com/u/153510?v=4"},"body":"Nikolai Weibull wrote:\n> \n> The following options lack (full) documentation in the manual pages:\n[...]\n> git-notes copy:\n>   --for-rewrite\n\nIntentional, cf. 6956f85 (notes: implement helpers needed for note\ncopying during rewrite, 2010-03-12).\n\n> Furthermore, the fact that most commands take -h and --help is\n> undocumented, but perhaps not of any real importance.\n\nIt's actually in gitcli(7).\n\n-- \nThomas Rast\ntrast@{inf,student}.ethz.ch\n"},{"id":"171816","messageId":"4E288993.3030005@web.de","threadId":"27878","inReplyTo":"CADdV=MsNyhOg7r9NV67e0V1_7FCvdBu4YA=7gAEjPLagP0r9yw@mail.gmail.com","subject":"Re: Command-line options that lack documentation","fromName":"Jens Lehmann","fromEmail":"jens.lehmann@web.de","sentAt":"2011-07-21T20:18:27Z","receivedAt":"2011-07-21T20:18:27Z","isPatch":false,"sender":{"key":"jens.lehmann@web.de","avatar":"https://avatars.githubusercontent.com/u/135220?v=4"},"body":"Am 21.07.2011 14:07, schrieb Nikolai Weibull:\n> Hi!\n> \n> The following options lack (full) documentation in the manual pages:\n\n<snip>\n\n> git-submodule update:\n>   --init\n\n\"--init\" is documented in the synopsis and under the \"init\" and \"update\"\ncommands. The only shortcoming is that the \"--init\" option isn't quoted\nproperly and thus doesn't get decorated like other options in the html\npages, is that what you mean?\n"},{"id":"171821","messageId":"CADdV=Ms6vK0vLV4sy-bGmD7raTKtEMCK_R4UqhyKNz8Q4T05Ug@mail.gmail.com","threadId":"27878","inReplyTo":"4E288993.3030005@web.de","subject":"Re: Command-line options that lack documentation","fromName":"Nikolai Weibull","fromEmail":"now@bitwi.se","sentAt":"2011-07-21T21:09:18Z","receivedAt":"2011-07-21T21:09:18Z","isPatch":false,"sender":{"key":"now@bitwi.se","avatar":"https://gravatar.com/avatar/d9242f067845cf9a72be23e4213c3b6e53492178e5df97372088a441af846133?d=mp&s=160"},"body":"On Thu, Jul 21, 2011 at 22:18, Jens Lehmann <Jens.Lehmann@web.de> wrote:\n> Am 21.07.2011 14:07, schrieb Nikolai Weibull:\n\n>> The following options lack (full) documentation in the manual pages:\n\n>> git-submodule update:\n>>   --init\n\n> \"--init\" is documented in the synopsis and under the \"init\" and \"update\"\n> commands.\n\nWhile that’s true, It’s not documented under the OPTIONS header.\n"}]}