{"thread":{"id":"63052","subject":"[PATCH 00/34] misc *.txt -> *.adoc fixes","startedAt":"2025-03-03T20:44:54Z","lastAt":"2025-03-04T00:15:09Z","messageCount":43,"participants":["Todd Zullinger","Junio C Hamano","brian m. carlson"],"isPatch":true,"patchVersion":1,"patchTotal":34},"messages":[{"id":"513435","messageId":"20250303204443.360595-1-tmz@pobox.com","threadId":"63052","inReplyTo":null,"subject":"[PATCH 00/34] misc *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:43:58Z","receivedAt":"2025-03-03T20:44:54Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"As a follow-up to , this\nseries aims to fix a good number of the remaining references\nto renamed *.txt files in our tree.\n\nThe first patch fixes an actual issue, where we were\nskipping all the tests in t0450-txt-doc-vs-help.\n\nTodd Zullinger (34):\n t0450: *.txt -> *.adoc fixes\n .gitattributes: more *.txt -> *.adoc updates\n doc: remove unneeded .gitattributes\n Makefile: update reference to technical/racy-git.adoc\n README: *.txt -> *.adoc fixes\n CodingGuidelines: *.txt -> *.adoc fixes\n MyFirstContribution: *.txt -> *.adoc fixes\n MyFirstObjectWalk: *.txt -> *.adoc fixes\n howto/new-command: update reference to builtin docs\n technical/partial-clone: update reference to rev-list-options.adoc\n doc: *.txt -> *.adoc fixes\n advice.h: *.txt -> *.adoc fixes\n apply.c: *.txt -> *.adoc fixes\n builtin.h: *.txt -> *.adoc fixes\n config.c: *.txt -> *.adoc fixes\n contrib/long-running-filter: *.txt -> *.adoc fixes\n diff.h: *.txt -> *.adoc fixes\n diffcore.h: *.txt -> *.adoc fixes\n fsck.h: *.txt -> *.adoc fixes\n list-objects-filter-options.h: *.txt -> *.adoc fixes\n object-name.c: *.txt -> *.adoc fixes\n parse-options.h: *.txt -> *.adoc fixes\n pseudo-merge.h: *.txt -> *.adoc fixes\n refs.h: *.txt -> *.adoc fixes\n setup.c: *.txt -> *.adoc fixes\n simple-ipc.h: *.txt -> *.adoc fixes\n t/helper/test-rot13-filter.c: *.txt -> *.adoc fixes\n t6012: *.txt -> *.adoc fixes\n t6434: *.txt -> *.adoc fixes\n trace2.h: *.txt -> *.adoc fixes\n trace2/tr2_sysenv.c: *.txt -> *.adoc fixes\n transport.h: *.txt -> *.adoc fixes\n unpack-trees.c: *.txt -> *.adoc fixes\n xdiff: *.txt -> *.adoc fixes\n\n .gitattributes | 6 +--\n Documentation/.gitattributes | 1 -\n Documentation/CodingGuidelines | 4 +-\n Documentation/MyFirstContribution.adoc | 24 ++++-----\n Documentation/MyFirstObjectWalk.adoc | 12 ++---\n Documentation/gitattributes.adoc | 6 +--\n Documentation/howto/new-command.adoc | 2 +-\n Documentation/technical/api-simple-ipc.adoc | 2 +-\n .../technical/hash-function-transition.adoc | 2 +-\n Documentation/technical/partial-clone.adoc | 2 +-\n Makefile | 2 +-\n README.md | 14 +++---\n advice.h | 2 +-\n apply.c | 2 +-\n builtin.h | 2 +-\n config.c | 16 +++---\n contrib/long-running-filter/example.pl | 2 +-\n diff.h | 2 +-\n diffcore.h | 2 +-\n fsck.h | 2 +-\n list-objects-filter-options.h | 2 +-\n object-name.c | 2 +-\n parse-options.h | 2 +-\n pseudo-merge.h | 2 +-\n refs.h | 2 +-\n setup.c | 2 +-\n simple-ipc.h | 2 +-\n t/helper/test-rot13-filter.c | 2 +-\n t/t0450-txt-doc-vs-help.sh | 50 +++++++++----------\n ...t-help-mismatches => adoc-help-mismatches} | 0\n t/t6012-rev-list-simplify.sh | 2 +-\n t/t6434-merge-recursive-rename-options.sh | 2 +-\n trace2.h | 2 +-\n trace2/tr2_sysenv.c | 2 +-\n transport.h | 2 +-\n unpack-trees.c | 2 +-\n xdiff/xdiff.h | 2 +-\n xdiff/xpatience.c | 2 +-\n 38 files changed, 94 insertions(+), 95 deletions(-)\n delete mode 100644 Documentation/.gitattributes\n rename t/t0450/{txt-help-mismatches => adoc-help-mismatches} (100%)\n\n-- \n2.49.0.rc0\n\n"},{"id":"513436","messageId":"20250303204443.360595-2-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 01/34] t0450: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:43:59Z","receivedAt":"2025-03-03T20:44:55Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"After 1f010d6bdf (doc: use .adoc extension for AsciiDoc files,\n2025-01-20), we no longer matched any files in this test. The result is\nthat we did not test for mismatches in the documentation and --help\noutput.\n\nAdjust the test to look at the renamed *.adoc files.\n\nSigned-off-by: Todd Zullinger \n---\n t/t0450-txt-doc-vs-help.sh | 50 +++++++++----------\n ...t-help-mismatches => adoc-help-mismatches} | 0\n 2 files changed, 25 insertions(+), 25 deletions(-)\n rename t/t0450/{txt-help-mismatches => adoc-help-mismatches} (100%)\n\ndiff --git a/t/t0450-txt-doc-vs-help.sh b/t/t0450-txt-doc-vs-help.sh\nindex 853101b86e..2f7504ae7e 100755\n--- a/t/t0450-txt-doc-vs-help.sh\n+++ b/t/t0450-txt-doc-vs-help.sh\n@@ -1,6 +1,6 @@\n #!/bin/sh\n \n-test_description='assert (unbuilt) Documentation/*.txt and -h output\n+test_description='assert (unbuilt) Documentation/*.adoc and -h output\n \n Run this with --debug to see a summary of where we still fail to make\n the two versions consistent with one another.'\n@@ -11,11 +11,11 @@ test_expect_success 'setup: list of builtins' '\n \tgit --list-cmds=builtins >builtins\n '\n \n-test_expect_success 'list of txt and help mismatches is sorted' '\n-\tsort -u \"$TEST_DIRECTORY\"/t0450/txt-help-mismatches >expect &&\n-\tif ! test_cmp expect \"$TEST_DIRECTORY\"/t0450/txt-help-mismatches\n+test_expect_success 'list of adoc and help mismatches is sorted' '\n+\tsort -u \"$TEST_DIRECTORY\"/t0450/adoc-help-mismatches >expect &&\n+\tif ! test_cmp expect \"$TEST_DIRECTORY\"/t0450/adoc-help-mismatches\n \tthen\n-\t\tBUG \"please keep the list of txt and help mismatches sorted\"\n+\t\tBUG \"please keep the list of adoc and help mismatches sorted\"\n \tfi\n '\n \n@@ -40,20 +40,20 @@ help_to_synopsis () {\n \techo \"$out\"\n }\n \n-builtin_to_txt () {\n- echo \"$GIT_BUILD_DIR/Documentation/git-$1.txt\"\n+builtin_to_adoc () {\n+ echo \"$GIT_BUILD_DIR/Documentation/git-$1.adoc\"\n }\n \n-txt_to_synopsis () {\n+adoc_to_synopsis () {\n \tbuiltin=\"$1\" &&\n \tout_dir=\"out/$builtin\" &&\n-\tout=\"$out_dir/txt.synopsis\" &&\n+\tout=\"$out_dir/adoc.synopsis\" &&\n \tif test -f \"$out\"\n \tthen\n \t\techo \"$out\" &&\n \t\treturn 0\n \tfi &&\n-\tb2t=\"$(builtin_to_txt \"$builtin\")\" &&\n+\tb2t=\"$(builtin_to_adoc \"$builtin\")\" &&\n \tsed -n \\\n \t\t-E '/^\\[(verse|synopsis)\\]$/,/^$/ {\n \t\t\t/^$/d;\n@@ -109,29 +109,29 @@ do\n \t\tfi\n \t'\n \n-\ttxt=\"$(builtin_to_txt \"$builtin\")\" &&\n-\tpreq=\"$(echo BUILTIN_TXT_$builtin | tr '[:lower:]-' '[:upper:]_')\" &&\n+\tadoc=\"$(builtin_to_adoc \"$builtin\")\" &&\n+\tpreq=\"$(echo BUILTIN_ADOC_$builtin | tr '[:lower:]-' '[:upper:]_')\" &&\n \n-\tif test -f \"$txt\"\n+\tif test -f \"$adoc\"\n \tthen\n \t\ttest_set_prereq \"$preq\"\n \tfi &&\n \n-\t# *.txt output assertions\n-\ttest_expect_success \"$preq\" \"$builtin *.txt SYNOPSIS has dashed labels\" '\n-\t\tcheck_dashed_labels \"$(txt_to_synopsis \"$builtin\")\"\n+\t# *.adoc output assertions\n+\ttest_expect_success \"$preq\" \"$builtin *.adoc SYNOPSIS has dashed labels\" '\n+\t\tcheck_dashed_labels \"$(adoc_to_synopsis \"$builtin\")\"\n \t'\n \n-\t# *.txt output consistency assertions\n+\t# *.adoc output consistency assertions\n \tresult=\n-\tif grep -q \"^$builtin$\" \"$TEST_DIRECTORY\"/t0450/txt-help-mismatches\n+\tif grep -q \"^$builtin$\" \"$TEST_DIRECTORY\"/t0450/adoc-help-mismatches\n \tthen\n \t\tresult=failure\n \telse\n \t\tresult=success\n \tfi &&\n \ttest_expect_$result \"$preq\" \"$builtin -h output and SYNOPSIS agree\" '\n-\t\tt2s=\"$(txt_to_synopsis \"$builtin\")\" &&\n+\t\tt2s=\"$(adoc_to_synopsis \"$builtin\")\" &&\n \t\tif test \"$builtin\" = \"merge-tree\"\n \t\tthen\n \t\t\ttest_when_finished \"rm -f t2s.new\" &&\n@@ -140,17 +140,17 @@ do\n \t\tfi &&\n \t\th2s=\"$(help_to_synopsis \"$builtin\")\" &&\n \n-\t\t# The *.txt and -h use different spacing for the\n+\t\t# The *.adoc and -h use different spacing for the\n \t\t# alignment of continued usage output, normalize it.\n-\t\talign_after_nl \"$builtin\" <\"$t2s\" >txt &&\n+\t\talign_after_nl \"$builtin\" <\"$t2s\" >adoc &&\n \t\talign_after_nl \"$builtin\" <\"$h2s\" >help &&\n-\t\ttest_cmp txt help\n+\t\ttest_cmp adoc help\n \t'\n \n-\tif test_have_prereq \"$preq\" && test -e txt && test -e help\n+\tif test_have_prereq \"$preq\" && test -e adoc && test -e help\n \tthen\n \t\ttest_debug '\n-\t\t\tif test_cmp txt help >cmp 2>/dev/null\n+\t\t\tif test_cmp adoc help >cmp 2>/dev/null\n \t\t\tthen\n \t\t\t\techo \"=== DONE: $builtin ===\"\n \t\t\telse\n@@ -161,7 +161,7 @@ do\n \n \t\t# Not in test_expect_success in case --run is being\n \t\t# used with --debug\n-\t\trm -f txt help tmp 2>/dev/null\n+\t\trm -f adoc help tmp 2>/dev/null\n \tfi\n done *.adoc updates","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:00Z","receivedAt":"2025-03-03T20:44:55Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"All Documentation files now end in .adoc. Update the entries for\ngit-merge.adoc, gitk.adoc, and user-manual.adoc to properly set the\nconflict-marker-size attribute.\n\nSigned-off-by: Todd Zullinger \n---\n .gitattributes | 6 +++---\n 1 file changed, 3 insertions(+), 3 deletions(-)\n\ndiff --git a/.gitattributes b/.gitattributes\nindex 43fa883a84..c6a0b35116 100644\n--- a/.gitattributes\n+++ b/.gitattributes\n@@ -12,7 +12,7 @@ CODE_OF_CONDUCT.md -whitespace\n /GIT-VERSION-GEN text eol=lf\n /mergetools/* text eol=lf\n /t/oid-info/* text eol=lf\n-/Documentation/git-merge.txt conflict-marker-size=32\n-/Documentation/gitk.txt conflict-marker-size=32\n-/Documentation/user-manual.txt conflict-marker-size=32\n+/Documentation/git-merge.adoc conflict-marker-size=32\n+/Documentation/gitk.adoc conflict-marker-size=32\n+/Documentation/user-manual.adoc conflict-marker-size=32\n /t/t????-*.sh conflict-marker-size=32\n-- \n2.49.0.rc0\n\n"},{"id":"513438","messageId":"20250303204443.360595-4-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 03/34] doc: remove unneeded .gitattributes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:01Z","receivedAt":"2025-03-03T20:44:56Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"The top-level .gitattributes file contains entries for the Documentation\ntree. Documentation/.gitattributes has not been touched since it was\nadded in 14f9e128d3 (Define the project whitespace policy, 2008-02-10).\n\nSigned-off-by: Todd Zullinger \n---\n Documentation/.gitattributes | 1 -\n 1 file changed, 1 deletion(-)\n delete mode 100644 Documentation/.gitattributes\n\ndiff --git a/Documentation/.gitattributes b/Documentation/.gitattributes\ndeleted file mode 100644\nindex ddb030137d..0000000000\n--- a/Documentation/.gitattributes\n+++ /dev/null\n@@ -1 +0,0 @@\n-*.txt whitespace\n-- \n2.49.0.rc0\n\n"},{"id":"513439","messageId":"20250303204443.360595-5-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 04/34] Makefile: update reference to technical/racy-git.adoc","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:02Z","receivedAt":"2025-03-03T20:44:57Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n Makefile | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/Makefile b/Makefile\nindex a9b2de0692..a8012569da 100644\n--- a/Makefile\n+++ b/Makefile\n@@ -194,7 +194,7 @@ include shared.mak\n # Linux, kernel 2.6.11 or newer is required for reliable sub-second file times\n # on file systems with exactly 1 ns or 1 s resolution. If you intend to use Git\n # on other file systems (e.g. CEPH, CIFS, NTFS, UDF), don't enable USE_NSEC. See\n-# Documentation/technical/racy-git.txt for details.\n+# Documentation/technical/racy-git.adoc for details.\n #\n # Define USE_ST_TIMESPEC if your \"struct stat\" uses \"st_ctimespec\" instead of\n # \"st_ctim\"\n-- \n2.49.0.rc0\n\n"},{"id":"513440","messageId":"20250303204443.360595-6-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 05/34] README: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:03Z","receivedAt":"2025-03-03T20:44:57Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n README.md | 14 +++++++-------\n 1 file changed, 7 insertions(+), 7 deletions(-)\n\ndiff --git a/README.md b/README.md\nindex 665ce5f5a8..d87bca1b8c 100644\n--- a/README.md\n+++ b/README.md\n@@ -17,15 +17,15 @@ Please read the file [INSTALL][] for installation instructions.\n Many Git online resources are accessible from \n including full documentation and Git related tools.\n \n-See [Documentation/gittutorial.txt][] to get started, then see\n-[Documentation/giteveryday.txt][] for a useful minimum set of commands, and\n-`Documentation/git-.txt` for documentation of each command.\n+See [Documentation/gittutorial.adoc][] to get started, then see\n+[Documentation/giteveryday.adoc][] for a useful minimum set of commands, and\n+`Documentation/git-.adoc` for documentation of each command.\n If git has been correctly installed, then the tutorial can also be\n read with `man gittutorial` or `git help tutorial`, and the\n documentation of each command with `man git-` or `git help\n `.\n \n-CVS users may also want to read [Documentation/gitcvs-migration.txt][]\n+CVS users may also want to read [Documentation/gitcvs-migration.adoc][]\n (`man gitcvs-migration` or `git help cvs-migration` if git is\n installed).\n \n@@ -66,9 +66,9 @@ and the name as (depending on your mood):\n - \"goddamn idiotic truckload of sh*t\": when it breaks\n \n [INSTALL]: INSTALL\n-[Documentation/gittutorial.txt]: Documentation/gittutorial.txt\n-[Documentation/giteveryday.txt]: Documentation/giteveryday.txt\n-[Documentation/gitcvs-migration.txt]: Documentation/gitcvs-migration.txt\n+[Documentation/gittutorial.adoc]: Documentation/gittutorial.adoc\n+[Documentation/giteveryday.adoc]: Documentation/giteveryday.adoc\n+[Documentation/gitcvs-migration.adoc]: Documentation/gitcvs-migration.adoc\n [Documentation/SubmittingPatches]: Documentation/SubmittingPatches\n [Documentation/CodingGuidelines]: Documentation/CodingGuidelines\n [po/README.md]: po/README.md\n-- \n2.49.0.rc0\n\n"},{"id":"513441","messageId":"20250303204443.360595-7-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 06/34] CodingGuidelines: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:04Z","receivedAt":"2025-03-03T20:44:58Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n Documentation/CodingGuidelines | 4 ++--\n 1 file changed, 2 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/CodingGuidelines b/Documentation/CodingGuidelines\nindex ba047ed224..a0e7041c54 100644\n--- a/Documentation/CodingGuidelines\n+++ b/Documentation/CodingGuidelines\n@@ -44,7 +44,7 @@ code are expected to match the style the surrounding code already\n uses (even if it doesn't match the overall style of existing code).\n \n But if you must have a list of rules, here are some language\n-specific ones. Note that Documentation/ToolsForGit.txt document\n+specific ones. Note that Documentation/ToolsForGit.adoc document\n has a collection of tips to help you use some external tools\n to conform to these guidelines.\n \n@@ -755,7 +755,7 @@ Externally Visible Names\n Writing Documentation:\n \n Most (if not all) of the documentation pages are written in the\n- AsciiDoc format in *.txt files (e.g. Documentation/git.txt), and\n+ AsciiDoc format in *.adoc files (e.g. Documentation/git.adoc), and\n processed into HTML and manpages (e.g. git.html and git.1 in the\n same directory).\n \n-- \n2.49.0.rc0\n\n"},{"id":"513442","messageId":"20250303204443.360595-8-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 07/34] MyFirstContribution: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:05Z","receivedAt":"2025-03-03T20:44:59Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n Documentation/MyFirstContribution.adoc | 24 ++++++++++++------------\n 1 file changed, 12 insertions(+), 12 deletions(-)\n\ndiff --git a/Documentation/MyFirstContribution.adoc b/Documentation/MyFirstContribution.adoc\nindex e41654c00a..afcf4b46c1 100644\n--- a/Documentation/MyFirstContribution.adoc\n+++ b/Documentation/MyFirstContribution.adoc\n@@ -21,7 +21,7 @@ This tutorial aims to summarize the following documents, but the reader may find\n useful additional context:\n \n - `Documentation/SubmittingPatches`\n-- `Documentation/howto/new-command.txt`\n+- `Documentation/howto/new-command.adoc`\n \n [[getting-help]]\n === Getting Help\n@@ -331,7 +331,7 @@ function body:\n apply standard precedence rules. `git_config_get_string_tmp()` will look up\n a specific key (\"user.name\") and give you the value. There are a number of\n single-key lookup functions like this one; you can see them all (and more info\n-about how to use `git_config()`) in `Documentation/technical/api-config.txt`.\n+about how to use `git_config()`) in `Documentation/technical/api-config.adoc`.\n \n You should see that the name printed matches the one you see when you run:\n \n@@ -461,10 +461,10 @@ $ ./bin-wrappers/git help psuh\n \n Your new command is undocumented! Let's fix that.\n \n-Take a look at `Documentation/git-*.txt`. These are the manpages for the\n+Take a look at `Documentation/git-*.adoc`. These are the manpages for the\n subcommands that Git knows about. You can open these up and take a look to get\n acquainted with the format, but then go ahead and make a new file\n-`Documentation/git-psuh.txt`. Like with most of the documentation in the Git\n+`Documentation/git-psuh.adoc`. Like with most of the documentation in the Git\n project, help pages are written with AsciiDoc (see CodingGuidelines, \"Writing\n Documentation\" section). Use the following template to fill out your own\n manpage:\n@@ -543,7 +543,7 @@ Try and run `./bin-wrappers/git psuh -h`. Your command should crash at the end.\n That's because `-h` is a special case which your command should handle by\n printing usage.\n \n-Take a look at `Documentation/technical/api-parse-options.txt`. This is a handy\n+Take a look at `Documentation/technical/api-parse-options.adoc`. This is a handy\n tool for pulling out options you need to be able to handle, and it takes a\n usage string.\n \n@@ -1088,14 +1088,14 @@ This gives reviewers a summary of what they're in for when reviewing your topic.\n The one generated for `psuh` from the sample implementation looks like this:\n \n ----\n- Documentation/git-psuh.txt | 40 +++++++++++++++++++++\n- Makefile | 1 +\n- builtin.h | 1 +\n- builtin/psuh.c | 73 ++++++++++++++++++++++++++++++++++++++\n- git.c | 1 +\n- t/t9999-psuh-tutorial.sh | 12 +++++++\n+ Documentation/git-psuh.adoc | 40 +++++++++++++++++++++\n+ Makefile | 1 +\n+ builtin.h | 1 +\n+ builtin/psuh.c | 73 ++++++++++++++++++++++++++++++++++++++\n+ git.c | 1 +\n+ t/t9999-psuh-tutorial.sh | 12 +++++++\n 6 files changed, 128 insertions(+)\n- create mode 100644 Documentation/git-psuh.txt\n+ create mode 100644 Documentation/git-psuh.adoc\n create mode 100644 builtin/psuh.c\n create mode 100755 t/t9999-psuh-tutorial.sh\n ----\n-- \n2.49.0.rc0\n\n"},{"id":"513443","messageId":"20250303204443.360595-9-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 08/34] MyFirstObjectWalk: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:06Z","receivedAt":"2025-03-03T20:45:00Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n Documentation/MyFirstObjectWalk.adoc | 12 ++++++------\n 1 file changed, 6 insertions(+), 6 deletions(-)\n\ndiff --git a/Documentation/MyFirstObjectWalk.adoc b/Documentation/MyFirstObjectWalk.adoc\nindex dec8afe5b1..d6e9dfdbbe 100644\n--- a/Documentation/MyFirstObjectWalk.adoc\n+++ b/Documentation/MyFirstObjectWalk.adoc\n@@ -15,7 +15,7 @@ revision walk is used for operations like `git log`.\n \n === Related Reading\n \n-- `Documentation/user-manual.txt` under \"Hacking Git\" contains some coverage of\n+- `Documentation/user-manual.adoc` under \"Hacking Git\" contains some coverage of\n the revision walker in its various incarnations.\n - `revision.h`\n - https://eagain.net/articles/git-for-computer-scientists/[Git for Computer Scientists]\n@@ -112,7 +112,7 @@ $ GIT_TRACE=1 ./bin-wrappers/git walken\n ----\n \n NOTE: For a more exhaustive overview of the new command process, take a look at\n-`Documentation/MyFirstContribution.txt`.\n+`Documentation/MyFirstContribution.adoc`.\n \n NOTE: A reference implementation can be found at\n https://github.com/nasamuffin/git/tree/revwalk.\n@@ -132,7 +132,7 @@ used to track the allocated size of the list.\n Per entry, we find:\n \n `item` is the object provided upon which to base the object walk. Items in Git\n-can be blobs, trees, commits, or tags. (See `Documentation/gittutorial-2.txt`.)\n+can be blobs, trees, commits, or tags. (See `Documentation/gittutorial-2.adoc`.)\n \n `name` is the object ID (OID) of the object - a hex string you may be familiar\n with from using Git to organize your source in the past. Check the tutorial\n@@ -141,7 +141,7 @@ from.\n \n `whence` indicates some information about what to do with the parents of the\n specified object. We'll explore this flag more later on; take a look at\n-`Documentation/revisions.txt` to get an idea of what could set the `whence`\n+`Documentation/revisions.adoc` to get an idea of what could set the `whence`\n value.\n \n `flags` are used to hint the beginning of the revision walk and are the first\n@@ -153,7 +153,7 @@ can be used during the walk, as well.\n \n This one is quite a bit longer, and many fields are only used during the walk\n by `revision.c` - not configuration options. Most of the configurable flags in\n-`struct rev_info` have a mirror in `Documentation/rev-list-options.txt`. It's a\n+`struct rev_info` have a mirror in `Documentation/rev-list-options.adoc`. It's a\n good idea to take some time and read through that document.\n \n == Basic Commit Walk\n@@ -710,7 +710,7 @@ objects grows along with the Git project.\n === Adding a Filter\n \n There are a handful of filters that we can apply to the object walk laid out in\n-`Documentation/rev-list-options.txt`. These filters are typically useful for\n+`Documentation/rev-list-options.adoc`. These filters are typically useful for\n operations such as creating packfiles or performing a partial clone. They are\n defined in `list-objects-filter-options.h`. For the purposes of this tutorial we\n will use the \"tree:1\" filter, which causes the walk to omit all trees and blobs\n-- \n2.49.0.rc0\n\n"},{"id":"513444","messageId":"20250303204443.360595-10-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 09/34] howto/new-command: update reference to builtin docs","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:07Z","receivedAt":"2025-03-03T20:45:00Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Commit ec14d4ecb5 (builtin.h: take over documentation from\napi-builtin.txt, 2017-08-02) deleted api-builtin.txt and moved the\ncontents into builtin.h. Most of the references were fixed in\nd85e9448dd (new-command.txt: update reference to builtin docs,\n2023-02-04), but one remained. Fix it.\n\nSigned-off-by: Todd Zullinger \n---\n Documentation/howto/new-command.adoc | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/Documentation/howto/new-command.adoc b/Documentation/howto/new-command.adoc\nindex 880c51112b..ac73c98be7 100644\n--- a/Documentation/howto/new-command.adoc\n+++ b/Documentation/howto/new-command.adoc\n@@ -48,7 +48,7 @@ binary); this organization makes it easy for people reading the code\n to find things.\n \n See the CodingGuidelines document for other guidance on what we consider\n-good practice in C and shell, and api-builtin.txt for the support\n+good practice in C and shell, and builtin.h for the support\n functions available to built-in commands written in C.\n \n What every extension command needs\n-- \n2.49.0.rc0\n\n"},{"id":"513445","messageId":"20250303204443.360595-11-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 10/34] technical/partial-clone: update reference to rev-list-options.adoc","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:08Z","receivedAt":"2025-03-03T20:45:01Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n Documentation/technical/partial-clone.adoc | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/Documentation/technical/partial-clone.adoc b/Documentation/technical/partial-clone.adoc\nindex bf5ec5c82d..e513e391ea 100644\n--- a/Documentation/technical/partial-clone.adoc\n+++ b/Documentation/technical/partial-clone.adoc\n@@ -85,7 +85,7 @@ See \"filter\" in linkgit:gitprotocol-pack[5].\n server to request filtering during packfile construction.\n +\n There are various filters available to accommodate different situations.\n-See \"--filter=\" in Documentation/rev-list-options.txt.\n+See \"--filter=\" in Documentation/rev-list-options.adoc.\n \n - On the server pack-objects applies the requested filter-spec as it\n creates \"filtered\" packfiles for the client.\n-- \n2.49.0.rc0\n\n"},{"id":"513446","messageId":"20250303204443.360595-12-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 11/34] doc: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:09Z","receivedAt":"2025-03-03T20:45:01Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Update a few more instances of Documentation/*.txt files which have been\nrenamed to *.adoc.\n\nSigned-off-by: Todd Zullinger \n---\n Documentation/gitattributes.adoc | 6 +++---\n Documentation/technical/api-simple-ipc.adoc | 2 +-\n Documentation/technical/hash-function-transition.adoc | 2 +-\n 3 files changed, 5 insertions(+), 5 deletions(-)\n\ndiff --git a/Documentation/gitattributes.adoc b/Documentation/gitattributes.adoc\nindex 7eaca89972..a22d1ef1e1 100644\n--- a/Documentation/gitattributes.adoc\n+++ b/Documentation/gitattributes.adoc\n@@ -513,7 +513,7 @@ If the filter command (a string value) is defined via\n `filter..process` then Git can process all blobs with a\n single filter invocation for the entire life of a single Git\n command. This is achieved by using the long-running process protocol\n-(described in technical/long-running-process-protocol.txt).\n+(described in Documentation/technical/long-running-process-protocol.adoc).\n \n When Git encounters the first file that needs to be cleaned or smudged,\n it starts the filter and performs the handshake. In the handshake, the\n@@ -1177,11 +1177,11 @@ integer has a meaningful effect.\n \n For example, this line in `.gitattributes` can be used to tell the merge\n machinery to leave much longer (instead of the usual 7-character-long)\n-conflict markers when merging the file `Documentation/git-merge.txt`\n+conflict markers when merging the file `Documentation/git-merge.adoc`\n results in a conflict.\n \n ------------------------\n-Documentation/git-merge.txt\tconflict-marker-size=32\n+Documentation/git-merge.adoc\tconflict-marker-size=32\n ------------------------\n \n \ndiff --git a/Documentation/technical/api-simple-ipc.adoc b/Documentation/technical/api-simple-ipc.adoc\nindex c4fb152b23..972178b042 100644\n--- a/Documentation/technical/api-simple-ipc.adoc\n+++ b/Documentation/technical/api-simple-ipc.adoc\n@@ -36,7 +36,7 @@ Comparison with sub-process model\n ---------------------------------\n \n The Simple-IPC mechanism differs from the existing `sub-process.c`\n-model (Documentation/technical/long-running-process-protocol.txt) and\n+model (Documentation/technical/long-running-process-protocol.adoc) and\n used by applications like Git-LFS. In the LFS-style sub-process model,\n the helper is started by the foreground process, communication happens\n via a pair of file descriptors bound to the stdin/stdout of the\ndiff --git a/Documentation/technical/hash-function-transition.adoc b/Documentation/technical/hash-function-transition.adoc\nindex 7102c7c8f5..f047fd80ca 100644\n--- a/Documentation/technical/hash-function-transition.adoc\n+++ b/Documentation/technical/hash-function-transition.adoc\n@@ -394,7 +394,7 @@ inflated again in step 3, for a total of two inflations.\n \n Step 4 is probably necessary for good read-time performance. \"git\n pack-objects\" on the server optimizes the pack file for good data\n-locality (see Documentation/technical/pack-heuristics.txt).\n+locality (see Documentation/technical/pack-heuristics.adoc).\n \n Details of this process are likely to change. It will take some\n experimenting to get this to perform well.\n-- \n2.49.0.rc0\n\n"},{"id":"513447","messageId":"20250303204443.360595-13-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 12/34] advice.h: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:10Z","receivedAt":"2025-03-03T20:45:02Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n advice.h | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/advice.h b/advice.h\nindex cf2284ec43..d233cfc693 100644\n--- a/advice.h\n+++ b/advice.h\n@@ -7,7 +7,7 @@ struct string_list;\n * To add a new advice, you need to:\n * Define a new advice_type.\n * Add a new entry to advice_setting array.\n- * Add the new config variable to Documentation/config/advice.txt.\n+ * Add the new config variable to Documentation/config/advice.adoc.\n * Call advise_if_enabled to print your advice.\n */\n enum advice_type {\n-- \n2.49.0.rc0\n\n"},{"id":"513448","messageId":"20250303204443.360595-14-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 13/34] apply.c: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:11Z","receivedAt":"2025-03-03T20:45:03Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n apply.c | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/apply.c b/apply.c\nindex b124678b93..f274a37948 100644\n--- a/apply.c\n+++ b/apply.c\n@@ -82,7 +82,7 @@ static int parse_whitespace_option(struct apply_state *state, const char *option\n \t}\n \t/*\n \t * Please update $__git_whitespacelist in git-completion.bash,\n-\t * Documentation/git-apply.txt, and Documentation/git-am.txt\n+\t * Documentation/git-apply.adoc, and Documentation/git-am.adoc\n \t * when you add new options.\n \t */\n \treturn error(_(\"unrecognized whitespace option '%s'\"), option);\n-- \n2.49.0.rc0\n\n"},{"id":"513449","messageId":"20250303204443.360595-15-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 14/34] builtin.h: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:12Z","receivedAt":"2025-03-03T20:45:04Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n builtin.h | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/builtin.h b/builtin.h\nindex 89928ccf92..993a583872 100644\n--- a/builtin.h\n+++ b/builtin.h\n@@ -63,7 +63,7 @@\n *\n * . Add tests to `t/` directory.\n *\n- * . Write documentation in `Documentation/git-foo.txt`.\n+ * . Write documentation in `Documentation/git-foo.adoc`.\n *\n * . Add an entry for `git-foo` to `command-list.txt`.\n *\n-- \n2.49.0.rc0\n\n"},{"id":"513450","messageId":"20250303204443.360595-16-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 15/34] config.c: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:13Z","receivedAt":"2025-03-03T20:45:04Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n config.c | 16 ++++++++--------\n 1 file changed, 8 insertions(+), 8 deletions(-)\n\ndiff --git a/config.c b/config.c\nindex 36f76fafe5..dcb5cb5265 100644\n--- a/config.c\n+++ b/config.c\n@@ -1652,7 +1652,7 @@ static int git_default_core_config(const char *var, const char *value,\n \t\treturn 0;\n \t}\n \n-\t/* Add other config variables here and to Documentation/config.txt. */\n+\t/* Add other config variables here and to Documentation/config.adoc. */\n \treturn platform_core_config(var, value, ctx, cb);\n }\n \n@@ -1663,7 +1663,7 @@ static int git_default_sparse_config(const char *var, const char *value)\n \t\treturn 0;\n \t}\n \n-\t/* Add other config variables here and to Documentation/config/sparse.txt. */\n+\t/* Add other config variables here and to Documentation/config/sparse.adoc. */\n \treturn 0;\n }\n \n@@ -1679,7 +1679,7 @@ static int git_default_i18n_config(const char *var, const char *value)\n \t\treturn git_config_string(&git_log_output_encoding, var, value);\n \t}\n \n-\t/* Add other config variables here and to Documentation/config.txt. */\n+\t/* Add other config variables here and to Documentation/config.adoc. */\n \treturn 0;\n }\n \n@@ -1715,7 +1715,7 @@ static int git_default_branch_config(const char *var, const char *value)\n \t\treturn 0;\n \t}\n \n-\t/* Add other config variables here and to Documentation/config.txt. */\n+\t/* Add other config variables here and to Documentation/config.adoc. */\n \treturn 0;\n }\n \n@@ -1744,7 +1744,7 @@ static int git_default_push_config(const char *var, const char *value)\n \t\treturn 0;\n \t}\n \n-\t/* Add other config variables here and to Documentation/config.txt. */\n+\t/* Add other config variables here and to Documentation/config.adoc. */\n \treturn 0;\n }\n \n@@ -1760,7 +1760,7 @@ static int git_default_mailmap_config(const char *var, const char *value)\n \t\treturn git_config_string(&git_mailmap_blob, var, value);\n \t}\n \n-\t/* Add other config variables here and to Documentation/config.txt. */\n+\t/* Add other config variables here and to Documentation/config.adoc. */\n \treturn 0;\n }\n \n@@ -1773,7 +1773,7 @@ static int git_default_attr_config(const char *var, const char *value)\n \n \t/*\n \t * Add other attribute related config variables here and to\n-\t * Documentation/config/attr.txt.\n+\t * Documentation/config/attr.adoc.\n \t */\n \treturn 0;\n }\n@@ -1831,7 +1831,7 @@ int git_default_config(const char *var, const char *value,\n \tif (starts_with(var, \"sparse.\"))\n \t\treturn git_default_sparse_config(var, value);\n \n-\t/* Add other config variables here and to Documentation/config.txt. */\n+\t/* Add other config variables here and to Documentation/config.adoc. */\n \treturn 0;\n }\n \n-- \n2.49.0.rc0\n\n"},{"id":"513451","messageId":"20250303204443.360595-17-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 16/34] contrib/long-running-filter: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:14Z","receivedAt":"2025-03-03T20:45:05Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n contrib/long-running-filter/example.pl | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/contrib/long-running-filter/example.pl b/contrib/long-running-filter/example.pl\nindex a677569ddd..4b83e4c5e8 100755\n--- a/contrib/long-running-filter/example.pl\n+++ b/contrib/long-running-filter/example.pl\n@@ -1,7 +1,7 @@\n #!/usr/bin/perl\n #\n # Example implementation for the Git filter protocol version 2\n-# See Documentation/gitattributes.txt, section \"Filter Protocol\"\n+# See Documentation/gitattributes.adoc, section \"Filter Protocol\"\n #\n # Please note, this pass-thru filter is a minimal skeleton. No proper\n # error handling was implemented.\n-- \n2.49.0.rc0\n\n"},{"id":"513452","messageId":"20250303204443.360595-18-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 17/34] diff.h: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:15Z","receivedAt":"2025-03-03T20:45:06Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n diff.h | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/diff.h b/diff.h\nindex 0a566f5531..ff0348e4a9 100644\n--- a/diff.h\n+++ b/diff.h\n@@ -333,7 +333,7 @@ struct diff_options {\n \tint xdl_opts;\n \tint ignore_driver_algorithm;\n \n-\t/* see Documentation/diff-options.txt */\n+\t/* see Documentation/diff-options.adoc */\n \tchar **anchors;\n \tsize_t anchors_nr, anchors_alloc;\n \n-- \n2.49.0.rc0\n\n"},{"id":"513453","messageId":"20250303204443.360595-19-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 18/34] diffcore.h: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:16Z","receivedAt":"2025-03-03T20:45:06Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n diffcore.h | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/diffcore.h b/diffcore.h\nindex 2feb325031..9c0a0e7aaf 100644\n--- a/diffcore.h\n+++ b/diffcore.h\n@@ -107,7 +107,7 @@ struct diff_filepair {\n \tstruct diff_filespec *one;\n \tstruct diff_filespec *two;\n \tunsigned short int score;\n-\tchar status; /* M C R A D U etc. (see Documentation/diff-format.txt or DIFF_STATUS_* in diff.h) */\n+\tchar status; /* M C R A D U etc. (see Documentation/diff-format.adoc or DIFF_STATUS_* in diff.h) */\n \tunsigned broken_pair : 1;\n \tunsigned renamed_pair : 1;\n \tunsigned is_unmerged : 1;\n-- \n2.49.0.rc0\n\n"},{"id":"513454","messageId":"20250303204443.360595-20-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 19/34] fsck.h: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:17Z","receivedAt":"2025-03-03T20:45:07Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n fsck.h | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/fsck.h b/fsck.h\nindex a44c231a5f..a95ae7eb84 100644\n--- a/fsck.h\n+++ b/fsck.h\n@@ -15,7 +15,7 @@ enum fsck_msg_type {\n };\n \n /*\n- * Documentation/fsck-msgids.txt documents these; when\n+ * Documentation/fsck-msgids.adoc documents these; when\n * modifying this list in any way, make sure to keep the\n * two in sync.\n */\n-- \n2.49.0.rc0\n\n"},{"id":"513455","messageId":"20250303204443.360595-21-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 20/34] list-objects-filter-options.h: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:18Z","receivedAt":"2025-03-03T20:45:08Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n list-objects-filter-options.h | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/list-objects-filter-options.h b/list-objects-filter-options.h\nindex 55fab8563d..7b2108b986 100644\n--- a/list-objects-filter-options.h\n+++ b/list-objects-filter-options.h\n@@ -82,7 +82,7 @@ void list_objects_filter_init(struct list_objects_filter_options *filter_options\n * \"filter\" SP \n *\n * The filter keyword will be used by many commands.\n- * See Documentation/rev-list-options.txt for allowed values for .\n+ * See Documentation/rev-list-options.adoc for allowed values for .\n *\n * Capture the given arg as the \"filter_spec\". This can be forwarded to\n * subordinate commands when necessary (although it's better to pass it through\n-- \n2.49.0.rc0\n\n"},{"id":"513456","messageId":"20250303204443.360595-22-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 21/34] object-name.c: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:19Z","receivedAt":"2025-03-03T20:45:08Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n object-name.c | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/object-name.c b/object-name.c\nindex 945d5bdef2..76749fbfe6 100644\n--- a/object-name.c\n+++ b/object-name.c\n@@ -1273,7 +1273,7 @@ static int peel_onion(struct repository *r, const char *name, int len,\n }\n \n /*\n- * Documentation/revisions.txt says:\n+ * Documentation/revisions.adoc says:\n * '', e.g. 'v1.7.4.2-679-g3bee7fb'::\n * Output from `git describe`; i.e. a closest tag, optionally\n * followed by a dash and a number of commits, followed by a dash, a\n-- \n2.49.0.rc0\n\n"},{"id":"513457","messageId":"20250303204443.360595-23-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 22/34] parse-options.h: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:20Z","receivedAt":"2025-03-03T20:45:09Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n parse-options.h | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/parse-options.h b/parse-options.h\nindex fca944d9a9..997ffbee80 100644\n--- a/parse-options.h\n+++ b/parse-options.h\n@@ -6,7 +6,7 @@\n struct repository;\n \n /**\n- * Refer to Documentation/technical/api-parse-options.txt for the API doc.\n+ * Refer to Documentation/technical/api-parse-options.adoc for the API doc.\n */\n \n enum parse_opt_type {\n-- \n2.49.0.rc0\n\n"},{"id":"513458","messageId":"20250303204443.360595-24-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 23/34] pseudo-merge.h: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:21Z","receivedAt":"2025-03-03T20:45:10Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n pseudo-merge.h | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/pseudo-merge.h b/pseudo-merge.h\nindex 29df8a32ec..c9fbe9d312 100644\n--- a/pseudo-merge.h\n+++ b/pseudo-merge.h\n@@ -101,7 +101,7 @@ void select_pseudo_merges(struct bitmap_writer *writer);\n \n /*\n * Represents a serialized view of a file containing pseudo-merge(s)\n- * (see Documentation/technical/bitmap-format.txt for a specification\n+ * (see Documentation/technical/bitmap-format.adoc for a specification\n * of the format).\n */\n struct pseudo_merge_map {\n-- \n2.49.0.rc0\n\n"},{"id":"513459","messageId":"20250303204443.360595-25-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 24/34] refs.h: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:22Z","receivedAt":"2025-03-03T20:45:10Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n refs.h | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/refs.h b/refs.h\nindex 09be47afbe..31c67a71b2 100644\n--- a/refs.h\n+++ b/refs.h\n@@ -577,7 +577,7 @@ int refs_for_each_reflog(struct ref_store *refs, each_reflog_fn fn, void *cb_dat\n \n /*\n * Return 0 iff refname has the correct format for a refname according\n- * to the rules described in Documentation/git-check-ref-format.txt.\n+ * to the rules described in Documentation/git-check-ref-format.adoc.\n * If REFNAME_ALLOW_ONELEVEL is set in flags, then accept one-level\n * reference names. If REFNAME_REFSPEC_PATTERN is set in flags, then\n * allow a single \"*\" wildcard character in the refspec. No leading or\n-- \n2.49.0.rc0\n\n"},{"id":"513460","messageId":"20250303204443.360595-26-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 25/34] setup.c: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:23Z","receivedAt":"2025-03-03T20:45:11Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n setup.c | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/setup.c b/setup.c\nindex 7da7aa8984..801bd8c1ee 100644\n--- a/setup.c\n+++ b/setup.c\n@@ -1822,7 +1822,7 @@ const char *setup_git_directory_gently(int *nongit_ok)\n \t *\n \t * Regardless of the state of nongit_ok, startup_info->prefix and\n \t * the GIT_PREFIX environment variable must always match. For details\n-\t * see Documentation/config/alias.txt.\n+\t * see Documentation/config/alias.adoc.\n \t */\n \tif (nongit_ok && *nongit_ok)\n \t\tstartup_info->have_repository = 0;\n-- \n2.49.0.rc0\n\n"},{"id":"513461","messageId":"20250303204443.360595-27-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 26/34] simple-ipc.h: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:24Z","receivedAt":"2025-03-03T20:45:12Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n simple-ipc.h | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/simple-ipc.h b/simple-ipc.h\nindex 3916eaf70d..701e005cb8 100644\n--- a/simple-ipc.h\n+++ b/simple-ipc.h\n@@ -2,7 +2,7 @@\n #define GIT_SIMPLE_IPC_H\n \n /*\n- * See Documentation/technical/api-simple-ipc.txt\n+ * See Documentation/technical/api-simple-ipc.adoc\n */\n \n enum ipc_active_state {\n-- \n2.49.0.rc0\n\n"},{"id":"513462","messageId":"20250303204443.360595-28-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 27/34] t/helper/test-rot13-filter.c: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:25Z","receivedAt":"2025-03-03T20:45:13Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n t/helper/test-rot13-filter.c | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/t/helper/test-rot13-filter.c b/t/helper/test-rot13-filter.c\nindex ff407b575c..722b1cbe77 100644\n--- a/t/helper/test-rot13-filter.c\n+++ b/t/helper/test-rot13-filter.c\n@@ -1,6 +1,6 @@\n /*\n * Example implementation for the Git filter protocol version 2\n- * See Documentation/gitattributes.txt, section \"Filter Protocol\"\n+ * See Documentation/gitattributes.adoc, section \"Filter Protocol\"\n *\n * Usage: test-tool rot13-filter [--always-delay] --log= \n *\n-- \n2.49.0.rc0\n\n"},{"id":"513463","messageId":"20250303204443.360595-29-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 28/34] t6012: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:26Z","receivedAt":"2025-03-03T20:45:13Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n t/t6012-rev-list-simplify.sh | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/t/t6012-rev-list-simplify.sh b/t/t6012-rev-list-simplify.sh\nindex de1e87f162..4cecb6224c 100755\n--- a/t/t6012-rev-list-simplify.sh\n+++ b/t/t6012-rev-list-simplify.sh\n@@ -177,7 +177,7 @@ test_expect_success '--full-diff is not affected by --parents' '\n # \\ / /\\ /\n # `---X--' `---Y--'\n #\n-# This example is explained in Documentation/rev-list-options.txt\n+# This example is explained in Documentation/rev-list-options.adoc\n \n test_expect_success 'setup rebuild repo' '\n \trm -rf .git * &&\n-- \n2.49.0.rc0\n\n"},{"id":"513464","messageId":"20250303204443.360595-30-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 29/34] t6434: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:27Z","receivedAt":"2025-03-03T20:45:14Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n t/t6434-merge-recursive-rename-options.sh | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/t/t6434-merge-recursive-rename-options.sh b/t/t6434-merge-recursive-rename-options.sh\nindex a11707835b..6e913c30a1 100755\n--- a/t/t6434-merge-recursive-rename-options.sh\n+++ b/t/t6434-merge-recursive-rename-options.sh\n@@ -22,7 +22,7 @@ R075 2-old 2-new\n R100 3-old 3-new\n \n Actual similarity indices are parsed from diff output. We rely on the fact that\n-they are rounded down (see, e.g., Documentation/diff-generate-patch.txt, which\n+they are rounded down (see, e.g., Documentation/diff-generate-patch.adoc, which\n mentions this in a different context).\n '\n \n-- \n2.49.0.rc0\n\n"},{"id":"513465","messageId":"20250303204443.360595-31-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 30/34] trace2.h: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:28Z","receivedAt":"2025-03-03T20:45:15Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n trace2.h | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/trace2.h b/trace2.h\nindex 901f39253a..e4f23784e4 100644\n--- a/trace2.h\n+++ b/trace2.h\n@@ -31,7 +31,7 @@\n *\n * For more info about: trace2 targets, conventions for public functions and\n * macros, trace2 target formats and examples on trace2 API usage refer to\n- * Documentation/technical/api-trace2.txt\n+ * Documentation/technical/api-trace2.adoc\n *\n */\n \n-- \n2.49.0.rc0\n\n"},{"id":"513466","messageId":"20250303204443.360595-32-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 31/34] trace2/tr2_sysenv.c: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:29Z","receivedAt":"2025-03-03T20:45:15Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n trace2/tr2_sysenv.c | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/trace2/tr2_sysenv.c b/trace2/tr2_sysenv.c\nindex 01379c5cad..4abc218514 100644\n--- a/trace2/tr2_sysenv.c\n+++ b/trace2/tr2_sysenv.c\n@@ -7,7 +7,7 @@\n \n /*\n * Each entry represents a trace2 setting.\n- * See Documentation/technical/api-trace2.txt\n+ * See Documentation/technical/api-trace2.adoc\n */\n struct tr2_sysenv_entry {\n \tconst char *env_var_name;\n-- \n2.49.0.rc0\n\n"},{"id":"513467","messageId":"20250303204443.360595-33-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 32/34] transport.h: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:30Z","receivedAt":"2025-03-03T20:45:16Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n transport.h | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/transport.h b/transport.h\nindex 44100fa9b7..892f19454a 100644\n--- a/transport.h\n+++ b/transport.h\n@@ -168,7 +168,7 @@ struct transport *transport_get(struct remote *, const char *);\n * Check whether a transport is allowed by the environment.\n *\n * Type should generally be the URL scheme, as described in\n- * Documentation/git.txt\n+ * Documentation/git.adoc\n *\n * from_user specifies if the transport was given by the user. If unknown pass\n * a -1 to read from the environment to determine if the transport was given by\n-- \n2.49.0.rc0\n\n"},{"id":"513468","messageId":"20250303204443.360595-34-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 33/34] unpack-trees.c: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:31Z","receivedAt":"2025-03-03T20:45:17Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n unpack-trees.c | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/unpack-trees.c b/unpack-trees.c\nindex 334cb84f65..cf5b73c84b 100644\n--- a/unpack-trees.c\n+++ b/unpack-trees.c\n@@ -2904,7 +2904,7 @@ int threeway_merge(const struct cache_entry * const *stages,\n * The rule is to \"carry forward\" what is in the index without losing\n * information across a \"fast-forward\", favoring a successful merge\n * over a merge failure when it makes sense. For details of the\n- * \"carry forward\" rule, please see .\n+ * \"carry forward\" rule, please see .\n *\n */\n int twoway_merge(const struct cache_entry * const *src,\n-- \n2.49.0.rc0\n\n"},{"id":"513469","messageId":"20250303204443.360595-35-tmz@pobox.com","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"[PATCH 34/34] xdiff: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T20:44:32Z","receivedAt":"2025-03-03T20:45:18Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Signed-off-by: Todd Zullinger \n---\n xdiff/xdiff.h | 2 +-\n xdiff/xpatience.c | 2 +-\n 2 files changed, 2 insertions(+), 2 deletions(-)\n\ndiff --git a/xdiff/xdiff.h b/xdiff/xdiff.h\nindex bb56b23f34..2cecde5afe 100644\n--- a/xdiff/xdiff.h\n+++ b/xdiff/xdiff.h\n@@ -85,7 +85,7 @@ typedef struct s_xpparam {\n \tregex_t **ignore_regex;\n \tsize_t ignore_regex_nr;\n \n-\t/* See Documentation/diff-options.txt. */\n+\t/* See Documentation/diff-options.adoc. */\n \tchar **anchors;\n \tsize_t anchors_nr;\n } xpparam_t;\ndiff --git a/xdiff/xpatience.c b/xdiff/xpatience.c\nindex 82f663004e..77dc411d19 100644\n--- a/xdiff/xpatience.c\n+++ b/xdiff/xpatience.c\n@@ -64,7 +64,7 @@ struct hashmap {\n \n \t\t/*\n \t\t * If 1, this entry can serve as an anchor. See\n-\t\t * Documentation/diff-options.txt for more information.\n+\t\t * Documentation/diff-options.adoc for more information.\n \t\t */\n \t\tunsigned anchor : 1;\n \t} *entries, *first, *last;\n-- \n2.49.0.rc0\n\n"},{"id":"513471","messageId":"xmqqo6yhvl2o.fsf@gitster.g","threadId":"63052","inReplyTo":"20250303204443.360595-2-tmz@pobox.com","subject":"Re: [PATCH 01/34] t0450: *.txt -> *.adoc fixes","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2025-03-03T21:52:15Z","receivedAt":"2025-03-03T21:52:18Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Todd Zullinger writes:\n\n> After 1f010d6bdf (doc: use .adoc extension for AsciiDoc files,\n> 2025-01-20), we no longer matched any files in this test. The result is\n> that we did not test for mismatches in the documentation and --help\n> output.\n>\n> Adjust the test to look at the renamed *.adoc files.\n>\n> Signed-off-by: Todd Zullinger \n> ---\n> t/t0450-txt-doc-vs-help.sh | 50 +++++++++----------\n> ...t-help-mismatches => adoc-help-mismatches} | 0\n> 2 files changed, 25 insertions(+), 25 deletions(-)\n> rename t/t0450/{txt-help-mismatches => adoc-help-mismatches} (100%)\n\nWow, good find. This is especially bad and I am glad we caught it\nbefore -rc1 (the hope was that all of these should have been caught\nwhile the topic was in 'next', which was the whole point of cooking\nit longer in 'next' than usual, but that plan did not really work).\n\n> diff --git a/t/t0450-txt-doc-vs-help.sh b/t/t0450-txt-doc-vs-help.sh\n> index 853101b86e..2f7504ae7e 100755\n> --- a/t/t0450-txt-doc-vs-help.sh\n> +++ b/t/t0450-txt-doc-vs-help.sh\n> @@ -1,6 +1,6 @@\n> #!/bin/sh\n> \n> -test_description='assert (unbuilt) Documentation/*.txt and -h output\n> +test_description='assert (unbuilt) Documentation/*.adoc and -h output\n> \n> Run this with --debug to see a summary of where we still fail to make\n> the two versions consistent with one another.'\n> @@ -11,11 +11,11 @@ test_expect_success 'setup: list of builtins' '\n> \tgit --list-cmds=builtins >builtins\n> '\n> \n> -test_expect_success 'list of txt and help mismatches is sorted' '\n> -\tsort -u \"$TEST_DIRECTORY\"/t0450/txt-help-mismatches >expect &&\n> -\tif ! test_cmp expect \"$TEST_DIRECTORY\"/t0450/txt-help-mismatches\n> +test_expect_success 'list of adoc and help mismatches is sorted' '\n> +\tsort -u \"$TEST_DIRECTORY\"/t0450/adoc-help-mismatches >expect &&\n> +\tif ! test_cmp expect \"$TEST_DIRECTORY\"/t0450/adoc-help-mismatches\n> \tthen\n> -\t\tBUG \"please keep the list of txt and help mismatches sorted\"\n> +\t\tBUG \"please keep the list of adoc and help mismatches sorted\"\n> \tfi\n> '\n> \n> @@ -40,20 +40,20 @@ help_to_synopsis () {\n> \techo \"$out\"\n> }\n> \n> -builtin_to_txt () {\n> - echo \"$GIT_BUILD_DIR/Documentation/git-$1.txt\"\n> +builtin_to_adoc () {\n> + echo \"$GIT_BUILD_DIR/Documentation/git-$1.adoc\"\n> }\n> \n> -txt_to_synopsis () {\n> +adoc_to_synopsis () {\n> \tbuiltin=\"$1\" &&\n> \tout_dir=\"out/$builtin\" &&\n> -\tout=\"$out_dir/txt.synopsis\" &&\n> +\tout=\"$out_dir/adoc.synopsis\" &&\n> \tif test -f \"$out\"\n> \tthen\n> \t\techo \"$out\" &&\n> \t\treturn 0\n> \tfi &&\n> -\tb2t=\"$(builtin_to_txt \"$builtin\")\" &&\n> +\tb2t=\"$(builtin_to_adoc \"$builtin\")\" &&\n> \tsed -n \\\n> \t\t-E '/^\\[(verse|synopsis)\\]$/,/^$/ {\n> \t\t\t/^$/d;\n> @@ -109,29 +109,29 @@ do\n> \t\tfi\n> \t'\n> \n> -\ttxt=\"$(builtin_to_txt \"$builtin\")\" &&\n> -\tpreq=\"$(echo BUILTIN_TXT_$builtin | tr '[:lower:]-' '[:upper:]_')\" &&\n> +\tadoc=\"$(builtin_to_adoc \"$builtin\")\" &&\n> +\tpreq=\"$(echo BUILTIN_ADOC_$builtin | tr '[:lower:]-' '[:upper:]_')\" &&\n> \n> -\tif test -f \"$txt\"\n> +\tif test -f \"$adoc\"\n> \tthen\n> \t\ttest_set_prereq \"$preq\"\n> \tfi &&\n> \n> -\t# *.txt output assertions\n> -\ttest_expect_success \"$preq\" \"$builtin *.txt SYNOPSIS has dashed labels\" '\n> -\t\tcheck_dashed_labels \"$(txt_to_synopsis \"$builtin\")\"\n> +\t# *.adoc output assertions\n> +\ttest_expect_success \"$preq\" \"$builtin *.adoc SYNOPSIS has dashed labels\" '\n> +\t\tcheck_dashed_labels \"$(adoc_to_synopsis \"$builtin\")\"\n> \t'\n> \n> -\t# *.txt output consistency assertions\n> +\t# *.adoc output consistency assertions\n> \tresult=\n> -\tif grep -q \"^$builtin$\" \"$TEST_DIRECTORY\"/t0450/txt-help-mismatches\n> +\tif grep -q \"^$builtin$\" \"$TEST_DIRECTORY\"/t0450/adoc-help-mismatches\n> \tthen\n> \t\tresult=failure\n> \telse\n> \t\tresult=success\n> \tfi &&\n> \ttest_expect_$result \"$preq\" \"$builtin -h output and SYNOPSIS agree\" '\n> -\t\tt2s=\"$(txt_to_synopsis \"$builtin\")\" &&\n> +\t\tt2s=\"$(adoc_to_synopsis \"$builtin\")\" &&\n> \t\tif test \"$builtin\" = \"merge-tree\"\n> \t\tthen\n> \t\t\ttest_when_finished \"rm -f t2s.new\" &&\n> @@ -140,17 +140,17 @@ do\n> \t\tfi &&\n> \t\th2s=\"$(help_to_synopsis \"$builtin\")\" &&\n> \n> -\t\t# The *.txt and -h use different spacing for the\n> +\t\t# The *.adoc and -h use different spacing for the\n> \t\t# alignment of continued usage output, normalize it.\n> -\t\talign_after_nl \"$builtin\" <\"$t2s\" >txt &&\n> +\t\talign_after_nl \"$builtin\" <\"$t2s\" >adoc &&\n> \t\talign_after_nl \"$builtin\" <\"$h2s\" >help &&\n> -\t\ttest_cmp txt help\n> +\t\ttest_cmp adoc help\n> \t'\n> \n> -\tif test_have_prereq \"$preq\" && test -e txt && test -e help\n> +\tif test_have_prereq \"$preq\" && test -e adoc && test -e help\n> \tthen\n> \t\ttest_debug '\n> -\t\t\tif test_cmp txt help >cmp 2>/dev/null\n> +\t\t\tif test_cmp adoc help >cmp 2>/dev/null\n> \t\t\tthen\n> \t\t\t\techo \"=== DONE: $builtin ===\"\n> \t\t\telse\n> @@ -161,7 +161,7 @@ do\n> \n> \t\t# Not in test_expect_success in case --run is being\n> \t\t# used with --debug\n> -\t\trm -f txt help tmp 2>/dev/null\n> +\t\trm -f adoc help tmp 2>/dev/null\n> \tfi\n> done \n> diff --git a/t/t0450/txt-help-mismatches b/t/t0450/adoc-help-mismatches\n> similarity index 100%\n> rename from t/t0450/txt-help-mismatches\n> rename to t/t0450/adoc-help-mismatches\n"},{"id":"513472","messageId":"xmqqjz95vkwi.fsf@gitster.g","threadId":"63052","inReplyTo":"20250303204443.360595-4-tmz@pobox.com","subject":"Re: [PATCH 03/34] doc: remove unneeded .gitattributes","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2025-03-03T21:55:57Z","receivedAt":"2025-03-03T21:56:00Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Todd Zullinger writes:\n\n> The top-level .gitattributes file contains entries for the Documentation\n> tree. Documentation/.gitattributes has not been touched since it was\n> added in 14f9e128d3 (Define the project whitespace policy, 2008-02-10).\n\nI'd explain this change a bit differently, but the end result I\nagree with. These days we no longer have any .txt file under the\nDocumentation/ hierarchy, so no matter what the other gitattributes\nfiles at the upper level(s) do, this attribute definition for .txt\nfile would not do anything, so it makes perfect sense to lose it.\n\n> Signed-off-by: Todd Zullinger \n> ---\n> Documentation/.gitattributes | 1 -\n> 1 file changed, 1 deletion(-)\n> delete mode 100644 Documentation/.gitattributes\n>\n> diff --git a/Documentation/.gitattributes b/Documentation/.gitattributes\n> deleted file mode 100644\n> index ddb030137d..0000000000\n> --- a/Documentation/.gitattributes\n> +++ /dev/null\n> @@ -1 +0,0 @@\n> -*.txt whitespace\n"},{"id":"513473","messageId":"xmqqfrjtvkqp.fsf@gitster.g","threadId":"63052","inReplyTo":"20250303204443.360595-10-tmz@pobox.com","subject":"Re: [PATCH 09/34] howto/new-command: update reference to builtin docs","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2025-03-03T21:59:26Z","receivedAt":"2025-03-03T21:59:28Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Todd Zullinger writes:\n\n> Commit ec14d4ecb5 (builtin.h: take over documentation from\n> api-builtin.txt, 2017-08-02) deleted api-builtin.txt and moved the\n> contents into builtin.h. Most of the references were fixed in\n> d85e9448dd (new-command.txt: update reference to builtin docs,\n> 2023-02-04), but one remained. Fix it.\n>\n> Signed-off-by: Todd Zullinger \n> ---\n> Documentation/howto/new-command.adoc | 2 +-\n> 1 file changed, 1 insertion(+), 1 deletion(-)\n\n;-) This is orthogonal to the txt-to-adoc gotcha but is a long\noverdue fix to even older breakage. Thanks for addressing it.\n\n> diff --git a/Documentation/howto/new-command.adoc b/Documentation/howto/new-command.adoc\n> index 880c51112b..ac73c98be7 100644\n> --- a/Documentation/howto/new-command.adoc\n> +++ b/Documentation/howto/new-command.adoc\n> @@ -48,7 +48,7 @@ binary); this organization makes it easy for people reading the code\n> to find things.\n> \n> See the CodingGuidelines document for other guidance on what we consider\n> -good practice in C and shell, and api-builtin.txt for the support\n> +good practice in C and shell, and builtin.h for the support\n> functions available to built-in commands written in C.\n> \n> What every extension command needs\n"},{"id":"513481","messageId":"Z8YtJd078J44snOE@teonanacatl.net","threadId":"63052","inReplyTo":"xmqqo6yhvl2o.fsf@gitster.g","subject":"Re: [PATCH 01/34] t0450: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-03T22:28:53Z","receivedAt":"2025-03-03T22:28:56Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Junio C Hamano wrote:\n> Todd Zullinger writes:\n> \n>> After 1f010d6bdf (doc: use .adoc extension for AsciiDoc files,\n>> 2025-01-20), we no longer matched any files in this test. The result is\n>> that we did not test for mismatches in the documentation and --help\n>> output.\n>>\n>> Adjust the test to look at the renamed *.adoc files.\n>>\n>> Signed-off-by: Todd Zullinger \n>> ---\n>> t/t0450-txt-doc-vs-help.sh | 50 +++++++++----------\n>> ...t-help-mismatches => adoc-help-mismatches} | 0\n>> 2 files changed, 25 insertions(+), 25 deletions(-)\n>> rename t/t0450/{txt-help-mismatches => adoc-help-mismatches} (100%)\n> \n> Wow, good find. This is especially bad and I am glad we caught it\n> before -rc1 (the hope was that all of these should have been caught\n> while the topic was in 'next', which was the whole point of cooking\n> it longer in 'next' than usual, but that plan did not really work).\n\nIndeed. I haven't looked closely at the CI bits to see how\nwe might be able to improve this. When we skip tests\nunintentionally we just don't see that currently.\n\nI have a file of patterns I expected to skip in the rpm\nbuilds when I maintained git in Fedora. I'd regularly run:\n\n grep -E '# SKIP|skipped:' build.log | grep -Evf git.skip-test-patterns\n\nto watch for skipped tests[1]. Those often indicated that I\nneeded to add a new build dependency, but sometimes catch\nissues like this. We have some similar things in the CI\nscripts, I think. Maybe we could add one for this sort of\nthing.\n\nWhat I don't know is how many tests we skip now and how\nthose differ across the multiple test runs. It might be\nannoyingly variable to track what is skipped between the\nmultiple OS types, releases, and build options.\n\nI don't even know if we have the same data in the build\nlogs. The rpm builds I run use `prove` with verbose output.\n\n[1] That is also how I noticed that we've been skipping all\n tests which rely on the GPG2 prereq, as I mentioned\n recently in .\n\n-- \nTodd\n"},{"id":"513483","messageId":"xmqqbjuhvi57.fsf@gitster.g","threadId":"63052","inReplyTo":"Z8YtJd078J44snOE@teonanacatl.net","subject":"Re: [PATCH 01/34] t0450: *.txt -> *.adoc fixes","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2025-03-03T22:55:32Z","receivedAt":"2025-03-03T22:55:35Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Todd Zullinger writes:\n\n> Indeed. I haven't looked closely at the CI bits to see how\n> we might be able to improve this. When we skip tests\n> unintentionally we just don't see that currently.\n\nIn any case, while the t0450 was inadvertently disabled this way, a\ntopic seems to have escaped to 'master' already with an inconsistent\nsynopsis section and help text.\n\nHere is a fix.\n\n--- >8 ---\nSubject: [PATCH] refs: show --no-reflog in the help text\n\nWe forgot that we must keep the documentation and help text in sync.\n\nSigned-off-by: Junio C Hamano \n---\n builtin/refs.c | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/builtin/refs.c b/builtin/refs.c\nindex c459507d51..44d592a94c 100644\n--- a/builtin/refs.c\n+++ b/builtin/refs.c\n@@ -8,7 +8,7 @@\n #include \"worktree.h\"\n \n #define REFS_MIGRATE_USAGE \\\n-\tN_(\"git refs migrate --ref-format= [--dry-run]\")\n+\tN_(\"git refs migrate --ref-format= [--no-reflog] [--dry-run]\")\n \n #define REFS_VERIFY_USAGE \\\n \tN_(\"git refs verify [--strict] [--verbose]\")\n-- \n2.49.0-rc0-191-g335411b56b\n"},{"id":"513485","messageId":"Z8Y_PxXsYndBV64C@tapette.crustytoothpaste.net","threadId":"63052","inReplyTo":"20250303204443.360595-1-tmz@pobox.com","subject":"Re: [PATCH 00/34] misc *.txt -> *.adoc fixes","fromName":"brian m. carlson","fromEmail":"sandals@crustytoothpaste.net","sentAt":"2025-03-03T23:46:07Z","receivedAt":"2025-03-03T23:46:15Z","isPatch":true,"sender":{"key":"sandals@crustytoothpaste.net","avatar":"https://avatars.githubusercontent.com/u/497054?v=4"},"body":"On 2025-03-03 at 20:43:58, Todd Zullinger wrote:\n> As a follow-up to , this\n> series aims to fix a good number of the remaining references\n> to renamed *.txt files in our tree.\n> \n> The first patch fixes an actual issue, where we were\n> skipping all the tests in t0450-txt-doc-vs-help.\n\nAll of these seem reasonable to me.\n-- \nbrian m. carlson (they/them or he/him)\nToronto, Ontario, CA\n"},{"id":"513486","messageId":"xmqq34ftvfo9.fsf@gitster.g","threadId":"63052","inReplyTo":"Z8Y_PxXsYndBV64C@tapette.crustytoothpaste.net","subject":"Re: [PATCH 00/34] misc *.txt -> *.adoc fixes","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2025-03-03T23:48:54Z","receivedAt":"2025-03-03T23:48:57Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"\"brian m. carlson\" writes:\n\n> On 2025-03-03 at 20:43:58, Todd Zullinger wrote:\n>> As a follow-up to , this\n>> series aims to fix a good number of the remaining references\n>> to renamed *.txt files in our tree.\n>> \n>> The first patch fixes an actual issue, where we were\n>> skipping all the tests in t0450-txt-doc-vs-help.\n>\n> All of these seem reasonable to me.\n\nYup, I plan to merge them down before -rc1 (or -rc2 at the latest).\n\nThanks.\n"},{"id":"513487","messageId":"Z8ZGChnWGa3sXD3s@teonanacatl.net","threadId":"63052","inReplyTo":"xmqqbjuhvi57.fsf@gitster.g","subject":"Re: [PATCH 01/34] t0450: *.txt -> *.adoc fixes","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2025-03-04T00:15:06Z","receivedAt":"2025-03-04T00:15:09Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Junio C Hamano wrote:\n> Todd Zullinger writes:\n> \n>> Indeed. I haven't looked closely at the CI bits to see how\n>> we might be able to improve this. When we skip tests\n>> unintentionally we just don't see that currently.\n> \n> In any case, while the t0450 was inadvertently disabled this way, a\n> topic seems to have escaped to 'master' already with an inconsistent\n> synopsis section and help text.\n> \n> Here is a fix.\n\nI'm glad that's already paying off; it helps prove the patch\nnicely.\n\nI wondered for a moment why I didn't catch it with any of my\ntest runs. But it's simply that the rpm build tests were on\ntop of 2.49.0-rc0 and my local branch for this was built on\ntop of tz/doc-txt-to-adoc-fixes, neither of which contain\n89be7d2774 (builtin/refs: add '--no-reflog' flag to drop\nreflogs, 2025-02-21).\n\n> --- >8 ---\n> Subject: [PATCH] refs: show --no-reflog in the help text\n> \n> We forgot that we must keep the documentation and help text in sync.\n> \n> Signed-off-by: Junio C Hamano \n> ---\n> builtin/refs.c | 2 +-\n> 1 file changed, 1 insertion(+), 1 deletion(-)\n> \n> diff --git a/builtin/refs.c b/builtin/refs.c\n> index c459507d51..44d592a94c 100644\n> --- a/builtin/refs.c\n> +++ b/builtin/refs.c\n> @@ -8,7 +8,7 @@\n> #include \"worktree.h\"\n> \n> #define REFS_MIGRATE_USAGE \\\n> -\tN_(\"git refs migrate --ref-format= [--dry-run]\")\n> +\tN_(\"git refs migrate --ref-format= [--no-reflog] [--dry-run]\")\n> \n> #define REFS_VERIFY_USAGE \\\n> \tN_(\"git refs verify [--strict] [--verbose]\")\n\nThe fix looks obviously correct. :)\n\n-- \nTodd\n"}]}