source: chapter06/ncurses.xml@ 942172e

multilib
Last change on this file since 942172e was 942172e, checked in by Thomas Trepl <thomas@…>, 7 weeks ago

Automatic merge of trunk into multilib

  • Property mode set to 100644
File size: 10.0 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-tools-ncurses" role="wrap">
9 <?dbhtml filename="ncurses.html"?>
10
11 <sect1info condition="script">
12 <productname>ncurses</productname>
13 <productnumber>&ncurses-version;</productnumber>
14 <address>&ncurses-url;</address>
15 </sect1info>
16
17 <title>Ncurses-&ncurses-version;</title>
18
19 <indexterm zone="ch-tools-ncurses">
20 <primary sortas="a-Ncurses">Ncurses</primary>
21 <secondary>tools</secondary>
22 </indexterm>
23
24 <sect2 role="package">
25 <title/>
26
27 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
28 href="../chapter08/ncurses.xml"
29 xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
30
31 <segmentedlist>
32 <segtitle>&buildtime;</segtitle>
33 <segtitle>&diskspace;</segtitle>
34
35 <seglistitem>
36 <seg>&ncurses-tmp-sbu;</seg>
37 <seg>&ncurses-tmp-du;</seg>
38 </seglistitem>
39 </segmentedlist>
40
41 </sect2>
42
43 <sect2 role="installation">
44 <title>Installation of Ncurses</title>
45
46 <para>First, ensure that <command>gawk</command> is found first during configuration:</para>
47
48<screen><userinput remap="pre">sed -i s/mawk// configure</userinput></screen>
49
50 <para>Then, run the following commands to build the <quote>tic</quote>
51 program on the build host:</para>
52
53<screen><userinput remap="pre">mkdir build
54pushd build
55 ../configure
56 make -C include
57 make -C progs tic
58popd</userinput></screen>
59
60 <para>Prepare Ncurses for compilation:</para>
61
62<screen><userinput remap="configure">./configure --prefix=/usr \
63 --host=$LFS_TGT \
64 --build=$(./config.guess) \
65 --mandir=/usr/share/man \
66 --with-manpage-format=normal \
67 --with-shared \
68 --without-normal \
69 --with-cxx-shared \
70 --without-debug \
71 --without-ada \
72 --disable-stripping</userinput></screen>
73
74 <variablelist>
75 <title>The meaning of the new configure options:</title>
76
77 <varlistentry>
78 <term><parameter>--with-manpage-format=normal</parameter></term>
79 <listitem>
80 <para>This prevents Ncurses from installing compressed manual
81 pages, which may happen if the host distribution itself
82 has compressed manual pages.</para>
83 </listitem>
84 </varlistentry>
85
86 <varlistentry>
87 <term><parameter>--with-shared</parameter></term>
88 <listitem>
89 <para>This makes Ncurses build and install shared C libraries.</para>
90 </listitem>
91 </varlistentry>
92
93 <varlistentry>
94 <term><parameter>--without-normal</parameter></term>
95 <listitem>
96 <para>This prevents Ncurses from building and installing static C
97 libraries.</para>
98 </listitem>
99 </varlistentry>
100
101 <varlistentry>
102 <term><parameter>--without-debug</parameter></term>
103 <listitem>
104 <para>This prevents Ncurses from building and installing debug
105 libraries.</para>
106 </listitem>
107 </varlistentry>
108
109 <varlistentry>
110 <term><parameter>--with-cxx-shared</parameter></term>
111 <listitem>
112 <para>This makes Ncurses build and install shared C++ bindings. It
113 also prevents it building and installing static C++ bindings.</para>
114 </listitem>
115 </varlistentry>
116
117 <varlistentry>
118 <term><parameter>--without-ada</parameter></term>
119 <listitem>
120 <para>This ensures that Ncurses does not build support for the Ada
121 compiler, which may be present on the host but will not be available
122 once we enter the <command>chroot</command> environment.</para>
123 </listitem>
124 </varlistentry>
125
126 <varlistentry>
127 <term><parameter>--disable-stripping</parameter></term>
128 <listitem>
129 <para>This switch prevents the building system from
130 using the <command>strip</command> program from the host.
131 Using host tools on cross-compiled programs can cause failure.</para>
132 </listitem>
133 </varlistentry>
134<!-- this is the default >= 6.5
135 <varlistentry>
136 <term><parameter>- -enable-widec</parameter></term>
137 <listitem>
138 <para>This switch causes wide-character libraries (e.g., <filename
139 class="libraryfile">libncursesw.so.&ncurses-version;</filename>)
140 to be built instead of normal ones (e.g., <filename
141 class="libraryfile">libncurses.so.&ncurses-version;</filename>).
142 These wide-character libraries are usable in both multibyte and
143 traditional 8-bit locales, while normal libraries work properly
144 only in 8-bit locales. Wide-character and normal libraries are
145 source-compatible, but not binary-compatible.</para>
146 </listitem>
147 </varlistentry>
148-->
149 </variablelist>
150
151 <para>Compile the package:</para>
152
153<screen><userinput remap="make">make</userinput></screen>
154
155 <para>Install the package:</para>
156
157<screen><userinput remap="install">make DESTDIR=$LFS TIC_PATH=$(pwd)/build/progs/tic install
158ln -sv libncursesw.so $LFS/usr/lib/libncurses.so
159sed -e 's/^#if.*XOPEN.*$/#if 1/' \
160 -i $LFS/usr/include/curses.h</userinput></screen>
161<!--
162 <para>Remove an unneeded static library not handled by
163 <command>configure</command>:</para>
164
165<screen><userinput remap="install">rm -v $LFS/usr/lib/libncurses++w.a</userinput></screen>
166-->
167 <variablelist>
168 <title>The meaning of the install options:</title>
169
170 <varlistentry>
171 <term><parameter>TIC_PATH=$(pwd)/build/progs/tic</parameter></term>
172 <listitem>
173 <para>We need to pass the path of the newly built
174 <command>tic</command> program that runs on the building machine, so
175 the terminal database can be created without errors.</para>
176 </listitem>
177 </varlistentry>
178
179 <varlistentry>
180 <term><command>ln -sv libncursesw.so $LFS/usr/lib/libncurses.so</command></term>
181 <listitem>
182 <para>The <filename>libncurses.so</filename> library is needed by
183 a few packages we will build soon. We create this symlink to use
184 <filename>libncursesw.so</filename> as a replacement.</para>
185 </listitem>
186 </varlistentry>
187
188 <varlistentry>
189 <term><command>sed -e 's/^#if.*XOPEN.*$/#if 1/' ...</command></term>
190 <listitem>
191 <para>The header file <filename>curses.h</filename> contains
192 the definition of various Ncurses data structures. With different
193 preprocessor macro definitions two different sets of the data
194 structure definition may be used: the 8-bit definition is
195 compatible with <filename>libncurses.so</filename> and the
196 wide-character definition is compatible with
197 <filename>libncursesw.so</filename>. Since we are using
198 <filename>libncursesw.so</filename> as a replacement of
199 <filename>libncurses.so</filename>, edit the header file so it
200 will always use the wide-character data structure definition
201 compatible with <filename>libncursesw.so</filename>.</para>
202 </listitem>
203 </varlistentry>
204
205 </variablelist>
206
207 </sect2>
208
209 <!-- - - - - - - - - - -->
210 <!-- Multilib - 32bit -->
211 <!-- - - - - - - - - - -->
212 <sect2 arch="ml_32,ml_all">
213 <title>Building Ncurses - 32bit</title>
214
215 <para>Clean previous build:</para>
216
217<screen><userinput remap="pre">make distclean</userinput></screen>
218
219 <para>Prepare Ncurses for compilation:</para>
220
221<screen><userinput remap="configure">CC="$LFS_TGT-gcc -m32" \
222CXX="$LFS_TGT-g++ -m32" \
223./configure --prefix=/usr \
224 --host=$LFS_TGT32 \
225 --build=$(./config.guess) \
226 --libdir=/usr/lib32 \
227 --mandir=/usr/share/man \
228 --with-shared \
229 --without-normal \
230 --with-cxx-shared \
231 --without-debug \
232 --without-ada \
233 --disable-stripping \
234 --enable-widec</userinput></screen>
235
236 <para>Compile the package:</para>
237
238<screen><userinput remap="make">make</userinput></screen>
239
240 <para>Install the package:</para>
241
242<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR TIC_PATH=$(pwd)/build/progs/tic install
243ln -s libncursesw.so DESTDIR/usr/lib32/libcursesw.so
244cp -Rv DESTDIR/usr/lib32/* $LFS/usr/lib32
245rm -rf DESTDIR</userinput></screen>
246
247 </sect2><!-- m32 -->
248
249 <!-- - - - - - - - - - -->
250 <!-- Multilib - x32bit -->
251 <!-- - - - - - - - - - -->
252 <sect2 arch="ml_x32,ml_all">
253 <title>Building Ncurses - x32bit</title>
254
255 <para>Clean previous build:</para>
256
257<screen><userinput remap="pre">make distclean</userinput></screen>
258
259 <para>Prepare Ncurses for compilation:</para>
260
261<screen><userinput remap="configure">CC="$LFS_TGT-gcc -mx32" \
262CXX="$LFS_TGT-g++ -mx32" \
263./configure --prefix=/usr \
264 --host=$LFS_TGTX32 \
265 --build=$(./config.guess) \
266 --libdir=/usr/libx32 \
267 --mandir=/usr/share/man \
268 --with-shared \
269 --without-normal \
270 --with-cxx-shared \
271 --without-debug \
272 --without-ada \
273 --disable-stripping \
274 --enable-widec</userinput></screen>
275
276 <para>Compile the package:</para>
277
278<screen><userinput remap="make">make</userinput></screen>
279
280 <para>Install the package:</para>
281
282<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR TIC_PATH=$(pwd)/build/progs/tic install
283ln -s libncursesw.so DESTDIR/usr/libx32/libcursesw.so
284cp -Rv DESTDIR/usr/libx32/* $LFS/usr/libx32
285rm -rf DESTDIR</userinput></screen>
286
287 </sect2><!-- mx32 -->
288
289 <sect2 role="content">
290 <title/>
291
292 <para>Details on this package are located in
293 <xref linkend="contents-ncurses" role="."/></para>
294
295 </sect2>
296
297</sect1>
Note: See TracBrowser for help on using the repository browser.