From: handa <handa>
Date: Fri, 20 Jun 2003 00:17:35 +0000 (+0000)
Subject: *** empty log message ***
X-Git-Tag: XML-base~173
X-Git-Url: http://git.chise.org/gitweb/?p=m17n%2Fm17n-docs.git;a=commitdiff_plain;h=1b985624cbd20fef279b633ea6c299c23f0854f6

*** empty log message ***
---

diff --git a/Makefile.am b/Makefile.am
index 40fc098..0105c4e 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -49,7 +49,7 @@ usr-latex latex-usr: usr/latex/refman.ps
 ja-latex latex-ja: ja/latex/refman.ps
 dev-latex latex-dev: dev/latex/refman.ps
 
-usr-man man-usr: man/man3/m17nIntro.3
+usr-man man-usr: man/man3m/m17nIntro.3m
 
 usr: html-usr latex-usr man-usr
 ja: html-ja latex-ja
@@ -156,11 +156,16 @@ doxyhead.txt: sample.c ${UTILPATH}/mkheaderlist.rb
 	(cd sample/man3; ruby ${UTILPATH}/mkheaderlist.rb) > $@
 	rm -rf doxytemp sample
 
-%/man/man3/m17nIntro.3: doxyfile-man.% ${SRCFILES}
+%/man/man3/m17nIntro.3m: doxyfile-man.% ${SRCFILES}
 	${DOXYGEN} $<
 
-%/man/man3m/m17nIntro.3: %/man/man3/m17nIntro.3 doxyhead.txt ${UTILPATH}/mkman.rb 
-	ruby ${UTILPATH}/mkman.rb 
+man/man3m/m17nIntro.3m: usr/man/man3/m17nIntro.3m doxyhead.txt ${UTILPATH}/mkman.rb 
+	[ -d "man/man3m" ] || mkdir -p man/man3m
+	ruby ${UTILPATH}/mkman.rb usr
+
+man/ja/man3m/m17nIntro.3m: ja/man/man3/m17nIntro.3m doxyhead.txt ${UTILPATH}/mkman.rb 
+	[ -d "man/ja/man3m" ] || mkdir -p man/ja/man3m
+	ruby ${UTILPATH}/mkman.rb ja
 
 .PRECIOUS: %/latex/refman.tex
 
diff --git a/doxyfile.in b/doxyfile.in
index 769c7c0..19cf320 100644
--- a/doxyfile.in
+++ b/doxyfile.in
@@ -602,7 +602,7 @@ MAN_OUTPUT             =
 # The MAN_EXTENSION tag determines the extension that is added to 
 # the generated man pages (default is the subroutine's section .3)
 
-MAN_EXTENSION          = 
+MAN_EXTENSION          = .3m
 
 # If the MAN_LINKS tag is set to YES and Doxygen generates man output,
 # then it will generate one additional man file for each entity
diff --git a/utils/mkman.rb b/utils/mkman.rb
index 43003af..5f2516f 100644
--- a/utils/mkman.rb
+++ b/utils/mkman.rb
@@ -3,12 +3,16 @@
 #¤â¤È¤Îdirectory¤Ë¤«¤­¤Ê¤ª¤¹¡£
 # see also ¤ÎÃæ¿È¤ò woman ¸þ¤±¤Ë½ñ¤­´¹¤¨¤ë¡£
 
-usr_dev_ja=$1
-
-currentdir = Dir.pwd
-doxywork = currentdir+"doxywork"+usr_dev_ja+"man3"
-doxyman3 = currentdir+usr_dev_ja+"man/man3"
-doxyman3m = currentdir+usr_dev_ja+"man/man3m"
+usr_or_ja=$*[0]
+
+currentdir = Dir.pwd+"/"
+$doxywork = currentdir+"doxywork/"
+$srcman3 = currentdir+usr_or_ja+"/man/man3/"
+if usr_or_ja == "usr"
+  $dstman3m = currentdir+"/man/man3m/"
+else
+  $dstman3m = currentdir+"/man/ja/man3m/"
+end
 
 headertexts = open("doxyhead.txt","r").readlines
  $fdheader = headertexts[0]
@@ -45,7 +49,7 @@ def  writedocumentation(buf, text, index)
 
 def datastructure(struct)
 
-   text = open(struct.concat(".3"),"r").readlines
+   text = open(struct.concat(".3m"),"r").readlines
 
    buf = []
 
@@ -126,7 +130,7 @@ def documentfunc2 (dstart, title, func_text, short_text)
  #short_text¤Î´Ø¿ô̾¤Î£²¹Ô¸å¤¬brief¡£
    brief =  short_text[short_text.index(short_text.find{|i| i.index(ffname)}) + 2]
  #´Ø¿ô¤´¤È¤Î¥Õ¥¡¥¤¥ë¤òºî¤ë¡£
-   file = open(doxywork+fname+".3", "w")
+   file = open($doxywork+fname+".3m", "w")
    file.puts("@function")
  #¥Ø¥Ã¥À
    /^\.TH \"([^"]*)\"\s/ =~ title
@@ -334,11 +338,9 @@ end
 
 #############################dividing files
 
-Dir.mkdir "doxywork/man3" unless FileTest.directory? "doxywork/man3"
-Dir.mkdir "man" unless FileTest.directory? "man"
-Dir.mkdir "man/man3m" unless FileTest.directory? "man/man3m"
+Dir.mkdir $doxywork unless FileTest.directory? $doxywork
 
-Dir.chdir("usr/man/man3")
+Dir.chdir($srcman3)
 
 Dir.open(".").each{|filename|
      if FileTest.directory? filename 
@@ -382,16 +384,18 @@ Dir.open(".").each{|filename|
   
   end
    
-  filetowrite = open("../../../doxywork/man3/".concat(filename),"w")
-  print "filetowrite=", filetowrite
+  filetowrite = open($doxywork+filename,"w")
   filetowrite.puts(group_text)
   filetowrite.flush
 }
 
-Dir.chdir(currentdir)
 #############################rewriting files
 
-Dir.chdir("doxywork/man3")
+Dir.chdir($dstman3m)
+
+Dir.open(".").each{|f|  File.delete(f) if FileTest.file?(f)}
+
+Dir.chdir($doxywork)
 
 Dir.open(".").each{|filename|
 unless FileTest.directory? filename
@@ -406,14 +410,13 @@ unless FileTest.directory? filename
     else buf = orewrite(text)
  end
 
-  filetowrite = open("../../man/man3m/".concat(filename).concat("m"),"w")
+  filetowrite = open($dstman3m+filename,"w")
   filetowrite.puts(buf)
   filetowrite.flush
 
 end
 }
 
+Dir.chdir($doxywork)
 
-# Dir.chdir("/tmp/doxyman")
-
-# Dir.open(".").each{|f|  File.delete(f) if FileTest.file?(f)}
+Dir.open(".").each{|f|  File.delete(f) if FileTest.file?(f)}
diff --git a/utils/mkman2.rb b/utils/mkman2.rb
deleted file mode 100755
index 10b9fd5..0000000
--- a/utils/mkman2.rb
+++ /dev/null
@@ -1,395 +0,0 @@
-#! /usr/bin/ruby
-#¼Â¹Ô¤¹¤ë¤È../work¤ò¤Ä¤«¤Ã¤Æ¥Õ¥¡¥¤¥ë¤òʬ¤±¡¢
-#¤â¤È¤Îdirectory¤Ë¤«¤­¤Ê¤ª¤¹¡£
-# see also ¤ÎÃæ¿È¤ò woman ¸þ¤±¤Ë½ñ¤­´¹¤¨¤ë¡£
-
-####  to find data structure documentation files and rewriting them 
-
-def writeuntilsectionheader(buf, text, index)
-      for line in text[index .. text.size] 
-          if line =~ /^.S(H|S)/ 
-             return
-          end 
-          buf.push(line)
-     end
- end
-
-def  writedocumentation(buf, text, index)
-      for line in text[index .. text.size] 
-          if line =~ /^.SH/ 
-             return
-          end 
-           if 
-               line =~ /^.SS\s"(.+)"/
-               buf.push(".PP\n\\fB".concat($1).concat("\\fP\n"))
-               else
-               buf.push(line)
-            end
-      end
- end
-
-
-def datastructure(struct)
-
-   text = open(struct.concat(".3"),"r").readlines
-
-   buf = []
-
-#  title
-    if tline = text.index("\.SH NAME\n")
-     if text[tline+1] =~ /^([\w\s]+)\s\\-\s(.+)$/ 
-        buf.push(".SS ".concat($1).concat("\n"))
-        buf.push(".PP\n")
-        buf.push($2.concat("\n"))
-        nl = tline + 2
-        writeuntilsectionheader(buf, text, nl)
-     else
-        if 
-        text[tline+1] =~ /^([\w\s]+)\s\\-/ 
-        buf.push(".SS ".concat($1).concat("\n"))
-        buf.push(".PP\n")
-        else
-        buf.push(text[tline+1])
-        buf.push(".PP\n")   
-        end
-     end
-    end
-
-    if ddline = text.index("\.SH \"DETAILED DESCRIPTION\"\n")
-       nl = ddline + 1 
-       writeuntilsectionheader(buf, text, nl)
-   end
-
-# public types
-    if ptline = text.index("\.SS \"Public Types\"\n")
-       buf.push("\\fBPublic Types:\\fP\n")
-       nl = ptline + 1 
-       writeuntilsectionheader(buf, text, nl)
-       buf.push(".PP\n")
-   end
-
-# member enumeration documentation
-   if medline = text.index("\.SH \"MEMBER ENUMERATION DOCUMENTATION\"\n")
-      buf.push("\.PP\n\\fBMEMBER ENUMERATION DOCUMENTATION:\\fP\n")
-       nl = medline + 1 
-       writedocumentation(buf, text, nl)
-   end
-
-# data fileds
-    if dfline = text.index("\.SS \"Data Fields\"\n")
-       buf.push("\\fBData Fields:\\fP\n")
-       nl = dfline + 1 
-       writeuntilsectionheader(buf, text, nl)
-       buf.push(".PP\n")
-   end
-
-# field documentation
-   if fdline = text.index("\.SH \"FIELD DOCUMENTATION\"\n")
-      buf.push("\.PP\n\\fBFIELD DOCUMENTATION:\\fP\n")
-       nl = fdline + 1 
-       writedocumentation(buf, text, nl)
-   end
-
-return buf
-end
-
-###############################
-### ¥Õ¥¡¥¤¥ëʬ¤±
-
-def documentfunc(title, func_text, short_text)
-  func_text.grep(/^\.SS/){|i| 
- #¼«Ê¬¤è¤ê¸å¤í¤À¤±
-      func_rest =  func_text[func_text.index(i)..func_text.size] 
-      documentfunc2(i, title, func_rest, short_text)}
-end
-
-def documentfunc2 (dstart, title, func_text, short_text)
- #func_text¤ÎºÇ½é¤Î¹ÔÃæ¤Î´Ø¿ô̾
-   dstart =~ /\s([a-z_]+)\s\(/
-   return if $1 == nil
-   fname = $1
-   ffname = "\\fB".concat($1.concat("\\fP"))
- #short_text¤Î´Ø¿ô̾¤Î£²¹Ô¸å¤¬brief¡£
-   brief =  short_text[short_text.index(short_text.find{|i| i.index(ffname)}) + 2]
- #´Ø¿ô¤´¤È¤Î¥Õ¥¡¥¤¥ë¤òºî¤ë¡£
-   file = open("../work/".concat(fname.concat(".3")), "w")
-   file.puts("@function")
- #¥Ø¥Ã¥À
-   /^\.TH \"([^"]*)\"\s/ =~ title
-   oname = $1
-   newtitle = title.gsub(oname, fname.chop.chop)
-   file.puts(newtitle)
- #@brief
-   file.print("@brief ") 
-   if /^.RI/ =~ brief 
-      file.puts(brief) 
-     else file.print("\n") 
-   end
- #¥í¥ó¥°
-   file.puts(func_text[0])
-   for line in func_text[1 .. func_text.size]
-     break if /.SS/ =~ line
-     file.puts(line)
-   end  
-   file.flush
-   end
-
-####rewriting each man file
-### rewriting a man file for a function
-
-def frewrite(text)
-  buf = [text[0]]
-  title =  text[0].split(" ")[1].chop!.reverse.chop!.reverse
-
-  if text.index("\\fBReturns: \\fP\n")  == nil
-   print  title, ": Returns not described\n" 
-   end  
-  if text.index("\\fBErrors: \\fP\n")  == nil
-   print  title, ": Errors not described\n" 
-   end
-
-  buf.push(".ad l\n.nh\n.SH NAME\n")
-#  if @brief is given  
-  if text[1] =~ /\"\\fI(.+)\\fP\"/
-     buf.push(title.concat(" \- ").concat($1))
-     else buf.push(title)
-  end
-
-  synopsys = text.find{|line| line =~ /\.SS/} 
-  buf.push("\n\n.SH SYNOPSIS").push(formatsynopsys(synopsys)).push("\n")
-
-  description = text[text.index(synopsys)+2..text.size]
-  if 
-    description == []
-    print title, ": No description found\n"
-    else
-    buf.push("\n.SH DESCRIPTION\n").push(womanrewrite(desrewrite(description)))
-  end
- return buf
-end
-
-####synopsys section of a function
-
-def formatsynopsys(line)
-  line.chop!.chop!.reverse!.chop!.chop!.chop!.chop!.chop!.reverse!
-
-#  line.gsub!(/\\fP\s*/,"\n.ft\n")
-#  line.gsub!(/\\fB/,"\n.ft B\n")
-
-  line.gsub!(/\s(\w*)\)/){"\n\\fI" << $1 << "\\fP)"}
-  line.gsub!(/\s(\w*),/){"\n\\fI" << $1 << "\\fP,"}
-  line.gsub!(/\s(\w*)\s\(/){"\n\\fB" << $1 << "\\fP ("}
-end
-
-####non-synopsys section of a function
-
-def desrewrite(text)
-
-#removing identation
-  text.grep(/^\\fB.+\\fP/){|line| 
-                     ind = text.index(line)
-                     text.delete_at(ind+1)  if text[ind+1] == (".in +1c\n")}
-
-
-  text.each_with_index{|line,i|
-
-#removing "More..."  hyperlink
-  line.gsub!(/More.../,"")
-# ? ad hoc 
-  line.gsub!(/^\.TP/,"")
-
-#headers
-  line.gsub!(/^\\fBReturns: \\fP/,"\n.SH RETURNS\n.PP")
-  line.gsub!(/^\\fBSee Also:\\fP/,"\n.SH \"SEE ALSO\"\n.PP")
-  line.gsub!(/^\\fBErrors:\\fP/,"\n.SH ERRORS\n.PP")
-
-  line.gsub!(/^\\fB(.+)\\fP/){"\n.SS " << $1}
-
-#removing indentation
- if text[i - 1] =~ /^.PP/
-    if line =~ /^\s./
-   line.reverse!.chop!.reverse!
-  end
- end
-
-# removing the results of doxygen bug 
-# \fP required for . , ; and <> 
-   line.gsub!(/\s*(\\fP)+\s*(,|\.|;)\s+/){"\\fP" << $2 << "\n.ft R\n"}
-
-   line.gsub!(/(\\fP)+\s*>/,"\\fP>")
-   line.gsub!(/<\s+\\f(P|I|B|C|)/){"<\\f" << $1}
-
-
-   line.gsub!(/\s*(\\fP)+\s+/,"\n.ft R\n")
-
-   line.gsub!(/\s+\\f(I|C)\\fB\s*/,"\n.ft B\n")
-   line.gsub!(/\s+\\f(B|I)\\fC\s*/,"\n.ft C\n")
-   line.gsub!(/\s+\\f(B|C)\\fI\s*/,"\n.ft I\n")
-   line.gsub!(/\s+\\fB\s*/,"\n.ft B\n")
-   line.gsub!(/\s+\\fC\s*/,"\n.ft C\n")
-   line.gsub!(/\s+\\fI\s*/,"\n.ft I\n")
-
-  }
-
-return text
-end
-
-def womanrewrite(text)
-
-  if sasectionstart  = text.index(text.find{|line| line =~ /^\.SH\s"SEE ALSO"/})
-     aftersasection = text[sasectionstart+1 .. text.size]
-    if sasectionend = aftersasection.index(aftersasection.find{|line| line =~ /^\.SH/})
-        for line in text[sasectionstart+1 .. sasectionend + sasectionstart]
-            line.gsub!(/(\w*)\\fP\(\)/){ $1 << "(3)\\fP"}
-        end
-      else
-        for line in text[sasectionstart+1 .. text.size]
-            line.gsub!(/(\w*)\\fP\(\)/){ $1 << "(3)\\fP"}
-       end
-     end
-  end
-  return text
-end
-
-# rewriting a man file for a non-function
-
-def orewrite(text)
-  buf = []
-  structures = ["\.SH \"Data Structure Documentation\"\n"]
-
-  if ddind = text.index("\.SH \"DETAILED DESCRIPTION\"\n")
-     if odind = text.index(text.find{|line| line =~ /\.SH\s+.+\s+DOCUMENTATION/})
-    unless
-     text[ddind+1 .. odind-1].find{|line| line =~ /^[^\.]/}  
-     text = text[0 .. ddind-1] + text[odind .. text.size] 
-  end  end  end
-
-  text.each_with_index{|line,i|
-             line.gsub!(/More.../,"")
-
-     # finding structure documentations and merging into "structures"
-             if line =~ /^\.RI\s\"struct\s\\fB(.*)\\fP\"/
-                structures.push(datastructure($1))
-             end
-
-     #removing indentation
-      	     if text[i - 1] =~ /^.PP/
-              if line =~ /^\s./
-               line.reverse!.chop!.reverse!
-               end
-             end
-
-     #removing extra "-"
-             if text[i - 1] =~ /^.SH\sNAME/
-                if line =~ /\\-/
-	          unless line =~ /\\-\s./
-                  line.chop!.chop!.chop!.chop!
-                  end
-               end
-             end
-
-     #removing author section
-             line.gsub!(/^\.SH\s\"AUTHOR\"/,"")
-             line.gsub!("Generated automatically by Doxygen for m17n_test from the source code.","")
-
-             line.gsub!(/\\fP\s+,/,"\\fP,")
-             line.gsub!(/\\fP\s+\./,"\\fP.")
-             line.gsub!(/\\fC\\fB(\w+)\\fP\\fP/){"\\fB" << $1 << "\\fP"}
-
-      buf.push(line)
-  }
-
-  unless structures == ["\.SH \"Data Structure Documentation\"\n"]
-  
-  if dindex = buf.index(buf.find{|line| line =~ /\.SH\s+.+\s+DOCUMENTATION/})
-     buf = buf[0 .. dindex-1] + structures + buf[dindex .. buf.size]
-     else 
-     buf = buf + structures
-   end
-  end 
-
- return buf
-end
-
-#############################dividing files
-
-Dir.mkdir "../work" unless FileTest.directory? "../work"
-
-Dir.open(".").each{|filename|
-     if FileTest.directory? filename 
-	next
-     end   
-
-     if filename =~ /\.c\./
-#      	File.delete(filename)
-        next
-     end   
-
-     file = open(filename,"r") 
-     text = file.readlines
-     title = text[0]
-
-   if
-      sfunctionstart = text.index(text.find{|i| i =~ /^\.SS "Function/})
-        if sfunctionend = text.index(text[sfunctionstart+1 .. text.size].find{|i| i =~ /^\.SS|^\.SH/})
-        short_text = text[sfunctionstart .. sfunctionend - 1] 
-       else
-        short_text = text[sfunctionstart .. text.size - 1] 
-       end
-
-   if lfunctionstart = text.index(text.find{|i| i =~ /^\.SH "FUNCTION DOCUMENTATION"/})
-      if lfunctionend = text.index(text[lfunctionstart+1 .. text.size].find{|i| i =~ /^\.SH/})
-         func_text = text[lfunctionstart .. lfunctionend - 1] 
-         group_text = text[0 .. lfunctionstart - 1] + text[lfunctionend ..text.size]
-       else 
-         func_text = text[lfunctionstart .. text.size]
-         group_text = text[0 .. lfunctionstart - 1]
-      end
-      else 
-       func_text = [] 
-       group_text = text  
-   end
-
-   documentfunc(title, func_text, short_text)
-
-  else
-  
-  group_text = text
-  
-  end
-   
-  filetowrite = open("../work/".concat(filename),"w")
-  filetowrite.puts(group_text)
-  filetowrite.flush
-}
-
-
-#############################rewriting files
-Dir.mkdir "../../man" unless FileTest.directory? "../../man"
-Dir.mkdir "../../man/man3" unless FileTest.directory? "../../man/man3"
-
-
-Dir.open("../work").each{|filename|
-unless FileTest.directory? filename
-
-   print "PROCESSING: ", filename, "\n"
-
-    file = open("../work/".concat(filename),"r") 
-    text = file.readlines
-
- if /@function/ =~ text[0]  
-    buf = frewrite(text[1..text.size])
-    else buf = orewrite(text)
- end
-
-  filetowrite = open("../../man/man3/".concat(filename),"w")
-  filetowrite.puts(buf)
-  filetowrite.flush
-
-end
-}
-
-
-Dir.chdir("../work")
-
-Dir.open(".").each{|f|  File.delete(f) if FileTest.file?(f)}