Documentation options

Tony Garnock-Jones tonyg at
Wed Jan 2 18:09:56 UTC 2008

Keith Hodges wrote:
> A slightly less radical solution which would offer the same benefit
> would be if the compiler stopped parsing if it encountered six or so
> comment quotes on a line like so. (perhaps this could be reduced to two)
> """"""

Upon reading this, I thought to myself: Each class has a classComment,
which has its own stamp, and browsers have a separate pane for editing
classComments. Perhaps methods could have a comment instance variable,
too, and the browsers could let you edit the comment separately from the
source code!

Then I went looking. CompiledMethod is a direct subclass of ByteArray,
and has no instance variables.

This is one of the weaker areas of Smalltalk: its self-representation is
not particularly object-oriented.

 [][][] Tony Garnock-Jones     | Mob: +44 (0)7905 974 211
   [][] LShift Ltd             | Tel: +44 (0)20 7729 7060
 []  [] | Email: tonyg at

More information about the Squeak-dev mailing list