Question

I would like to include into the documentation some raw HTML. I am using Doxygen to generate this documentation so it is included in the PHP script.

The problem is that if I do this:

\\\ \htmlonly
<table>
.... etc

\\\ \endhtmlonly

PHP parses the raw HTML and hence produces errors.

But if I add ‘///’ at the start of each line that occurs in the generated page.

What is the solution to this problem? Or is it possible to get Doxygen to generate a table using the various tags?

Answer 1

I am not sure of the context of your example code, since I do not know PHP, but generally doxygen comments look like:

/// \htmlonly
/// <table>
/// .... etc
/// \endhtmlonly

Notice how all comment lines (doxygen parses comments, not source code to generate the documentation) start with ///, even the HTML code. The /// will be stripped from the HTML before being included in the documentation. Try the above and see if that fixes your problem. If not, can you provide some more context, i.e. a minimal working example.