From: Junio C Hamano <gitster@pobox.com>
Date: Thu, 07 Jan 2010 21:08:38 GMT
Subject: Re: [NON-PATCH 3/2] Documentation/git-merge: format full commands in typewriter font
Message-ID: <7v3a2h39nt.fsf@alter.siamese.dyndns.org>
In-Reply-To: <ebbb4e2b0e98490a64b3cd52c33d3a995fa7e980.1262883414.git.trast@student.ethz.ch>

Thomas Rast <trast@student.ethz.ch> writes:

> * More importantly, while `code` style seems to be an improvement in
>   HTML output (because it gives typewriter font), my local 'man'
>   renders 'emphasis' as underlines -- which actually makes the code
>   snippets much more visible than `literal` quotes which are not
>   rendered specially at all.
>
> So which way should it be changed?

I'd prefer to see us mark code as `code`.

The documentation toolchain may hopefully be fixed in the upstream in the
future, and we could keep our local style tweaks in Documentation/ until
that happens if we really wanted to.