Note Structure

D’Note scans for the common noting pattern used by develepors of many laguages of an all-caps label followed bt a colon. To be more specific, for D’Note to recogznie a note, it needs ot follow this simple set of rules:

1) Notes start with an all-caps label punctuated with a colon, followed by the note’s text.

  # LABEL: description ...

2) Specially designated notes can omit the colon. By default these are TODO, FIXME and OPTIMIZE. Eg.

  # TODO description ...

3) Any note that requires more than one line must remain flush to the left margin (the margin is set by the first line). This is done because RDoc will mistake the note for a <pre> block if it is indented.

  # LABEL: description ...
  # continue ...

4) An alternative to the limitation of the last rule is to indent the whole note, making it a <pre> block. Then the text layout is free-form.

  # This is a description of something...
  #
  #   LABEL: description ...
  #          continue ...

That’s all there is to it, if I can convince the developers of RDoc to add recognize labels, we may eventually be able to relax the flush rule, which would be very nice.