Hi Michael,

On Jul 20, 2012, at 1:06 , <michael.bro...@thomsonreuters.com> 
<michael.bro...@thomsonreuters.com> wrote:

> Even using direct HTML <table> format, Doxygen removes the HTML character 
> entity.  :(

Doxygen supports multiple output formats, so it cannot possibly support any 
random entity in all formats.
As a result it supports a limited set.

You can insert HTML only code using \htmlonly ... \endhtmlonly.
For convenience you could wrap this in a ALIAS, e.g.:

ALIASES = html{1}="\htmlonly \1\endhtmlonly"

Then you can for instance use:

/** @mainpage
 *  This is a HTML entity \html{&#177;}
 */

You can also use UTF-8 characters directly (or others encodings depending on 
your INPUT_ENCODING setting)

>  
> And equivalent entity &#177; does not work: Doxygen turns it into:   
> &amp;#177;
> Escaping the "&" gives the same result.
>  
> So how can I get HTML character entities inside an HTML table in Doxygen?
>  
> (&plusmn; and &#177; both work fine in tables outside of Doxygen.)
>  
>  
>  
> From: Broida, Michael 
> Sent: Thursday, July 19, 2012 5:33 PM
> To: Broida, Michael; doxygen-users@lists.sourceforge.net
> Subject: RE: [Doxygen-users] Markdown-style tables don't allow HTML entities 
> inside
>  
> The &plusmn; entity is in the list that Doxygen supports, but the &#124; 
> entity is not.

&plusmn; was only added in version 1.8.1.2.

>  
> From: Broida, Michael 
> Sent: Thursday, July 19, 2012 5:16 PM
> To: doxygen-users@lists.sourceforge.net
> Subject: [Doxygen-users] Markdown-style tables don't allow HTML entities 
> inside
>  
> Hi!
>  
> If I use a Markdown-style table in Doxygen 1.8.1.1, any/every HTML "entity" 
> in the table is ignored.
>  
> Example:
>  
> Type | Result Range
> ---- | ------------
> junk | &plusmn;3.4E-38 .. &plusmn;3.4E+38
>  
> The entity "&plusmn;" is discarded.

In version 1.8.1.2 this works.

>  
> I've seen that with other entities as well: I tried to embed a pipe symbol 
> (&#124;) into such a table and it did not work.  (Escaping the pipe did not 
> work, so I hoped the entity would work.)

Escaping the pipe symbol is also possible in 1.8.1.2.

Regards,
  Dimitri


------------------------------------------------------------------------------
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users

Reply via email to