Semi-automated ASCII art removal tool
Jan Holesovsky
kendy at collabora.com
Thu May 15 01:59:32 PDT 2014
Hi Chris,
mostthingsweb píše v St 14. 05. 2014 v 14:01 -0700:
> I have been working on a tool to semi-automate the process of removing ASCII
> art and pointless comments (ref:
> https://bugs.freedesktop.org/show_bug.cgi?id=62475). Unless someone has an
> alternate suggestion, for the time being I will host it here:
> https://bitbucket.org/MostThingsWeb/asciitool.
>
> Screenshots: http://imgur.com/a/BO0t2
This is cool! :-) - thanks for that. Just a small thing; the last
screenshot that removes '/**'
/** something something
*/
This style of comment has a special meaning for Doxygen which parses
such comments, and adds them to the automatically generated
documentation like
http://docs.libreoffice.org/sw/html/classDocxAttributeOutput.html#a13f211c2bbce84cee1017b3d78c048a3
etc.
I would suggest that your tool should leave the comments like
///
/**
///<
untouched. Of course, /*********** does not have any meaning for
Doxygen, and should go away ;-) But a thing like /*****//** should turn
into /** only; etc.
The full list of comments understood by Doxygen is here:
http://www.stack.nl/~dimitri/doxygen/manual/docblocks.html
> I'd be interested in getting some feedback regarding this, whether it's bug
> reports, suggested features, or even just "why bother?".
I like it! :-) - thanks again for writing it.
All the best,
Kendy
More information about the LibreOffice
mailing list