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
|
Avoid cut-and-paste for descriptive text. If two functions are
|
||||||
similar, consider documenting them together with
|
similar, consider documenting them together with
|
||||||
@scheme[deftogether]. To abstract a description, consider using
|
@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
|
except that ...,'' instead of abstracting the source and instantiating
|
||||||
it multiple times; often, a prose abstraction is clearer to the reader
|
it multiple times; often, a prose abstraction is clearer to the reader
|
||||||
than a hidden abstraction in the document implementation.
|
than a hidden abstraction in the document implementation.
|
||||||
|
|
Loading…
Reference in New Issue
Block a user