We need to improve on that level but this requires to fix the formatter and we do not cycle for that. Now we would love that. Guys have been working on a mark down parser so that class comments and help can be optional displayed nicely. Now the first thing is to write class and methods comments.

Hello all,

having a very short memory I need to write quite a lot of comments. I loved the way to do this in Haskell, where you essentially write a LaTeX document which happens to contains some code snippets and which still is an executable program.

So in Smalltalk you can write full expressions in comments and class example methods.

In squeak I used to write "pretty" class comments, using sections with titles in bold fonts and hypertext links where another class or method was referenced in the text.

In Pharo and in the latest squeaks this no longer seems to work. Bold fond silently disappears when saving the comment, hypertext seems to be gone entirely in Pharo.

Comments in methods are moved aound by the configurable formatter, i.e. I found no way to place comments BETWEEN statements.

Now I certaninly don't want to complain. But I would be happy if someone could give me some advice on how to comment code in a stylish way.

-- Martin