source: chapter06/ncurses.xml@ af974a9c

multilib
Last change on this file since af974a9c was af974a9c, checked in by Thomas Trepl (Moody) <thomas@…>, 9 months ago

Do not force to create pc files in ch6 for mx32/m32

  • Property mode set to 100644
File size: 8.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
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-debug \
69 --without-ada \
70 --without-normal \
71 --disable-stripping \
72 --enable-widec</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 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>--without-ada</parameter></term>
88 <listitem>
89 <para>This ensures that Ncurses does not build support for the Ada
90 compiler which may be present on the host but will not be available
91 once we enter the <command>chroot</command> environment.</para>
92 </listitem>
93 </varlistentry>
94
95 <varlistentry>
96 <term><parameter>--disable-stripping</parameter></term>
97 <listitem>
98 <para>This switch prevents the building system from stripping
99 the programs using <command>strip</command> program from the host.
100 Using host tools on cross-compiled program can cause failure.</para>
101 </listitem>
102 </varlistentry>
103
104 <varlistentry>
105 <term><parameter>--enable-widec</parameter></term>
106 <listitem>
107 <para>This switch causes wide-character libraries (e.g., <filename
108 class="libraryfile">libncursesw.so.&ncurses-version;</filename>)
109 to be built instead of normal ones (e.g., <filename
110 class="libraryfile">libncurses.so.&ncurses-version;</filename>).
111 These wide-character libraries are usable in both multibyte and
112 traditional 8-bit locales, while normal libraries work properly
113 only in 8-bit locales. Wide-character and normal libraries are
114 source-compatible, but not binary-compatible.</para>
115 </listitem>
116 </varlistentry>
117
118 <varlistentry>
119 <term><parameter>--without-normal</parameter></term>
120 <listitem>
121 <para>This switch disables building and installing most static libraries.
122 </para>
123 </listitem>
124 </varlistentry>
125
126 </variablelist>
127
128 <para>Compile the package:</para>
129
130<screen><userinput remap="make">make</userinput></screen>
131
132 <para>Install the package:</para>
133
134<screen><userinput remap="install">make DESTDIR=$LFS TIC_PATH=$(pwd)/build/progs/tic install
135echo "INPUT(-lncursesw)" > $LFS/usr/lib/libncurses.so</userinput></screen>
136
137 <variablelist>
138 <title>The meaning of the install options:</title>
139
140 <varlistentry>
141 <term><parameter>TIC_PATH=$(pwd)/build/progs/tic</parameter></term>
142 <listitem>
143 <para>We need to pass the path of the just built
144 <command>tic</command> able to run on the building machine, so that
145 the terminal database can be created without errors.</para>
146 </listitem>
147 </varlistentry>
148
149 <varlistentry>
150 <term><command>echo "INPUT(-lncursesw)" > $LFS/usr/lib/libncurses.so</command></term>
151 <listitem>
152 <para>The <filename>libncurses.so</filename> library is needed by
153 a few packages we will build soon. We create this small linker
154 script, as this is what is done in <xref
155 linkend="chapter-building-system"/>.</para>
156 </listitem>
157 </varlistentry>
158
159 </variablelist>
160
161 </sect2>
162
163 <!-- - - - - - - - - - -->
164 <!-- Multilib - 32bit -->
165 <!-- - - - - - - - - - -->
166 <sect2 arch="ml_32,ml_all">
167 <title>Building Ncurses - 32bit</title>
168
169 <para>Clean previous build:</para>
170
171<screen><userinput remap="pre">make distclean</userinput></screen>
172
173 <para>Prepare Ncurses for compilation:</para>
174
175<screen><userinput remap="configure">CC="$LFS_TGT-gcc -m32" \
176CXX="$LFS_TGT-g++ -m32" \
177./configure --prefix=/usr \
178 --host=$LFS_TGT32 \
179 --build=$(./config.guess) \
180 --libdir=/usr/lib32 \
181 --mandir=/usr/share/man \
182 --with-shared \
183 --without-debug \
184 --without-ada \
185 --without-normal \
186 --disable-stripping \
187 --enable-widec</userinput></screen>
188
189 <para>Compile the package:</para>
190
191<screen><userinput remap="make">make</userinput></screen>
192
193 <para>Install the package:</para>
194
195<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR TIC_PATH=$(pwd)/build/progs/tic install
196ln -s libncursesw.so DESTDIR/usr/lib32/libcursesw.so
197cp -Rv DESTDIR/usr/lib32/* $LFS/usr/lib32
198rm -rf DESTDIR</userinput></screen>
199
200 </sect2><!-- m32 -->
201
202 <!-- - - - - - - - - - -->
203 <!-- Multilib - x32bit -->
204 <!-- - - - - - - - - - -->
205 <sect2 arch="ml_x32,ml_all">
206 <title>Building Ncurses - x32bit</title>
207
208 <para>Clean previous build:</para>
209
210<screen><userinput remap="pre">make distclean</userinput></screen>
211
212 <para>Prepare Ncurses for compilation:</para>
213
214<screen><userinput remap="configure">CC="$LFS_TGT-gcc -mx32" \
215CXX="$LFS_TGT-g++ -mx32" \
216./configure --prefix=/usr \
217 --host=$LFS_TGTX32 \
218 --build=$(./config.guess) \
219 --libdir=/usr/libx32 \
220 --mandir=/usr/share/man \
221 --with-shared \
222 --without-debug \
223 --without-ada \
224 --without-normal \
225 --disable-stripping \
226 --enable-widec</userinput></screen>
227
228 <para>Compile the package:</para>
229
230<screen><userinput remap="make">make</userinput></screen>
231
232 <para>Install the package:</para>
233
234<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR TIC_PATH=$(pwd)/build/progs/tic install
235ln -s libncursesw.so DESTDIR/usr/libx32/libcursesw.so
236cp -Rv DESTDIR/usr/libx32/* $LFS/usr/libx32
237rm -rf DESTDIR</userinput></screen>
238
239 </sect2><!-- mx32 -->
240
241 <sect2 role="content">
242 <title/>
243
244 <para>Details on this package are located in
245 <xref linkend="contents-ncurses" role="."/></para>
246
247 </sect2>
248
249</sect1>
Note: See TracBrowser for help on using the repository browser.