source: x/installing/xterm.xml@ b2bd6604

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b2bd6604 was b2bd6604, checked in by Bruce Dubbs <bdubbs@…>, 16 months ago

Update to mpg123-1.26.2.
Update to xterm-357.
Update to libevent-2.1.12.
Update to rsync-3.2.2.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23366 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.7 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 <!ENTITY xterm-download-http "http://invisible-mirror.net/archives/xterm/xterm-&xterm-version;.tgz">
8 <!--<!ENTITY xterm-download-ftp "ftp://invisible-island.net/xterm/xterm-&xterm-version;.tgz">-->
9 <!ENTITY xterm-download-ftp " ">
10 <!ENTITY xterm-md5sum "2a59342cb2c4d04fd1fd9d1c7a50d9c4">
11 <!ENTITY xterm-size "1.4 MB">
12 <!ENTITY xterm-buildsize "14 MB">
13 <!ENTITY xterm-time "0.2 SBU">
14]>
15
16<sect1 id="xterm2" xreflabel="xterm-&xterm-version;">
17 <?dbhtml filename="xterm.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>xterm-&xterm-version;</title>
25
26 <indexterm zone="xterm2">
27 <primary sortas="a-xterm2">xterm</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to xterm</title>
32
33 <para>
34 <application>xterm</application> is a terminal emulator for
35 the X Window System.
36 </para>
37
38 &not-katamari;
39
40 &lfs91_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&xterm-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&xterm-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &xterm-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &xterm-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &xterm-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &xterm-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">xterm Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="xorg7-app"/>
81 </para>
82
83 <bridgehead renderas="sect4">Required (at runtime)</bridgehead>
84 <para role="required">
85 A monospace TTF or OTF font such as
86 <xref role="runtime" linkend="dejavu-fonts"/>
87 </para>
88
89
90 <bridgehead renderas="sect4">Optional</bridgehead>
91 <para role="optional">
92 <xref linkend="pcre"/> or <xref linkend="pcre2"/>,
93 <xref linkend="valgrind"/> and
94 <ulink url="http://www.nongnu.org/man2html/">man2html</ulink>
95 </para>
96
97 <para condition="html" role="usernotes">User Notes:
98 <ulink url='&blfs-wiki;/Xterm'/></para>
99
100 </sect2>
101
102 <sect2 role="installation">
103 <title>Installation of xterm</title>
104
105 <para>
106 Install <application>xterm</application> by running the
107 following commands:
108 </para>
109
110<screen><userinput>sed -i '/v0/{n;s/new:/new:kb=^?:/}' termcap &amp;&amp;
111printf '\tkbs=\\177,\n' &gt;&gt; terminfo &amp;&amp;
112
113TERMINFO=/usr/share/terminfo \
114./configure $XORG_CONFIG \
115 --with-app-defaults=/etc/X11/app-defaults &amp;&amp;
116
117make</userinput></screen>
118
119 <!--
120 there is a 'make check' but i havn't found a description
121 how the output should look like
122 -->
123 <para>
124 This package does not come with a test suite.
125 </para>
126
127 <para>
128 Now, as the <systemitem class="username">root</systemitem> user:
129 </para>
130
131<screen role="root"><userinput>make install &amp;&amp;
132make install-ti &amp;&amp;
133
134mkdir -pv /usr/share/applications &amp;&amp;
135cp -v *.desktop /usr/share/applications/</userinput></screen>
136
137 </sect2>
138
139 <sect2 role="commands">
140 <title>Command Explanations</title>
141
142 <para>
143 <command>sed -i ... termcap</command>,
144 <command>printf ... >> terminfo</command>:
145 These commands modify the terminal description so that the Backspace
146 key is expected to send the character with ASCII code 127. This is done
147 for consistency with the Linux console.
148 </para>
149
150 <para>
151 <envar>TERMINFO=/usr/share/terminfo</envar>: This ensures
152 that the <command>xterm</command> terminfo files are installed to the
153 system terminfo database.
154 </para>
155
156 <para>
157 <parameter>--with-app-defaults=...</parameter>: Sets the location
158 for the <filename class="directory">app-defaults</filename>
159 directory.
160 </para>
161
162 <para>
163 <command>make install-ti</command>: This command installs corrected
164 terminfo description files for use with
165 <application>xterm</application>.
166 </para>
167
168 </sect2>
169
170 <sect2 role="configuration">
171 <title>Configuring xterm</title>
172
173 <para>
174 There are two ways to configure xterm. You can add the X resource
175 definitions to the user's <filename>~/.Xresources</filename> file, or
176 add them to the system-wide
177 <filename>$XORG_PREFIX/share/X11/app-defaults/Xterm</filename> file.
178 </para>
179
180 <para>
181 In order for xterm to follow the locale settings in the environment,
182 use TrueType fonts, and follow the Linux convention about the code sent by
183 the Backspace key, add the following definitions as the
184 <systemitem class="username">root</systemitem> user:
185 </para>
186
187<screen role="root"><userinput>cat &gt;&gt; /etc/X11/app-defaults/XTerm &lt;&lt; "EOF"
188<literal>*VT100*locale: true
189*VT100*faceName: Monospace
190*VT100*faceSize: 10
191*backarrowKeyIsErase: true
192*ptyInitialErase: true</literal>
193EOF</userinput></screen>
194
195 </sect2>
196
197 <sect2 role="content">
198 <title>Contents</title>
199
200 <segmentedlist>
201 <segtitle>Installed Programs</segtitle>
202 <segtitle>Installed Libraries</segtitle>
203 <segtitle>Installed Directories</segtitle>
204
205 <seglistitem>
206 <seg>koi8rxterm, resize, uxterm, and xterm</seg>
207 <seg>None</seg>
208 <seg>None</seg>
209 </seglistitem>
210 </segmentedlist>
211
212 <variablelist>
213 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
214 <?dbfo list-presentation="list"?>
215 <?dbhtml list-presentation="table"?>
216
217 <varlistentry id="koi8rxterm">
218 <term><command>koi8rxterm</command></term>
219 <listitem>
220 <para>
221 is a wrapper script to set up xterm with a KOI8-R locale.
222 </para>
223 <indexterm zone="xterm2 koi8rxterm">
224 <primary sortas="b-koi8rxterm">koi8rxterm</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry id="resize">
230 <term><command>resize</command></term>
231 <listitem>
232 <para>
233 prints a shell command for setting the TERM and TERMCAP
234 environment variables to indicate the current size of xterm
235 window.
236 </para>
237 <indexterm zone="xterm2 resize">
238 <primary sortas="b-resize">resize</primary>
239 </indexterm>
240 </listitem>
241 </varlistentry>
242
243 <varlistentry id="uxterm">
244 <term><command>uxterm</command></term>
245 <listitem>
246 <para>
247 is a wrapper script that modifies the current locale to use
248 UTF-8 and starts xterm with the proper settings.
249 </para>
250 <indexterm zone="xterm2 uxterm">
251 <primary sortas="b-uxterm">uxterm</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255
256 <varlistentry id="xterm-bin">
257 <term><command>xterm</command></term>
258 <listitem>
259 <para>
260 is a terminal emulator for the X Window System.
261 </para>
262 <indexterm zone="xterm2 xterm2">
263 <primary sortas="b-xterm2">xterm</primary>
264 </indexterm>
265 </listitem>
266 </varlistentry>
267
268 </variablelist>
269
270 </sect2>
271
272</sect1>
Note: See TracBrowser for help on using the repository browser.