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