发信人: dingdang()
整理人: zelor(2001-11-27 10:40:26), 站内信件
|
第一节, 上一节, 下一节, 最后一节, 回到目录
----------------------------------------------------------------------
----------
编译文档
目前Automake可支持Texinfo和Man格式。
Texinfo
如果当前目录包含Texinfo源文件，则必须在`TEXINFOS'主变量中声明。一般Tex
info文件将被转换成info文件，所以这里多数都使用 info_TEXINFOS宏。注意Te
xinfo源文件的扩展名必须是 `.texi'或`.texinfo'。
如果`.texi'文件@include了`version.texi', 则该文件可被自动生成。`versio
n.texi'定义了3个你可以引用的 Texinfo宏: EDITION, VERSION和UPDATED。前两
个是软件包的版本号，后面那个是主文件的最后修改日期。对 `version.texi'的
支持需要mdate-sh程序，此程序随 Automake一起发布。
有时一个info文件实际上依赖于多个`.texi'文件。例如，在GNU Hello中，`hel
lo.texi'包含了`gpl.texi'文件。你可通过`texi_TEXINFOS'变量告诉Automake
这些文件之间的依赖性。具体如下:
info_TEXINFOS = hello.texi
hello_TEXINFOS = gpl.texi
默认情况下Automake要求`texinfo.tex'应位于Texinfo源文件所在的目录。但是
，你也可在`configure.in'中使用 AC_CONFIG_AUX_DIR宏，然后可在该目录下查
找 `texinfo.tex'文件。若指定了`--add-missing' 选项，则Automake可自动提
供`texinfo.tex'文件。
如果软件包的多个目录中都有Texinfo文件，就必须使用 TEXINFO_TEX变量来告诉
automake在哪里找到规范的 `texinfo.tex'文件。此变量的值可以是基于当前 `
Makefile.am'所在目录的相对路径:
TEXINFO_TEX = ../doc/texinfo.tex
若使用了`no-texinfo.tex'选项，则可以不需要`texinfo.tex'。但最好是使用T
EXINFO_TEX变量，因为这样就让dvi 目标在任何情况下都可工作。
Automake会生成一个install-info目标，有些人可能会用到。缺省时，info页会
在运行`make install'时安装。但若指定了no-installinfo选项，则不会安装。
Man手册页
Man手册页在`MANS'主变量中声明，通常使用 man_MANS宏来完成。根据文件的扩
展名，Man手册页会被自动安装到mandir目录的合适的子目录下。 based on the
file extension.
缺省时，man手册页在执行`make install'时被安装。但由于 GNU项目并不要求m
an手册页，许多维护人员并不花太多精力去更新手册页。可以使用no-installma
n选项使禁止安装手册页成为去默认值，此时用户仍可以执行`make install-man
'来手工安装手册页。
下面是GNU cpio安装文档的方法(同时包含Texinfo文档和man手册页):
info_TEXINFOS = cpio.texi
man_MANS = cpio.1 mt.1
Texinfo源文件和info页都被认为是生成发布版本的源文件。
Man手册页目前并不被当作源文件，因为自动生成手册页的方法并不通用。
----------------------------------------------------------------------
----------
第一节, 上一节, 下一节, 最后一节, 回到目录
--
※ 来源:．月光软件站 http://www.moon-soft.com．[FROM: 202.104.84.141]
|
|