From cce6d2787df1b2fcbeb916b3e37a0096549f3775 Mon Sep 17 00:00:00 2001 From: handa Date: Thu, 24 Jul 2003 13:07:08 +0000 Subject: [PATCH] *** empty log message *** --- Makefile.am | 141 +++++++++++++++++++++------ data-usr/im.txt | 2 +- data-usr/m17n-lib.sty | 25 +---- data-usr/mainpage.txt | 4 +- data/dbformat.txt | 260 +++++++++++++++++++++++++++++++++++++++++++++++++ data/mainpage.txt | 67 +++++++++++++ doxyfile | 12 +-- parrot.gif | Bin 4132 -> 0 bytes parrot.png | Bin 0 -> 3599 bytes utils/mkman.rb | 24 +++-- 10 files changed, 457 insertions(+), 78 deletions(-) create mode 100644 data/dbformat.txt create mode 100644 data/mainpage.txt delete mode 100755 parrot.gif create mode 100644 parrot.png diff --git a/Makefile.am b/Makefile.am index d9cab2c..fe9797d 100644 --- a/Makefile.am +++ b/Makefile.am @@ -26,45 +26,75 @@ pkgdata_DATA = \ usr/html/index.html \ - usr/man3m/m17nIntro.3m \ - usr/latex/m17n-lib.dvi usr/latex/m17n-lib.ps + usr/latex/m17n-lib.dvi usr/latex/m17n-lib.ps \ + man/man1/m17nconfig.1 \ + man/man3/m17nIntro.3m17n \ + man/man5/m17nDatabaseFormat.5 pkgdatadir = $(datadir)/m17n-lib -EXTRA_DIST = usr/html usr/man3m usr/latex/m17n-lib.dvi usr/latex/m17n-lib.ps +EXTRA_DIST = usr/html usr/latex/m17n-lib.dvi usr/latex/m17n-lib.ps \ + man/man1 man/man3 man/man5 install-pkgdataDATA: $(pkgdata_DATA) - $(mkinstalldirs) $(pkgdatadir)/html $(mandir)/man3m + $(mkinstalldirs) $(pkgdatadir)/html + $(mkinstalldirs) $(mandir)/man1 $(mandir)/man3 $(mandir)/man5 $(INSTALL_DATA) usr/latex/m17n-lib.dvi $(pkgdatadir)/m17n-lib.dvi $(INSTALL_DATA) usr/latex/m17n-lib.ps $(pkgdatadir)/m17n-lib.ps cd usr/html; \ for f in *.html; do $(INSTALL_DATA) $$f $(pkgdatadir)/html/$$f; done - cd usr/man3m; \ - for f in *.3m; do $(INSTALL_DATA) $$f $(mandir)/man3m/$$f; done + cd usr/html; \ + for f in *.png; do $(INSTALL_DATA) $$f $(pkgdatadir)/html/$$f; done + cd man/man1; \ + for f in *.1; do $(INSTALL_DATA) $$f $(mandir)/man1/$$f; done + cd man/man3; \ + for f in *.3m17n; do $(INSTALL_DATA) $$f $(mandir)/man3/$$f; done + cd man/man5; \ + for f in *.5; do $(INSTALL_DATA) $$f $(mandir)/man5/$$f; done # # The followings are for maintainers only. # if MAINTAINER_MODE -SRCFILES = $(shell echo @M17NLIB@/src/*.[ch] @M17NLIB@/example/README.txt) - PROJECT_NAME_EN = "The M17N Library" PROJECT_NAME_JA = "M17N ¿¸À¸ì¥é¥¤¥Ö¥é¥ê" PROJECT_VERSION = @PACKAGE_VERSION@ DOXYGEN = doxygen -usr-html html-usr: usr/html/index.html usr/html/parrot.gif -ja-html html-ja: ja/html/index.html ja/html/parrot.gif -dev-html html-dev: dev/html/index.html dev/html/parrot.gif +SRC_MAN1 = \ + data/m17n-config.txt \ + data/mconv.txt \ + data/mview.txt \ + data/mdate.txt \ + data/mdump.txt \ + data/medit.txt + +SRC_MAN3 = \ + @M17NLIB@/src/m17n-core.h \ + @M17NLIB@/src/m17n.h \ + @M17NLIB@/src/m17n-gui.h \ + @M17NLIB@/src/m17n-X.h \ + @M17NLIB@/src/m17n-err.h \ + @M17NLIB@/src + +SRC_MAN5 = \ + data/dbformat.txt + +SRC_ALL = \ + data/mainpage.txt ${SRC_MAN3} ${SRC_MAN1} ${SRC_MAN5} + +usr-html html-usr: usr/html/index.html usr/html/parrot.png +ja-html html-ja: ja/html/index.html ja/html/parrot.png +dev-html html-dev: dev/html/index.html dev/html/parrot.png usr-latex latex-usr: usr/latex/m17n-lib.ps ja-latex latex-ja: ja/latex/m17n-lib.ps dev-latex latex-dev: dev/latex/m17n-lib.ps -usr-man man-usr: usr/man3m/m17nIntro.3m -ja-man man-ja: ja/man3m/m17nIntro.3m +usr-man man-usr: man/man1/m17n-config.1 man/man3/m17nIntro.3m17n man/man5/m17nDatabaseFormat.5 +ja-man man-ja: ja/man3/m17nIntro.3m usr: html-usr latex-usr man-usr ja: html-ja latex-ja @@ -72,7 +102,7 @@ dev: html-dev latex-dev doxyfile-html: doxyfile sed -e 's|%PROJECT_NUMBER%|@PACKAGE_VERSION@|' \ - -e 's|%M17NLIB%|@M17NLIB@|' \ + -e 's|%INPUT%|${SRC_ALL}|' \ -e 's|%GENERATE_HTML%|YES|' \ -e 's|%GENERATE_LATEX%|NO|' \ -e 's|%GENERATE_MAN%|NO|' \ @@ -98,7 +128,7 @@ doxyfile-html.ja: doxyfile-html doxyfile-latex: doxyfile sed -e 's|%PROJECT_NUMBER%|@PACKAGE_VERSION@|' \ - -e 's|%M17NLIB%|@M17NLIB@|' \ + -e 's|%INPUT%|${SRC_ALL}|' \ -e 's|%GENERATE_HTML%|NO|' \ -e 's|%GENERATE_LATEX%|YES|' \ -e 's|%GENERATE_MAN%|NO|' \ @@ -122,32 +152,59 @@ doxyfile-latex.ja: doxyfile-latex -e 's/%OUTPUT_LANGUAGE%/Japanese/' \ < $< >$@ -doxyfile-man: doxyfile +doxyfile-man1: doxyfile + sed -e 's|%PROJECT_NUMBER%|@PACKAGE_VERSION@|' \ + -e 's|%INPUT%|${SRC_MAN1}|' \ + -e 's|%GENERATE_HTML%|NO|' \ + -e 's|%GENERATE_LATEX%|NO|' \ + -e 's|%GENERATE_MAN%|YES|' \ + -e 's|%MAN_EXTENSION%|.1|' \ + < $< >$@ + +doxyfile-man3: doxyfile + sed -e 's|%PROJECT_NUMBER%|@PACKAGE_VERSION@|' \ + -e 's|%INPUT%|${SRC_MAN3}|' \ + -e 's|%GENERATE_HTML%|NO|' \ + -e 's|%GENERATE_LATEX%|NO|' \ + -e 's|%GENERATE_MAN%|YES|' \ + -e 's|%MAN_EXTENSION%|.3m17n|' \ + < $< >$@ + +doxyfile-man5: doxyfile sed -e 's|%PROJECT_NUMBER%|@PACKAGE_VERSION@|' \ - -e 's|%M17NLIB%|@M17NLIB@|' \ + -e 's|%INPUT%|${SRC_MAN5}|' \ -e 's|%GENERATE_HTML%|NO|' \ -e 's|%GENERATE_LATEX%|NO|' \ -e 's|%GENERATE_MAN%|YES|' \ + -e 's|%MAN_EXTENSION%|.5|' \ < $< >$@ -doxyfile-man.usr: doxyfile-man +doxyfile-man%.usr: doxyfile-man% sed -e 's|%PROJECT_NAME%|${PROJECT_NAME_EN}|' \ -e 's/%USR_JA_DEV%/usr/g' \ -e 's/%OUTPUT_LANGUAGE%/English/' \ < $< >$@ -%/html/index.html: doxyfile-html.% ${SRCFILES} \ +data/mainpage.txt: + +data/dbformat.txt: + +data/m17n-config.txt: @M17NLIB@/m17n-config.in + sed -n -e '/BEG-DOXYGEN/,/END-DOXYGEN/ p' < $< > $@ + +data/%.txt: @M17NLIB@/example/%.c + sed -n -e '/BEG-DOXYGEN/,/END-DOXYGEN/ p' < $< > $@ + +%/html/index.html: doxyfile-html.% ${SRC_ALL} \ header.html footer.html \ - data-%/mainpage.txt data-%/dbformat.txt \ utils/%_filter.rb m17n-lib.css rm -rf `dirname $@` ${DOXYGEN} $< -%/html/parrot.gif: parrot.gif +%/html/parrot.png: parrot.png cp $< $@ -%/latex/refman.tex: doxyfile-latex.% ${SRCFILES} data-%/mainpage.txt data-%/dbformat.txt \ - utils/%_filter.rb +%/latex/refman.tex: doxyfile-latex.% ${SRC_ALL} utils/%_filter.rb rm -rf `dirname $@` ${DOXYGEN} $< @@ -164,11 +221,21 @@ doxyfile-man.usr: doxyfile-man %/latex/m17n-lib.pdf: %/latex/m17n-lib.tex data-%/m17n-lib.sty utils/latex.sh utils/latex.sh `dirname $@` pdflatex -%/man/man3/m17nIntro.3m: doxyfile-man.% ${SRCFILES} utils/%_filter.rb +%/man/man1/m17n-config.1: doxyfile-man1.% ${SRC_MAN1} utils/%_filter.rb + rm -rf `dirname $@` + ${DOXYGEN} $< + +%/man/man3/m17nIntro.3m17n: doxyfile-man3.% ${SRC_MAN3} utils/%_filter.rb + rm -rf `dirname $@` + ${DOXYGEN} $< + +%/man/man5/m17nDatabaseFormat.5: doxyfile-man5.% ${SRC_MAN5} utils/%_filter.rb rm -rf `dirname $@` ${DOXYGEN} $< -usr/man3m/%.3m: usr/man/man3/%.3m sample.c utils/mkman.rb +sample/man3/SampleGroup.3: sample.c + [ -d sample ] || mkdir sample + [ -d sample/man3 ] || mkdir sample/man3 -${DOXYGEN} -g doxytemp echo "INPUT = sample.c" >> doxytemp echo "GENERATE_LATEX = NO" >> doxytemp @@ -177,10 +244,22 @@ usr/man3m/%.3m: usr/man/man3/%.3m sample.c utils/mkman.rb echo "MAN_OUTPUT = sample" >> doxytemp echo "OPTIMIZE_OUTPUT_FOR_C = yes" >> doxytemp ${DOXYGEN} doxytemp - [ -d usr/man3m ] || mkdir -p usr/man3m - rm -rf usr/man3m/index.* - ruby utils/mkman.rb usr - rm -rf doxytemp sample + rm -rf doxytemp + +man/man1/%: usr/man/man1/% sample/man3/SampleGroup.3 utils/mkman.rb + $(mkinstalldirs) man/man1 + rm -rf doxywork man/man1/* + ruby utils/mkman.rb 1 usr/man/man1 man/man1 + +man/man3/%: usr/man/man3/% sample/man3/SampleGroup.3 utils/mkman.rb + $(mkinstalldirs) man/man3 + rm -rf doxywork usr/man3/* + ruby utils/mkman.rb 3m17n usr/man/man3 man/man3 + +man/man5/%: usr/man/man5/% sample/man3/SampleGroup.3 utils/mkman.rb + $(mkinstalldirs) man/man5 + rm -rf doxywork usr/man5/* + ruby utils/mkman.rb 5 usr/man/man5 man/man5 ja/man3m/%.3m: ja/man/man3/%.3m sample-ja.c utils/mkman.rb -${DOXYGEN} -g doxytemp @@ -203,12 +282,12 @@ clean-local: WEBDIR = /project/web/extra/m17n-lib/m17n-docs -web: $(pkgdata_DATA) +web: usr-html [ -d ${WEBDIR} ] || mkdir ${WEBDIR} [ -f ${distdir}.tar.gz ] || make dist cp ${distdir}.tar.gz ${WEBDIR} cp usr/html/* ${WEBDIR} -.PRECIOUS: %/latex/m17n-lib.tex %/man/man3/m17nIntro.3m +.PRECIOUS: %/latex/m17n-lib.tex %/man/man3/m17nIntro.3m ${SRC_ALL} endif diff --git a/data-usr/im.txt b/data-usr/im.txt index 99a4292..c1b5dc6 100644 --- a/data-usr/im.txt +++ b/data-usr/im.txt @@ -1,4 +1,4 @@ -INPUT-METDHO ::= +INPUT-METHOD ::= '(' TITLE MAP-LIST MODULE-LIST ? STATE-LIST ')' TITLE ::= diff --git a/data-usr/m17n-lib.sty b/data-usr/m17n-lib.sty index 2a3ccb0..bc06fbf 100644 --- a/data-usr/m17n-lib.sty +++ b/data-usr/m17n-lib.sty @@ -1,25 +1,4 @@ \ProvidesPackage{m17n-lib} -%% Copyright (C) 2003 -*- coding: euc-jp; -*- -%% National Institute of Advanced Industrial Science and Technology (AIST) -%% Registration Number H15PRO112 - -%% This file is part of the m17n library. - -%% The m17n library is free software; you can redistribute it and/or -%% modify it under the terms of the GNU General Public License as -%% published by the Free Software Foundation; either version 2, or (at -%% your option) any later version. - -%% The m17n library is distributed in the hope that it will be useful, -%% but WITHOUT ANY WARRANTY; without even the implied warranty of -%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -%% GNU General Public License for more details. - -%% You should have received a copy of the GNU General Public License -%% along with the m17n library; see the file COPYING. If not, write to -%% the Free Software Foundation, Inc., 59 Temple Place - Suite 330, -%% Boston, MA 02111-1307, USA. - %% Don't leave the space for marginal notes. \setlength{\textwidth}{\paperwidth} \addtolength{\textwidth}{-2in} @@ -80,3 +59,7 @@ Boston, MA 02111-1307, USA. %% Run the above hook before printing TOC. \let\origtableofcontents\tableofcontents \def\tableofcontents{\m17nhook\origtableofcontents\clearpage} + +%% Add Index section to the table of contents. +\let\origprintindex\printindex +\def\printindex{\addcontentsline{toc}{section}{Index}\origprintindex} diff --git a/data-usr/mainpage.txt b/data-usr/mainpage.txt index b45ff77..902a3b3 100644 --- a/data-usr/mainpage.txt +++ b/data-usr/mainpage.txt @@ -47,8 +47,8 @@ system. @section usage How to use it? Just include in your program, and link it with the m17n -library by -lm17n. See the documentation of the module \link -m17nIntro Introduction \endlink for the detail. +library by -lm17n. See @ref m17nIntro @latexonly +(P.\pageref{group__m17nIntro}) @endlatexonly for the detail. @section contact Contact us: diff --git a/data/dbformat.txt b/data/dbformat.txt new file mode 100644 index 0000000..04cb4d0 --- /dev/null +++ b/data/dbformat.txt @@ -0,0 +1,260 @@ +/***@page m17nDatabaseFormat Data format of the m17n database + +@section dbformat General format + +The mdatabase_load () function returns the data specified by tags in +the form of plist if the first tag is not @c Mchartable nor @c +Mcharset. The keys of the returned plist are limited to +Minteger, Msymbol, Mtext, and +Mplist. The type of the value is unambiguously determined by +the corresponding key. If the key is Minteger, the value is +an integer. If the key is Msymbol, the value is a symbol. +And so on. + +A number of expressions are possible to represent a plist. For +instance, we can use the form (K1:V1, K2:V2, ..., Kn:Vn) to +represent a plist whose first property key and value are K1 and V1, +second key and value are K2 and V2, and so on. However, we can use a +simpler expression here because the types of plists used in the m17n +database are fairly restricted. + +Hereafter, we use an expression, which is similar to S-expression, to +represent a plist. (Actually, the default database loader of the m17n +library is designed to read data files written in this expression.) + +The expression consists of one or more elements. Each element +represents a property, i.e. a single element of a plist. + +Elements are separated by one or more whitespaces, i.e. a space +(code 32), a tab (code 9), or a newline (code 10). Comments begin +with a semicolon (;) and extend to the end of the line. + +The key and the value of each property are determined based on the +type of the element as explained below. + + + +EXAMPLE + +Here is an example of plist that is written in the expression +explained above. + +@verbatim +abc 123 (pqr 0xff) "m\"text" (_\\_ ("string" xyz) -456) +@endverbatim + +It represents the following plist: + +@verbatim +(Msymbol:abc, + Minteger:123, + Mplist:(Msymbol:pqr, + Minteger:255), + Mtext:m"text, + Mplist:(Msymbol:_\_, + Mplist:(Mtext:string, + Msymbol:xyz), + Minteger:-456)) +@endverbatim + +@section fontenc Font Encoding + +The m17n library loads information about the encoding of each font +form the m17n database by the tags \. The plist +format of the data is as follows: + +@verbatim +FONT-ENCODING ::= + PER-FONT-INFO * + +PER-FONT-INFO ::= + '(' FONT-SPEC ENCODING ')' + +FONT-SPEC ::= + '(' + [ FOUNDRY FAMILY [ WEIGHT [ STYLE [ STRETCH [ ADSTYLE ] ] ] ] ] REGISTRY + ')' +@endverbatim + +@c FOUNDRY to @c REGISTRY are symbols specifying the corresponding +XLFD font name fields. Omitted symbols are regarded as @c nil, and +@c nil means a wild card. For instance, this @c FONT-SPEC: + +@verbatim + (nil alice0\ lao iso8859-1) +@endverbatim + +should be applied to all fonts whose family is "alice0 lao", and +registry is "iso8859-1". + +@c ENCODING is a symbol representing a charset. A font matching @c +FONT-SPEC supports all characters of the charset, and a character code +is mapped to the corresponding glyph code of the font by this charset. + + +@section fontsize Font Resizing + +In some case, a font contains incorrect information about its size +(typically in the case of a hacked TrueType font), which results in a +bad text layout when such a font is used in combination with the other +fonts. To overcome this problem, the m17n library loads information +about font-size correction from the m17n database by the tags \. The plist format of the data is as follows: + +@verbatim +FONT-RESIZE ::= + PER-FONT-INFO * + +PER-FONT-INFO ::= + '(' FONT-SPEC RESIZE-RATIO ')' + +FONT-SPEC ::= + '(' + [ FOUNDRY FAMILY [ WEIGHT [ STYLE [ STRETCH [ ADSTYLE ] ] ] ] ] REGISTRY + ')' +@endverbatim + +The meanings of @c FOUNDRY to @c REGISTRY are the same as @e Font @e +Encoding. @c RESIZE-RATIO is an integer number specifying by +percentage how much the font-size must be adjusted. For instance, +this @c PER-FONT-INFO: + +@verbatim + ((devanagari-cdac) 150) +@endverbatim + +means that, to use a font of registry "devanagari-cdac" with a +specific size, we have to open an 1.5 times bigger one. + +@section fontset Fontset + +The m17n library loads a fontset definition from the m17n database by +the tags \. The plist format of the data is +as follows: + +@verbatim +FONTSET ::= + PER-SCRIPT * PER-CHARSET * FALLBACK * + +PER-SCRIPT ::= + '(' SCRIPT PER-LANGUAGE + ')' + +PER-LANGUAGE ::= + '(' LANGUAGE FONT-SPEC-ELEMENT + ')' + +PER-CHARSET ::= + '(' CHARSET FONT-SPEC-ELEMENT + ')' + +FALLBACK ::= + FONT-SPEC-ELEMENT + +FONT-SPEC-ELEMENT ::= + '(' FONT-SPEC [ FLT-NAME ] ')' + +FONT-SPEC ::= + '(' + [ FOUNDRY FAMILY [ WEIGHT [ STYLE [ STRETCH [ ADSTYLE ] ] ] ] ] REGISTRY + ')' +@endverbatim + +@c SCRIPT is a symbol of script name (e.g. latin, han) or @c nil. @c +LANGUAGE is a two-letter symbol of language name code defined by ISO +639 (e.g. ja, zh) or @c nil. The meanings of @c FOUNDRY to @c +REGISTRY are the same as @e Font @e Encoding. @c FLT-NAME is a name +of @ref flt. + +For instance, this @c PER_SCRIPT: + +@verbatim +(han + (ja + ((jisx0208.1983-0))) + (zh + ((gb2312.1980-0))) + (nil + ((big5-0)))) +@endverbatim + +instructs the rendering engine to use a font of registry +"jisx0208.1983-0" for a "han" character that has @c Mlanguage text +propert "ja" if the character is in the repertories of such fonts. +Otherwise, try a font of registry "gb2312.1980-0" or "big5-0". If a +"han" character does not have @c Mlangauge text property, try all +three fonts. + +@section flt Font Layout Table + +Usually, the rendering engine converts character codes of into glyph +codes one by one by consulting information about encoding of each +selected font. But, for rendering a text that requires complicated +layouting (e.g. Thai and Indic), such an one to one conversion is not +sufficient. In addition, some glyphs must be shifted 2-dimensionally +on the screen. For such a case, a font layout table (FLT in short) +must be used. + +A FLT can contain the information equivarent to OpenType Layout Table +(CMAP, GSUB, and GPOS) in addition to the information about how to +extract a grapheme cluster and how to re-order characters. + +The m17n library loads a FLT from the m17n database by the tags +\. The plist format of the data is as +follows: + +@verbinclude flt.txt + +@section im Input Method + +@verbinclude im.txt + +*/ + +//// diff --git a/data/mainpage.txt b/data/mainpage.txt new file mode 100644 index 0000000..902a3b3 --- /dev/null +++ b/data/mainpage.txt @@ -0,0 +1,67 @@ +/***@mainpage The M17N Library Documentation + +@section what What is the m17n library? + +The @e m17n @e library is a multilingual text processing library for +the C language. + +
    + +
  • It is a free and open source software. + +
  • It is for any GNU/Linux and Unix applications/libraries. + +
  • It realizes multilingualization of many aspects of +applications/libraries. + +
+ +The word "m17n" is an abbreviation of "multilingualization". + +The m17n library provides following facilities to handle +multilingual text. + +
    + +
  • @e M-text: A data structure for a multilingual text. It is +basically a string but with attributes called text property, and +is designed to substitute for the C string. It is the most important +object of the m17n library. + +
  • Functions for creating and processing M-texts. + +
  • Functions for converting M-texts from/to strings encoded in +various existing formats. + +
  • A huge character space, which contains all the Unicode +characters and more non-Unicode characters. + +
  • @e Chartable: A data structure that contains per-character +information efficiently. + +
  • Functions for inputting and displaying M-text on a window +system. + +
+ +@section usage How to use it? + +Just include in your program, and link it with the m17n +library by -lm17n. See @ref m17nIntro @latexonly +(P.\pageref{group__m17nIntro}) @endlatexonly for the detail. + +@section contact Contact us: + +Global IT Security Group\n +National Information Technology Research Institute\n +Institute of Advanced Industrial Science and Technology + +Web: http://www.m17n.org/m17n-lib/ + +Bug report: m17n-lib-bug@m17n.org + +Mailing list (English): m17n-lib@m17n.org + +Mailing list (Japanese): m17n-lib-ja@m17n.org +*/ +//// diff --git a/doxyfile b/doxyfile index 3bcace2..044dcf8 100644 --- a/doxyfile +++ b/doxyfile @@ -308,15 +308,7 @@ WARN_LOGFILE = warning # directories like "/usr/src/myproject". Separate the files or directories # with spaces. -INPUT = "data-%USR_JA_DEV%/mainpage.txt" -INPUT += "%M17NLIB%/src/m17n-core.h" -INPUT += "%M17NLIB%/src/m17n.h" -INPUT += "%M17NLIB%/src/m17n-gui.h" -INPUT += "%M17NLIB%/src/m17n-X.h" -INPUT += "%M17NLIB%/src/m17n-err.h" -INPUT += "%M17NLIB%/src/" -INPUT += "data-%USR_JA_DEV%/dbformat.txt" -INPUT += "%M17NLIB%/example/README.txt" +INPUT = %INPUT% # If the value of the INPUT tag contains directories, you can use the # FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp @@ -609,7 +601,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 = .3m +MAN_EXTENSION = %MAN_EXTENSION% # 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/parrot.gif b/parrot.gif deleted file mode 100755 index b07e3bf8967f03297ee76822c1699876d9da6e58..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 4132 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 diff --git a/parrot.png b/parrot.png new file mode 100644 index 0000000000000000000000000000000000000000..d740fa0c0b1fe100f8e20c35b59c00feabad656b GIT binary patch literal 3599 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 literal 0 HcmV?d00001 diff --git a/utils/mkman.rb b/utils/mkman.rb index 5cf667d..f695ff1 100644 --- a/utils/mkman.rb +++ b/utils/mkman.rb @@ -1,25 +1,23 @@ #! /usr/local/bin/ruby +# Usage: mkman.rb SRCDIR DSTDIR + #¼Â¹Ô¤¹¤ë¤È/tmp/doxyman¤ò¤Ä¤«¤Ã¤Æ¥Õ¥¡¥¤¥ë¤òʬ¤±¡¢ #¤â¤È¤Îdirectory¤Ë¤«¤­¤Ê¤ª¤¹¡£ # see also ¤ÎÃæ¿È¤ò woman ¸þ¤±¤Ë½ñ¤­´¹¤¨¤ë¡£ -usr_or_ja=$*[0] +$manext="."+$*[0] # # Setting up directory names. # $currentdir = Dir.pwd+"/" +$srcdir=$currentdir+$*[1]+"/" +$dstdir=$currentdir+$*[2]+"/" $doxywork = $currentdir+"doxywork/" -$srcman3 = $currentdir+usr_or_ja+"/man/man3/" -if usr_or_ja == "usr" - $dstman3m = $currentdir+"/usr/man3m/" -else - $dstman3m = $currentdir+"/ja/man3m/" -end $sampledir="sample/man3/" - $headfile = $currentdir+"manhead" + headbuf = open($headfile, "r").readlines # @@ -87,7 +85,7 @@ def writedocumentation(buf, text, index) def datastructure(struct) - text = open(struct.concat(".3m"),"r").readlines + text = open(struct.concat($manext),"r").readlines buf = [] @@ -172,7 +170,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+".3m", "w") + file = open($doxywork+fname+$manext, "w") file.puts("@function") #¥Ø¥Ã¥À /^\.TH \"([^"]*)\"\s/ =~ title @@ -402,7 +400,7 @@ end Dir.mkdir $doxywork unless FileTest.directory? $doxywork -Dir.chdir($srcman3) +Dir.chdir($srcdir) Dir.open(".").each{|filename| @@ -454,7 +452,7 @@ Dir.open(".").each{|filename| #############################rewriting files -Dir.chdir($dstman3m) +Dir.chdir($dstdir) Dir.open(".").each{|f| File.delete(f) if FileTest.file?(f)} @@ -477,7 +475,7 @@ unless FileTest.directory? filename else buf = orewrite(text) end - filetowrite = open($dstman3m+filename,"w") + filetowrite = open($dstdir+filename,"w") filetowrite.puts(headbuf) filetowrite.puts(buf) filetowrite.flush -- 1.7.10.4