*** empty log message ***

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

diff --git a/utils/ja_filter.rb b/utils/ja_filter.rb
index 3428949..e2f7ac1 100755 (executable)
--- a/utils/ja_filter.rb
+++ b/utils/ja_filter.rb
@@ -2,6 +2,7 @@
 
 buf = [] 
 doxy = 0
+example = 0
 
 def commentblock(buf)
     unless buf == []   
@@ -22,29 +23,53 @@ while gets
  #make variables in function descriptions shown in bold
   gsub!(/\$[A-Z_]+/) {|m| m.delete!("$").reverse.downcase!.concat(" b@").reverse}
 
+  if example == 1
+     case $_ 
+      when /#endif/
+        buf.push($_.gsub!(/#endif/, "@endcode"))
+       example = 0
+      else     
+        buf.push($_)
+    end
+
+    else  # when example == 0
+
    case  $_
      when /^\s*$/
-       if doxy == 1 
+       if doxy == 1                        # empty line in doxygen comment
            buf.push($_)
           end
-     when /\/\/\/\// 
+     when /\/\*=\*\//                         #/*=*/ (flush)
        commentblock(buf)
        buf = []
    
-     when /\/\*\s.*\*\//       # /* comment */ type comment
-       if doxy == 1            
-       buf.push($_.gsub!(/\*\//, " ").gsub!(/\/\*/, "//")) # should be included only in the example code
-       else
+      when /^\/\*\s.*\*\//     # /* comment */ type comment 
+#      if doxy == 1            
+#        # 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
-         end
+           commentblock(buf)
+           buf = []
+           print $_.gsub!(/\/\*\s.*\*\//," ") # should be omiited in code
+#        end
        end
+
      when /\/\*{2,3}en.*\*\//  #english one liner is omitted
      when /\/\*\*ja.*\*\//     #one liner
      when /\/\*\*\*ja.*\*\//   #one liner
-        buf.push($_.gsub!(/\/\*+ja/, " ").gsub!(/\*\//, " "))
+        buf.push($_.gsub!(/\/\*+ja/, " ").gsub!(/\*\//, " ")).push("\n")
      when /\/\*\*\s.*\*\//     #one liner
      when /\/\*\*\*\s.*\*\//   #one liner
         buf.push($_.gsub!(/\/\*+/, " ").gsub!(/\*\//, " ")).push("\n")
@@ -59,18 +84,10 @@ while gets
        doxy = 1
 
      when /EXAMPLE_CODE/ 
+       #start example code lines
         buf.push($_.gsub!(/#if EXAMPLE_CODE/, "\n \n @par Î㡧 \n @code"))
-       doxy = 1
+       example = 1
 
-     when /#endif/
-       if doxy == 1
-           buf.push($_.gsub!(/#endif/, "@endcode"))
-       else
-           commentblock(buf)
-          buf = []
-          print $_
-       end
-        doxy = 0
      when /\*\//
        if doxy == 1
            buf.push($_.gsub!(/\*\//, " "))
@@ -86,6 +103,7 @@ while gets
           buf = []
           print($_)
         end
+    end
    end
 end
 
@@ -93,4 +111,4 @@ commentblock(buf)
 
 # Local Variables:
 # coding: euc-jp
-# End:
\ No newline at end of file
+# End: