mirrors/git
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
dedb2883ce5670401ccd2a18e47d6dae2bc798ab
git/Documentation
History
Martin Ågren 32c6fff4b8 cmd-list.perl: fix identifying man sections 
We attribute each documentation text file to a man section by finding a
line in the file that looks like "gitfoo(<digit>)". Commit cc75e556a9
("scalar: add to 'git help -a' command list", 2022-09-02) updated this
logic to look not only for "gitfoo" but also "scalarfoo". In doing so,
it forgot to account for the fact that after the updated regex has found
a match, the man section is no longer to be found in `$1` but now lives
in `$2`.

This makes our git(1) manpage look as follows:

  Main porcelain commands
       git-add(git)
           Add file contents to the index.

  [...]

       gitk(git)
           The Git repository browser.

       scalar(scalar)
           A tool for managing large Git repositories.

Restore the man sections by not capturing the (git|scalar) part of the
match into `$1`.

As noted by Ævar [1], we could even match any "foo" rather than just
"gitfoo" and "scalarfoo", but that's a larger change. For now, just fix
the regression in cc75e556a9.

[1] https://lore.kernel.org/git/220923.86wn9u4joo.gmgdl@evledraar.gmail.com/#t

Helped-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Signed-off-by: Martin Ågren <martin.agren@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2022-09-23 10:01:07 -07:00
..
config
Merge branch 'js/typofix'
2022-09-15 16:09:46 -07:00
howto
docs: move pack format docs to man section 5
2022-08-04 14:12:24 -07:00
includes
docs: add and use include template for config/* includes
2022-09-07 09:46:05 -07:00
mergetools
vimdiff: add tool documentation
2022-04-03 15:09:52 -07:00
RelNotes
Git 2.38-rc1
2022-09-21 15:27:03 -07:00
technical
Merge branch 'js/typofix'
2022-09-21 15:27:02 -07:00
.gitattributes
…
.gitignore
doc lint: make "lint-docs" non-.PHONY
2021-10-15 10:29:11 -07:00
asciidoc.conf
…
asciidoctor-extensions.rb
…
blame-options.txt
Merge branch 'bs/doc-blame-color-lines'
2021-10-18 15:47:58 -07:00
build-docdep.perl
…
cat-texi.perl
…
cmd-list.perl
cmd-list.perl: fix identifying man sections
2022-09-23 10:01:07 -07:00
CodingGuidelines
Documentation: fix various repeat word typos
2022-09-12 11:04:55 -07:00
config.txt
Merge branch 'mb/config-document-include' into maint
2022-08-05 15:51:36 -07:00
date-formats.txt
doc: use only hyphens as word separators in placeholders
2021-11-09 09:39:11 -08:00
diff-format.txt
diff-format.txt: correct misleading wording
2022-06-13 11:57:03 -07:00
diff-generate-patch.txt
doc: point to diff attribute in patch format docs
2021-04-28 13:34:44 +09:00
diff-options.txt
Merge branch 'js/diff-filter-negation-fix'
2022-02-16 15:14:30 -08:00
doc-diff
…
docbook-xsl.css
…
docbook.xsl
…
everyday.txto
…
fetch-options.txt
Merge branch 'rc/fetch-refetch'
2022-04-04 10:56:23 -07:00
fix-texi.perl
…
git-add.txt
Merge branch 'ab/dedup-config-and-command-docs'
2022-09-14 12:56:40 -07:00
git-am.txt
Merge branch 'ab/dedup-config-and-command-docs'
2022-09-14 12:56:40 -07:00
git-annotate.txt
…
git-apply.txt
apply docs: de-duplicate configuration sections
2022-09-07 09:46:05 -07:00
git-archimport.txt
doc: split placeholders as individual tokens
2021-10-28 09:57:09 -07:00
git-archive.txt
archive-tar: use internal gzip by default
2022-06-15 13:19:47 -07:00
git-bisect-lk2009.txt
…
git-bisect.txt
…
git-blame.txt
docs: add CONFIGURATION sections that fuzzy map to built-ins
2022-09-07 09:46:07 -07:00
git-branch.txt
docs: add CONFIGURATION sections that fuzzy map to built-ins
2022-09-07 09:46:07 -07:00
git-bugreport.txt
builtin/bugreport.c: create '--diagnose' option
2022-08-12 13:20:02 -07:00
git-bundle.txt
Documentation: fix various repeat word typos
2022-09-12 11:04:55 -07:00
git-cat-file.txt
Merge branch 'tb/cat-file-z'
2022-08-05 15:52:14 -07:00
git-check-attr.txt
…
git-check-ignore.txt
doc: check-ignore: code-quote an exclamation mark
2022-02-03 11:13:49 -08:00
git-check-mailmap.txt
check-mailmap doc: note config options
2021-01-12 14:04:40 -08:00
git-check-ref-format.txt
…
git-checkout-index.txt
checkout-index: add --ignore-skip-worktree-bits option
2022-01-13 13:49:45 -08:00
git-checkout.txt
docs: add CONFIGURATION sections that fuzzy map to built-ins
2022-09-07 09:46:07 -07:00
git-cherry-pick.txt
doc: consolidate --rerere-autoupdate description
2022-08-03 13:47:11 -07:00
git-cherry.txt
…
git-citool.txt
…
git-clean.txt
docs: add CONFIGURATION sections that map to a built-in
2022-09-07 09:46:06 -07:00
git-clone.txt
Merge branch 'ab/dedup-config-and-command-docs'
2022-09-14 12:56:40 -07:00
git-column.txt
docs: add CONFIGURATION sections that fuzzy map to built-ins
2022-09-07 09:46:07 -07:00
git-commit-graph.txt
Merge branch 'ab/dedup-config-and-command-docs'
2022-09-14 12:56:40 -07:00
git-commit-tree.txt
…
git-commit.txt
docs: add CONFIGURATION sections that map to a built-in
2022-09-07 09:46:06 -07:00
git-config.txt
Documentation: define protected configuration
2022-07-14 15:08:29 -07:00
git-count-objects.txt
…
git-credential-cache--daemon.txt
doc: replace "--" with {litdd} in credential-cache/fsmonitor
2022-04-06 16:06:06 -07:00
git-credential-cache.txt
…
git-credential-store.txt
…
git-credential.txt
doc: fix git credential synopsis
2021-10-28 09:57:09 -07:00
git-cvsexportcommit.txt
doc: express grammar placeholders between angle brackets
2021-11-09 09:39:11 -08:00
git-cvsimport.txt
doc: use only hyphens as word separators in placeholders
2021-11-09 09:39:11 -08:00
git-cvsserver.txt
git-cvsserver: clarify directory list
2022-07-19 12:45:31 -07:00
git-daemon.txt
daemon: clarify directory arguments
2022-07-19 12:45:31 -07:00
git-describe.txt
describe-doc: clarify default length of abbreviation
2021-05-17 15:56:29 +09:00
git-diagnose.txt
builtin/diagnose.c: add '--mode' option
2022-08-12 13:20:02 -07:00
git-diff-files.txt
doc: use only hyphens as word separators in placeholders
2021-11-09 09:39:11 -08:00
git-diff-index.txt
diff-index.txt: update raw output format in examples
2022-06-13 11:59:16 -07:00
git-diff-tree.txt
doc: use only hyphens as word separators in placeholders
2021-11-09 09:39:11 -08:00
git-diff.txt
docs: add CONFIGURATION sections that fuzzy map to built-ins
2022-09-07 09:46:07 -07:00
git-difftool.txt
difftool docs: de-duplicate configuration sections
2022-09-07 09:46:06 -07:00
git-fast-export.txt
…
git-fast-import.txt
docs: add CONFIGURATION sections that map to a built-in
2022-09-07 09:46:06 -07:00
git-fetch-pack.txt
builtin/fetch-pack: add --refetch option
2022-03-28 10:25:52 -07:00
git-fetch.txt
docs: add CONFIGURATION sections that fuzzy map to built-ins
2022-09-07 09:46:07 -07:00
git-filter-branch.txt
…
git-fmt-merge-msg.txt
merge: allow to pretend a merge is made into a different branch
2021-12-20 14:55:02 -08:00
git-for-each-ref.txt
ref-filter: --format=%(raw) support --perl
2021-07-26 12:01:25 -07:00
git-for-each-repo.txt
…
git-format-patch.txt
format-patch: learn format.forceInBodyFrom configuration variable
2022-08-29 14:39:13 -07:00
git-fsck-objects.txt
…
git-fsck.txt
docs: add and use include template for config/* includes
2022-09-07 09:46:05 -07:00
git-fsmonitor--daemon.txt
doc: replace "--" with {litdd} in credential-cache/fsmonitor
2022-04-06 16:06:06 -07:00
git-gc.txt
docs: add and use include template for config/* includes
2022-09-07 09:46:05 -07:00
git-get-tar-commit-id.txt
…
git-grep.txt
grep docs: de-duplicate configuration sections
2022-09-07 09:46:05 -07:00
git-gui.txt
doc: express grammar placeholders between angle brackets
2021-11-09 09:39:11 -08:00
git-hash-object.txt
…
git-help.txt
git docs: add a category for file formats, protocols and interfaces
2022-08-04 14:12:23 -07:00
git-hook.txt
git hook run: add an --ignore-missing flag
2022-01-07 15:19:34 -08:00
git-http-backend.txt
docs/http-backend: mention v2 protocol
2021-09-10 15:34:59 -07:00
git-http-fetch.txt
doc: uniformize <URL> placeholders' case
2021-11-09 09:39:11 -08:00
git-http-push.txt
doc: git-http-push: describe the refs as pattern pairs
2021-11-09 09:39:11 -08:00
git-imap-send.txt
docs: add and use include template for config/* includes
2022-09-07 09:46:05 -07:00
git-index-pack.txt
index-pack: document and test the --promisor option
2022-03-09 10:25:26 -08:00
git-init-db.txt
doc: use only hyphens as word separators in placeholders
2021-11-09 09:39:11 -08:00
git-init.txt
docs: add CONFIGURATION sections that fuzzy map to built-ins
2022-09-07 09:46:07 -07:00
git-instaweb.txt
…
git-interpret-trailers.txt
Documentation: clarify whitespace rules for trailers
2022-08-30 10:17:34 -07:00
git-log.txt
Merge branch 'ab/dedup-config-and-command-docs'
2022-09-14 12:56:40 -07:00
git-ls-files.txt
ls-files: introduce "--format" option
2022-07-23 10:53:55 -07:00
git-ls-remote.txt
…
git-ls-tree.txt
ls-tree doc: document interaction with submodules
2022-04-08 11:21:11 -07:00
git-mailinfo.txt
docs: add CONFIGURATION sections that map to a built-in
2022-09-07 09:46:06 -07:00
git-mailsplit.txt
…
git-maintenance.txt
docs: add CONFIGURATION sections that map to a built-in
2022-09-07 09:46:06 -07:00
git-merge-base.txt
…
git-merge-file.txt
update documentation for new zdiff3 conflictStyle
2021-12-01 14:45:59 -08:00
git-merge-index.txt
doc: use three dots for indicating repetition instead of star
2021-11-09 09:39:11 -08:00
git-merge-one-file.txt
…
git-merge-tree.txt
git-merge-tree.txt: add a section on potentional usage mistakes
2022-06-22 16:10:06 -07:00
git-merge.txt
Merge branch 'ab/dedup-config-and-command-docs'
2022-09-14 12:56:40 -07:00
git-mergetool--lib.txt
mergetool: break setup_tool out into separate initialization function
2021-02-09 14:09:16 -08:00
git-mergetool.txt
docs: add and use include template for config/* includes
2022-09-07 09:46:05 -07:00
git-mktag.txt
docs: fix linting issues due to incorrect relative section order
2021-04-10 23:36:34 -07:00
git-mktree.txt
fix typo in git-mktree.txt
2022-02-02 14:50:09 -08:00
git-multi-pack-index.txt
docs: move pack format docs to man section 5
2022-08-04 14:12:24 -07:00
git-mv.txt
…
git-name-rev.txt
name-rev: deprecate --stdin in favor of --annotate-stdin
2022-01-10 09:39:26 -08:00
git-notes.txt
notes docs: de-duplicate and combine configuration sections
2022-09-07 09:46:06 -07:00
git-p4.txt
git-p4: improve encoding handling to support inconsistent encodings
2022-05-04 10:30:01 -07:00
git-pack-objects.txt
builtin/pack-objects.c: --cruft without expiration
2022-05-26 15:48:26 -07:00
git-pack-redundant.txt
doc: express grammar placeholders between angle brackets
2021-11-09 09:39:11 -08:00
git-pack-refs.txt
…
git-patch-id.txt
…
git-prune-packed.txt
…
git-prune.txt
…
git-pull.txt
Merge branch 'js/retire-preserve-merges'
2021-10-18 15:47:56 -07:00
git-push.txt
docs: add CONFIGURATION sections that map to a built-in
2022-09-07 09:46:06 -07:00
git-quiltimport.txt
…
git-range-diff.txt
range-diff: optionally accept pathspecs
2022-08-26 09:49:26 -07:00
git-read-tree.txt
Merge branch 'en/sparse-cone-becomes-default'
2022-06-03 14:30:33 -07:00
git-rebase.txt
Merge branch 'ab/dedup-config-and-command-docs'
2022-09-14 12:56:40 -07:00
git-receive-pack.txt
upload-pack: document and rename --advertise-refs
2021-08-05 08:59:37 -07:00
git-reflog.txt
Documentation/git-reflog: remove unneeded \ from \{
2022-08-01 14:33:44 -07:00
git-remote-ext.txt
…
git-remote-fd.txt
…
git-remote-helpers.txto
…
git-remote.txt
builtin/remote.c: teach -v to list filters for promisor remotes
2022-05-09 10:53:58 -07:00
git-repack.txt
builtin/repack.c: support generating a cruft pack
2022-05-26 15:48:26 -07:00
git-replace.txt
…
git-request-pull.txt
doc: uniformize <URL> placeholders' case
2021-11-09 09:39:11 -08:00
git-rerere.txt
…
git-reset.txt
reset: remove 'reset.refresh' config option
2022-03-23 14:39:45 -07:00
git-restore.txt
update documentation for new zdiff3 conflictStyle
2021-12-01 14:45:59 -08:00
git-rev-list.txt
docs/rev-list: add some examples of --disk-usage
2021-02-17 16:25:29 -08:00
git-rev-parse.txt
…
git-revert.txt
Merge branch 'ab/dedup-config-and-command-docs'
2022-09-14 12:56:40 -07:00
git-rm.txt
rm: add --sparse option
2021-09-28 10:31:02 -07:00
git-send-email.txt
send-email docs: de-duplicate configuration sections
2022-09-07 09:46:05 -07:00
git-send-pack.txt
send-pack: properly use parse_options() API for usage string
2021-09-12 18:57:30 -07:00
git-sh-i18n--envsubst.txt
…
git-sh-i18n.txt
…
git-sh-setup.txt
…
git-shell.txt
…
git-shortlog.txt
doc: use only hyphens as word separators in placeholders
2021-11-09 09:39:11 -08:00
git-show-branch.txt
docs: add CONFIGURATION sections that map to a built-in
2022-09-07 09:46:06 -07:00
git-show-index.txt
…
git-show-ref.txt
…
git-show.txt
…
git-sparse-checkout.txt
Documentation: some sparsity wording clarifications
2022-04-21 23:12:39 -07:00
git-stage.txt
doc: express grammar placeholders between angle brackets
2021-11-09 09:39:11 -08:00
git-stash.txt
docs: add CONFIGURATION sections that map to a built-in
2022-09-07 09:46:06 -07:00
git-status.txt
status: print stash info with --porcelain=v2 --show-stash
2021-10-21 17:24:30 -07:00
git-stripspace.txt
…
git-submodule.txt
clone, submodule: pass partial clone filters to submodules
2022-02-09 15:38:36 -08:00
git-svn.txt
Merge branch 'ja/doc-cleanup'
2021-12-10 14:35:03 -08:00
git-switch.txt
docs: add CONFIGURATION sections that fuzzy map to built-ins
2022-09-07 09:46:07 -07:00
git-symbolic-ref.txt
…
git-tag.txt
Documentation: typofix --column description
2021-02-19 19:36:47 -08:00
git-tools.txt
…
git-unpack-file.txt
…
git-unpack-objects.txt
…
git-update-index.txt
Documentation: fix various repeat word typos
2022-09-12 11:04:55 -07:00
git-update-ref.txt
…
git-update-server-info.txt
…
git-upload-archive.txt
…
git-upload-pack.txt
Documentation: fix various repeat word typos
2022-09-12 11:04:55 -07:00
git-var.txt
var: add GIT_DEFAULT_BRANCH variable
2021-11-03 13:25:36 -07:00
git-verify-commit.txt
…
git-verify-pack.txt
…
git-verify-tag.txt
…
git-version.txt
documentation: add documentation for 'git version'
2021-09-14 10:05:40 -07:00
git-web--browse.txt
doc: split placeholders as individual tokens
2021-10-28 09:57:09 -07:00
git-whatchanged.txt
…
git-worktree.txt
Merge branch 'pw/worktree-list-with-z'
2022-04-04 10:56:25 -07:00
git-write-tree.txt
…
git.txt
Documentation: clean up a few misspelled word typos
2022-09-21 10:28:35 -07:00
gitattributes.txt
userdiff: add builtin diff driver for kotlin language.
2022-03-12 18:15:47 -08:00
gitcli.txt
git-cli.txt: clarify "options first and then args"
2022-01-17 11:42:25 -08:00
gitcore-tutorial.txt
…
gitcredentials.txt
doc: uniformize <URL> placeholders' case
2021-11-09 09:39:11 -08:00
gitcvs-migration.txt
…
gitdiffcore.txt
Merge branch 'en/ort-perf-batch-8'
2021-03-22 14:00:24 -07:00
giteveryday.txt
…
gitfaq.txt
Update docs for change of default merge backend
2021-08-05 15:35:02 -07:00
gitformat-bundle.txt
docs: move protocol-related docs to man section 5
2022-08-04 14:12:23 -07:00
gitformat-chunk.txt
docs: move pack format docs to man section 5
2022-08-04 14:12:24 -07:00
gitformat-commit-graph.txt
docs: move pack format docs to man section 5
2022-08-04 14:12:24 -07:00
gitformat-index.txt
Merge branch 'ab/tech-docs-to-help'
2022-08-14 23:19:28 -07:00
gitformat-pack.txt
docs: move cruft pack docs to gitformat-pack
2022-08-04 14:12:24 -07:00
gitformat-signature.txt
docs: move signature docs to man section 5
2022-08-04 14:12:24 -07:00
gitglossary.txt
…
githooks.txt
hook: add 'run' subcommand
2022-01-07 15:19:34 -08:00
gitignore.txt
gitignore.txt: change "folder" to "directory"
2021-10-25 11:06:56 -07:00
gitk.txt
…
gitmailmap.txt
docs: document symlink restrictions for dot-files
2021-05-04 11:52:03 +09:00
gitmodules.txt
docs: document symlink restrictions for dot-files
2021-05-04 11:52:03 +09:00
gitnamespaces.txt
doc lint: lint and fix missing "GIT" end sections
2021-04-10 23:36:34 -07:00
gitprotocol-capabilities.txt
docs: fix a few recently broken links
2022-09-16 08:38:03 -07:00
gitprotocol-common.txt
docs: move protocol-related docs to man section 5
2022-08-04 14:12:23 -07:00
gitprotocol-http.txt
docs: move http-protocol docs to man section 5
2022-08-04 14:12:24 -07:00
gitprotocol-pack.txt
docs: move http-protocol docs to man section 5
2022-08-04 14:12:24 -07:00
gitprotocol-v2.txt
docs: fix a few recently broken links
2022-09-16 08:38:03 -07:00
gitremote-helpers.txt
remote-curl: add 'get' capability
2022-08-10 14:07:37 -07:00
gitrepository-layout.txt
…
gitrevisions.txt
…
gitsubmodules.txt
doc: uniformize <URL> placeholders' case
2021-11-09 09:39:11 -08:00
gittutorial-2.txt
…
gittutorial.txt
Documentation: render special characters correctly
2021-07-30 09:08:12 -07:00
gitweb.conf.txt
gitweb: add "e-mail privacy" feature to redact e-mail addresses
2021-04-08 15:54:26 -07:00
gitweb.txt
gitweb.txt: change "folder" to "directory"
2021-10-25 11:06:57 -07:00
gitworkflows.txt
doc: uniformize <URL> placeholders' case
2021-11-09 09:39:11 -08:00
glossary-content.txt
glossary: describe "worktree"
2022-02-09 18:34:41 -08:00
howto-index.sh
…
i18n.txt
i18n.txt: camel case and monospace "i18n.commitEncoding"
2021-02-24 15:21:25 -08:00
install-doc-quick.sh
…
install-webdoc.sh
…
line-range-format.txt
…
line-range-options.txt
…
lint-gitlink.perl
doc lint: make "lint-docs" non-.PHONY
2021-10-15 10:29:11 -07:00
lint-man-end-blurb.perl
doc lint: emit errors on STDERR
2021-10-15 10:16:57 -07:00
lint-man-section-order.perl
git docs: add a category for file formats, protocols and interfaces
2022-08-04 14:12:23 -07:00
Makefile
Merge branch 'vd/doc-reviewing-guidelines'
2022-09-21 15:27:02 -07:00
manpage-base-url.xsl.in
…
manpage-bold-literal.xsl
…
manpage-normal.xsl
…
manpage-quote-apos.xsl
…
manpage.xsl
…
merge-options.txt
Document positive variant of commit and merge option "--no-verify"
2021-10-29 11:22:56 -07:00
merge-strategies.txt
Update docs for change of default merge backend
2021-08-05 15:35:02 -07:00
MyFirstContribution.txt
Documentation: clean up a few misspelled word typos
2022-09-21 10:28:35 -07:00
MyFirstObjectWalk.txt
Documentation: clean up a few misspelled word typos
2022-09-21 10:28:35 -07:00
object-format-disclaimer.txt
…
pretty-formats.txt
Merge branch 'es/pretty-describe-more'
2021-12-15 09:39:48 -08:00
pretty-options.txt
log: document --encoding behavior on iconv() failure
2021-10-29 14:35:59 -07:00
pull-fetch-param.txt
…
ref-reachability-filters.txt
…
rerere-options.txt
doc: clarify rerere-autoupdate
2022-08-03 13:57:25 -07:00
rev-list-description.txt
…
rev-list-options.txt
Merge branch 'en/ancestry-path-in-a-range'
2022-08-29 14:55:11 -07:00
ReviewingGuidelines.txt
Documentation: add ReviewingGuidelines
2022-09-19 14:36:08 -07:00
revisions.txt
Merge branch 'tk/rev-parse-doc-clarify-at-u' into maint
2022-07-27 13:19:52 -07:00
scalar.txt
scalar: include in standard Git build & installation
2022-09-02 10:02:55 -07:00
sequencer.txt
…
signoff-option.txt
…
SubmittingPatches
SubmittingPatches: use more stable git.ozlabs.org URL
2022-05-11 08:19:08 -07:00
texi.xsl
…
ToolsForGit.txt
Documentation/ToolsForGit.txt: Tools for developing Git
2022-04-21 09:50:25 -07:00
trace2-target-values.txt
…
transfer-data-leaks.txt
…
urls-remotes.txt
doc: uniformize <URL> placeholders' case
2021-11-09 09:39:11 -08:00
urls.txt
…
user-manual.conf
…
user-manual.txt
docs: fix a few recently broken links
2022-09-16 08:38:03 -07:00