{"thread":{"id":"56177","subject":"[PATCH] Documentation: render special characters correctly","startedAt":"2021-07-29T11:03:01Z","lastAt":"2021-07-29T13:04:45Z","messageCount":2,"participants":["Andrei Rybak","Jeff King"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"431476","messageId":"20210729110252.116214-1-rybak.a.v@gmail.com","threadId":"56177","inReplyTo":null,"subject":"[PATCH] Documentation: render special characters correctly","fromName":"Andrei Rybak","fromEmail":"rybak.a.v@gmail.com","sentAt":"2021-07-29T11:02:52Z","receivedAt":"2021-07-29T11:03:01Z","isPatch":true,"sender":{"key":"rybak.a.v@gmail.com","avatar":"https://avatars.githubusercontent.com/u/624072?v=4"},"body":"Three hyphens are rendered verbatim, so \"--\" has to be used to produce a\ndash.  There is no double arrow (\"<->\" is rendered as \"<→\"), so a left\nand right arrow \"<-->\" have to be combined for that.\n\nSo fix asciidoc output for special characters.  This is similar to fixes\nin commit de82095a95 (doc hash-function-transition: fix asciidoc output,\n2021-02-05).\n\nSigned-off-by: Andrei Rybak <rybak.a.v@gmail.com>\n---\n Documentation/git-fetch.txt   | 2 +-\n Documentation/gittutorial.txt | 2 +-\n 2 files changed, 2 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/git-fetch.txt b/Documentation/git-fetch.txt\nindex 9067c2079e..550c16ca61 100644\n--- a/Documentation/git-fetch.txt\n+++ b/Documentation/git-fetch.txt\n@@ -133,7 +133,7 @@ remember to run that, set `fetch.prune` globally, or\n linkgit:git-config[1].\n \n Here's where things get tricky and more specific. The pruning feature\n-doesn't actually care about branches, instead it'll prune local <->\n+doesn't actually care about branches, instead it'll prune local <-->\n remote-references as a function of the refspec of the remote (see\n `<refspec>` and <<CRTB,CONFIGURED REMOTE-TRACKING BRANCHES>> above).\n \ndiff --git a/Documentation/gittutorial.txt b/Documentation/gittutorial.txt\nindex 59ef5cef1f..0e0b863105 100644\n--- a/Documentation/gittutorial.txt\n+++ b/Documentation/gittutorial.txt\n@@ -322,7 +322,7 @@ initiating this \"pull\".  If Bob's work conflicts with what Alice did since\n their histories forked, Alice will use her working tree and the index to\n resolve conflicts, and existing local changes will interfere with the\n conflict resolution process (Git will still perform the fetch but will\n-refuse to merge --- Alice will have to get rid of her local changes in\n+refuse to merge -- Alice will have to get rid of her local changes in\n some way and pull again when this happens).\n \n Alice can peek at what Bob did without merging first, using the \"fetch\"\n-- \n2.32.0\n\n"},{"id":"431481","messageId":"YQKnaCcfJaagTF/h@coredump.intra.peff.net","threadId":"56177","inReplyTo":"20210729110252.116214-1-rybak.a.v@gmail.com","subject":"Re: [PATCH] Documentation: render special characters correctly","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2021-07-29T13:04:40Z","receivedAt":"2021-07-29T13:04:45Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Thu, Jul 29, 2021 at 01:02:52PM +0200, Andrei Rybak wrote:\n\n> Three hyphens are rendered verbatim, so \"--\" has to be used to produce a\n> dash.  There is no double arrow (\"<->\" is rendered as \"<→\"), so a left\n> and right arrow \"<-->\" have to be combined for that.\n> \n> So fix asciidoc output for special characters.  This is similar to fixes\n> in commit de82095a95 (doc hash-function-transition: fix asciidoc output,\n> 2021-02-05).\n\nThanks. I looked at the doc-diff output before and after this patch, and\nthey both seem like strict improvements.\n\nThe double-arrow thing is kind of weird to me in the first place,\nthough. I suspect it might be more clear if it just spelled out what it\nis trying to say with words. Something like:\n\n  The pruning feature doesn't actually care about branches. Instead, it\n  will prune local refs tracking remote ones as a function of...\n\nBut I'm OK to leave that to do on top; the current code simply renders\nincorrectly, and your patch is fixing that.\n\n-Peff\n"}]}