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.