Date: prev next · Thread: first prev next last
2014 Archives by date, by thread · List index


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


Context


Privacy Policy | Impressum (Legal Info) | Copyright information: Unless otherwise specified, all text and images on this website are licensed under the Creative Commons Attribution-Share Alike 3.0 License. This does not include the source code of LibreOffice, which is licensed under the Mozilla Public License (MPLv2). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.