# PATCH Documentation/git-rev-list.txt typo fix

7 messages from 2005-09-15 to 2005-09-16. Participants: jdl@freescale.com, Peter Hagervall, Junio C Hamano, Chris Wright.
Thread: https://gitlist.dev/t/1815

## jdl@freescale.com, 2005-09-15 22:40

Subject: PATCH Documentation/git-rev-list.txt typo fix
Message-ID: <E1EG2Or-0005E2-Pw@jdl.com>
URL: https://gitlist.dev/e/E1EG2Or-0005E2-Pw%40jdl.com

```
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>
---


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,8 @@ 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.

```

## Peter Hagervall, 2005-09-16 14:24

Subject: Re: PATCH Documentation/git-rev-list.txt typo fix
Message-ID: <20050916142412.GA973@brainysmurf.cs.umu.se>
URL: https://gitlist.dev/e/20050916142412.GA973%40brainysmurf.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:
> 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.

```

## Junio C Hamano, 2005-09-16 16:31

Subject: Re: PATCH Documentation/git-rev-list.txt typo fix
Message-ID: <7vy85xotxt.fsf@assigned-by-dhcp.cox.net>
URL: https://gitlist.dev/e/7vy85xotxt.fsf%40assigned-by-dhcp.cox.net
In-Reply-To: <20050916142412.GA973@brainysmurf.cs.umu.se>

```
Peter Hagervall <hager@cs.umu.se> writes:

> 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.

Thanks.

Sigh...

```

## Chris Wright, 2005-09-16 20:02

Subject: Re: PATCH Documentation/git-rev-list.txt typo fix
Message-ID: <20050916200232.GM8041@shell0.pdx.osdl.net>
URL: https://gitlist.dev/e/20050916200232.GM8041%40shell0.pdx.osdl.net
In-Reply-To: <7vy85xotxt.fsf@assigned-by-dhcp.cox.net>

```
* Junio C Hamano (junkio@cox.net) wrote:
> Peter Hagervall <hager@cs.umu.se> writes:
> 
> > 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.
> 
> Thanks.

This is breaking the build.  Reverting fixes the build...

[chrisw@vas Documentation]$ make git-rev-list.1
asciidoc -b docbook -d manpage git-rev-list.txt
xmlto man git-rev-list.xml
xmlto: input does not validate (status 1)
/home/chrisw/git/git/git/Documentation/git-rev-list.xml:38: parser error : Opening and ending tag mismatch: superscript line 38 and emphasis
of <emphasis>git-rev-list foo <superscript>midpoint</emphasis> and <emphasis>git                                                              ^
/home/chrisw/git/git/git/Documentation/git-rev-list.xml:38: parser error : Opening and ending tag mismatch: emphasis line 38 and superscript
perscript>midpoint</emphasis> and <emphasis>git-rev-list midpoint </superscript>                                                                               ^make: *** [git-rev-list.1] Error 1
rm git-rev-list.xml

thanks,
-chris

```

## Chris Wright, 2005-09-16 20:06

Subject: Re: PATCH Documentation/git-rev-list.txt typo fix
Message-ID: <20050916200642.GN8041@shell0.pdx.osdl.net>
URL: https://gitlist.dev/e/20050916200642.GN8041%40shell0.pdx.osdl.net
In-Reply-To: <20050916200232.GM8041@shell0.pdx.osdl.net>

```
* Chris Wright (chrisw@osdl.org) wrote:
> * Junio C Hamano (junkio@cox.net) wrote:
> > Peter Hagervall <hager@cs.umu.se> writes:
> > 
> > > 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.
> > 
> > Thanks.
> 
> This is breaking the build.  Reverting fixes the build...

Err, ignore me.  I was one patch behind.  That patch from Peter fixes
the broken build introduced by Jon.

thanks,
-chris

```

## jdl@freescale.com, 2005-09-16 20:47

Subject: Re: PATCH Documentation/git-rev-list.txt typo fix
Message-ID: <E1EGN7c-00058R-TG@jdl.com>
URL: https://gitlist.dev/e/E1EGN7c-00058R-TG%40jdl.com
In-Reply-To: <20050916200642.GN8041@shell0.pdx.osdl.net>

```

> Err, ignore me.  I was one patch behind.  That patch from Peter fixes
> the broken build introduced by Jon.
>
> chris

Mea culpa.  Apologies.

jdl

```

## Junio C Hamano, 2005-09-16 23:01

Subject: Re: PATCH Documentation/git-rev-list.txt typo fix
Message-ID: <7v8xxwhb1s.fsf@assigned-by-dhcp.cox.net>
URL: https://gitlist.dev/e/7v8xxwhb1s.fsf%40assigned-by-dhcp.cox.net
In-Reply-To: <20050916142412.GA973@brainysmurf.cs.umu.se>

```
Thanks.  Will be pushed out when mister.kernel.org comes back
online after relocation.

```