From 6456a92ebbfd854d285ea41db6d653dbe7b495ce Mon Sep 17 00:00:00 2001
From: David Turner <david@freetype.org>
Date: Mon, 7 Jan 2002 12:09:51 +0000
Subject: [PATCH] fixed html quoting in DocMaker

---
 ChangeLog             |  4 +++-
 src/tools/docmaker.py | 27 ++++++++++++++++-----------
 2 files changed, 19 insertions(+), 12 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index dd1e8d1f1..05421ef4c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,7 +1,9 @@
-2002-01-06  David Turner  <david@freetype.org>
+2002-01-07  David Turner  <david@freetype.org>
 
         * docs/BUGS, docs/CHANGES: updating documentation for 2.0.6 release
 
+        * src/tools/docmaker.py: fixed HTML quoting in sources
+
         * include/freetype/config/ftoption.h: setting default options for
         a release build (debugging off, bytecode interpreter off)
 
diff --git a/src/tools/docmaker.py b/src/tools/docmaker.py
index a20f22b5b..a818d1a73 100644
--- a/src/tools/docmaker.py
+++ b/src/tools/docmaker.py
@@ -171,12 +171,17 @@ def sort_order_list( input_list, order_list ):
 # Translate a single line of source to HTML.  This will convert
 # a "<" into "&lt.", ">" into "&gt.", etc.
 #
-def html_format( line ):
-    result = string.replace( line, "<", "&lt." )
-    result = string.replace( line, ">", "&gt." )
-    result = string.replace( line, "&", "&amp." )
+def html_quote( line ):
+    result = string.replace( line,   "&", "&amp;" )
+    result = string.replace( result, "<", "&lt;" )
+    result = string.replace( result, ">", "&gt;" )
     return result
 
+# same as 'html_quote', but ignores left and right brackets
+#
+def html_quote0( line ):
+    return string.replace( line, "&", "&amp;" )
+
 
 # Open the standard output to a given project documentation file.  Use
 # "output_dir" to determine the filename location if necessary and save the
@@ -355,10 +360,10 @@ class DocCode:
         # The code footer should be directly appended to the last code
         # line to avoid an additional blank line.
         #
-        sys.stdout.write( code_header )
+        print code_header,
         for line in self.lines[0 : l+1]:
-            sys.stdout.write( '\n' + html_format(line) )
-        sys.stdout.write( code_footer )
+            print '\n' + html_quote(line),
+        print code_footer,
 
 
 
@@ -435,7 +440,7 @@ class DocParagraph:
                     word = '?' + word
 
             if cursor + len( word ) + 1 > max_width:
-                print html_format( line )
+                print html_quote0(line)
                 cursor = 0
                 line   = ""
 
@@ -451,7 +456,7 @@ class DocParagraph:
             #
             if extra:
                 if cursor + len( extra ) + 1 > max_width:
-                    print html_format( line )
+                    print html_quote0(line)
                     cursor = 0
                     line   = ""
 
@@ -460,7 +465,7 @@ class DocParagraph:
                 extra  = None
 
         if cursor > 0:
-            print html_format(line)
+            print html_quote0(line)
 
         # print "§" # for debugging only
 
@@ -877,7 +882,7 @@ class DocBlock:
         print source_header
         print ""
         for line in lines[0 : l+1]:
-            print line
+            print html_quote(line)
         print source_footer
 
         in_table = 0