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

Re: PATCH Documentation/git-rev-list.txt typo fix

From
PHPeter Hagervall <hager@cs.umu.se>
Date
Sep 16, 2005, 14:24 UTC
Message-ID
<20050916142412.GA973@brainysmurf.cs.umu.se>
In-Reply-To
<E1EG2Or-0005E2-Pw@jdl.com>
On Thu, Sep 15, 2005 at 05:40:13PM -0500, jdl@freescale.com wrote:
Show 5 quoted lines
> I'm not positive what the doc conventions are, but I think
> something like this patch fixes the "superscript" problem
> on the git-rev-list doc page.
> 
> Signed-off-by: Jon Loeliger <jdl@freescale.com>
<snip>
> -if "git-rev-list --bisect foo ^bar ^baz" outputs 'midpoint', the output
> -of "git-rev-list foo ^midpoint" and "git-rev-list midpoint ^bar ^baz"
> +if 'git-rev-list --bisect foo ^bar ^baz' outputs 'midpoint', the output
> +of 'git-rev-list foo ^midpoint' and 'git-rev-list midpoint ^bar ^baz'
<snip>

This causes a mismatch in <emphasis> and <superscript> tags, one way of fixing it is having no more than one caret symbol per line, which is the only solution I found in the asciidoc documentation. Ugly, but it works.

Signed-off-by: Peter Hagervall <hager@cs.umu.se>
---
diff --git a/Documentation/git-rev-list.txt b/Documentation/git-rev-list.txt
--- a/Documentation/git-rev-list.txt
+++ b/Documentation/git-rev-list.txt
@@ -32,8 +32,11 @@ I have the commit object 'bar', but not 
 
 The *--bisect* flag limits output to the one commit object which is
 roughly halfway between the included and excluded commits. Thus,
-if 'git-rev-list --bisect foo ^bar ^baz' outputs 'midpoint', the output
-of 'git-rev-list foo ^midpoint' and 'git-rev-list midpoint ^bar ^baz'
+if 'git-rev-list --bisect foo ^bar
+^baz' outputs 'midpoint', the output
+of 'git-rev-list foo ^midpoint' and 'git-rev-list midpoint
+^bar
+^baz'
 would be of roughly the same length. Finding the change which introduces
 a regression is thus reduced to a binary search: repeatedly generate and
 test new 'midpoint's until the commit chain is of length one.
Previous: jdl@freescale.comNext: Junio C Hamano
Message 2 of 7 in “PATCH Documentation/git-rev-list.txt typo fix”
  1. jdl@freescale.comSep 15, 2005
  2. Peter HagervallSep 16, 2005
  3. Junio C HamanoSep 16, 2005
  4. Chris WrightSep 16, 2005
  5. Chris WrightSep 16, 2005
  6. jdl@freescale.comSep 16, 2005
  7. Junio C HamanoSep 16, 2005

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.