From: Xavi Artigas <xavierartigas@yahoo.es>
Date: Tue, 23 Jul 2019 10:45:17 +0000 (+0200)
Subject: mono-docs: Allow HTML codes in documentation
X-Git-Tag: submit/tizen/20190805.083058~175
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=bb052b9fa609e556a6911769722a276008926650;p=platform%2Fupstream%2Fefl.git

mono-docs: Allow HTML codes in documentation

Summary:
All comments from EO files are HTML-escaped (i.e. "<" is turned into "&lt;"), and this is good.
However all text added by the mono code generator is HTML-escaped too, and that is a pity.
Circumventing the escaping in the generator involves serious code changes so it is simpler to
allow "escaping" characters to avoid escaping...
"<" is turned into "&lt;"
but
"\<" is turned into "<"

If you are giving these strings from C, remember that the backslash needs to be escaped too!
For example: "\\<b\\>Hello\\</b\\>"

This is intended for use in the generators, NOT in the EO docs.

Test Plan: Everything works as before, but now HTML codes can be added from the generators.

Reviewers: lauromoura, vitor.sousa, felipealmeida

Subscribers: cedric, #reviewers, #committers

Tags: #efl

Differential Revision: https://phab.enlightenment.org/D9380
---

diff --git a/src/lib/eolian_cxx/grammar/html_escaped_string.hpp b/src/lib/eolian_cxx/grammar/html_escaped_string.hpp
index 9a6eef1..371afcd 100644
--- a/src/lib/eolian_cxx/grammar/html_escaped_string.hpp
+++ b/src/lib/eolian_cxx/grammar/html_escaped_string.hpp
@@ -26,6 +26,7 @@ struct html_escaped_string_generator
                case '\'': out.append("&apos;"); break;
                case '<':  out.append("&lt;"); break;
                case '>':  out.append("&gt;"); break;
+               case '\\': if (pos < input.size() - 1) pos++; // Deliberate fallthrough
                default:   out.append(&input[pos], 1); break;
             }
         }