commit 60bcb31c6c39a830ed91e7a28582692a4da97ab1 parent 8a28499503be46a98d34f728a244d3abce6c5a87 Author: Matthew Flatt <mflatt@racket-lang.org> Date: Fri, 11 Jun 2010 04:34:22 -0400 fix docs for define-cite Closes PR 10971 original commit: 5b33f0b9510a8a8c6f178d6e0a41877b39baf72e Diffstat:
| M | collects/scriblib/scribblings/autobib.scrbl | | | 15 | ++++++++++----- |
1 file changed, 10 insertions(+), 5 deletions(-)
diff --git a/collects/scriblib/scribblings/autobib.scrbl b/collects/scriblib/scribblings/autobib.scrbl @@ -22,16 +22,21 @@ Binds @scheme[~cite-id], @scheme[citet-id], and @scheme[generate-bibliography-id], which share state to accumulate and render citations. -The function bound to @scheme[~cite-id] produces a citation with a -preceding non-breaking space. It has the contract +The function bound to @scheme[~cite-id] produces a citation referring +to one or more bibliography entries with a preceding non-breaking +space. It has the contract @schemeblock[ ((bib?) () (listof bib?) . ->* . element?) ] -The function bound to @scheme[citet-id] has the same contract as the -function for @scheme[~cite-id], but it generates an element suitable -for use as a noun refering to the document or its author. +The function bound to @scheme[citet-id] generates an element suitable +for use as a noun---referring to a document or its author---for a +single bibliography entry. It has the contract + +@schemeblock[ +(bib? . -> . element?) +] The function bound to @scheme[generate-bibliography-id] generates the section for the bibliography. It has the contract