scribble fixes -- nested @scheme and a few other similar problems
svn: r10744
original commit: 4cd2614c21
This commit is contained in:
parent
56918ad2f2
commit
5a9ff6a044
|
@ -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