[armedbear-devel] DocString (lazy version)

[Mark Evenson]

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."