Ihor Radchenko <[email protected]> writes:
> A friendly ping.

Sorry for dropping the ball on this for months.

I attach two patches. One contains my revisions on top of your patch
with edits from earlier in this thread. The other (marked
0001-org-*-REBASED.patch) is all the revisions squashed down to a fresh
patch that should apply cleanly on main.

I have kept the form you gave it, and made the following edits:

- Added =note= style for the =basic= processor

- Added examples for the =numeric= and =title= styles, using the
  =bare= variant for title, similar to how you illustrated the
  =caps-full= variant for =text= (now with added unicorns)
  
- Added long form (=text=) for the =text= style

- Moved the =year= style to after =noauthor=, as they are similar, and
  added examples
  
- Corrected the =author= and =title= examples (locators are not
  included in output, as my examples wrongly suggested)
  
- Changed the =full= variant examples to have a list of four authors
  (in the default style sheet for the CSL processor, less than four
  authors does not trigger "et al.")
  
- Fixed some typos and polished some formulations

Some outstanding questions:

- Do we need an example for =bibentry=? It would contain the full
  bibliographic data, so the table would overflow (and I'd need to
  come up with a fictive journal for the fictive article)
  
- It could probably say more about the latex-oriented processors, but
  that gets very latex-y in a complicated, processor-dependent way.
  
- I have not added any caution about =oc-basic= being a fallback.

- I have not deduplicated the variant examples under the default style
  after all; on reflection, it makes sense to me to keep them in both
  places.

Regards,
Christian

>From bbb61107baaf7345400c0df25e53267df564bf77 Mon Sep 17 00:00:00 2001
From: Christian Moe <[email protected]>
Date: Mon, 6 Apr 2026 12:39:20 +0200
Subject: [PATCH 3/3] doc/org-manual.org: Citation edits on top of edits

* doc/org-manual.org (Citations): Add note style for basic processor.
Add examples for the numeric, title, year, and text styles.  Move the
'year' style to after 'noauthor'.  Correct the 'author' and 'title'
examples to omit locators.  Correct the 'full' variants to show a list
of four authors.  Fix typos.
---
 doc/org-manual.org | 102 +++++++++++++++++++++++++++------------------
 1 file changed, 62 insertions(+), 40 deletions(-)

diff --git a/doc/org-manual.org b/doc/org-manual.org
index 9928266b3..357487c70 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -17902,8 +17902,8 @@ identifying a reference in the bibliography.
 
   : [cite:see @key p. 123]
 
-- A single citation can cite more than one reference ; the keys are
-  separated by semicolons ; the formatting of such citation groups is
+- A single citation can cite more than one reference; the keys are
+  separated by semicolons; the formatting of such citation groups is
   specified by the style.
 
   : [cite:@key1;@key2;@key3]
@@ -17925,9 +17925,10 @@ identifying a reference in the bibliography.
 
 #+cindex: styles, for citations
 Support for styles varies between processors.  Supported styles and
-variants are detailed below. Citation styles and variants can be
-specified by their full name (e.g., =author/bare=) or shortcut (e.g.,
-=a/b=).
+variants are detailed below.  The examples illustrate default results
+for the =csl= processor except for styles only supported by =basic=.
+Citation styles and variants can be specified by their full name
+(e.g., =author/bare=) or shortcut (e.g., =a/b=).
 
 - default style =nil= (<omitted>) :: Provide a typical author-date
   citation in parentheses.\\
@@ -17941,15 +17942,15 @@ specified by their full name (e.g., =author/bare=) or shortcut (e.g.,
   | =[cite:@dewaal06 p. 5]=            | (de Waal et al. 2006, 5) |
   | =[cite//bare-caps:@dewaal06 p. 5]= | De Waal et al. 2006, 5   |
   | =[cite//bc:@dewaal06 p. 5]=        | De Waal et al. 2006, 5   |
-  
-- =author= (=a=) :: As default, but suppress the year.\\
+
+- =author= (=a=) :: Provide the author names only.\\
   Variants: =bare= (=b=), =caps= (=c=), =full= (=f=), and all their
   combinations.\\
   Support: =basic= (only =c=), =csl= (all variants), =natbib= (=c=,
   =f=), =biblatex= (=c=, =f=, =cf=).
 
-  | =[cite/author:@dewaal06 p. 5]= | (de Waal et al., 5) |
-  | =[cite/a:@dewaal06 p. 5]=      | (de Waal et al., 5) |
+  | =[cite/author:@dewaal06 p. 5]= | (de Waal et al.) |
+  | =[cite/a:@dewaal06 p. 5]=      | (de Waal et al.) |
 
 - =noauthor= (=na=) :: As default, but suppress author names.\\
   Variants: =bare= (=b=), =caps= (=c=), and =bare-caps= (=bc=).\\
@@ -17959,6 +17960,14 @@ specified by their full name (e.g., =author/bare=) or shortcut (e.g.,
   | =[cite/noauthor:@dewaal06, p. 5]= | (2006, 5) |
   | =[cite/na:@dewaal06, p. 5]=       | (2006, 5) |
 
+- =year= (=y=) :: Provide the year only, like =noauthor=, but also suppress
+  locators.\\
+  Variant: =bare=.\\
+  Support: =csl=.
+
+  | =[cite/year:@dewaal06, p. 5]= | (2006) |
+  | =[cite/y:@dewaal06, p. 5]=    | (2006) |
+
 - =nocite= (=n=) :: Suppress the whole citation (but list the item in
   the bibliography).  As a special case, =[cite/n:@*]= will cause all
   works in the bibliography file(s) to be printed in the bibliography.\\
@@ -17968,39 +17977,52 @@ specified by their full name (e.g., =author/bare=) or shortcut (e.g.,
   | =[cite/nocite:@dewaal06]= | <empty> |
   | =[cite/n:@dewaal06]=      | <empty> |
 
-- =year= (=y=) :: Provide the year only, like =noauthor=, but also suppress
-  locators.\\
-  Variant: =bare=.\\
-  Support: =csl=.
-
 - =text= (=t=) :: Provide an author-date citation with the author
   outside the parentheses.\\
   Variants: =caps= (=c=), =full= (=f=), and =caps-full= (=cf=).\\
   Support: =basic= (only =c=), =natbib= (all variants), =biblatex=
   (only =c=).
 
-  | =[cite/t/cf:@dewaal06 p. 5]= | De Waal, Jones, and Smith (2006, 5) |
+  | =[cite/text:@dewaal06 p. 5]= | de Waal et al. (2006, 5)           |
+  | =[cite/t/cf:@dewaal06 p. 5]= | De Waal, Li, Wu, and Roy (2006, 5) |
 
 - =title= (=ti=) :: Provide the title only.\\
   Variant: =bare=.\\
-  Support: =csl=
+  Support: =csl=.
+
+  | =[cite/title:@dewaal06, p. 5]= | ("Unicorn Conservation")       |
+  | =[cite/ti/b:@dewaal06, p. 5]=  | "Unicorn Conservation"         |
 
 - =locators= (=l=) :: Provide the locator(s) only, e.g., the page
   number.\\
   Variant: =bare= (=b=), =caps= (=c=), =bare-caps= (=bc=).\\
   Support: =csl= (only =b=), =biblatex= (all variants).
 
-  | =[cite/locators:@dewaal06 p. 5]= | (5) |
-  | =[cite/l:@dewaal06 p. 5]=        | (5) |
+  | =[cite/locators:@dewaal06 p. 5]= | (5)      |
+  | =[cite/l:@dewaal06 sec. 2]=      | (sec. 2) |
 
-- =numeric= (=nb=) :: Provide citation number.\\
+- =numeric= (=nb=) :: Provide the citation number.\\
   Variant: none.\\
-  Support: =basic=
+  Support: =basic=.[fn:numeric:Other processors than the =basic= one
+  can also make numeric- or note-style citations, but this is done by
+  using an appropriate style file, rather than adding style variants
+  to the individual citations.  A numeric style is the default for the
+  =bibtex= exporter.]
+
+  | =[cite/numeric:@dewaal06 p. 5]= | (1 p. 5) |
+  | =[cite/n:@dewaal06 p. 5]=       | (1 p. 5) |
+
+- =note= (=ft=) :: Provide a footnote.\\
+  Variant:\\
+  Support: =basic=.
+
+  | =[cite/note:@dewaal06 p. 5]= | [1] |
+  | =[cite/n:@dewaal06 p. 5]=    | [1] |
 
 - =bibentry= (=b=) :: Provide full bibliographic information as an
   in-text citation.\\
   Variant: =bare=.\\
-  Support: =csl=
+  Support: =csl=.
 
 Here is the full list of all the variants and their meaning:
 
@@ -18008,7 +18030,7 @@ Here is the full list of all the variants and their meaning:
 
   | =[cite//bare:@dewaal06 p. 5]= | de Waal et al. 2006, 5 |
   | =[cite//b:@dewaal06 p. 5]=    | de Waal et al. 2006, 5 |
-  
+
 - =caps= (=c=) :: Capitalize the first word.  This is sometimes useful
   for last names beginning e.g.\nbsp{}with "von" or "de".
 
@@ -18017,31 +18039,31 @@ Here is the full list of all the variants and their meaning:
 
 - =bare-caps= (=bc=) :: Combine =bare= and =caps=.
 
-  | =[cite//bare-caps:@dewaal06 p. 5]= | De Waal et al. 2006, 5   |
-  | =[cite//bc:@dewaal06 p. 5]=        | De Waal et al. 2006, 5   |
-  
+  | =[cite//bare-caps:@dewaal06 p. 5]= | De Waal et al. 2006, 5 |
+  | =[cite//bc:@dewaal06 p. 5]=        | De Waal et al. 2006, 5 |
+
 - =full= (=f=) :: List all author names instead of replacing them with
   "et al."
 
-  | =[cite//full:@dewaal06 p. 5]= | (de Waal, Jones, and Smith 2006, 5) |
-  | =[cite//f:@dewaal06 p. 5]=    | (de Waal, Jones, and Smith 2006, 5) |
+  | =[cite//full:@dewaal06 p. 5]= | (de Waal, Li, Wu, and Roy 2006, 5) |
+  | =[cite//f:@dewaal06 p. 5]=    | (de Waal, Li, Wu, and Roy 2006, 5) |
 
 - =bare-full= (=bf=) :: Combine =bare= and =full=.
 
-  | =[cite//bare-full:@dewaal06 p. 5]= | de Waal, Jones, and Smith 2006, 5 |
-  | =[cite//bf:@dewaal06 p. 5]=        | de Waal, Jones, and Smith 2006, 5 |
+  | =[cite//bare-full:@dewaal06 p. 5]= | de Waal, Li, Wu, and Roy 2006, 5 |
+  | =[cite//bf:@dewaal06 p. 5]=        | de Waal, Li, Wu, and Roy 2006, 5 |
 
 - =caps-full= (=cf=) ::  Combine =caps= and =full=.
 
-  | =[cite//caps-full:@dewaal06 p. 5]= | (De Waal, Jones, and Smith 2006, 5) |
-  | =[cite//cf:@dewaal06 p. 5]=        | (De Waal, Jones, and Smith 2006, 5) |
+  | =[cite//caps-full:@dewaal06 p. 5]= | (De Waal, Li, Wu, and Roy 2006, 5) |
+  | =[cite//cf:@dewaal06 p. 5]=        | (De Waal, Li, Wu, and Roy 2006, 5) |
 
 - =bare-caps-full= (=bcf=) :: Combine =bare=, =caps=, and =full=.
 
-  | =[cite//bare-caps-full:@dewaal06 p. 5]= | De Waal, Jones, and Smith 2006, 5 |
-  | =[cite//bcf:@dewaal06 p. 5]=            | De Waal, Jones, and Smith 2006, 5 |
+  | =[cite//bare-caps-full:@dewaal06 p. 5]= | De Waal, Li, Wu, and Roy 2006, 5 |
+  | =[cite//bcf:@dewaal06 p. 5]=            | De Waal, Li, Wu, and Roy 2006, 5 |
 
-When =style= is not specified, one of the two default styles are used
+When =style= is not specified, one of the two default styles is used:
 
 - either the default style specified in the =CITE_EXPORT= keyword
   (see [[*Citation export processors]])
@@ -18049,7 +18071,7 @@ When =style= is not specified, one of the two default styles are used
   : #+cite_export: basic numeric noauthor/bare
   : [cite:@key] is the same as [cite/noauthor/bare:@key]
 
-- or, if =CITE_EXPORT= is not set, using the default =nil= style
+- or, if =CITE_EXPORT= is not set, the default =nil= style
 
   : [cite:@key] is the same as [cite/nil:@key]
 
@@ -18057,7 +18079,7 @@ When =style= is not specified, one of the two default styles are used
 While the =basic= and =csl= processors format citations directly in
 the final output format, the =bibtex=, =natbib=, and =biblatex=
 processors output corresponding Bib(La)TeX cite commands for further
-processing; for example, the =natbib= processor renders
+processing.  For example, the =natbib= processor renders
 =[cite/author:@Jones]= as ~\citeauthor{Jones}~.  With the =biblatex=
 processor the resulting commands can be controlled by customizing
 `org-cite-biblatex-styles'.  Results will depend on the style as well
@@ -18067,10 +18089,10 @@ processors.
 #+cindex: locators
 When the =csl= processor is used, "locators" such as page references
 will be recognized and rendered according to the selected CSL style
-(other processors will render them verbatim).  A locator is a part
-of the citation suffix that starts with a locator term and ends with
-the last comma or digit in the suffix, whichever comes last. Locator
-terms include "p.", "page", and "chap."[fn::CSL locator terms include
+(other processors will render them verbatim).  A locator is a part of
+the citation suffix that starts with a locator term and ends with the
+last comma or digit in the suffix, whichever comes last.  Locator
+terms include "p.", "page", and "chap."[fn::The CSL locator terms are
 "book", "bk.", "bks.", "chapter", "chap.", "chaps.", "column", "col.",
 "cols.", "figure", "fig.", "figs.", "folio", "fol.", "fols.",
 "number", "no.", "nos.", "line", "l.", "ll.", "note", "n.", "nn.",
-- 
2.43.0

>From 293576015b9e1cc27818588c5665cde0e1d4c814 Mon Sep 17 00:00:00 2001
From: Christian Moe <[email protected]>
Date: Mon, 27 Oct 2025 23:25:23 +0100
Subject: [PATCH] org-manual: Document citation styles and locators

* doc/org-manual.org (Citations): Mention style variants.  Simplify
the cite/style syntax example and add an example with a variant.
Mention locators in suffixes for the csl processor.  List each style
and variant, indicating supporting processors and variants supported
for each style, with illustrative examples.  Add a list of locator
terms.  Add index entries. Fix a few typos.

The missing documentation of citation styles was brought up by yaca in
the October 2025 Org meetup, see:
https://list.orgmode.org/87ms5cp4j5.fsf@localhost.

The listings have been adapted from the commentary in the lisp/oc-*.el
sources for the different processors.  Ihor Radchenko contributed
substantive editing and input, see discussion:

Link: https://list.orgmode.org/[email protected]
---
 doc/org-manual.org | 204 +++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 188 insertions(+), 16 deletions(-)

diff --git a/doc/org-manual.org b/doc/org-manual.org
index b7c45ff7e..357487c70 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -17885,6 +17885,7 @@ search for citation keys.
 One can then insert and edit citations using ~org-cite-insert~, called
 with {{{kbd(C-c C-x @)}}}.
 
+#+cindex: citation
 A /citation/ requires one or more citation /key(s)/, elements
 identifying a reference in the bibliography.
 
@@ -17901,37 +17902,208 @@ identifying a reference in the bibliography.
 
   : [cite:see @key p. 123]
 
-- A single citation can cite more than one reference ; the keys are
-  separated by semicolons ; the formatting of such citation groups is
+- A single citation can cite more than one reference; the keys are
+  separated by semicolons; the formatting of such citation groups is
   specified by the style.
 
   : [cite:@key1;@key2;@key3]
 
 - One can also specify a stylistic variation for the citations by
   inserting a =/= and a style name between the =cite= keyword and the
-  colon; this usually makes sense only for the author-year styles.
+  colon; this usually makes sense only for the author-year
+  styles.  Additionally, one can insert a =/= and a variant name after
+  the style.
+
+  : [cite/<style>:@key]
+  : [cite/<style>/<variant>:@key]
+
+- The only mandatory elements are:
+
+  + The =cite= keyword and the colon.
+  + The =@= character immediately preceding each key.
+  + The brackets surrounding the citation(s) (group).
+
+#+cindex: styles, for citations
+Support for styles varies between processors.  Supported styles and
+variants are detailed below.  The examples illustrate default results
+for the =csl= processor except for styles only supported by =basic=.
+Citation styles and variants can be specified by their full name
+(e.g., =author/bare=) or shortcut (e.g., =a/b=).
+
+- default style =nil= (<omitted>) :: Provide a typical author-date
+  citation in parentheses.\\
+  Variants: =bare= (=b=), =caps= (=c=), =bare-caps= (=bc=), =full=
+  (=f=), =bare-full= (=bf=), =caps-full= (=cf=), =bare-caps-full=
+  (=bcf=).\\
+  Support: =basic= (=b=, =c=, =bc=), =csl= (=b=, =c=, =bc=), =natbib=
+  (all variants), =bibtex= (variants not supported), =biblatex= (=b=,
+  =c=, =bc=).
+
+  | =[cite:@dewaal06 p. 5]=            | (de Waal et al. 2006, 5) |
+  | =[cite//bare-caps:@dewaal06 p. 5]= | De Waal et al. 2006, 5   |
+  | =[cite//bc:@dewaal06 p. 5]=        | De Waal et al. 2006, 5   |
+
+- =author= (=a=) :: Provide the author names only.\\
+  Variants: =bare= (=b=), =caps= (=c=), =full= (=f=), and all their
+  combinations.\\
+  Support: =basic= (only =c=), =csl= (all variants), =natbib= (=c=,
+  =f=), =biblatex= (=c=, =f=, =cf=).
+
+  | =[cite/author:@dewaal06 p. 5]= | (de Waal et al.) |
+  | =[cite/a:@dewaal06 p. 5]=      | (de Waal et al.) |
+
+- =noauthor= (=na=) :: As default, but suppress author names.\\
+  Variants: =bare= (=b=), =caps= (=c=), and =bare-caps= (=bc=).\\
+  Support: =basic= (only =b=), =csl= (all variants), =natbib= (only
+  =b=), =biblatex= (only =b=).
+
+  | =[cite/noauthor:@dewaal06, p. 5]= | (2006, 5) |
+  | =[cite/na:@dewaal06, p. 5]=       | (2006, 5) |
+
+- =year= (=y=) :: Provide the year only, like =noauthor=, but also suppress
+  locators.\\
+  Variant: =bare=.\\
+  Support: =csl=.
+
+  | =[cite/year:@dewaal06, p. 5]= | (2006) |
+  | =[cite/y:@dewaal06, p. 5]=    | (2006) |
+
+- =nocite= (=n=) :: Suppress the whole citation (but list the item in
+  the bibliography).  As a special case, =[cite/n:@*]= will cause all
+  works in the bibliography file(s) to be printed in the bibliography.\\
+  Variants: none.\\
+  Support: =basic=, =csl=, =natbib=, =bibtex=, =biblatex=.
+
+  | =[cite/nocite:@dewaal06]= | <empty> |
+  | =[cite/n:@dewaal06]=      | <empty> |
+
+- =text= (=t=) :: Provide an author-date citation with the author
+  outside the parentheses.\\
+  Variants: =caps= (=c=), =full= (=f=), and =caps-full= (=cf=).\\
+  Support: =basic= (only =c=), =natbib= (all variants), =biblatex=
+  (only =c=).
+
+  | =[cite/text:@dewaal06 p. 5]= | de Waal et al. (2006, 5)           |
+  | =[cite/t/cf:@dewaal06 p. 5]= | De Waal, Li, Wu, and Roy (2006, 5) |
+
+- =title= (=ti=) :: Provide the title only.\\
+  Variant: =bare=.\\
+  Support: =csl=.
+
+  | =[cite/title:@dewaal06, p. 5]= | ("Unicorn Conservation")       |
+  | =[cite/ti/b:@dewaal06, p. 5]=  | "Unicorn Conservation"         |
+
+- =locators= (=l=) :: Provide the locator(s) only, e.g., the page
+  number.\\
+  Variant: =bare= (=b=), =caps= (=c=), =bare-caps= (=bc=).\\
+  Support: =csl= (only =b=), =biblatex= (all variants).
+
+  | =[cite/locators:@dewaal06 p. 5]= | (5)      |
+  | =[cite/l:@dewaal06 sec. 2]=      | (sec. 2) |
+
+- =numeric= (=nb=) :: Provide the citation number.\\
+  Variant: none.\\
+  Support: =basic=.[fn:numeric:Other processors than the =basic= one
+  can also make numeric- or note-style citations, but this is done by
+  using an appropriate style file, rather than adding style variants
+  to the individual citations.  A numeric style is the default for the
+  =bibtex= exporter.]
+
+  | =[cite/numeric:@dewaal06 p. 5]= | (1 p. 5) |
+  | =[cite/n:@dewaal06 p. 5]=       | (1 p. 5) |
+
+- =note= (=ft=) :: Provide a footnote.\\
+  Variant:\\
+  Support: =basic=.
+
+  | =[cite/note:@dewaal06 p. 5]= | [1] |
+  | =[cite/n:@dewaal06 p. 5]=    | [1] |
+
+- =bibentry= (=b=) :: Provide full bibliographic information as an
+  in-text citation.\\
+  Variant: =bare=.\\
+  Support: =csl=.
+
+Here is the full list of all the variants and their meaning:
+
+- =bare= (=b=) :: Do not enclose the citation in parentheses.
+
+  | =[cite//bare:@dewaal06 p. 5]= | de Waal et al. 2006, 5 |
+  | =[cite//b:@dewaal06 p. 5]=    | de Waal et al. 2006, 5 |
+
+- =caps= (=c=) :: Capitalize the first word.  This is sometimes useful
+  for last names beginning e.g.\nbsp{}with "von" or "de".
+
+  | =[cite//caps:@dewaal06 p. 5]= | (De Waal et al. 2006, 5) |
+  | =[cite//c:@dewaal06 p. 5]=    | (De Waal et al. 2006, 5) |
+
+- =bare-caps= (=bc=) :: Combine =bare= and =caps=.
+
+  | =[cite//bare-caps:@dewaal06 p. 5]= | De Waal et al. 2006, 5 |
+  | =[cite//bc:@dewaal06 p. 5]=        | De Waal et al. 2006, 5 |
+
+- =full= (=f=) :: List all author names instead of replacing them with
+  "et al."
+
+  | =[cite//full:@dewaal06 p. 5]= | (de Waal, Li, Wu, and Roy 2006, 5) |
+  | =[cite//f:@dewaal06 p. 5]=    | (de Waal, Li, Wu, and Roy 2006, 5) |
+
+- =bare-full= (=bf=) :: Combine =bare= and =full=.
+
+  | =[cite//bare-full:@dewaal06 p. 5]= | de Waal, Li, Wu, and Roy 2006, 5 |
+  | =[cite//bf:@dewaal06 p. 5]=        | de Waal, Li, Wu, and Roy 2006, 5 |
+
+- =caps-full= (=cf=) ::  Combine =caps= and =full=.
+
+  | =[cite//caps-full:@dewaal06 p. 5]= | (De Waal, Li, Wu, and Roy 2006, 5) |
+  | =[cite//cf:@dewaal06 p. 5]=        | (De Waal, Li, Wu, and Roy 2006, 5) |
+
+- =bare-caps-full= (=bcf=) :: Combine =bare=, =caps=, and =full=.
 
-  : [cite/style:common prefix ;prefix @key suffix; ... ; common suffix]
+  | =[cite//bare-caps-full:@dewaal06 p. 5]= | De Waal, Li, Wu, and Roy 2006, 5 |
+  | =[cite//bcf:@dewaal06 p. 5]=            | De Waal, Li, Wu, and Roy 2006, 5 |
 
-  When =style= is not specified, one of the two default styles are
-  used
+When =style= is not specified, one of the two default styles is used:
 
-  + either the default style specified in the =CITE_EXPORT= keyword
-    (see [[*Citation export processors]])
+- either the default style specified in the =CITE_EXPORT= keyword
+  (see [[*Citation export processors]])
 
-    : #+cite_export: basic numeric noauthor/bare
-    : [cite:@key] is the same as [cite/noauthor/bare:@key]
+  : #+cite_export: basic numeric noauthor/bare
+  : [cite:@key] is the same as [cite/noauthor/bare:@key]
 
-  + or, if =CITE_EXPORT= is not set, using the default =nil= style
+- or, if =CITE_EXPORT= is not set, the default =nil= style
 
-    : [cite:@key] is the same as [cite/nil:@key]
+  : [cite:@key] is the same as [cite/nil:@key]
 
+#+vindex: org-cite-biblatex-styles
+While the =basic= and =csl= processors format citations directly in
+the final output format, the =bibtex=, =natbib=, and =biblatex=
+processors output corresponding Bib(La)TeX cite commands for further
+processing.  For example, the =natbib= processor renders
+=[cite/author:@Jones]= as ~\citeauthor{Jones}~.  With the =biblatex=
+processor the resulting commands can be controlled by customizing
+`org-cite-biblatex-styles'.  Results will depend on the style as well
+as the engine used (bibtex or biber), and will vary between
+processors.
 
-The only mandatory elements are:
+#+cindex: locators
+When the =csl= processor is used, "locators" such as page references
+will be recognized and rendered according to the selected CSL style
+(other processors will render them verbatim).  A locator is a part of
+the citation suffix that starts with a locator term and ends with the
+last comma or digit in the suffix, whichever comes last.  Locator
+terms include "p.", "page", and "chap."[fn::The CSL locator terms are
+"book", "bk.", "bks.", "chapter", "chap.", "chaps.", "column", "col.",
+"cols.", "figure", "fig.", "figs.", "folio", "fol.", "fols.",
+"number", "no.", "nos.", "line", "l.", "ll.", "note", "n.", "nn.",
+"opus", "op.", "opp.", "page", "p.", "pp.", "paragraph", "para.",
+"paras.", "¶", "¶¶", "part", "pt.", "pts.", "section", "sec.",
+"secs.", "§", "§§", "sub verbo", "s.v.", "s.vv.", "verse", "v.",
+"vv.", "volume", "vol.", "vols."].  In the following example, the
+locator =p. 3-4= might be rendered "pp. 3--4" or just "3--4" in
+export, depending on the CSL style.
 
-- The =cite= keyword and the colon.
-- The =@= character immediately preceding each key.
-- The brackets surrounding the citation(s) (group).
+: [cite:see @Tarski1965 p. 3-4 for an example]
 
 ** Citation export processors
 
-- 
2.43.0

Reply via email to