source: clfs-sysroot/BOOK/final-system/common/ncurses.xml@ a76a37b

Last change on this file since a76a37b was 394cdeb, checked in by Joe Ciccone <jciccone@…>, 17 years ago

Keep all the link commands consistant.

  • Property mode set to 100644
File size: 8.9 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-system-ncurses" role="wrap">
9 <?dbhtml filename="ncurses.html"?>
10
11 <title>Ncurses-&ncurses-version;</title>
12
13 <indexterm zone="ch-system-ncurses">
14 <primary sortas="a-Ncurses">Ncurses</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
20 <para>The Ncurses package contains libraries for terminal-independent
21 handling of character screens.</para>
22
23 </sect2>
24
25 <sect2 role="installation">
26 <title>Installation of Ncurses</title>
27
28 <para os="p1">This patch fixes an issue with some bash versions:</para>
29
30<screen os="p2"><userinput>patch -Np1 -i ../&ncurses-bashfix-patch;</userinput></screen>
31
32 <para os="a">Prepare Ncurses for compilation:</para>
33
34<screen os="b"><userinput>./configure --build=${CLFS_HOST} --host=${CLFS_TARGET} \
35 --prefix=/usr --libdir=/lib --with-shared \
36 --without-debug --without-ada --with-build-cc=gcc</userinput></screen>
37
38 <para os="c">Compile the package:</para>
39
40<screen os="d"><userinput>make</userinput></screen>
41
42 <para os="e">Install the package:</para>
43
44<screen os="f"><userinput>make DESTDIR=${CLFS} install</userinput></screen>
45
46 <para os="g">Move the Ncurses static libraries to the proper location:</para>
47
48<screen os="h"><userinput>mv -v ${CLFS}/lib/lib{panel,menu,form,ncurses,ncurses++,curses}.a \
49 ${CLFS}/usr/lib</userinput></screen>
50
51 <para os="i">Create symlinks in <filename class="directory">/usr/lib:</filename></para>
52
53<screen os="j"><userinput>rm -v ${CLFS}/lib/lib{ncurses,menu,panel,form,curses}.so
54ln -sfv ../../lib/libncurses.so.&ncurses-version2; ${CLFS}/usr/lib/libcurses.so
55ln -sfv ../../lib/libncurses.so.&ncurses-version2; ${CLFS}/usr/lib/libncurses.so
56ln -sfv ../../lib/libmenu.so.&ncurses-version2; ${CLFS}/usr/lib/libmenu.so
57ln -sfv ../../lib/libpanel.so.&ncurses-version2; ${CLFS}/usr/lib/libpanel.so
58ln -sfv ../../lib/libform.so.&ncurses-version2; ${CLFS}/usr/lib/libform.so</userinput></screen>
59
60 <para os="k">Give the Ncurses libraries execute permissions:</para>
61
62<screen os="l"><userinput>chmod -v 755 ${CLFS}/lib/lib{panel,menu,form,ncurses}.so.&ncurses-version;</userinput></screen>
63
64 </sect2>
65
66 <sect2 id="contents-ncurses" role="content">
67 <title>Contents of Ncurses</title>
68
69 <segmentedlist>
70 <segtitle>Installed programs</segtitle>
71 <segtitle>Installed libraries</segtitle>
72
73 <seglistitem>
74 <seg>captoinfo (link to tic), clear, infocmp, infotocap (link to tic),
75 reset (link to tset), tack, tic, toe, tput, and tset</seg>
76 <seg>libcurses.[a,so] (link to libncurses.[a,so]), libform.[a,so],
77 libmenu.[a,so], libncurses++.a, libncurses.[a,so], and
78 libpanel.[a,so]</seg>
79 </seglistitem>
80 </segmentedlist>
81
82 <variablelist>
83 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
84 <?dbfo list-presentation="list"?>
85 <?dbhtml list-presentation="table"?>
86
87 <varlistentry id="captoinfo">
88 <term><command>captoinfo</command></term>
89 <listitem>
90 <para>Converts a termcap description into a terminfo description</para>
91 <indexterm zone="ch-system-ncurses captoinfo">
92 <primary sortas="b-captoinfo">captoinfo</primary>
93 </indexterm>
94 </listitem>
95 </varlistentry>
96
97 <varlistentry id="clear">
98 <term><command>clear</command></term>
99 <listitem>
100 <para>Clears the screen, if possible</para>
101 <indexterm zone="ch-system-ncurses clear">
102 <primary sortas="b-clear">clear</primary>
103 </indexterm>
104 </listitem>
105 </varlistentry>
106
107 <varlistentry id="infocmp">
108 <term><command>infocmp</command></term>
109 <listitem>
110 <para>Compares or prints out terminfo descriptions</para>
111 <indexterm zone="ch-system-ncurses infocmp">
112 <primary sortas="b-infocmp">infocmp</primary>
113 </indexterm>
114 </listitem>
115 </varlistentry>
116
117 <varlistentry id="infotocap">
118 <term><command>infotocap</command></term>
119 <listitem>
120 <para>Converts a terminfo description into a termcap description</para>
121 <indexterm zone="ch-system-ncurses infotocap">
122 <primary sortas="b-infotocap">infotocap</primary>
123 </indexterm>
124 </listitem>
125 </varlistentry>
126
127 <varlistentry id="reset">
128 <term><command>reset</command></term>
129 <listitem>
130 <para>Reinitializes a terminal to its default values</para>
131 <indexterm zone="ch-system-ncurses reset">
132 <primary sortas="b-reset">reset</primary>
133 </indexterm>
134 </listitem>
135 </varlistentry>
136
137 <varlistentry id="tack">
138 <term><command>tack</command></term>
139 <listitem>
140 <para>The terminfo action checker; it is mainly used to test the
141 accuracy of an entry in the terminfo database</para>
142 <indexterm zone="ch-system-ncurses tack">
143 <primary sortas="b-tack">tack</primary>
144 </indexterm>
145 </listitem>
146 </varlistentry>
147
148 <varlistentry id="tic">
149 <term><command>tic</command></term>
150 <listitem>
151 <para>The terminfo entry-description compiler that translates a
152 terminfo file from source format into the binary format needed for the
153 ncurses library routines. A terminfo file contains information on the
154 capabilities of a certain terminal</para>
155 <indexterm zone="ch-system-ncurses tic">
156 <primary sortas="b-tic">tic</primary>
157 </indexterm>
158 </listitem>
159 </varlistentry>
160
161 <varlistentry id="toe">
162 <term><command>toe</command></term>
163 <listitem>
164 <para>Lists all available terminal types, giving the primary name and
165 description for each</para>
166 <indexterm zone="ch-system-ncurses toe">
167 <primary sortas="b-toe">toe</primary>
168 </indexterm>
169 </listitem>
170 </varlistentry>
171
172 <varlistentry id="tput">
173 <term><command>tput</command></term>
174 <listitem>
175 <para>Makes the values of terminal-dependent capabilities available to
176 the shell; it can also be used to reset or initialize a terminal or
177 report its long name</para>
178 <indexterm zone="ch-system-ncurses tput">
179 <primary sortas="b-tput">tput</primary>
180 </indexterm>
181 </listitem>
182 </varlistentry>
183
184 <varlistentry id="tset">
185 <term><command>tset</command></term>
186 <listitem>
187 <para>Can be used to initialize terminals</para>
188 <indexterm zone="ch-system-ncurses tset">
189 <primary sortas="b-tset">tset</primary>
190 </indexterm>
191 </listitem>
192 </varlistentry>
193
194 <varlistentry id="libcurses">
195 <term><filename class="libraryfile">libcurses</filename></term>
196 <listitem>
197 <para>A link to <filename>libncurses</filename></para>
198 <indexterm zone="ch-system-ncurses libcurses">
199 <primary sortas="c-libcurses">libcurses</primary>
200 </indexterm>
201 </listitem>
202 </varlistentry>
203
204 <varlistentry id="libncurses">
205 <term><filename class="libraryfile">libncurses</filename></term>
206 <listitem>
207 <para>Contains functions to display text in many complex ways on a
208 terminal screen; a good example of the use of these functions is the
209 menu displayed during the kernel's
210 <command>make menuconfig</command></para>
211 <indexterm zone="ch-system-ncurses libncurses">
212 <primary sortas="c-libncurses">libncurses</primary>
213 </indexterm>
214 </listitem>
215 </varlistentry>
216
217 <varlistentry id="libform">
218 <term><filename class="libraryfile">libform</filename></term>
219 <listitem>
220 <para>Contains functions to implement forms</para>
221 <indexterm zone="ch-system-ncurses libform">
222 <primary sortas="c-libform">libform</primary>
223 </indexterm>
224 </listitem>
225 </varlistentry>
226
227 <varlistentry id="libmenu">
228 <term><filename class="libraryfile">libmenu</filename></term>
229 <listitem>
230 <para>Contains functions to implement menus</para>
231 <indexterm zone="ch-system-ncurses libmenu">
232 <primary sortas="c-libmenu">libmenu</primary>
233 </indexterm>
234 </listitem>
235 </varlistentry>
236
237 <varlistentry id="libpanel">
238 <term><filename class="libraryfile">libpanel</filename></term>
239 <listitem>
240 <para>Contains functions to implement panels</para>
241 <indexterm zone="ch-system-ncurses libpanel">
242 <primary sortas="c-libpanel">libpanel</primary>
243 </indexterm>
244 </listitem>
245 </varlistentry>
246
247 </variablelist>
248
249 </sect2>
250
251</sect1>
Note: See TracBrowser for help on using the repository browser.