From: Junio C Hamano <gitster@pobox.com>
Date: Tue, 03 Mar 2026 01:48:23 GMT
Subject: Re: [GSoC PATCH 3/3] doc: gitprotocol-pack: normalize inline code formatting
Message-ID: <xmqqv7fdvg2g.fsf@gitster.g>
In-Reply-To: <aaY4tQzdEGE0hfvB@lorenzo-VM>

Lorenzo Pegorari <lorenzo.pegorari2002@gmail.com> writes:

>> > -Initiating the upload-pack or receive-pack processes over SSH is
>> > +Initiating the 'upload-pack' or 'receive-pack' processes over SSH is
>> 
>> These are not `backquoted` for <tt>teletype text</tt> typesetting,
>> like the other hunks in this patch do?
>> 
>> All other things in these three patches I found them reasonable,
>> except for this hunk.
>> 
>> Thanks.
>
> Thank you so much for catching all my mistakes Junio.
>
> I misread the existing formatting: I mistook the apostrophes for
> backticks, and so I incorrectly assumed that the document used inline
> code for command and process names. In reality, the rest of the document
> uses italics for these elements.
>
> I'm sending a v2 where I correctly uniform command and process names to
> use the italic style ASAP.

Sorry but I am confused.  

I am not sure we want <em>emphasis</em> for most of these things;
when we spell names of commands that users would type literally, in
which case we would do the <tt>monospaced</tt>, no?

I may be way off, though.  I'd appreciate our Doc experts to inject
a bit of sanity.

Thanks.