source: chapter05/ncurses.xml@ efcb393

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 cross-chap5 ml-11.0 multilib trunk xry111/git-transition xry111/glibc-2.34 xry111/tester-nohack xry111/usr-move
Last change on this file since efcb393 was efcb393, checked in by Pierre Labastie <pieere@…>, 19 months ago

Make the new book

git-svn-id: http://svn.linuxfromscratch.org/LFS/branches/cross-chap5@11831 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

  • Property mode set to 100644
File size: 4.8 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="../chapter06/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-ch5-sbu;</seg>
37 <seg>&ncurses-ch5-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>Prepare Ncurses for compilation:</para>
51
52<screen><userinput remap="configure">./configure --prefix=/usr \
53 --host=$LFS_TGT \
54 --build=$(./config.guess) \
55 --mandir=/usr/share/man \
56 --with-shared \
57 --without-debug \
58 --without-ada \
59 --without-normal \
60 --disable-db-install \
61 --enable-widec \
62 --enable-pc-files</userinput></screen>
63
64 <variablelist>
65 <title>The meaning of the new configure options:</title>
66
67 <varlistentry>
68 <term><parameter>--without-ada</parameter></term>
69 <listitem>
70 <para>This ensures that Ncurses does not build support for the Ada
71 compiler which may be present on the host but will not be available
72 once we enter the <command>chroot</command> environment.</para>
73 </listitem>
74 </varlistentry>
75
76 <varlistentry>
77 <term><parameter>--enable-widec</parameter></term>
78 <listitem>
79 <para>This switch causes wide-character libraries (e.g., <filename
80 class="libraryfile">libncursesw.so.&ncurses-version;</filename>)
81 to be built instead of normal ones (e.g., <filename
82 class="libraryfile">libncurses.so.&ncurses-version;</filename>).
83 These wide-character libraries are usable in both multibyte and
84 traditional 8-bit locales, while normal libraries work properly
85 only in 8-bit locales. Wide-character and normal libraries are
86 source-compatible, but not binary-compatible.</para>
87 </listitem>
88 </varlistentry>
89
90 <varlistentry>
91 <term><parameter>--enable-pc-files</parameter></term>
92 <listitem>
93 <para>This switch generates and installs .pc files for pkg-config.
94 </para>
95 </listitem>
96 </varlistentry>
97
98 <varlistentry>
99 <term><parameter>--without-normal</parameter></term>
100 <listitem>
101 <para>This switch disables building and installing most static libraries.
102 </para>
103 </listitem>
104 </varlistentry>
105
106 <varlistentry>
107 <term><parameter>--disable-db-install</parameter></term>
108 <listitem>
109 <para>This switch disables building the terminfo database: it is not
110 needed at this stage, and if <command>tic</command> is too old,
111 it cannot compile recent databases.</para>
112 </listitem>
113 </varlistentry>
114
115 </variablelist>
116
117 <para>Compile the package:</para>
118
119<screen><userinput remap="make">make</userinput></screen>
120
121 <para>Install the package:</para>
122<!-- TODO: check and document -->
123<screen><userinput remap="install">make DESTDIR=$LFS install
124 ln -s libncursesw.so $LFS/usr/lib/libncurses.so</userinput></screen>
125
126 <para>Move the shared libraries to the
127 <filename class="directory">/lib</filename> directory, where they are
128 expected to reside:</para>
129
130<screen><userinput remap="install">mv -v $LFS/usr/lib/libncursesw.so.6* $LFS/lib</userinput></screen>
131
132 <para>Because the libraries have been moved, one symlink points to
133 a non-existent file. Recreate it:</para>
134
135<screen><userinput remap="install">ln -sfv ../../lib/$(readlink $LFS/usr/lib/libncursesw.so) $LFS/usr/lib/libncursesw.so</userinput></screen>
136
137
138 </sect2>
139
140 <sect2 role="content">
141 <title/>
142
143 <para>Details on this package are located in
144 <xref linkend="contents-ncurses" role="."/></para>
145
146 </sect2>
147
148</sect1>
Note: See TracBrowser for help on using the repository browser.