*** empty log message ***

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

diff --git a/utils/usr_filter.rb b/utils/usr_filter.rb
index c776220..10d4094 100755 (executable)
--- a/utils/usr_filter.rb
+++ b/utils/usr_filter.rb
@@ -13,8 +13,6 @@ def commentblock(buf)
 
 while gets
 
-#  print "****",  $_, "\n"
-
   gsub!("@seealso", "@par See Also:")
   gsub!("@errors", "@par Errors:")
   gsub!("@returns", "@par Return value:")
@@ -29,20 +27,33 @@ while gets
        if doxy == 1 
            buf.push($_)
           end
-     when /\/\/\/\// 
+     when /\/\*=\*\// 
        commentblock(buf)
        buf = []
    
-     when /\/\*\s.*\*\//       # /* comment */ type comment
+     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            
+         # 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
+
      when /\/\*{2,3}ja.*\*\//  #japanese one liner
      when /\/\*\*en.*\*\//     #one liner
      when /\/\*\*\*en.*\*\//   #one liner