From: Junio C Hamano <gitster@pobox.com>
Date: Mon, 17 Dec 2012 02:24:58 GMT
Subject: Re: [PATCH v2] Documentation: don't link to example mail addresses
Message-ID: <7vehippg91.fsf@alter.siamese.dyndns.org>
In-Reply-To: <20121216140029.GE2725@river.lan>

John Keeping <john@keeping.me.uk> writes:

> diff --git a/Documentation/git-fast-import.txt b/Documentation/git-fast-import.txt
> index d1844ea..68bca1a 100644
> --- a/Documentation/git-fast-import.txt
> +++ b/Documentation/git-fast-import.txt
> @@ -427,7 +427,7 @@ they made it.
>  
>  Here `<name>` is the person's display name (for example
>  ``Com M Itter'') and `<email>` is the person's email address
> -(``cm@example.com'').  `LT` and `GT` are the literal less-than (\x3c)
> +(``\cm@example.com'').  `LT` and `GT` are the literal less-than (\x3c)

I seem to be getting

(<tt>`\cm@example.com'').  `LT</tt> and <tt>GT</tt> are the literal less-than (\x3c)

out of this part in the resulting HTML output, which is probably not
what you wanted to see.

I have a feeling that it might be a better solution to stop using
these pretty quotes.  It's not like we use them a lot and a quick
scanning of "git grep '``'" output seems to tell me that many of
them should be `monospace output`, and the rest (mostly references
to section headers) can be "Section".