summaryrefslogtreecommitdiff
path: root/support/digestif/data/amsrefs.sty.tags
blob: 21bcad5c0105263ed963f88a34cb1222aa7e457f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
-- Copyright 2001-2004, 2007, 2008, 2010-2013 American Mathematical Society
-- Copyright 2022 Augusto Stoffel
-- SPDX-License-Identifier: LPPL-1.3c+
--
-- Adapted from the amsrefs package documentation, which can be found
-- at https://ctan.org/pkg/amsrefs.
ctan_package = "amsrefs"
package = {
  options = {
    alphabetic = {
      details = [[
This generates alphabetic labels similar to the `alpha` BibTeX
style, consisting of the first letter(s) of each author name plus the
year of publication.
]]
    },
    shortalphabetic = {
      details = [[
This generates a shorter alphabetic label using only the first letter
of each author name.
]]
    },
    ["author-year"] = {
      details = [[
This switches to the popular author-year citation format, similar to
that described in The Chicago Manual of Style.
]]
    },
    y2k = {
      details = [[
When using the `alphabetic` option, normally only the last two digits
of the year are used in the label.  The `y2k` option instructs amsrefs
to use the full year.
]]
    },
    ["non-compressed-cites"] = {
      details = [[
Turn off range compression; citations will still be sorted.  Range
compression is also automatically turned off if amsrefs detects that
the hyperref package has been loaded.  (In order for this to work
correctly, the hyperref package must be loaded after the amsrefs
package.)
]]
    },
    ["non-sorted-cites"] = {
      details = [[
Turn off range sorting.  This also turns off range compression as a
side-effect.
]]
    },
    abbrev = {
      details = [[
This is equivalent to requesting all four of the options `initials`,
`short-journals`,`short-months` and `short-publishers`.
]]
    },
    initials = {
      details = [[
Replace the given names of all authors, editors, and translators with
their initials.
]]
    },
    ["short-journals"] = {
      details = [[
Print short form instead of full form for journal names.  This works
only with abbreviations defined with the `\DefineJournal` command.
]]
    },
    ["short-months"] = {
      details = [[
Print short version of month names (e.g., Jan. instead of January).
This works only when you write all dates in ISO 8601 format.
]]
    },
    ["short-publishers"] = {
      details = [[
Print short form instead of full form for publisher names.  This works
only with abbreviations defined with the `\DefinePublisher` command.
]]
    },
    backrefs = {
      details = [[
This option causes “back-references” to be printed at the end of each
bibliography entry to show what page it was cited on.  This option
will work only if the hyperref package is installed.
]]
    },
    ["bibtex-style"] = {
      details = [[
By default, amsrefs formats references using the AMS house style.  The
`bibtex-style` option instructs it to use a format that is very
similar to the one implemented by the standard BibTeX styles (plain,
alpha, abbrv, and unsrt).
]]
    },
    ["citation-order"] = {
      details = [[
This option applies only when using amsrefs in conjunction with
BibTeX.  Consequently, changing this option will have no effect until
after the next bibtex run.

The `citation-order` option corresponds to the standard BibTeX style
unsrt, where items are printed in the reference list in the order in
which they are cited in the document.
]]
    },
    lite = {
      details = [[
Suppress the loading of the following packages, which amsrefs
will normally automatically load:

  - mathscinet: Define a number of special characters and accents that
    are sometimes encountered when downloading data from MathSciNet.

  - txtcmds: Provide shorthand commands for a number of characters
    that are usually specified via ligatures (e.g., -- for an en-dash
    or ?` for ?.  Using these ligatures can cause problems if you're
    using fonts other than the Computer Modern Roman family or if you
    want to make it easy to convert your document to, say, HTML.
    LaTeX does provide macros for these characters, but their names
    tend to be rather unwieldy (e.g., `\textendash` and
    `\textquestiondown`, so txtcmds provides shorter names (`\ndash`
    and `\qd` in this case).
]]
    },
    ["msc-links"] = {
      details = [[
Redefine the `\MR` command to create hypertext links to the
MathSciNet database.  This option will work only if the hyperref
package is installed.
]]
    },
    nobysame = {
      details = [[
If two or more consecutive bibliography items have the same authors,
amsrefs will normally replace the author names in the second and
succeeding entries by a horizontal rule.  This option disables this
feature, causing the full author names to always be printed.
]]
    }
  }
}
commands= {
  bibselect = {
    summary = "Read \\bib entries from an ltb file.",
    action = "input",
    filename = "?.ltb",
    arguments = {
      {
        meta = "*",
        summary = "If present, print all bibliography items, including not cited.",
        optional = true,
        type = "literal"
      },
      {
        meta = "files",
        summary = "A list of files with ltb extension."
      }
    }
  },
  bib = {
    action = "amsrefs_bib",
    summary = "Create a bibliogprahy item.",
    arguments = {
      {
        meta = "label"
      },
      {
        meta = "type",
        keys = {
          article = {
            details = [[
A relatively short but self-contained item that is typically published
as part of a larger collection, such as a journal, a conference
proceedings, an edited collection published as a book, or even as part
of a World Wide Web document.
]]
          },
          book = {
            details = [[
A written work by one or more authors where the authors share credit
for the work as a whole.  For compatibility with BibTeX, the following
entry types are available as aliases for book: collection,
proceedings, manual, and unpublished.
]]
          },
          misc = {
            details = [[
Anything that doesn’t fit into one of the other types.
]]
          },
          report = {
            details = [[
A technical report, white paper, or the like. Similar to an article
but usually published and distributed by an organization such as a
university or corporation whose primary business is usually not
publishing.  Also known as a techreport.
]]
          },
          thesis = {
            details = [[
Like report but produced by the author for an educational institution
to satisfy the requirements for a degree.  Not (normally) produced by
a commercial publisher for sale.
]]
          },
          webpage = {
            details = [[
An online resource. It is limited to the following fields: accessdate,
author, date, note, subtitle, title, url.
]]
          }
        }
      },
      {
        meta = "fields",
        keys = {
          accessdate = {
            details = [[
Used to specify the date on which a webpage was viewed, as opposed to
the date on which the resource was last modified, which would be put
in the date field.
]]
          },
          address = {
            details = [[
Usually the address of the publisher or other issuing organization,
but inside the conference compound field it refers to the address of
the conference.
]]
          },
          booktitle = {
            details = [[
Used in the article type to specify the title of the book in which the
article appeared.  If anything other than a simple book title is
required, the book compound field should be used instead.
]]
          },
          date = {
            details = [[
Usually the date of publication, except inside the conference field,
where it is the date of the conference.

This replaces BibTeX's year and month fields.  Its value should be
written in ISO 8601 format, e.g., 1967-02-24.  The day and/or month
can be omitted, so all of the following are valid representations of
February 24, 1967:
```
date={1967-02-24}
date={1967-02}
date={1967}
```
Using this format allows amsrefs maximum flexibility in formatting
dates, for example, by allowing month names to be printed in full or
abbreviated as necessary.

For Winter, Spring, Summer, Fall, either use month numbers of 13, 14,
15, 16 (respectively) or just put in the text before the year:
```
date={Summer 1987},
```
For compatibility, year is provided as an alias for date, but its use
is discouraged.
]]
          },
          edition = {
            details = [[
For books or reports.  If the value of this field is a simple number,
bib will convert it to cardinal form and add “ed.” (or alternative
text if specified by the bibliography style).  Otherwise it will be
printed as is.
]]
          },
          eprint = {
            details = [[
Electronic preprint information such as for <www.arXiv.org>. See
<http://xxx.lanl.gov/help/faq/references> for recommended form.
]]
          },
          hyphenation = {
            details = [[
This corresponds to the Babel package notion of language.  The
hyphenation language used for a given bib entry is determined from
various clues, which are checked in the following order:

- The Babel language specified by the hyphenation field.

- The Babel language specified by the \emph{first word} of the
  language field (after lowercasing).

- The current Babel language that was in effect before the \cn{bib}
  command started.

- The current hyphenation patterns of the document, if there are no
  Babel language modules loaded.

The hyphenation field applies to an entire entry.  To change the Babel
language for a single field, see the discussion of the language
attribute.
]]
          },
          journal = {},
          label = {
            details = [[
When the alphabetic or shortalphabetic options are used, amsrefs will
usually try to generate the label on its own.  If necessary, you can
override the automatically generated label by specifying a label
field.
]]
          },
          language = {
            details = [[
Language of the work.  The language name should be the printed form,
not a Babel-style language name, since in principle this field could
contain more complicated remarks such as “Russian, with French
abstract”.
]]
          },
          note = {
            details = [[
Any additional information that does not fit into one of the other
fields.
]]
          },
          number = {
            details = [[
The issue number of the journal for an article or the technical report
number for a report.
]]
          },
          organization = {
            details = [[
The school, university, corporation, or other nonpublisher
organization that issued the document.
]]
          },
          pages = {},
          part = {},
          publisher = {},
          series = {},
          setup = {
            details = [[
This is a special field that can be used to give arbitrary commands to
be executed at the beginning of the current bib entry, after all the
fields have been read. The idea is that one can alter the formatting
of an individual entry through this field to handle special cases.
]]
          },
          status = {
            details = [[
Typically used for notes such as “to appear” or “in preparation”
or “unpublished” with journal articles.
]]
          },
          subtitle = {
            details = [[
Typically used with a multipart journal article to give a subtitle for
each part, but it can also be used for books.
]]
          },
          type = {
            details = [[
The type of a thesis, e.g., “Master's Thesis” or “Ph.D. Thesis”.
]]
          },
          xref = {
          },
          author = {
            details = [[
The authors of the item.  If there are other contributors that should
be acknowledged, they should be listed in contribution fields.
]]
          },
          editor = {
            details = [[
The editors of the item.  If there are other contributors that should
be acknowledged, they should be listed in contribution fields.
]]
          },
          translator = {
            details = [[
The translators of the item.  If there are other contributors that
should be acknowledged, they should be listed in contribution fields.
]]
          },
          isbn, issn = {
            details = [[
An International Standard Book or Serial Number.  (These are not
printed by the standard styles, but are reserved for future use.)
]]
          },
          review = {
            details = [[
A review number or similar pointer to, for example, Mathematical
Reviews or Zentralblatt.  You must supply any special markup for the
number; i.e., you should write

    review={\MR{2015463}}

instead of

    review={2015463}
]]
          },
          book = {
            details = [[
This is used for conference articles to make it easier to
differentiate between an article and the book or proceedings that it
appeared in.  The book field can contain any of the following
subfields: title, part, subtitle, edition, editor, translator,
contribution, series, volume, publisher, organization, address, date,
note.

It is often used in conjunction with the conference field.
]]
          },
          conference = {
            details = [[
The conference field can contain a title, address, and date.

    \bib{Burkholder1986a}{article}{
        author={Burkholder, Donald L.},
        title={Martingales and Fourier analysis in Banach spaces},
        conference={
            title={C.I.M.E. Lectures},
            address={Varenna, Italy},
            date={1985}
        },
        book={
            series={Lecture Notes in Math.},
            volume={1206},
            publisher={Springer-Verlag},
            address={Berlin and New York},
            date={1986},
        },
        pages={61--108},
        review={\MR{0864712}}
    }
]]
          },
          contribution = {
            details = [[
This field can be repeated as many times as necessary to list any
contributors other than authors, editors, or translators.

    contribution={
        type={illustrations},
        author={Gorey, Edward}
    }

which in the default style produces

    with illustrations by Edward Gorey

Since contributions are potentially complicated, so is the
contribution field:

- Sometimes it is necessary to add additional material to the type in
  order to produce intelligible text:

      contribution={
          type={an appendix},
          author={Doe, John}
      }

- amsrefs tries very hard to format multiple contributions, each of
  which may have multiple authors, in an appropriate way.  However,
  there might be cases where the default rules aren't flexible enough,
  in which case you can instead use the contribution field as a simple
  field and format it exactly the way you want:

      contribution={some arbitrary text about contributions}

This feature should only be used as a last resort, though.
]]
          },
          partial = {
            details = [[
This is used with the article type for multipart articles.  Like the
contribution field, it is repeatable.  It can contain any of the
following fields: part, subtitle, contribution, journal, volume, date,
number, pages.

    \bib{Zho-fan1972}{article}{
        author={Zho-fan, Z.},
        title={Monomials},
        partial={
            part={I},
            journal={Tot. Math.},
            volume={19},
            date={1972},
            pages={335--350}
        },
        partial={
            part={II},
            journal={Tot. Math.},
            volume={20},
            date={1973},
            pages={19--37}
        }
    }
]]
          },
          reprint = {
            details = [[
This can be used inside an article to indicate another place (usually
a book) where the article can also be found.  It can contain any field
that the book type can.

    \bib{Sokal96}{article}{
        title={Trangressing the boundaries},
        subtitle={Toward a transformative hermeneutics of quantum
        gravity},
        author={Sokal, Alan},
        journal={Social Text},
        volume={46/47},
        date={1996},
        pages={217--252},
        reprint={
            title={Fashionable Nonsense},
            subtitle={Postmodern Intellectuals' Abuse of Science},
            author={Sokal, Alan},
            author={Bricmont, Jean},
            publisher={Picador USA},
            address={New York},
            date={1998}
        }
    }
]]
          },
          translation = {
            details = [[
This is the only compound field that can be used with any bibliography
type.  It can contain any field that its parent type can contain.
]]
          }
        }
      }
    }
  },
  citelist = {
    details = [[
This is used to group a number of individual `\cite` commands into a
single citation.  Among other things, this makes it possible to add an
optional argument to any of the `\cite` commands unambiguously:

    \citelist{\cite{xx} \cite{yy}*{Theorem 4.9} \cite{zz}}

Note that there is no punctuation or other text between the `\cite
commands.  Any necessary commas or other punctuation will be supplied
automatically.  Any attempts to supply it by hand will backfire.
]]
  },
  cites = {
    action = "cite",
    arguments = {{meta = "labels"}},
    details = [[
This is a variant of citelist, provided for convenience:

    \cites{aa,bb,cc}

is equivalent to

    \citelist{\cite{aa}\cite{bb}\cite{cc}}

Note that cites does not take an optional arguments.
]]
  },
  nocite = {
    action = "cite",
    arguments = {{meta = "labels"}},
    details = [[
This continues to work the same way that it does in standard LaTeX
when used with BibTeX, but see the manual for limitations when it is
used with bibselect and ltb files.
]]
  },
  ocite = {
    action = "cite",
    arguments = {{meta = "label"}},
    summary = "Cite as an object.",
    action = "cite"
  },
  ycite = {
    action = "cite",
    arguments = {{meta = "label"}},
    summary = "Cite year.",
    action = "cite",
  },
  DefineName = {
    arguments = {
      {meta = "label"},
      {meta = "text"}
    }
  },
  DefinePublisher = {
    arguments = {
      {meta = "label"},
      {meta = "text"}
    }
  },
  DefineJournal = {
    arguments = {
      {meta = "label"},
      {meta = "text"}
    }
  }
}
environments = {
  bibdiv = {},
  biblist = {}
}