scribble fixes -- nested @scheme and a few other similar problems

svn: r10744

original commit: 4cd2614c2122dd13e75d2dccc60e11109e26e152
This commit is contained in:
Eli Barzilay 2008-07-13 17:13:20 +00:00
parent d1a3a0a6c2
commit 28f34349dd

View File

@ -27,7 +27,7 @@ Prefer ``function'' to ``procedure.''
Avoid cut-and-paste for descriptive text. If two functions are
similar, consider documenting them together with
@scheme[deftogether]. To abstract a description, consider using
explicit prose abstraction, such as ``@scheme[x] is like @scheme[@y],
explicit prose abstraction, such as ``@scheme[x] is like @scheme[y],
except that ...,'' instead of abstracting the source and instantiating
it multiple times; often, a prose abstraction is clearer to the reader
than a hidden abstraction in the document implementation.