copperspice / doxypress

Documentation generator using annotated sources for multiple computer languages
https://www.copperspice.com/
GNU General Public License v2.0
148 stars 14 forks source link

Broken section formatting #32

Open Sp3EdeR opened 4 years ago

Sp3EdeR commented 4 years ago

When creating sections or subsections (either with commands or Markdown), adding span-formatting into the section contents (such as <code>...</code> or Markdown backticks), the generated formatting tags are HTML-escaped (contain &lt; and &gt; entities).

This is a regression issue, it is not being reproduced in an old version. As far as I had time to debug it, the parser seems to generate "Sym_Less" tokens within the sections. I did not find why yet.

agserm commented 4 years ago

Thanks for reporting this. Can you provide a little more information about the exact input you are using? There are multiple different code paths for the parsing, and knowing the precise input syntax is important to trace this down.

Sp3EdeR commented 4 years ago

.dox

/** \page some_id Some Title

# Section `with code span` #
content

\subsection mysectionid <code>with code span</code>
content

*/

some_id html

.md:

Some Other Title {#some_other_id}
================

# Section `with code span`
content

\subsection mysectionid2 <code>with code span</code>
content

some_other_id html

Sp3EdeR commented 4 years ago

(note: while there I think it would be a good idea to update Markdown's to for modernization's sake)