source: x/installing/xterm.xml@ 54ed60b

elogind
Last change on this file since 54ed60b was 54ed60b, checked in by DJ Lucas <dj@…>, 6 years ago

Merge to HEAD 20836

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

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