File: libtoolize.1

package info (click to toggle)
manpages-ja 0.5.0.0.20120606-1
  • links: PTS
  • area: main
  • in suites: wheezy
  • size: 25,964 kB
  • sloc: perl: 161; makefile: 116
file content (191 lines) | stat: -rw-r--r-- 8,019 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
.\" You may copy, distribute and modify under the terms of the LDP General
.\" Public License as specified in the LICENSE file that comes with the
.\" gnumaniak distribution
.\"
.\" The author kindly requests that no comments regarding the "better"
.\" suitability or up-to-date notices of any info documentation alternative
.\" is added without contacting him first.
.\"
.\" (C) 1999-2002 Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
.\"
.\"	libtoolize man page
.\"	man pages are NOT obsolete!
.\"	<ragnar@ragnar-hojland.com>
.\"
.\" Japanese Version Copyright (c) 2000 Yuichi SATO
.\"         all rights reserved.                                               
.\" Translated Mon Jun  5 02:27:10 JST 2000
.\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
.\"
.\"WORD:	dlopen			ダイナミックロード
.\"WORD:	dlopen support		ダイナミックロード機能
.\"WORD:	library			ライブラリ
.\"WORD:	seamless		シームレス
.\"WORD:	shared			共有
.\"WORD:	static			静的
.\"
.TH LIBTOOLIZE 1 "June 2002" "libtoolize 1.4.2"
.SH 名前
\fBlibtoolize\fR \- Makefile に libtool の機能を付加する。
.SH 書式
.B libtoolize
.RB [ \-cfn ]
.RB [ \-\-automake ]
.RB [ \-\-copy ]
.RB [ \-\-debug ]
.RB [ \-\-dry\-run ]
.RB [ \-\-force ]
.RB [ \-\-ltdl ]
.RB [ \-\-ltdl\-tar ]

.BR libtoolize " [" \-\-help "] [" \-\-version ]
.SH 説明
.B libtoolize
は Makefile に \fBlibtool\fR(1) の機能を
付加するための標準的な方法を提供する。

もし \fBautoconf\fR や \fBautomake\fR を使っているならば、
`\fBconfigure.in\fR' ファイルに \fBAM_PROG_LIBTOOL\fR の呼び出しを
追加すべきである。
このマクロを使うと `\fBconfigure\fR' スクリプトと \fBltconfig\fR を
シームレスに統合できる。

\fBaclocal\fR プログラムは \fBconfigure\fR スクリプトに
\fBAM_PROG_LIBTOOL\fR 機能を自動的に付加する。
あなたの \fBlibtool.m4\fR のコピーを \fBacinclude.m4\fR に
インクルードしておくことを推奨する。
なぜなら、あなたのマクロのバージョンと \fBacinclude.m4\fR の
バージョンが合わない場合にユーザーが \fBaclocal.m4\fR や \fBconfigure\fR を 
リビルドすると、互換性のないマクロのために終了しないかもしれないからである。

マクロでは `\fBMakefile.in\fR' において Makefile の変数
\fBtop_builddir\fR を定義する必要がある。
\fBautomake\fR はこれを自動で行うが、
\fBautoconf\fR ユーザーは、この変数をビルドディレクトリのトップへの相対パスで
(`../..' といったように) 設定すべきである。
.TP
.B AM_PROG_LIBTOOL
ライブラリパッケージの名前によって、
共有/静的のどちらのライブラリをビルドするかをユーザーが指定できるように、
\fB\-\-enable\-shared\fR[\fB=\fIPACKAGE\fB,...\fR] をサポートする。
パッケージ名が `default' の場合、環境変数 \fBPACKAGE\fR にその名前がない
すべてのパッケージがマッチする。

デフォルトではこのマクロは、もし可能であれば、
共有ライブラリの使用を有効にする。
さらに静的ライブラリが共有ライブラリと衝突しなければ、
静的ライブラリの使用も有効にする。
\fBAM_DISABLE_SHARED\fR または \fBAM_DISABLE_STATIC\fR マクロを
呼び出すことにより、このデフォルトを変更することができる。
.sp
.nf
# ビルドプロセスが非常に長くなるので、
# ベータテストの間は共有ライブラリを無効にする。
AC_DISABLE_SHARED
AM_PROG_LIBTOOL
.fi
.sp
マクロは環境変数 \fBLIBTOOL_DEPS\fR も設定する。
この変数は libtool スクリプトが古くなったときに
自動的に更新するために使われる。
そのためには、\fBconfigure.in\fR に以下を加え、
.sp
.RS
.RS
.nf
AC_SUBST(LIBTOOL_DEPS)
.fi
.RE
.sp
さらに \fBMakefile.in\fR または \fBMakefile.am\fR に以下を加えること。
.sp
.RS
.nf
LIBTOOL_DEPS = @LIBTOOL_DEPS@
libtool: $(LIBTOOL_DEPS)
        $(SHELL) ./config.status --recheck
.fi
.RE
.RE
.sp
.TP
.B AC_DISABLE_FAST_INSTALL
デフォルトの動作を \fBAM_PROG_LIBTOOL\fR でなく
すべての最適化を無効にするよう変更し、インストールを高速化する。
ユーザーは \fB\-\-enable\-shared\fR と同じように、
\fB\-\-enable\-fast\-install[\fB=\fIPACKAGE\fB,...\fR] を指定することで
このマクロを上書きすることができる。
.TP
.B AC_DISABLE_SHARED
\fBAM_PROG_LIBTOOL\fR に対するデフォルトの動作を
共有ライブラリを無効とするように変更する。
ユーザーは \fB\-\-enable\-shared\fR を指定することにより、
このデフォルトの動作を更に変更することができる。
.TP
.B AC_DISABLE_STATIC
\fBAM_PROG_LIBTOOL\fR に対するデフォルトの動作を
静的ライブラリを無効とするように変更する。
ユーザーは \fB\-\-enable\-static\fR を指定することにより、
このデフォルトの動作を更に変更することができる。
.TP
.B AC_LIBTOOL_DLOPEN
パッケージが \fB\-dlopen\fR または \fB\-dlpreopen\fR を
使用するためには、このマクロを使用すること。
このマクロは \fBAMPROG_LIBTOOL\fR より前に呼ばれなければならず、
ダイナミックロード機能のチェックを有効にする。
さもなければ、libtool はプラットホームがダイナミックロードを
サポートしていないと仮定する。
.TP
.B AC_LIBTOOL_WIN32_DLL
パッケージが win32 プラットホーム上でクリーンな dll をビルドするように
移植された場合には、このマクロを使用すること。
このマクロは \fBAMPROG_LIBTOOL\fR より前に呼ばれなければならず、
リンクモードで \fB\-no\-undefined が \fBlibtool に渡されなければならない\fR。

これは通常、ライブラリデータアイテムが `__declspec(dllexport)' で
エクスポートされ、`__declspec(dllimport)' インポートされることを意味している。
このマクロが使用されないと、libtool はパッケージライブラリは
dll クリーンでないと仮定して、win32 ホスト上で静的ライブラリしか作らなくなる。
.PP
Makefile.am の例は \fBlibtool\fR(1) を参照すること。
.SH オプション
.TP
.B \-c, \-\-copy
シンボリックリンクを作らず、
libtool データディレクトリからファイルをコピーする。
.TP
.B \-f, \-\-force
既存の \fBlibtool\fR ファイルを置き換える。
デフォルトでは \fBlibtoolize\fR は既存のファイルを上書きしない。
.TP
.B \-n, \-\-dry\-run
ファイルの作成・修正・削除をせず、\fBlibtoolize\fR によって
どのようなコマンドが実行されるかを表示する。
.TP
.B \-\-automake
静かに動作させるとともに、
Automake の libtool 機能が使用されることを仮定する。
\fBAM_PROG_LIBTOOL\fR が `\fBconfigure.in\fR' にある場合、
パッケージに libtool ファイルを追加するために
Automake により `libtoolize \-\-automake' が使用される。
.TP
.B \-\-debug
シェルスクリプトのトレースモードを有効にし、標準出力に書き出す。
.TP
.B \-\-ltdl
パッケージのサブディレクトリに libltdl をインストールする。
.TP
.B \-\-ltdl\-tar
パッケージに libtdl.tar.gz を追加する。
.TP
.B "\-\-help"
使用法のメッセージを標準出力に表示し、正常終了する。
.TP
.B "\-\-version"
バージョン情報を標準出力に表示し、正常終了する。
.SH 関連項目
 \fBlibtool\fR(1), \fBltconfig\fR(1)
.SH 注意
プログラムのバグについては <bug-libtool@gnu.org> へ報告してください。
.br
man ページは Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com> が作成しました。