search

acbarbosa1964 / rawflickr

Automatically exported from code.google.com/p/rawflickr
Other
0 stars 0 forks source link

Proposal: Special markers for doc-comments in the source #5

Open GoogleCodeExporter opened 9 years ago

GoogleCodeExporter commented 9 years ago 
doc-comments should be explicitly marked as such by using a special marker
such as; p.e.
  {:@summary(A doc comment)} vs. {A regular one}

The reason for this is that as of now PasDoc doesn't allow for exclusion
markers (as I thought at first) so sometimes regular comments en up being
passed to the docs. :-/

Though perhaps the best solution would be changing of system altogether;
sometimes I get the impression that the source is somehow "dirty" with all
the documentation embedded it.

Original issue reported on code.google.com by sillyl...@gmail.com on 6 Jul 2008 at 8:06