vishapoberon / compiler

vishap oberon compiler
http://oberon.vishap.am
GNU General Public License v3.0
186 stars 25 forks source link

comments in showdef? #29

Open antranigv opened 8 years ago

antranigv commented 8 years ago

showdef is an amazing tool, specially for newbies, it helps to understand the content of a module without reading the source code. however, it will be more useful, it the .sym files where also commented about every TYPE, CONST, PROCEDURE, etc. This also means that we will need to re-implement showdef, AFAIK it does not support comments. thanks in advance.

dcwbrown commented 8 years ago

The Oakwood guidelines propose that showdef retain comments that begin (**. i.e. two asterisks instead of one.

antranigv commented 8 years ago

True, and, AFAIK, there is a tool implemented for that, called Watson. we should try either porting watson, and/or add an option for voc that creates .sym files with exported comments.