source: chapter06/ncurses.xml@ ad25331

multilib-10.1
Last change on this file since ad25331 was 37e35d2, checked in by Thomas Trepl <thomas@…>, 4 years ago

Update to new lfs structure

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/branches/multilib@11986 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
  • Property mode set to 100644
File size: 7.3 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 --enable-widec</userinput></screen>
72
73 <variablelist>
74 <title>The meaning of the new configure options:</title>
75
76 <varlistentry>
77 <term><parameter>--with-manpage-format=normal</parameter></term>
78 <listitem>
79 <para>This prevents Ncurses installing compressed manual
80 pages, which may happen if the host distribution itself
81 has compressed manual pages.</para>
82 </listitem>
83 </varlistentry>
84
85 <varlistentry>
86 <term><parameter>--without-ada</parameter></term>
87 <listitem>
88 <para>This ensures that Ncurses does not build support for the Ada
89 compiler which may be present on the host but will not be available
90 once we enter the <command>chroot</command> environment.</para>
91 </listitem>
92 </varlistentry>
93
94 <varlistentry>
95 <term><parameter>--enable-widec</parameter></term>
96 <listitem>
97 <para>This switch causes wide-character libraries (e.g., <filename
98 class="libraryfile">libncursesw.so.&ncurses-version;</filename>)
99 to be built instead of normal ones (e.g., <filename
100 class="libraryfile">libncurses.so.&ncurses-version;</filename>).
101 These wide-character libraries are usable in both multibyte and
102 traditional 8-bit locales, while normal libraries work properly
103 only in 8-bit locales. Wide-character and normal libraries are
104 source-compatible, but not binary-compatible.</para>
105 </listitem>
106 </varlistentry>
107
108 <varlistentry>
109 <term><parameter>--without-normal</parameter></term>
110 <listitem>
111 <para>This switch disables building and installing most static libraries.
112 </para>
113 </listitem>
114 </varlistentry>
115
116 </variablelist>
117
118 <para>Compile the package:</para>
119
120<screen><userinput remap="make">make</userinput></screen>
121
122 <para>Install the package:</para>
123<!-- TODO: check and document -->
124<screen><userinput remap="install">make DESTDIR=$LFS TIC_PATH=$(pwd)/build/progs/tic install
125ln -s libncursesw.so $LFS/usr/lib/libncurses.so</userinput></screen>
126
127 <para>Move the shared libraries to the
128 <filename class="directory">/lib</filename> directory, where they are
129 expected to reside:</para>
130
131<screen><userinput remap="install">mv -v $LFS/usr/lib/libncursesw.so.6* $LFS/lib</userinput></screen>
132
133 <para>Because the libraries have been moved, one symlink points to
134 a non-existent file. Recreate it:</para>
135
136<screen><userinput remap="install">ln -sfv ../../lib/$(readlink $LFS/usr/lib/libncursesw.so) $LFS/usr/lib/libncursesw.so</userinput></screen>
137
138 </sect2>
139
140 <!-- - - - - - - - - - -->
141 <!-- Multilib - 32bit -->
142 <!-- - - - - - - - - - -->
143 <sect2 arch="ml_32,ml_all">
144 <title>Building Ncurses - 32bit</title>
145
146 <para>Clean previous build:</para>
147
148<screen><userinput remap="pre">make distclean</userinput></screen>
149
150 <para>Prepare Ncurses for compilation:</para>
151
152<screen><userinput remap="configure">CC="$LFS_TGT-gcc -m32" \
153CXX="$LFS_TGT-g++ -m32" \
154./configure --prefix=/usr \
155 --host=$LFS_TGT32 \
156 --libdir=&usr-lib-m32; \
157 --mandir=/usr/share/man \
158 --with-shared \
159 --without-debug \
160 --without-normal \
161 --enable-pc-files \
162 --enable-widec \
163 --with-pkg-config-libdir=&usr-lib-m32;/pkgconfig</userinput></screen>
164
165 <para>Compile the package:</para>
166
167<screen><userinput remap="make">make</userinput></screen>
168
169 <para>Install the package:</para>
170
171<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR TIC_PATH=$(pwd)/build/progs/tic install
172ln -s libncursesw.so DESTDIR&usr-lib-m32;/libcursesw.so
173cp -Rv DESTDIR&usr-lib-m32;/* $LFS&usr-lib-m32;
174rm -rf DESTDIR</userinput></screen>
175
176 </sect2><!-- m32 -->
177
178 <!-- - - - - - - - - - -->
179 <!-- Multilib - x32bit -->
180 <!-- - - - - - - - - - -->
181 <sect2 arch="ml_x32,ml_all">
182 <title>Building Ncurses - x32bit</title>
183
184 <para>Clean previous build:</para>
185
186<screen><userinput remap="pre">make distclean</userinput></screen>
187
188 <para>Prepare Ncurses for compilation:</para>
189
190<screen><userinput remap="configure">CC="$LFS_TGT-gcc -mx32" \
191CXX="$LFS_TGT-g++ -mx32" \
192./configure --prefix=/usr \
193 --host=$LFS_TGTX32 \
194 --libdir=&usr-lib-mx32; \
195 --mandir=/usr/share/man \
196 --with-shared \
197 --without-debug \
198 --without-normal \
199 --enable-pc-files \
200 --enable-widec \
201 --with-pkg-config-libdir=&usr-lib-mx32;/pkgconfig</userinput></screen>
202
203 <para>Compile the package:</para>
204
205<screen><userinput remap="make">make</userinput></screen>
206
207 <para>Install the package:</para>
208
209<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR TIC_PATH=$(pwd)/build/progs/tic install
210ln -s libncursesw.so DESTDIR&usr-lib-mx32;/libcursesw.so
211cp -Rv DESTDIR&usr-lib-mx32;/* $LFS&usr-lib-mx32;
212rm -rf DESTDIR</userinput></screen>
213
214 </sect2><!-- mx32 -->
215
216 <sect2 role="content">
217 <title/>
218
219 <para>Details on this package are located in
220 <xref linkend="contents-ncurses" role="."/></para>
221
222 </sect2>
223
224</sect1>
Note: See TracBrowser for help on using the repository browser.