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

[PATCH v2 1/2] doc: fix asciidoc markup issues in several files

From
Jean-Noël Avila via GitGitGadget <gitgitgadget@gmail.com>
Date
Dec 19, 2025, 18:54 UTC
Message-ID
<31694ab9d337d68294a5710d55fc4f7e1ff6f83a.1766170456.git.gitgitgadget@gmail.com>
In-Reply-To
<pull.2016.v2.git.1766170456.gitgitgadget@gmail.com>
From: =?UTF-8?q?Jean-No=C3=ABl=20Avila?= <jn.avila@free.fr>
* fix incorrect use of backticks for markup in
  git-checkout.adoc, git-worktree.adoc
* switch tabs to spaces	in git-send-email.adoc list items
Signed-off-by: Jean-Noël Avila <jn.avila@free.fr>
---
 Documentation/git-checkout.adoc   |  2 +-
 Documentation/git-send-email.adoc | 14 +++++++-------
 Documentation/git-worktree.adoc   |  2 +-
 3 files changed, 9 insertions(+), 9 deletions(-)
diff --git a/Documentation/git-checkout.adoc b/Documentation/git-checkout.adoc
index 6f281b298e..43ccf47cf6 100644
--- a/Documentation/git-checkout.adoc
+++ b/Documentation/git-checkout.adoc
@@ -509,7 +509,7 @@ ARGUMENT DISAMBIGUATION
 -----------------------
 
 When you run `git checkout <something>`, Git tries to guess whether
-`<something>` is intended to be a branch, a commit, or a set of file(s),
+_<something>_ is intended to be a branch, a commit, or a set of file(s),
 and then either switches to that branch or commit, or restores the
 specified files.
 
diff --git a/Documentation/git-send-email.adoc b/Documentation/git-send-email.adoc
index 263b977353..caf9d693a3 100644
--- a/Documentation/git-send-email.adoc
+++ b/Documentation/git-send-email.adoc
@@ -277,7 +277,7 @@ must be used for each option.
 --smtp-ssl::
 	Legacy alias for `--smtp-encryption ssl`.
 
---smtp-ssl-cert-path::
+--smtp-ssl-cert-path <path>::
 	Path to a store of trusted CA certificates for SMTP SSL/TLS
 	certificate validation (either a directory that has been processed
 	by `c_rehash`, or a single file containing one or more PEM format
@@ -510,12 +510,12 @@ have been specified, in which case default to `compose`.
 	Currently, validation means the following:
 +
 --
-		*	Invoke the sendemail-validate hook if present (see linkgit:githooks[5]).
-		*	Warn of patches that contain lines longer than
-			998 characters unless a suitable transfer encoding
-			(`auto`, `base64`, or `quoted-printable`) is used;
-			this is due to SMTP limits as described by
-			https://www.ietf.org/rfc/rfc5322.txt.
+* Invoke the sendemail-validate hook if present (see linkgit:githooks[5]).
+* Warn of patches that contain lines longer than
+  998 characters unless a suitable transfer encoding
+  (`auto`, `base64`, or `quoted-printable`) is used;
+  this is due to SMTP limits as described by
+  https://www.ietf.org/rfc/rfc5322.txt.
 --
 +
 Default is the value of `sendemail.validate`; if this is not set,
diff --git a/Documentation/git-worktree.adoc b/Documentation/git-worktree.adoc
index f272f79783..d74ad7b0e9 100644
--- a/Documentation/git-worktree.adoc
+++ b/Documentation/git-worktree.adoc
@@ -104,7 +104,7 @@ associated with a new unborn branch named _<branch>_ (after
 passed to the command. In the event the repository has a remote and
 `--guess-remote` is used, but no remote or local branches exist, then the
 command fails with a warning reminding the user to fetch from their remote
-first (or override by using `-f/--force`).
+first (or override by using `-f`/`--force`).
 
 `list`::
 
-- 
gitgitgadget
Previous: Jean-Noël Avila via GitGitGadgetNext: Kristoffer Haugsbakk
Message 7 of 12 in “doc: flock of small fixes to various documentation files”
  1. doc: flock of small fixes to various documentation filesJean-Noël Avila via GitGitGadget, Dec 15, 2025
  2. Kristoffer HaugsbakkDec 15, 2025
  3. Jean-Noël AvilaDec 17, 2025
  4. Kristoffer HaugsbakkDec 18, 2025
  5. Kristoffer HaugsbakkDec 19, 2025
  6. 0/2 doc: flock of small fixes to various documentation filesJean-Noël Avila via GitGitGadget, Dec 19, 2025
  7. 1/2 doc: fix asciidoc markup issues in several filesJean-Noël Avila via GitGitGadget, Dec 19, 2025
  8. Kristoffer HaugsbakkDec 21, 2025
  9. 2/2 doc: correct minor wording issuesJean-Noël Avila via GitGitGadget, Dec 19, 2025
  10. Kristoffer HaugsbakkDec 21, 2025
  11. Junio C HamanoDec 22, 2025
  12. Kristoffer HaugsbakkDec 21, 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.