From: John MacFarlane <jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org>
To: Joseph Reagle
<joseph.2011-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>,
pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
Subject: Re: Citation syntax description in manual
Date: Tue, 18 May 2021 11:54:42 -0700 [thread overview]
Message-ID: <m28s4blvnx.fsf@MacBook-Pro.hsd1.ca.comcast.net> (raw)
In-Reply-To: <28110ceb-e6ca-a40f-48ab-6e9a6d0137fd-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>
You're right I think. If you want to propose a structure for
rewriting this, I'd consider it!
Joseph Reagle <joseph.2011-T1oY19WcHSwdnm+yROfE0A@public.gmane.org> writes:
> I was reviewing the citation syntax documentation in light of the new curly-bracket syntax [1] and wonder if the description has gotten crufty? It does reflect the evolution of the citation syntax: simple bracket citations, then no bracket "in-text" citations, then curly brackets enclosing complex pagination, and now curly brackets to enclose complex identifiers.
>
> [1]: https://github.com/jgm/pandoc/commit/3f09f53459b877f53072efbf57dec21fa37280b5
>
> If this were to be re-written, should the start of the documentation focus be on "@" and not square brackets?
>
> --
> You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/28110ceb-e6ca-a40f-48ab-6e9a6d0137fd%40reagle.org.
--
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/m28s4blvnx.fsf%40MacBook-Pro.hsd1.ca.comcast.net.
next prev parent reply other threads:[~2021-05-18 18:54 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-05-18 15:49 Joseph Reagle
[not found] ` <28110ceb-e6ca-a40f-48ab-6e9a6d0137fd-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>
2021-05-18 18:54 ` John MacFarlane [this message]
[not found] ` <m28s4blvnx.fsf-jF64zX8BO08an7k8zZ43ob9bIa4KchGshsV+eolpW18@public.gmane.org>
2021-05-18 20:58 ` Joseph Reagle
[not found] ` <d9397afc-78cb-9c47-5bb8-f5a88d096226-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>
2021-05-19 17:21 ` John MacFarlane
[not found] ` <m2r1i2iqra.fsf-jF64zX8BO08an7k8zZ43ob9bIa4KchGshsV+eolpW18@public.gmane.org>
2021-05-19 17:32 ` Joseph Reagle
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=m28s4blvnx.fsf@MacBook-Pro.hsd1.ca.comcast.net \
--to=jgm-tvlzxgkolnx2fbvcvol8/a@public.gmane.org \
--cc=joseph.2011-T1oY19WcHSwdnm+yROfE0A@public.gmane.org \
--cc=pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org \
/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).