From: "Ævar Arnfjörð Bjarmason" <avarab@gmail.com>
To: git@vger.kernel.org
Cc: "Junio C Hamano" <gitster@pobox.com>,
"Victoria Dye" <vdye@github.com>, "Taylor Blau" <me@ttaylorr.com>,
"Emily Shaffer" <emilyshaffer@google.com>,
"Jonathan Nieder" <jrnieder@gmail.com>,
"John Cai" <johncai86@gmail.com>,
"Eric Sunshine" <sunshine@sunshineco.com>,
"Ævar Arnfjörð Bjarmason" <avarab@gmail.com>
Subject: [PATCH v5 00/34] doc/UX: make txt & -h output more consistent
Date: Thu, 13 Oct 2022 17:38:54 +0200 [thread overview]
Message-ID: <cover-v5-00.34-00000000000-20221013T153625Z-avarab@gmail.com> (raw)
In-Reply-To: <cover-v3-00.34-00000000000-20221004T131009Z-avarab@gmail.com>
We are currently wildly inconsistent in whether the SYNOPSIS in the
manual page matches the first line of the -h output, and as we add new
options we routinely forget to add them to one or the other (or both).
Without a more complex approach it's hard to do something about the
"or both" case. But we can rather easily test whether the -h output
matches the *.txt version, and report differences.
As this series shows that allows us to fix a lot of issues we've
effectively already "fixed", we just fixed them in one version, but
not the other.
For the rest of the general overview (the first paragraphs are
copy/pasted) see the v1 at:
https://lore.kernel.org/git/cover-00.34-00000000000-20220902T092734Z-avarab@gmail.com
For v3 see:
https://lore.kernel.org/git/cover-v4-00.34-00000000000-20221004T132211Z-avarab@gmail.com/
Junio: A trivial v5 re your
https://lore.kernel.org/git/xmqqlepvsgeo.fsf@gitster.g/; FWIW I saw
that existing prose, but figured we could continue to use "any paths",
but it's rephrased to incorporate "<pathspec>" here, no other changes.
I'm aware of the minor merge conflict with the builtin/symbolic-ref.c
topic of yours, but I see you've resolved it on your side, so this is
still based on "master".
Ævar Arnfjörð Bjarmason (34):
tests: assert *.txt SYNOPSIS and -h output
CodingGuidelines: update and clarify command-line conventions
builtin/bundle.c: indent with tabs
bundle: define subcommand -h in terms of command -h
doc SYNOPSIS: don't use ' for subcommands
doc SYNOPSIS: consistently use ' for commands
built-ins: consistently add "\n" between "usage" and options
doc txt & -h consistency: word-wrap
doc txt & -h consistency: fix incorrect alternates syntax
doc txt & -h consistency: add "-z" to cat-file "-h"
doc txt & -h consistency: balance unbalanced "[" and "]"
doc txt & -h consistency: correct padding around "[]()"
stash doc SYNOPSIS & -h: correct padding around "[]()"
doc txt & -h consistency: use "<options>", not "<options>..."
doc SYNOPSIS & -h: use "-" to separate words in labels, not "_"
doc txt & -h consistency: fix mismatching labels
doc txt & -h consistency: add or fix optional "--" syntax
doc txt & -h consistency: make output order consistent
doc txt & -h consistency: add missing options and labels
doc txt & -h consistency: make "rerere" consistent
doc txt & -h consistency: make "read-tree" consistent
doc txt & -h consistency: make "bundle" consistent
doc txt & -h consistency: use "git foo" form, not "git-foo"
doc txt & -h consistency: add missing options
doc txt & -h consistency: make "stash" consistent
doc txt & -h consistency: make "annotate" consistent
doc txt & -h consistency: use "[<label>...]" for "zero or more"
doc txt & -h consistency: make "diff-tree" consistent
doc txt & -h consistency: make "commit" consistent
reflog doc: list real subcommands up-front
worktree: define subcommand -h in terms of command -h
doc txt & -h consistency: make "worktree" consistent
tests: start asserting that *.txt SYNOPSIS matches -h output
tests: assert consistent whitespace in -h output
Documentation/CodingGuidelines | 14 +-
Documentation/git-annotate.txt | 2 +-
Documentation/git-clean.txt | 10 +-
Documentation/git-commit-graph.txt | 5 +-
.../git-credential-cache--daemon.txt | 4 +-
Documentation/git-diff-files.txt | 2 +-
Documentation/git-fast-export.txt | 2 +-
Documentation/git-hash-object.txt | 3 +-
Documentation/git-interpret-trailers.txt | 5 +-
Documentation/git-merge-base.txt | 4 +-
Documentation/git-mv.txt | 4 +-
Documentation/git-pack-redundant.txt | 2 +-
Documentation/git-prune-packed.txt | 2 +-
Documentation/git-read-tree.txt | 2 +-
Documentation/git-receive-pack.txt | 4 +-
Documentation/git-reflog.txt | 17 +-
Documentation/git-rerere.txt | 2 +-
Documentation/git-rev-list.txt | 2 +-
Documentation/git-send-pack.txt | 5 +-
Documentation/git-show-branch.txt | 4 +-
Documentation/git-show-ref.txt | 4 +-
Documentation/git-sparse-checkout.txt | 2 +-
Documentation/git-stash.txt | 17 +-
Documentation/git-status.txt | 2 +-
Documentation/git-tag.txt | 18 +-
Documentation/git-update-server-info.txt | 8 +-
Documentation/git-upload-archive.txt | 4 +-
Documentation/git-var.txt | 2 +-
Documentation/git-verify-commit.txt | 2 +-
Documentation/git-verify-pack.txt | 2 +-
Documentation/git-verify-tag.txt | 2 +-
Documentation/git-worktree.txt | 3 +-
builtin/blame.c | 22 ++-
builtin/bugreport.c | 3 +-
builtin/bundle.c | 38 ++--
builtin/cat-file.c | 2 +-
builtin/clean.c | 2 +-
builtin/commit-graph.c | 10 +-
builtin/commit-tree.c | 5 +-
builtin/commit.c | 11 +-
builtin/credential-cache--daemon.c | 4 +-
builtin/describe.c | 5 +-
builtin/diagnose.c | 3 +-
builtin/diff-files.c | 1 +
builtin/diff-index.c | 3 +-
builtin/diff-tree.c | 6 +-
builtin/diff.c | 3 +-
builtin/for-each-repo.c | 2 +-
builtin/fsck.c | 5 +-
builtin/hash-object.c | 5 +-
builtin/help.c | 2 +-
builtin/init-db.c | 5 +-
builtin/interpret-trailers.c | 4 +-
builtin/ls-remote.c | 2 +-
builtin/merge-base.c | 2 +-
builtin/pack-objects.c | 4 +-
builtin/pack-redundant.c | 2 +-
builtin/pack-refs.c | 2 +-
builtin/read-tree.c | 4 +-
builtin/rerere.c | 2 +-
builtin/rev-list.c | 3 +-
builtin/revert.c | 9 +-
builtin/rm.c | 4 +-
builtin/send-pack.c | 1 +
builtin/show-branch.c | 3 +-
builtin/show-ref.c | 4 +-
builtin/sparse-checkout.c | 2 +-
builtin/stash.c | 73 +++++---
builtin/symbolic-ref.c | 5 +-
builtin/tag.c | 10 +-
builtin/unpack-file.c | 2 +-
builtin/update-server-info.c | 2 +-
builtin/upload-archive.c | 2 +-
builtin/upload-pack.c | 3 +-
builtin/verify-commit.c | 2 +-
builtin/verify-pack.c | 2 +-
builtin/verify-tag.c | 2 +-
builtin/worktree.c | 110 ++++++++---
help.c | 2 +-
t/helper/test-proc-receive.c | 2 +-
t/t0450-txt-doc-vs-help.sh | 172 ++++++++++++++++++
t/t0450/txt-help-mismatches | 58 ++++++
82 files changed, 594 insertions(+), 199 deletions(-)
create mode 100755 t/t0450-txt-doc-vs-help.sh
create mode 100644 t/t0450/txt-help-mismatches
Range-diff against v4:
1: f76804fe9ae = 1: cb0e2ffcd2c tests: assert *.txt SYNOPSIS and -h output
2: c95d3b9ad42 = 2: 998cd47045b CodingGuidelines: update and clarify command-line conventions
3: b7c98a40393 = 3: dadae0d364f builtin/bundle.c: indent with tabs
4: 522d7fbb0a3 = 4: 7c9b42d8a9b bundle: define subcommand -h in terms of command -h
5: ac437d4eee5 = 5: 88fdaff4f28 doc SYNOPSIS: don't use ' for subcommands
6: f20cbb661c6 = 6: 7a4e244b261 doc SYNOPSIS: consistently use ' for commands
7: ecdc14f6dfe = 7: c31e6eba62d built-ins: consistently add "\n" between "usage" and options
8: 1b9b6a91916 = 8: e029f1303af doc txt & -h consistency: word-wrap
9: f4598ca1899 = 9: d878b1fd91d doc txt & -h consistency: fix incorrect alternates syntax
10: 0e955f294cd = 10: 323afb78f75 doc txt & -h consistency: add "-z" to cat-file "-h"
11: aa2f9325839 = 11: 84a81046a95 doc txt & -h consistency: balance unbalanced "[" and "]"
12: 009a0e586e9 = 12: f5bd52cb103 doc txt & -h consistency: correct padding around "[]()"
13: b568189532f = 13: 83d53381165 stash doc SYNOPSIS & -h: correct padding around "[]()"
14: e5cb5c91b82 = 14: 760bc0a6727 doc txt & -h consistency: use "<options>", not "<options>..."
15: 403e7ceb449 = 15: 00b4cc7dfcc doc SYNOPSIS & -h: use "-" to separate words in labels, not "_"
16: 563ccaab6a9 ! 16: 503bd076a6b doc txt & -h consistency: fix mismatching labels
@@ Documentation/git-clean.txt: Normally, only files unknown to Git are removed, bu
+ Normally, when no <pathspec> is specified, git clean will not
recurse into untracked directories to avoid removing too much.
Specify -d to have it recurse into such directories as well.
- If any paths are specified, -d is irrelevant; all untracked
+- If any paths are specified, -d is irrelevant; all untracked
++ If a <pathspec> is specified, -d is irrelevant; all untracked
+ files matching the specified paths (with exceptions for nested
+ git directories mentioned under `--force`) will be removed.
+
## Documentation/git-credential-cache--daemon.txt ##
@@ Documentation/git-credential-cache--daemon.txt: git-credential-cache--daemon - Temporarily store user credentials in memory
17: e6ef67f1c4f = 17: a27ce91d9b3 doc txt & -h consistency: add or fix optional "--" syntax
18: 766bafcde05 = 18: 517ff5a4565 doc txt & -h consistency: make output order consistent
19: fb95d7a9f86 = 19: f5ad5f0a87f doc txt & -h consistency: add missing options and labels
20: 729029f49c3 = 20: 058b22e22f7 doc txt & -h consistency: make "rerere" consistent
21: 2d4fdbd1aa1 = 21: 2c4c48792b3 doc txt & -h consistency: make "read-tree" consistent
22: c3d227c17c6 = 22: c616f2e9129 doc txt & -h consistency: make "bundle" consistent
23: 02e450ea39b = 23: 1a49bbd1f6a doc txt & -h consistency: use "git foo" form, not "git-foo"
24: 430d40d3083 = 24: bacce14d438 doc txt & -h consistency: add missing options
25: acd6e1f2632 = 25: 89ad801409d doc txt & -h consistency: make "stash" consistent
26: c02fc626542 = 26: a7762e82f71 doc txt & -h consistency: make "annotate" consistent
27: d991b9ef611 = 27: 6c68125f191 doc txt & -h consistency: use "[<label>...]" for "zero or more"
28: dd7d2f0b167 = 28: abaffb0b0df doc txt & -h consistency: make "diff-tree" consistent
29: 3c8154151f3 = 29: 65cd6340726 doc txt & -h consistency: make "commit" consistent
30: 2452157548b = 30: f8f716e6ff5 reflog doc: list real subcommands up-front
31: dbcabff3421 = 31: fd2d358fc05 worktree: define subcommand -h in terms of command -h
32: ea82721b057 = 32: 48c1bb97a91 doc txt & -h consistency: make "worktree" consistent
33: a2abf7a1161 = 33: 099998e8cba tests: start asserting that *.txt SYNOPSIS matches -h output
34: 3443ae7ee6b = 34: 4de83d3d89a tests: assert consistent whitespace in -h output
--
2.38.0.1085.gb7e61c3016c
next prev parent reply other threads:[~2022-10-13 15:39 UTC|newest]
Thread overview: 230+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-09-05 8:26 [PATCH 00/34] doc/UX: make txt & -h output more consistent Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 01/34] CodingGuidelines: update and clarify command-line conventions Ævar Arnfjörð Bjarmason
2022-09-07 20:19 ` Junio C Hamano
2022-09-08 7:46 ` Ævar Arnfjörð Bjarmason
2022-09-08 16:41 ` Junio C Hamano
2022-09-05 8:26 ` [PATCH 02/34] builtin/bundle.c: use \t, not fix indentation 2-SP indentation Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 03/34] bundle: define subcommand -h in terms of command -h Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 04/34] blame: use a more detailed usage_msg_optf() error on bad -L Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 05/34] doc SYNOPSIS: don't use ' for subcommands Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 06/34] doc SYNOPSIS: consistently use ' for commands Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 07/34] doc SYNOPSIS & -h: fix incorrect alternates syntax Ævar Arnfjörð Bjarmason
2022-09-19 22:09 ` Victoria Dye
2022-09-26 11:28 ` Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 08/34] built-ins: consistently add "\n" between "usage" and options Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 09/34] doc txt & -h consistency: word-wrap Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 10/34] doc txt & -h consistency: fix incorrect alternates syntax Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 11/34] doc txt & -h consistency: add "-z" to cat-file "-h" Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 12/34] doc txt & -h consistency: add missing "]" to bugreport "-h" Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 13/34] doc txt & -h consistency: correct padding around "[]()" Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 14/34] stash doc SYNOPSIS & -h: " Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 15/34] doc txt & -h consistency: use "<options>", not "<options>..." Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 16/34] t/helper/test-proc-receive.c: " Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 17/34] doc txt & -h consistency: fix mismatching labels Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 18/34] doc txt & -h consistency: add or fix optional "--" syntax Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 19/34] doc txt & -h consistency: make output order consistent Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 20/34] doc txt & -h consistency: add missing options and labels Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 21/34] doc txt & -h consistency: make "rerere" consistent Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 22/34] doc txt & -h consistency: make "read-tree" consistent Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 23/34] doc txt & -h consistency: make "bundle" consistent Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 24/34] doc txt & -h consistency: use "git foo" form, not "git-foo" Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 25/34] doc txt & -h consistency: add missing options Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 26/34] doc txt & -h consistency: make "stash" consistent Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 27/34] doc txt & -h consistency: make "annotate" consistent Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 28/34] doc txt & -h consistency: use "[<label>...]" for "zero or more" Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 29/34] doc txt & -h consistency: make "diff-tree" consistent Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 30/34] doc txt & -h consistency: make "commit" consistent Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 31/34] reflog doc: list real subcommands up-front Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 32/34] worktree: define subcommand -h in terms of command -h Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 33/34] doc txt & -h consistency: make "worktree" consistent Ævar Arnfjörð Bjarmason
2022-09-05 8:26 ` [PATCH 34/34] tests: start asserting that *.txt SYNOPSIS matches -h output Ævar Arnfjörð Bjarmason
2022-09-19 22:15 ` [PATCH 00/34] doc/UX: make txt & -h output more consistent Victoria Dye
2022-09-20 0:57 ` Victoria Dye
2022-09-28 8:38 ` [PATCH v2 00/35] " Ævar Arnfjörð Bjarmason
2022-09-28 8:38 ` [PATCH v2 01/35] CodingGuidelines: update and clarify command-line conventions Ævar Arnfjörð Bjarmason
2022-09-28 17:29 ` Junio C Hamano
2022-09-30 17:09 ` Junio C Hamano
2022-09-30 17:27 ` Ævar Arnfjörð Bjarmason
2022-09-28 8:38 ` [PATCH v2 02/35] builtin/bundle.c: use \t, not fix indentation 2-SP indentation Ævar Arnfjörð Bjarmason
2022-09-28 23:35 ` Eric Sunshine
2022-09-28 8:38 ` [PATCH v2 03/35] bundle: define subcommand -h in terms of command -h Ævar Arnfjörð Bjarmason
2022-09-28 8:38 ` [PATCH v2 04/35] blame: use a more detailed usage_msg_optf() error on bad -L Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 05/35] doc SYNOPSIS: don't use ' for subcommands Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 06/35] doc SYNOPSIS: consistently use ' for commands Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 07/35] doc SYNOPSIS & -h: fix incorrect alternates syntax Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 08/35] built-ins: consistently add "\n" between "usage" and options Ævar Arnfjörð Bjarmason
2022-09-28 23:51 ` Eric Sunshine
2022-09-28 8:39 ` [PATCH v2 09/35] doc txt & -h consistency: word-wrap Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 10/35] doc txt & -h consistency: fix incorrect alternates syntax Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 11/35] doc txt & -h consistency: add "-z" to cat-file "-h" Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 12/35] doc txt & -h consistency: add missing "]" to bugreport "-h" Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 13/35] doc txt & -h consistency: correct padding around "[]()" Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 14/35] stash doc SYNOPSIS & -h: " Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 15/35] doc txt & -h consistency: use "<options>", not "<options>..." Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 16/35] t/helper/test-proc-receive.c: " Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 17/35] doc txt & -h consistency: fix mismatching labels Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 18/35] doc txt & -h consistency: add or fix optional "--" syntax Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 19/35] doc txt & -h consistency: make output order consistent Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 20/35] doc txt & -h consistency: add missing options and labels Ævar Arnfjörð Bjarmason
2022-09-29 3:04 ` Eric Sunshine
2022-09-28 8:39 ` [PATCH v2 21/35] doc txt & -h consistency: make "rerere" consistent Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 22/35] doc txt & -h consistency: make "read-tree" consistent Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 23/35] doc txt & -h consistency: make "bundle" consistent Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 24/35] doc txt & -h consistency: use "git foo" form, not "git-foo" Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 25/35] doc txt & -h consistency: add missing options Ævar Arnfjörð Bjarmason
2022-09-29 4:36 ` Eric Sunshine
2022-09-28 8:39 ` [PATCH v2 26/35] doc txt & -h consistency: make "stash" consistent Ævar Arnfjörð Bjarmason
2022-09-29 4:41 ` Eric Sunshine
2022-09-28 8:39 ` [PATCH v2 27/35] doc txt & -h consistency: make "annotate" consistent Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 28/35] doc txt & -h consistency: use "[<label>...]" for "zero or more" Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 29/35] doc txt & -h consistency: make "diff-tree" consistent Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 30/35] doc txt & -h consistency: make "commit" consistent Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 31/35] reflog doc: list real subcommands up-front Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 32/35] worktree: define subcommand -h in terms of command -h Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 33/35] doc txt & -h consistency: make "worktree" consistent Ævar Arnfjörð Bjarmason
2022-09-28 8:39 ` [PATCH v2 34/35] tests: start asserting that *.txt SYNOPSIS matches -h output Ævar Arnfjörð Bjarmason
2022-09-28 20:27 ` Junio C Hamano
2022-09-28 8:39 ` [PATCH v2 35/35] tests: assert consistent whitespace in " Ævar Arnfjörð Bjarmason
2022-09-28 18:04 ` [PATCH v2 00/35] doc/UX: make txt & -h output more consistent Junio C Hamano
2022-09-28 20:10 ` Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 00/36] " Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 01/36] CodingGuidelines: update and clarify command-line conventions Ævar Arnfjörð Bjarmason
2022-09-30 21:01 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 02/36] builtin/bundle.c: indent with tabs Ævar Arnfjörð Bjarmason
2022-09-30 21:01 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 03/36] bundle: define subcommand -h in terms of command -h Ævar Arnfjörð Bjarmason
2022-09-30 21:01 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 04/36] blame: use a more detailed usage_msg_optf() error on bad -L Ævar Arnfjörð Bjarmason
2022-09-30 21:00 ` Junio C Hamano
2022-10-03 8:36 ` Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 05/36] doc SYNOPSIS: don't use ' for subcommands Ævar Arnfjörð Bjarmason
2022-09-30 21:23 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 06/36] doc SYNOPSIS: consistently use ' for commands Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 07/36] doc SYNOPSIS & -h: fix incorrect alternates syntax Ævar Arnfjörð Bjarmason
2022-09-30 21:28 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 08/36] built-ins: consistently add "\n" between "usage" and options Ævar Arnfjörð Bjarmason
2022-09-30 21:31 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 09/36] doc SYNOPSIS & -h: word-wrap Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 10/36] doc txt & -h consistency: word-wrap Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 11/36] doc txt & -h consistency: fix incorrect alternates syntax Ævar Arnfjörð Bjarmason
2022-10-01 1:09 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 12/36] doc txt & -h consistency: add "-z" to cat-file "-h" Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 13/36] doc txt & -h consistency: balance unbalanced "[" and "]" Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 14/36] doc txt & -h consistency: correct padding around "[]()" Ævar Arnfjörð Bjarmason
2022-09-30 21:40 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 15/36] stash doc SYNOPSIS & -h: " Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 16/36] doc txt & -h consistency: use "<options>", not "<options>..." Ævar Arnfjörð Bjarmason
2022-09-30 21:43 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 17/36] t/helper/test-proc-receive.c: " Ævar Arnfjörð Bjarmason
2022-09-30 21:46 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 18/36] doc txt & -h consistency: fix mismatching labels Ævar Arnfjörð Bjarmason
2022-09-30 22:04 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 19/36] doc txt & -h consistency: add or fix optional "--" syntax Ævar Arnfjörð Bjarmason
2022-09-30 22:09 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 20/36] doc txt & -h consistency: make output order consistent Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 21/36] doc txt & -h consistency: add missing options and labels Ævar Arnfjörð Bjarmason
2022-10-01 18:43 ` Junio C Hamano
2022-10-01 23:44 ` Junio C Hamano
2022-10-02 4:52 ` Junio C Hamano
2022-10-04 10:13 ` Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 22/36] doc txt & -h consistency: make "rerere" consistent Ævar Arnfjörð Bjarmason
2022-10-01 18:45 ` Junio C Hamano
2022-10-03 9:00 ` Ævar Arnfjörð Bjarmason
2022-10-03 15:55 ` Junio C Hamano
2022-10-04 7:50 ` Ævar Arnfjörð Bjarmason
2022-10-05 17:20 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 23/36] doc txt & -h consistency: make "read-tree" consistent Ævar Arnfjörð Bjarmason
2022-10-01 18:48 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 24/36] doc txt & -h consistency: make "bundle" consistent Ævar Arnfjörð Bjarmason
2022-10-01 18:51 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 25/36] doc txt & -h consistency: use "git foo" form, not "git-foo" Ævar Arnfjörð Bjarmason
2022-10-01 18:59 ` Junio C Hamano
2022-09-30 18:07 ` [PATCH v3 26/36] doc txt & -h consistency: add missing options Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 27/36] doc txt & -h consistency: make "stash" consistent Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 28/36] doc txt & -h consistency: make "annotate" consistent Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 29/36] doc txt & -h consistency: use "[<label>...]" for "zero or more" Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 30/36] doc txt & -h consistency: make "diff-tree" consistent Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 31/36] doc txt & -h consistency: make "commit" consistent Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 32/36] reflog doc: list real subcommands up-front Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 33/36] worktree: define subcommand -h in terms of command -h Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 34/36] doc txt & -h consistency: make "worktree" consistent Ævar Arnfjörð Bjarmason
2022-09-30 18:07 ` [PATCH v3 35/36] tests: start asserting that *.txt SYNOPSIS matches -h output Ævar Arnfjörð Bjarmason
2022-10-02 1:25 ` Eric Sunshine
2022-09-30 18:07 ` [PATCH v3 36/36] tests: assert consistent whitespace in " Ævar Arnfjörð Bjarmason
2022-10-02 1:29 ` Eric Sunshine
2022-10-04 13:20 ` [PATCH v3 00/34] doc/UX: make txt & -h output more consistent Ævar Arnfjörð Bjarmason
2022-10-04 13:20 ` [PATCH v3 01/34] tests: assert *.txt SYNOPSIS and -h output Ævar Arnfjörð Bjarmason
2022-10-04 13:20 ` [PATCH v3 02/34] CodingGuidelines: update and clarify command-line conventions Ævar Arnfjörð Bjarmason
2022-10-04 13:20 ` [PATCH v3 03/34] builtin/bundle.c: indent with tabs Ævar Arnfjörð Bjarmason
2022-10-13 15:38 ` Ævar Arnfjörð Bjarmason [this message]
2022-10-13 15:38 ` [PATCH v5 01/34] tests: assert *.txt SYNOPSIS and -h output Ævar Arnfjörð Bjarmason
2022-10-13 15:38 ` [PATCH v5 02/34] CodingGuidelines: update and clarify command-line conventions Ævar Arnfjörð Bjarmason
2022-10-13 15:38 ` [PATCH v5 03/34] builtin/bundle.c: indent with tabs Ævar Arnfjörð Bjarmason
2022-10-13 15:38 ` [PATCH v5 04/34] bundle: define subcommand -h in terms of command -h Ævar Arnfjörð Bjarmason
2022-10-13 15:38 ` [PATCH v5 05/34] doc SYNOPSIS: don't use ' for subcommands Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 06/34] doc SYNOPSIS: consistently use ' for commands Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 07/34] built-ins: consistently add "\n" between "usage" and options Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 08/34] doc txt & -h consistency: word-wrap Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 09/34] doc txt & -h consistency: fix incorrect alternates syntax Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 10/34] doc txt & -h consistency: add "-z" to cat-file "-h" Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 11/34] doc txt & -h consistency: balance unbalanced "[" and "]" Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 12/34] doc txt & -h consistency: correct padding around "[]()" Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 13/34] stash doc SYNOPSIS & -h: " Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 14/34] doc txt & -h consistency: use "<options>", not "<options>..." Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 15/34] doc SYNOPSIS & -h: use "-" to separate words in labels, not "_" Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 16/34] doc txt & -h consistency: fix mismatching labels Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 17/34] doc txt & -h consistency: add or fix optional "--" syntax Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 18/34] doc txt & -h consistency: make output order consistent Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 19/34] doc txt & -h consistency: add missing options and labels Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 20/34] doc txt & -h consistency: make "rerere" consistent Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 21/34] doc txt & -h consistency: make "read-tree" consistent Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 22/34] doc txt & -h consistency: make "bundle" consistent Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 23/34] doc txt & -h consistency: use "git foo" form, not "git-foo" Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 24/34] doc txt & -h consistency: add missing options Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 25/34] doc txt & -h consistency: make "stash" consistent Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 26/34] doc txt & -h consistency: make "annotate" consistent Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 27/34] doc txt & -h consistency: use "[<label>...]" for "zero or more" Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 28/34] doc txt & -h consistency: make "diff-tree" consistent Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 29/34] doc txt & -h consistency: make "commit" consistent Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 30/34] reflog doc: list real subcommands up-front Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 31/34] worktree: define subcommand -h in terms of command -h Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 32/34] doc txt & -h consistency: make "worktree" consistent Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 33/34] tests: start asserting that *.txt SYNOPSIS matches -h output Ævar Arnfjörð Bjarmason
2022-10-13 15:39 ` [PATCH v5 34/34] tests: assert consistent whitespace in " Ævar Arnfjörð Bjarmason
2022-10-13 16:33 ` [PATCH v5 00/34] doc/UX: make txt & -h output more consistent Junio C Hamano
2022-10-04 13:23 ` [PATCH v4 " Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 01/34] tests: assert *.txt SYNOPSIS and -h output Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 02/34] CodingGuidelines: update and clarify command-line conventions Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 03/34] builtin/bundle.c: indent with tabs Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 04/34] bundle: define subcommand -h in terms of command -h Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 05/34] doc SYNOPSIS: don't use ' for subcommands Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 06/34] doc SYNOPSIS: consistently use ' for commands Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 07/34] built-ins: consistently add "\n" between "usage" and options Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 08/34] doc txt & -h consistency: word-wrap Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 09/34] doc txt & -h consistency: fix incorrect alternates syntax Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 10/34] doc txt & -h consistency: add "-z" to cat-file "-h" Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 11/34] doc txt & -h consistency: balance unbalanced "[" and "]" Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 12/34] doc txt & -h consistency: correct padding around "[]()" Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 13/34] stash doc SYNOPSIS & -h: " Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 14/34] doc txt & -h consistency: use "<options>", not "<options>..." Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 15/34] doc SYNOPSIS & -h: use "-" to separate words in labels, not "_" Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 16/34] doc txt & -h consistency: fix mismatching labels Ævar Arnfjörð Bjarmason
2022-10-04 16:27 ` Junio C Hamano
2022-10-04 13:23 ` [PATCH v4 17/34] doc txt & -h consistency: add or fix optional "--" syntax Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 18/34] doc txt & -h consistency: make output order consistent Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 19/34] doc txt & -h consistency: add missing options and labels Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 20/34] doc txt & -h consistency: make "rerere" consistent Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 21/34] doc txt & -h consistency: make "read-tree" consistent Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 22/34] doc txt & -h consistency: make "bundle" consistent Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 23/34] doc txt & -h consistency: use "git foo" form, not "git-foo" Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 24/34] doc txt & -h consistency: add missing options Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 25/34] doc txt & -h consistency: make "stash" consistent Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 26/34] doc txt & -h consistency: make "annotate" consistent Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 27/34] doc txt & -h consistency: use "[<label>...]" for "zero or more" Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 28/34] doc txt & -h consistency: make "diff-tree" consistent Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 29/34] doc txt & -h consistency: make "commit" consistent Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 30/34] reflog doc: list real subcommands up-front Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 31/34] worktree: define subcommand -h in terms of command -h Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 32/34] doc txt & -h consistency: make "worktree" consistent Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 33/34] tests: start asserting that *.txt SYNOPSIS matches -h output Ævar Arnfjörð Bjarmason
2022-10-04 13:23 ` [PATCH v4 34/34] tests: assert consistent whitespace in " Ævar Arnfjörð Bjarmason
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
List information: http://vger.kernel.org/majordomo-info.html
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=cover-v5-00.34-00000000000-20221013T153625Z-avarab@gmail.com \
--to=avarab@gmail.com \
--cc=emilyshaffer@google.com \
--cc=git@vger.kernel.org \
--cc=gitster@pobox.com \
--cc=johncai86@gmail.com \
--cc=jrnieder@gmail.com \
--cc=me@ttaylorr.com \
--cc=sunshine@sunshineco.com \
--cc=vdye@github.com \
/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.
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
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 read-only IMAP folder(s) and NNTP newsgroup(s).