git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] doc: fix 'git status --help' character quoting

From
Philip Oakley <philipoakley@iee.org>
Date
Oct 21, 2014, 22:08 UTC
Message-ID
<F862A78B765340E9B18BFDC2A9C2E96F@PhilipOakley>
In-Reply-To
<xmqqy4sa1pct.fsf@gitster.dls.corp.google.com>
From: "Junio C Hamano" <gitster@pobox.com>
Show 37 quoted lines
> Junio C Hamano <gitster@pobox.com> writes:
>
>> "Philip Oakley" <philipoakley@iee.org> writes:
>>
>>> From: "Junio C Hamano" <gitster@pobox.com>
>>> ...
>>>> I think it is just the font. I just opened the above page with
>>>> Chrome and futzed the text from '0' to '0123456789' to see how it
>>>> look.  That round thing is consistent with how other digits are
>>>> rendered.
>>>>
>>>> https://plus.google.com/u/0/+JunioCHamano/posts/dzNXV2FwP6K
>>>>
>>>> (sorry for a URL to plus)
>>>>
>>>>> https://www.kernel.org/pub/software/scm/git/docs/git-status.html
>>>>> (which IIUC is out of date) has an unformatted 0.
>>>> --
>>>
>>> I've just had a look at how it formats when the zero is back-tick
>>> quoted s /ASCII 0/ASCII `0`/ and it looks OK with both Chromium and
>>> Firefox on my hack Ubuntu laptop - the character is colourised and
>>> full sized, and the --man page output looks unchanged and clearly a
>>> zero.
>>>
>>> my hacky attempt at an in-line patch (squash in?) below:
>>
>> You'd need a matching change to 34 in the same document to preserve
>> the consistency the original patch sought, though ;-)
>
> Not that I think such a change makes much sense.
>
> If there was a way to force use of a font whose numerals and I/O are
> more clearly distinguishable and we do so for all HTML documents we
> generate, that would be a good change that is not limited to these
> places, though.
>

I've generated a patch for the 'git status --help' that can act as a reference. (to follow)

For me it's only those pages that have a lone zero that cause problems due to lack of context. It'll still be a slow burner problem as lone zeros are spotted.

Philip 
Previous: Junio C Hamano
Message 9 of 9 in “doc: fix 'git status --help' character quoting”
  1. doc: fix 'git status --help' character quotingPhilip Oakley, Oct 19, 2014
  2. Junio C HamanoOct 19, 2014
  3. Philip OakleyOct 20, 2014
  4. Philip OakleyOct 20, 2014
  5. Junio C HamanoOct 20, 2014
  6. Philip OakleyOct 20, 2014
  7. Junio C HamanoOct 20, 2014
  8. Junio C HamanoOct 20, 2014
  9. Philip OakleyOct 21, 2014

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.