[Aldor-l] Source documentation

[Pippijn van Steenhoven]

Also related but previously forgotten: where can doc comments be and what
are the semantics of these comments? Are they attached to the expression,
such that:

  Foo (I : Integer) : Integer == {
      +++ This doc comment is attached to the following expression
      I := I + 1;
      ++ This doc comment is attached to the above expression
      +++ This doc comment is attached to I * I
      I * I
      ++ I * I is multiplying a number by itself (interesting, isn't it?)
  }

What use is a doc comment? How can one use them? More importantly: what
do we _want_ them to do?

-- 
Pippijn van Steenhoven
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: Digital signature
URL: <http://aldor.org/pipermail/aldor-l_aldor.org/attachments/20090425/37bce2dd/attachment.bin>