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

[PATCH] Documentation: Fix indentation problem in git-commit(1)

From
Jacob Helwig <jacob.helwig@gmail.com>
Date
Feb 15, 2010, 00:45 UTC
Message-ID
<1266194717-25438-1-git-send-email-jacob.helwig@gmail.com>

All options listed after "-u[<mode>], --untracked-files[=<mode>]" in the git-commit(1) manpage ended up listed as though they were part of the description for -u/--untracked-files. This was introduced by d6293d1.

Signed-off-by: Jacob Helwig <jacob.helwig@gmail.com>
---

Ever since the "See linkgit:git-config[1]..." paragraph was added to the description for the --untracked-files option (d6293d1), the paragraphs for the following options were indented at the same level as the "See linkgit:git-config[1]" paragraph. This problem looks like it only showed up in the manpages, not in the HTML documentation.

I'm not entirely happy with this patch, since the "See linkgit..." paragraph does not retain its previous indentation level in the manpages, or HTML documentation.

Unfortunately, I'm not very good with ASCIIDOC at all, so this is mainly the result of me throwing things at the problem until I found something that (mostly) works. Hopefully this will be enough to grab the attention of someone that's better with ASCIIDOC than I.

 Documentation/git-commit.txt |    6 +++---
 1 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/Documentation/git-commit.txt b/Documentation/git-commit.txt
index e99bb14..64fb458 100644
--- a/Documentation/git-commit.txt
+++ b/Documentation/git-commit.txt
@@ -197,13 +197,13 @@ FROM UPSTREAM REBASE" section in linkgit:git-rebase[1].)
 	Show untracked files (Default: 'all').
 +
 The mode parameter is optional, and is used to specify
-the handling of untracked files. The possible options are:
+the handling of untracked files.
++
+The possible options are:
 +
---
 	- 'no'     - Show no untracked files
 	- 'normal' - Shows untracked files and directories
 	- 'all'    - Also shows individual files in untracked directories.
---
 +
 See linkgit:git-config[1] for configuration variable
 used to change the default for when the option is not
-- 
1.7.0
Next: Thomas Rast
Message 1 of 5 in “Documentation: Fix indentation problem in git-commit(1)”
  1. Documentation: Fix indentation problem in git-commit(1)Jacob Helwig, Feb 15, 2010
  2. Thomas RastFeb 15, 2010
  3. Documentation: Fix indentation problem in git-commit(1)Jacob Helwig, Feb 15, 2010
  4. Jacob HelwigFeb 19, 2010
  5. Junio C HamanoFeb 20, 2010

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.