scribble fixes -- nested @scheme and a few other similar problems
svn: r10744 original commit: 4cd2614c2122dd13e75d2dccc60e11109e26e152
This commit is contained in:
parent
d1a3a0a6c2
commit
28f34349dd
|
@ -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.
|
||||
|
|
Loading…
Reference in New Issue
Block a user