From: Junio C Hamano <gitster@pobox.com>
Date: Wed, 13 Jun 2007 16:20:05 GMT
Subject: Re: [PATCH 2/3] Add gitmodules(5)
Message-ID: <7vd4zzg72i.fsf@assigned-by-dhcp.pobox.com>
In-Reply-To: <20070613153611.GA11852@moooo.ath.cx>

Matthias Lederhofer <matled@gmx.net> writes:

> Lars Hjemli <hjemli@gmail.com> wrote:
>> +SYNOPSIS
>> +--------
>> +.gitmodules
>
> My asciidoc (7.1.2 and 8.2.1) generates an empty refsynopsisdiv from
> this.  xmlto refuses to convert this into anything else:
> ...
> This breaks the build process for the documentation.  I could not find
> out how to fix this.  Probably just needs the right quoting for the
> dot at the beginning of the line.

Sorry, I should have caught this much earlier, as already knew
about this issue when I did gitattributes(5).

As it seems to be customary not to even say 'dot' at the
beginning for man(5) section (existing examples I found are
netrc, postgresrc, procmailrc, ...), I think the best fix is
just to do s/\.gitmodules/gitmodules/ there.