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

Re: Broken alignment in git-reset docs

From
MÅMartin Ågren <martin.agren@gmail.com>
Date
Nov 28, 2018, 12:02 UTC
Message-ID
<CAN0heSph-a08AzsihqqxfC=nqmUQLsqx-rKGULXQ-gmT4+c10w@mail.gmail.com>
In-Reply-To
<CAJjcwZ-bjCVbsXhyRtQHsH9U+yytbRvq07j4hTOnuD-g0XXL0w@mail.gmail.com>
On Wed, 28 Nov 2018 at 12:42, Paweł Samoraj <samoraj.pawel@gmail.com> wrote:
Show 5 quoted lines
>
> Hi!
> The git-reset documentation page section which is accessible via URL
> https://git-scm.com/docs/git-reset#_discussion is not looking good.
>
[snip]
>
> The web archive has got a snapshot from 2014-06-28 when it was ok
> (https://web.archive.org/web/20140628170155/http://git-scm.com/docs/git-reset).
Hi Paweł

Thanks for the report. The sources have not changed since 2010, so this is most likely because something in the build has changed. It's probably that git-scm.com has switched to using Asciidoctor (as opposed to Asciidoc). The correct fix could be something like 379805051d ("Documentation: render revisions correctly under Asciidoctor", 2018-05-06).

Do you feel like attempting a patch against git.git? The hard part of that is probably to get all the build dependencies in place, in particular to be able to test with both Asciidoc and Asciidoctor. See USE_ASCIIDOCTOR in Documentation/Makefile. If you're not up for it, no problem, I should be able to get to this later today.

Thanks again for the report. Martin

Previous: Paweł SamorajNext: Martin Ågren
Message 2 of 7 in “Broken alignment in git-reset docs”
  1. Paweł SamorajNov 28, 2018
  2. Martin ÅgrenNov 28, 2018
  3. 0/2 Re: Broken alignment in git-reset docsMartin Ågren, Nov 28, 2018
  4. 1/2 git-reset.txt: render tables correctly under AsciidoctorMartin Ågren, Nov 28, 2018
  5. Ævar Arnfjörð BjarmasonNov 28, 2018
  6. Martin ÅgrenNov 28, 2018
  7. 2/2 git-reset.txt: render literal examples as monospaceMartin Ågren, Nov 28, 2018

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.