# [PATCH] Documentation/gitmodules: fix asciidoc

5 messages from 2007-06-15 to 2007-06-16. Participants: Sam Vilain, Shawn O. Pearce, Lars Hjemli.
Thread: https://gitlist.dev/t/8605

## Sam Vilain, 2007-06-15 03:42

Subject: [PATCH] Documentation/gitmodules: fix asciidoc
Message-ID: <11818789512948-git-send-email-sam.vilain@catalyst.net.nz>
URL: https://gitlist.dev/e/11818789512948-git-send-email-sam.vilain%40catalyst.net.nz

```
---
  I was getting documentation build errors without this

 Documentation/gitmodules.txt |    4 +++-
 1 files changed, 3 insertions(+), 1 deletions(-)

diff --git a/Documentation/gitmodules.txt b/Documentation/gitmodules.txt
index 7814b6a..5c9fe9c 100644
--- a/Documentation/gitmodules.txt
+++ b/Documentation/gitmodules.txt
@@ -5,9 +5,11 @@ NAME
 ----
 gitmodules - defining submodule properties
 
+
 SYNOPSIS
 --------
-.gitmodules
+[verse]
+'.gitmodules'
 
 
 DESCRIPTION
-- 
1.5.2.0.45.gfea6d-dirty

```

## Shawn O. Pearce, 2007-06-15 03:49

Subject: Re: [PATCH] Documentation/gitmodules: fix asciidoc
Message-ID: <20070615034915.GE18491@spearce.org>
URL: https://gitlist.dev/e/20070615034915.GE18491%40spearce.org
In-Reply-To: <11818789512948-git-send-email-sam.vilain@catalyst.net.nz>

```
Sam Vilain <sam.vilain@catalyst.net.nz> wrote:
> ---
>   I was getting documentation build errors without this

Yea, I got doc build errors today too from `next` but did not have
time to track down what was causing them.  Something about the XML
not matching the DocBook DTD.

-- 
Shawn.

```

## Sam Vilain, 2007-06-15 03:53

Subject: Re: [PATCH] Documentation/gitmodules: fix asciidoc
Message-ID: <46720D44.2040409@vilain.net>
URL: https://gitlist.dev/e/46720D44.2040409%40vilain.net
In-Reply-To: <20070615034915.GE18491@spearce.org>

```
Shawn O. Pearce wrote:
> Sam Vilain <sam.vilain@catalyst.net.nz> wrote:
>   
>> ---
>>   I was getting documentation build errors without this
>>     
>
> Yea, I got doc build errors today too from `next` but did not have
> time to track down what was causing them.  Something about the XML
> not matching the DocBook DTD.

Yep, the synopsis section did not have enough in it to satisfy the
requirements of asciidoc, so it generated an empty <refsynopsisinfo>
section which doesn't match the DocBook 4.2 DTD.

Perhaps there is another solution by fixing the asciidoc.conf... but
looks like voodoo to me :)

Sam.

```

## Lars Hjemli, 2007-06-15 07:11

Subject: Re: [PATCH] Documentation/gitmodules: fix asciidoc
Message-ID: <8c5c35580706150011g2189e45dvb1dc1567f12c7f8c@mail.gmail.com>
URL: https://gitlist.dev/e/8c5c35580706150011g2189e45dvb1dc1567f12c7f8c%40mail.gmail.com
In-Reply-To: <20070615034915.GE18491@spearce.org>

```
On 6/15/07, Shawn O. Pearce <spearce@spearce.org> wrote:
> Sam Vilain <sam.vilain@catalyst.net.nz> wrote:
> > ---
> >   I was getting documentation build errors without this
>
> Yea, I got doc build errors today too from `next`

This is my bad, sorry about that.

Have you tested the patch in
<11817720703159-git-send-email-hjemli@gmail.com> /
http://article.gmane.org/gmane.comp.version-control.git/50135 ?

--
larsh

```

## Sam Vilain, 2007-06-16 01:53

Subject: Re: [PATCH] Documentation/gitmodules: fix asciidoc
Message-ID: <4673428E.6070106@vilain.net>
URL: https://gitlist.dev/e/4673428E.6070106%40vilain.net
In-Reply-To: <8c5c35580706150011g2189e45dvb1dc1567f12c7f8c@mail.gmail.com>

```
Lars Hjemli wrote:
>> Yea, I got doc build errors today too from `next`
> This is my bad, sorry about that.
> Have you tested the patch in
> <11817720703159-git-send-email-hjemli@gmail.com> /
> http://article.gmane.org/gmane.comp.version-control.git/50135 ?

Yep, that works, cheers.

Sam.

```