From 60bcb31c6c39a830ed91e7a28582692a4da97ab1 Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Fri, 11 Jun 2010 04:34:22 -0400 Subject: [PATCH] fix docs for define-cite Closes PR 10971 original commit: 5b33f0b9510a8a8c6f178d6e0a41877b39baf72e --- 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 index acf86c4e..f57316bc 100644 --- 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