3815: Notes with html show verbatim in narrative web

svn: r15169

src/plugins/docgen/AsciiDoc.py

@@ -362,7 +362,18 @@ class AsciiDoc(BaseDoc,TextDoc):
         else:
             self.f.write(this_text)
 
-    def write_styled_note(self,styledtext,format,style_name):
+    def write_styled_note(self, styledtext, format, style_name,
+                          contains_html=False):
+        """
+        Convenience function to write a styledtext to the ASCII doc. 
+        styledtext : assumed a StyledText object to write
+        format : = 0 : Flowed, = 1 : Preformatted
+        style_name : name of the style to use for default presentation
+        contains_html: bool, the backend should not check if html is present. 
+            If contains_html=True, then the textdoc is free to handle that in 
+            some way. Eg, a textdoc could remove all tags, or could make sure
+            a link is clickable. AsciiDoc prints the html without handling it
+        """
         text = str(styledtext)
         if format:
             #Preformatted note, keep all white spaces, tabs, LF's