*** empty log message ***

[m17n/m17n-docs.git] / utils / usr_filter.rb

diff --git a/utils/usr_filter.rb b/utils/usr_filter.rb
index 05e3fe8..10d4094 100755 (executable)
--- a/utils/usr_filter.rb
+++ b/utils/usr_filter.rb
@@ -33,17 +33,24 @@ while gets
    
      when /^\/\*\s.*\*\//      # /* comment */ type comment
        if doxy == 1            
-       buf.push($_.gsub!(/\*\//, " ").gsub!(/\/\*/, "//")) # should be included only in the example code
+         # should be included only in the example code
+         ## We used to do the following substituion as a workaround of
+         ## a Doxygen bug.
+         ## buf.push($_.gsub!(/\*\//, " ").gsub!(/\/\*/, "//"))
+         buf.push($_)
        end
 
      when /\/\*\s.*\*\//       # code + /* comment */ type comment
        if doxy == 1            
-       buf.push($_.gsub!(/\*\//, " ").gsub!(/\/\*/, "//")) # should be included in the example code
+         # should be included in the example code
+         ## See the above comment.
+         ## buf.push($_.gsub!(/\*\//, " ").gsub!(/\/\*/, "//"))
+         buf.push($_) # should be included in the example code
        else
           if doxy == 0 
-         commentblock(buf)
-         buf = []
-         print $_.gsub!(/\/\*\s.*\*\//," ")                # should be omiited in code
+           commentblock(buf)
+           buf = []
+           print $_.gsub!(/\/\*\s.*\*\//," ") # should be omiited in code
          end
        end