[squeak-dev] [class comments] Kernel-Classes

Simon Michael simon at joyful.com
Wed Aug 19 18:26:23 UTC 2009


The first category in my image with uncommented classes is Kernel-Classes. I'm cautious about presuming to explain 
things in here, so if you can, please provide suitable class comments by committing or by replying to this thread. 
Otherwise I press on, knowing that comments can be improved later.

I want to ask about ClassOrganizer's comment, by NS 4/6/2004:

   "I represent method categorization information for classes.  The handling of class comments has gone through a 
tortuous evolution.   Grandfathered class comments (before late aug 98) have no time stamps, and historically, fileouts 
of class comments always substituted the timestamp reflecting the author and date/time at the moment of fileout; and 
historically any timestamps in a filed out class comment were dropped on the floor, with the author & time prevailing at 
the moment of filein being substituted.   Such grandfathered comments now go out on fileouts with '<historical>' 
timestamp; class comments created after the 8/98 changes will have their correct timestamps preserved, though there is 
not yet a decent ui for reading those stamps other than filing out and looking at the file; nor is there yet any ui for 
browsing and recovering past versions of such comments.  Everything in good time!"

Isn't ClassOrganizer about managing the class categories that we see in the left two panes of the package pane browser ? 
Why does the above focus so much on




More information about the Squeak-dev mailing list