Re: Is there such a thing as commenting-out doxygen markdown?

Robert Heller <[email protected]> Mon, 4 Nov 2019 13:20:45 -0500 (EST)
Newsgroups gmane.text.doxygen.general
Organization Deepwoods Software
Message-ID <[email protected]>
At Mon, 4 Nov 2019 16:38:05 +0000 "Kerry, Richard" <[email protected]> wrote:

> 
> Content-Language: en-US
> 
> 
> 
> 
> A Doxygen comment is pretty well explained in the docs, but is there some syntax to comment-out a line of mark-up in a Doxygen comment block ?
> 
> In the course of trying to get my documentation working (see elsewhere) I'd like to try removing some of the markup.  But I don't want to just delete it, or even to cut it and copy it elsewhere.  If it were source code I'd just stick line comment characters at the start of the line.  Is there an equivalent I can use within a comment block to get doxygen to ignore a line, without actually removing it?

Probably closing the comment and then reopening it *without* the Doxygen 
flagging:

/** This is for Doxygen
 * more for Doxygen
 */
/* something else (Doxygen will ignore this, even if there are Doxygen 
 * directives here) 
 */
/** More for Doxygen
 * still more for Doxygen
 */
 
(similar WRT /// or //! or /*! commenting)

> 
> 
> Regards,
> Richard.
> 
> 
> Richard Kerry
> BNCS Engineer, Global Media Practice
> 
> M: +44 (0)7812 325518
> 2nd Floor, MidCity Place, 71 High Holborn, London, WC1V 6EA
> [email protected]<mailto:[email protected]>
> 
> [cid:[email protected]]
> 
> [Email-signature-banner_IBC-2019]
> 
> Content-Description: image001.png
> 
> 
> This message contains data in an unrecognized format, image/png,
> which is being decoded and written to the file named "/home/heller/Mail/Attachments/355-image001.png".
> If you do not want this data, you probably should delete that file.
> Wrote file /home/heller/Mail/Attachments/355-image001.png
> Content-Description: image002.png
> 
> 
> This message contains data in an unrecognized format, image/png,
> which is being decoded and written to the file named "/home/heller/Mail/Attachments/330-image002.png".
> If you do not want this data, you probably should delete that file.
> Wrote file /home/heller/Mail/Attachments/330-image002.png
> Content-Description: image003.jpg
> 
> 
> This message contains data in an unrecognized format, image/jpeg,
> which is being decoded and written to the file named "/home/heller/Mail/Attachments/48-image003.jpg".
> If you do not want this data, you probably should delete that file.
> Wrote file /home/heller/Mail/Attachments/48-image003.jpg
> MIME-Version: 1.0
> 
> 
> MIME-Version: 1.0
> 
> _______________________________________________
> Doxygen-users mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
> 
>                                                                                                       

-- 
Robert Heller             -- 978-544-6933
Deepwoods Software        -- Custom Software Services
http://www.deepsoft.com/  -- Linux Administration Services
[email protected]       -- Webhosting Services