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

[PATCH 6/6] Doc: use two backticks for monospace, not backtick+apostrophe

From
MÅMartin Ågren <martin.agren@gmail.com>
Date
May 13, 2021, 18:17 UTC
Message-ID
<f0af6c8f6aeb765a2670cc6c097059c591cdcedc.1620928059.git.martin.agren@gmail.com>
In-Reply-To
<cover.1620928059.git.martin.agren@gmail.com>

In a few places, we wrap the name of an --option or an ENV_VARIABLE in backtick+apostrophe rather than backtick+backtick. Switch to using two backticks, as per the coding guidelines.

As an added bonus to rendering these as monospace, we will have them render the same with AsciiDoc and Asciidoctor. The `quoted' way ends up as ‘quoted’ vs “quoted”.

Signed-off-by: Martin Ågren <martin.agren@gmail.com>
---
 Documentation/config/diff.txt      | 2 +-
 Documentation/git-check-ignore.txt | 2 +-
 Documentation/git-describe.txt     | 2 +-
 Documentation/git-svn.txt          | 6 +++---
 4 files changed, 6 insertions(+), 6 deletions(-)
diff --git a/Documentation/config/diff.txt b/Documentation/config/diff.txt
index 2d3331f55c..eda0c452d1 100644
--- a/Documentation/config/diff.txt
+++ b/Documentation/config/diff.txt
@@ -69,7 +69,7 @@ diff.interHunkContext::
 diff.external::
 	If this config variable is set, diff generation is not
 	performed using the internal diff machinery, but using the
-	given command.  Can be overridden with the `GIT_EXTERNAL_DIFF'
+	given command.  Can be overridden with the `GIT_EXTERNAL_DIFF`
 	environment variable.  The command is called with parameters
 	as described under "git Diffs" in linkgit:git[1].  Note: if
 	you want to use an external diff program only on a subset of
diff --git a/Documentation/git-check-ignore.txt b/Documentation/git-check-ignore.txt
index 0c3924a63d..ab97ee9d50 100644
--- a/Documentation/git-check-ignore.txt
+++ b/Documentation/git-check-ignore.txt
@@ -21,7 +21,7 @@ input files to the exclude mechanism) and output the path if it is
 excluded.
 
 By default, tracked files are not shown at all since they are not
-subject to exclude rules; but see `--no-index'.
+subject to exclude rules; but see `--no-index`.
 
 OPTIONS
 -------
diff --git a/Documentation/git-describe.txt b/Documentation/git-describe.txt
index a88f6ae2c6..adbbb8907f 100644
--- a/Documentation/git-describe.txt
+++ b/Documentation/git-describe.txt
@@ -44,7 +44,7 @@ OPTIONS
 	HEAD".  If the working tree has local modification "-dirty"
 	is appended to it.  If a repository is corrupt and Git
 	cannot determine if there is local modification, Git will
-	error out, unless `--broken' is given, which appends
+	error out, unless `--broken` is given, which appends
 	the suffix "-broken" instead.
 
 --all::
diff --git a/Documentation/git-svn.txt b/Documentation/git-svn.txt
index 4e62dc37e7..2491ed47a6 100644
--- a/Documentation/git-svn.txt
+++ b/Documentation/git-svn.txt
@@ -361,7 +361,7 @@ where <name> is the name of the SVN repository as specified by the -R option to
 	This should make it easy to look up svn log messages when svn
 	users refer to -r/--revision numbers.
 +
-The following features from `svn log' are supported:
+The following features from `svn log` are supported:
 +
 --
 -r <n>[:<n>];;
@@ -397,7 +397,7 @@ Any other arguments are passed directly to 'git log'
 'blame'::
 	Show what revision and author last modified each line of a file. The
 	output of this mode is format-compatible with the output of
-	`svn blame' by default. Like the SVN blame command,
+	`svn blame` by default. Like the SVN blame command,
 	local uncommitted changes in the working tree are ignored;
 	the version of the file in the HEAD revision is annotated. Unknown
 	arguments are passed directly to 'git blame'.
@@ -482,7 +482,7 @@ denotes such an object, or it is requested by invoking an editor (see
 
 'info'::
 	Shows information about a file or directory similar to what
-	`svn info' provides.  Does not currently support a -r/--revision
+	`svn info` provides.  Does not currently support a -r/--revision
 	argument.  Use the --url option to output only the value of the
 	'URL:' field.
 
-- 
2.31.1.751.gd2f1c929bd
Previous: Martin ÅgrenNext: Junio C Hamano
Message 14 of 22 in “AsciiDoc vs Asciidoctor, once again”
  1. 0/6 AsciiDoc vs Asciidoctor, once againMartin Ågren, May 13, 2021
  2. 1/6 git-http-push.txt,git-send-pack.txt: avoid single quoteMartin Ågren, May 13, 2021
  3. 2/6 git-range-diff.txt: avoid single quotesMartin Ågren, May 13, 2021
  4. 3/6 git-check-ref-format.txt: avoid single quoteMartin Ågren, May 13, 2021
  5. Eric SunshineMay 13, 2021
  6. Martin ÅgrenMay 13, 2021
  7. Junio C HamanoMay 13, 2021
  8. Martin ÅgrenMay 14, 2021
  9. Felipe ContrerasMay 14, 2021
  10. Jeff KingMay 14, 2021
  11. Martin ÅgrenMay 14, 2021
  12. 4/6 diff-options.txt: move monospace markup out of attributeMartin Ågren, May 13, 2021
  13. 5/6 git-svn.txt: change verse to listing blockMartin Ågren, May 13, 2021
  14. 6/6 Doc: use two backticks for monospace, not backtick+apostropheMartin Ågren, May 13, 2021
  15. Junio C HamanoMay 13, 2021
  16. Martin ÅgrenMay 14, 2021
  17. Felipe ContrerasMay 14, 2021
  18. Felipe ContrerasMay 14, 2021
  19. Martin ÅgrenMay 14, 2021
  20. Felipe ContrerasMay 14, 2021
  21. Martin ÅgrenMay 14, 2021
  22. Felipe ContrerasMay 14, 2021

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.