git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH 07/34] MyFirstContribution: *.txt -> *.adoc fixes

From
Todd Zullinger <tmz@pobox.com>
Date
Mar 3, 2025, 20:44 UTC
Message-ID
<20250303204443.360595-8-tmz@pobox.com>
In-Reply-To
<20250303204443.360595-1-tmz@pobox.com>
Signed-off-by: Todd Zullinger <tmz@pobox.com>
---
 Documentation/MyFirstContribution.adoc | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)
diff --git a/Documentation/MyFirstContribution.adoc b/Documentation/MyFirstContribution.adoc
index e41654c00a..afcf4b46c1 100644
--- a/Documentation/MyFirstContribution.adoc
+++ b/Documentation/MyFirstContribution.adoc
@@ -21,7 +21,7 @@ This tutorial aims to summarize the following documents, but the reader may find
 useful additional context:
 
 - `Documentation/SubmittingPatches`
-- `Documentation/howto/new-command.txt`
+- `Documentation/howto/new-command.adoc`
 
 [[getting-help]]
 === Getting Help
@@ -331,7 +331,7 @@ function body:
 apply standard precedence rules. `git_config_get_string_tmp()` will look up
 a specific key ("user.name") and give you the value. There are a number of
 single-key lookup functions like this one; you can see them all (and more info
-about how to use `git_config()`) in `Documentation/technical/api-config.txt`.
+about how to use `git_config()`) in `Documentation/technical/api-config.adoc`.
 
 You should see that the name printed matches the one you see when you run:
 
@@ -461,10 +461,10 @@ $ ./bin-wrappers/git help psuh
 
 Your new command is undocumented! Let's fix that.
 
-Take a look at `Documentation/git-*.txt`. These are the manpages for the
+Take a look at `Documentation/git-*.adoc`. These are the manpages for the
 subcommands that Git knows about. You can open these up and take a look to get
 acquainted with the format, but then go ahead and make a new file
-`Documentation/git-psuh.txt`. Like with most of the documentation in the Git
+`Documentation/git-psuh.adoc`. Like with most of the documentation in the Git
 project, help pages are written with AsciiDoc (see CodingGuidelines, "Writing
 Documentation" section). Use the following template to fill out your own
 manpage:
@@ -543,7 +543,7 @@ Try and run `./bin-wrappers/git psuh -h`. Your command should crash at the end.
 That's because `-h` is a special case which your command should handle by
 printing usage.
 
-Take a look at `Documentation/technical/api-parse-options.txt`. This is a handy
+Take a look at `Documentation/technical/api-parse-options.adoc`. This is a handy
 tool for pulling out options you need to be able to handle, and it takes a
 usage string.
 
@@ -1088,14 +1088,14 @@ This gives reviewers a summary of what they're in for when reviewing your topic.
 The one generated for `psuh` from the sample implementation looks like this:
 
 ----
- Documentation/git-psuh.txt | 40 +++++++++++++++++++++
- Makefile                   |  1 +
- builtin.h                  |  1 +
- builtin/psuh.c             | 73 ++++++++++++++++++++++++++++++++++++++
- git.c                      |  1 +
- t/t9999-psuh-tutorial.sh   | 12 +++++++
+ Documentation/git-psuh.adoc | 40 +++++++++++++++++++++
+ Makefile                    |  1 +
+ builtin.h                   |  1 +
+ builtin/psuh.c              | 73 ++++++++++++++++++++++++++++++++++++++
+ git.c                       |  1 +
+ t/t9999-psuh-tutorial.sh    | 12 +++++++
  6 files changed, 128 insertions(+)
- create mode 100644 Documentation/git-psuh.txt
+ create mode 100644 Documentation/git-psuh.adoc
  create mode 100644 builtin/psuh.c
  create mode 100755 t/t9999-psuh-tutorial.sh
 ----
-- 
2.49.0.rc0
Previous: Todd ZullingerNext: Todd Zullinger
Message 13 of 43 in “misc *.txt -> *.adoc fixes”
  1. 00/34 misc *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  2. 01/34 t0450: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  3. Junio C HamanoMar 3, 2025
  4. Todd ZullingerMar 3, 2025
  5. Junio C HamanoMar 3, 2025
  6. Todd ZullingerMar 4, 2025
  7. 02/34 .gitattributes: more *.txt -> *.adoc updatesTodd Zullinger, Mar 3, 2025
  8. 03/34 doc: remove unneeded .gitattributesTodd Zullinger, Mar 3, 2025
  9. Junio C HamanoMar 3, 2025
  10. 04/34 Makefile: update reference to technical/racy-git.adocTodd Zullinger, Mar 3, 2025
  11. 05/34 README: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  12. 06/34 CodingGuidelines: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  13. 07/34 MyFirstContribution: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  14. 08/34 MyFirstObjectWalk: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  15. 09/34 howto/new-command: update reference to builtin docsTodd Zullinger, Mar 3, 2025
  16. Junio C HamanoMar 3, 2025
  17. 10/34 technical/partial-clone: update reference to rev-list-options.adocTodd Zullinger, Mar 3, 2025
  18. 11/34 doc: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  19. 12/34 advice.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  20. 13/34 apply.c: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  21. 14/34 builtin.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  22. 15/34 config.c: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  23. 16/34 contrib/long-running-filter: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  24. 17/34 diff.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  25. 18/34 diffcore.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  26. 19/34 fsck.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  27. 20/34 list-objects-filter-options.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  28. 21/34 object-name.c: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  29. 22/34 parse-options.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  30. 23/34 pseudo-merge.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  31. 24/34 refs.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  32. 25/34 setup.c: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  33. 26/34 simple-ipc.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  34. 27/34 t/helper/test-rot13-filter.c: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  35. 28/34 t6012: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  36. 29/34 t6434: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  37. 30/34 trace2.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  38. 31/34 trace2/tr2_sysenv.c: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  39. 32/34 transport.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  40. 33/34 unpack-trees.c: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  41. 34/34 xdiff: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  42. brian m. carlsonMar 3, 2025
  43. Junio C HamanoMar 3, 2025

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.