source: x/installing/xterm.xml@ 98878ef1

10.0 10.1 11.0 11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 98878ef1 was 98878ef1, checked in by Thomas Trepl <thomas@…>, 2 years ago

Update to xterm-354

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

  • Property mode set to 100644
File size: 7.6 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 "e5d71c5aeccfb19ca23dff261e7c0a30">
11 <!ENTITY xterm-size "1.3 MB">
12 <!ENTITY xterm-buildsize "13 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 <para>
120 This package does not come with a test suite.
121 </para>
122
123 <para>
124 Now, as the <systemitem class="username">root</systemitem> user:
125 </para>
126
127<screen role="root"><userinput>make install &amp;&amp;
128make install-ti &amp;&amp;
129
130mkdir -pv /usr/share/applications &amp;&amp;
131cp -v *.desktop /usr/share/applications/</userinput></screen>
132
133 </sect2>
134
135 <sect2 role="commands">
136 <title>Command Explanations</title>
137
138 <para>
139 <command>sed -i ... termcap</command>,
140 <command>printf ... >> terminfo</command>:
141 These commands modify the terminal description so that the Backspace
142 key is expected to send the character with ASCII code 127. This is done
143 for consistency with the Linux console.
144 </para>
145
146 <para>
147 <envar>TERMINFO=/usr/share/terminfo</envar>: This ensures
148 that the <command>xterm</command> terminfo files are installed to the
149 system terminfo database.
150 </para>
151
152 <para>
153 <parameter>--with-app-defaults=...</parameter>: Sets the location
154 for the <filename class="directory">app-defaults</filename>
155 directory.
156 </para>
157
158 <para>
159 <command>make install-ti</command>: This command installs corrected
160 terminfo description files for use with
161 <application>xterm</application>.
162 </para>
163
164 </sect2>
165
166 <sect2 role="configuration">
167 <title>Configuring xterm</title>
168
169 <para>
170 There are two ways to configure xterm. You can add the X resource
171 definitions to the user's <filename>~/.Xresources</filename> file, or
172 add them to the system-wide
173 <filename>$XORG_PREFIX/share/X11/app-defaults/Xterm</filename> file.
174 </para>
175
176 <para>
177 In order for xterm to follow the locale settings in the environment,
178 use TrueType fonts, and follow the Linux convention about the code sent by
179 the Backspace key, add the following definitions as the
180 <systemitem class="username">root</systemitem> user:
181 </para>
182
183<screen role="root"><userinput>cat &gt;&gt; /etc/X11/app-defaults/XTerm &lt;&lt; "EOF"
184<literal>*VT100*locale: true
185*VT100*faceName: Monospace
186*VT100*faceSize: 10
187*backarrowKeyIsErase: true
188*ptyInitialErase: true</literal>
189EOF</userinput></screen>
190
191 </sect2>
192
193 <sect2 role="content">
194 <title>Contents</title>
195
196 <segmentedlist>
197 <segtitle>Installed Programs</segtitle>
198 <segtitle>Installed Libraries</segtitle>
199 <segtitle>Installed Directories</segtitle>
200
201 <seglistitem>
202 <seg>koi8rxterm, resize, uxterm, and xterm</seg>
203 <seg>None</seg>
204 <seg>None</seg>
205 </seglistitem>
206 </segmentedlist>
207
208 <variablelist>
209 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
210 <?dbfo list-presentation="list"?>
211 <?dbhtml list-presentation="table"?>
212
213 <varlistentry id="koi8rxterm">
214 <term><command>koi8rxterm</command></term>
215 <listitem>
216 <para>
217 is a wrapper script to set up xterm with a KOI8-R locale.
218 </para>
219 <indexterm zone="xterm2 koi8rxterm">
220 <primary sortas="b-koi8rxterm">koi8rxterm</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="resize">
226 <term><command>resize</command></term>
227 <listitem>
228 <para>
229 prints a shell command for setting the TERM and TERMCAP
230 environment variables to indicate the current size of xterm
231 window.
232 </para>
233 <indexterm zone="xterm2 resize">
234 <primary sortas="b-resize">resize</primary>
235 </indexterm>
236 </listitem>
237 </varlistentry>
238
239 <varlistentry id="uxterm">
240 <term><command>uxterm</command></term>
241 <listitem>
242 <para>
243 is a wrapper script that modifies the current locale to use
244 UTF-8 and starts xterm with the proper settings.
245 </para>
246 <indexterm zone="xterm2 uxterm">
247 <primary sortas="b-uxterm">uxterm</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251
252 <varlistentry id="xterm-bin">
253 <term><command>xterm</command></term>
254 <listitem>
255 <para>
256 is a terminal emulator for the X Window System.
257 </para>
258 <indexterm zone="xterm2 xterm2">
259 <primary sortas="b-xterm2">xterm</primary>
260 </indexterm>
261 </listitem>
262 </varlistentry>
263
264 </variablelist>
265
266 </sect2>
267
268</sect1>
Note: See TracBrowser for help on using the repository browser.