On 7/15/10 11:33 PM, Matt Seddon wrote:
To address Allesio's concern, I've now moved the processing of DocStrings into LispObject.getDocumentation. When no FUNCTION documentation has been set for a symbol, it checks to see if there is an annotation it can pull out of the symbol's function in the function slot, and attach and return it if found.
A good use of annotations! Note that there are two other places in ABCL where the use of the string "###" in comments are used: 1. In the function GROVEL-JAVA-DEFINITIONS-IN-FILE in compile-system.lisp, which produces a tags file via Lisp. 2. The target 'TAGS' in 'build.xml' which passes a regexp to 'etags'. Of the two uses, I certainly make heavy use of #2. I suspect that #1 could be deprecated. If we are going to start removing the "###" docstrings, it would be nice to at least adjust the regexp in #2. -- "A screaming comes across the sky. It has happened before, but there is nothing to compare to it now."