git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Felipe Contreras <felipe.contreras@gmail.com>
To: "Martin Ågren" <martin.agren@gmail.com>,
	"Felipe Contreras" <felipe.contreras@gmail.com>
Cc: Git Mailing List <git@vger.kernel.org>
Subject: Re: [PATCH 0/6] AsciiDoc vs Asciidoctor, once again
Date: Fri, 14 May 2021 15:11:41 -0500	[thread overview]
Message-ID: <609ed97d9013_43127208bd@natae.notmuch> (raw)
In-Reply-To: <CAN0heSp7JFS3j+DypQm=P-rPzyScvs+Yed75AXYBsQpbJtVytA@mail.gmail.com>

Martin Ågren wrote:
> On Fri, 14 May 2021 at 14:24, Felipe Contreras
> <felipe.contreras@gmail.com> wrote:
> >
> > Martin Ågren wrote:
> > > On Fri, 14 May 2021 at 03:40, Felipe Contreras
> > > <felipe.contreras@gmail.com> wrote:
> > >
> > > > We should be submitting bug reports to the asciidoctor project as well,
> > > > so in the future it's less likely we find ourselves in the same
> > > > scenario.
> > > >
> > > > Preferably the bug report should be in the commit message.
> > >
> > > I don't have an account with the website they use for their issue
> > > tracking.
> >
> > GitHub? It probably takes a couple of minutes to set up an account.
> 
> Yes, it's GitHub. I'm not interested in having an account there. There's
> some trade-off there with me not being able to report bugs, but that
> cuts both ways, so I don't feel bad about it.

I don't see what are those both ways, but OK.

> > > If you want to submit a bug report and post the link here,
> > > that's fine by me and I'll include it in the reroll.
> >
> > If you would rather have me act as a proxy, that's fine by me.
> 
> Thanks. If you have better things to do, no worry.

I do, but reporting bugs doesn't that *that* much time.

> > Just give me a simple example that produces the issue.
> 
> Here are three variants where AsciiDoc 8.6.10 renders the same, with
> emphasis:
> 
>   single quotes that will not render literally: 'git cat-file'.
> 
>   single quotes that won't render literally: 'git cat-file'.
> 
>   single quotes that\'ll render literally: 'git cat-file'.
> 
> With Asciidoctor (2.0.15),
> 
>   asciidoctor -b docbook5 -d manpage -o test.xml test.txt
> 
> the XML contains

I'm not talking about the XML, I'm talking about the man pages. I'm not
interested in intermediary code, I'm interested in the final output,
which does seem to work correctly:

  ruby -r asciidoctor <<\EOF
  puts Asciidoctor.convert(<<REOF, backend: :manpage)
  single quotes that will not render literally: 'git cat-file'.
  single quotes that won't render literally: 'git cat-file'.
  single quotes that\'ll render literally: 'git cat-file'.
  REOF
  EOF

  single quotes that will not render literally: \(aqgit cat\-file\(aq.
  single quotes that won\(cqt render literally: \(aqgit cat\-file\(aq.
  single quotes that\(cqll render literally: \(aqgit cat\-file\(aq.

Cheers.

-- 
Felipe Contreras

      reply	other threads:[~2021-05-14 20:11 UTC|newest]

Thread overview: 22+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-05-13 18:17 [PATCH 0/6] AsciiDoc vs Asciidoctor, once again Martin Ågren
2021-05-13 18:17 ` [PATCH 1/6] git-http-push.txt,git-send-pack.txt: avoid single quote Martin Ågren
2021-05-13 18:17 ` [PATCH 2/6] git-range-diff.txt: avoid single quotes Martin Ågren
2021-05-13 18:17 ` [PATCH 3/6] git-check-ref-format.txt: avoid single quote Martin Ågren
2021-05-13 19:16   ` Eric Sunshine
2021-05-13 19:35     ` Martin Ågren
2021-05-13 22:00   ` Junio C Hamano
2021-05-14  9:07     ` Martin Ågren
2021-05-14 12:30       ` Felipe Contreras
2021-05-14  5:30   ` Jeff King
2021-05-14  9:08     ` Martin Ågren
2021-05-13 18:17 ` [PATCH 4/6] diff-options.txt: move monospace markup out of attribute Martin Ågren
2021-05-13 18:17 ` [PATCH 5/6] git-svn.txt: change verse to listing block Martin Ågren
2021-05-13 18:17 ` [PATCH 6/6] Doc: use two backticks for monospace, not backtick+apostrophe Martin Ågren
2021-05-13 20:35 ` [PATCH 0/6] AsciiDoc vs Asciidoctor, once again Junio C Hamano
2021-05-14  8:40   ` Martin Ågren
2021-05-14 12:18     ` Felipe Contreras
2021-05-14  1:40 ` Felipe Contreras
2021-05-14  8:43   ` Martin Ågren
2021-05-14 12:24     ` Felipe Contreras
2021-05-14 15:28       ` Martin Ågren
2021-05-14 20:11         ` Felipe Contreras [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=609ed97d9013_43127208bd@natae.notmuch \
    --to=felipe.contreras@gmail.com \
    --cc=git@vger.kernel.org \
    --cc=martin.agren@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).