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

[PATCH] git-shortlog: Fix two formatting errors in asciidoc documentation

From
Frank Lichtenheld <frank@lichtenheld.de>
Date
Apr 18, 2007, 22:10 UTC
Message-ID
<11769342222941-git-send-email-frank@lichtenheld.de>

First use [verse] in the SYNOPSIS so that the line break actually shows.

Secondly drop the quotes around '.mailmap' since this exposes a bug in our toolchain (didn't bother enough yet to find out wether it is asciidoc's fault or that of the XSL templates) that leads to the dot not getting escaped correctly in the roff output and thereby swallowing the line.

Signed-off-by: Frank Lichtenheld <frank@lichtenheld.de>
---
 Documentation/git-shortlog.txt |    4 +++-
 1 files changed, 3 insertions(+), 1 deletions(-)
 I sometimes wonder if anyone except me actually reads the
 git man pages?
diff --git a/Documentation/git-shortlog.txt b/Documentation/git-shortlog.txt
index b0df92e..1c8c55e 100644
--- a/Documentation/git-shortlog.txt
+++ b/Documentation/git-shortlog.txt
@@ -7,6 +7,7 @@ git-shortlog - Summarize 'git log' output
 
 SYNOPSIS
 --------
+[verse]
 git-log --pretty=short | 'git-shortlog' [-h] [-n] [-s]
 git-shortlog [-n|--number] [-s|--summary] [<committish>...]
 
@@ -33,7 +34,8 @@ OPTIONS
 
 FILES
 -----
-'.mailmap'::
+
+.mailmap::
 	If this file exists, it will be used for mapping author email
 	addresses to a real author name. One mapping per line, first
 	the author name followed by the email address enclosed by
-- 
1.5.1.1
Message 1 of 1 in “git-shortlog: Fix two formatting errors in asciidoc documentation”
  1. git-shortlog: Fix two formatting errors in asciidoc documentationFrank Lichtenheld, Apr 18, 2007

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.