StarMirror/styleguide
1
0
Fork 0
mirror of https://github.com/google/styleguide.git synced 2024-03-22 13:11:43 +08:00
Code Issues Projects Releases Wiki Activity

Google Common Lisp Style Guide, revision 1.17

Browse Source
This commit is contained in:
tunes@google.com 2012-11-29 00:14:33 +00:00
parent c8c76a2389
commit ed8e4680ce
1 changed files with 10 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
lispguide.xml
View File

@ -5,7 +5,7 @@
<p align="right"> <p align="right">
Revision 1.16 Revision 1.17
</p> </p>
@ -1147,6 +1147,9 @@ Robert Brown
You must sign and date You must sign and date
any of the above "requiring further attention" comments any of the above "requiring further attention" comments
(but not mere cautionary explanations). (but not mere cautionary explanations).
You must use the
<a HREF="http://www.w3.org/TR/NOTE-datetime">YYYY-MM-DD</a>
format for dates to make automated processing of such dates easier.
</p> </p>
<p> <p>
This strategy ensures that grepping for <code>;---</code> This strategy ensures that grepping for <code>;---</code>
@ -3637,13 +3640,13 @@ Robert Brown
<CATEGORY title="Pitfalls"> <CATEGORY title="Pitfalls">
<STYLEPOINT title="#'FUN vs. 'FUN"> <STYLEPOINT title="#'FUN vs. 'FUN">
<SUMMARY> <SUMMARY>
You should usually refer to a function as <code>#'FOO</code> rather than <code>'FOO</code>. You should usually refer to a function as <code>#'FUN</code> rather than <code>'FUN</code>.
</SUMMARY> </SUMMARY>
<BODY> <BODY>
<p> <p>
The former, which reads as <code>(FUNCTION FOO)</code>, The former, which reads as <code>(FUNCTION FUN)</code>,
refers to the function object, and is properly scoped. refers to the function object, and is lexically scoped.
The latter, which reads as <code>(QUOTE FOO)</code>, The latter, which reads as <code>(QUOTE FUN)</code>,
refers to the symbol, which when called refers to the symbol, which when called
uses the global <code>FDEFINITION</code> of the symbol. uses the global <code>FDEFINITION</code> of the symbol.
</p> </p>
@ -3651,7 +3654,7 @@ Robert Brown
When using functions that take a functional argument When using functions that take a functional argument
(e.g., <code>MAPCAR</code>, <code>APPLY</code>, (e.g., <code>MAPCAR</code>, <code>APPLY</code>,
<code>:TEST</code> and <code>:KEY</code> arguments), <code>:TEST</code> and <code>:KEY</code> arguments),
you should use the <code>#'</code> to quote the function, you should use the <code>#'</code> to refer to the function,
not just single quote. not just single quote.
</p> </p>
<p> <p>
@ -3887,7 +3890,7 @@ Robert Brown
</small> </small>
<p align="right"> <p align="right">
Revision 1.16 Revision 1.17
</p> </p>