source: gnome/platform/vte.xml@ 261bdae

12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since 261bdae was 261bdae, checked in by Bruce Dubbs <bdubbs@…>, 8 months ago

Update to gnome-terminal-3.50.1 and vte-0.74.1
  • Property mode set to 100644
File size: 8.0 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 vte-download-http "https://gitlab.gnome.org/GNOME/vte/-/archive/&vte-version;/vte-&vte-version;.tar.gz">
8 <!ENTITY vte-download-ftp " ">
9 <!ENTITY vte-md5sum "ffc4d99da350f2997db79be1515462fd">
10 <!ENTITY vte-size "620 KB">
11 <!ENTITY vte-buildsize "24 MB (with tests)">
12 <!ENTITY vte-time "0.4 SBU (using parallelism=4; with tests)">
13
14 <!-- For "Contents" and "Short Descriptions" sections -->
15 <!ENTITY vte-nano "91">
16]>
17
18<sect1 id="vte" xreflabel="VTE-&vte-version;">
19 <?dbhtml filename="vte.html"?>
20
21
22 <title>VTE-&vte-version;</title>
23
24 <indexterm zone="vte">
25 <primary sortas="a-VTE">VTE</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to VTE</title>
30
31 <para>
32 The <application>VTE</application> package contains a termcap
33 file implementation for terminal emulators.
34 </para>
35
36 &lfs120_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>
42 Download (HTTP): <ulink url="&vte-download-http;"/>
43 </para>
44 </listitem>
45 <listitem>
46 <para>
47 Download (FTP): <ulink url="&vte-download-ftp;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download MD5 sum: &vte-md5sum;
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download size: &vte-size;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Estimated disk space required: &vte-buildsize;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated build time: &vte-time;
68 </para>
69 </listitem>
70 </itemizedlist>
71
72 <bridgehead renderas="sect3">VTE Dependencies</bridgehead>
73
74 <bridgehead renderas="sect4">Required</bridgehead>
75 <para role="required">
76 <xref linkend="gtk3"/>,
77 <xref linkend="libxml2"/>, and
78 <xref linkend="pcre2"/>
79 </para>
80
81 <bridgehead renderas="sect4">Recommended</bridgehead>
82 <para role="recommended">
83 <xref linkend="icu"/>,
84 <xref linkend="gnutls"/>,
85 <xref linkend="gobject-introspection"/>,
86 <xref linkend="gtk4"/>, and
87 <xref linkend="vala"/>
88 </para>
89
90 <bridgehead renderas="sect4">Optional</bridgehead>
91 <para role="optional">
92 <xref linkend="fribidi"/>, and
93 <xref linkend="gi-docgen"/>
94 </para>
95
96 </sect2>
97
98 <sect2 role="installation">
99 <title>Installation of VTE</title>
100
101 <para>
102 Install <application>VTE</application> by running the following
103 commands:
104 </para>
105
106<screen revision="systemd"><userinput>mkdir build &amp;&amp;
107cd build &amp;&amp;
108
109meson setup --prefix=/usr --buildtype=release -Dfribidi=false .. &amp;&amp;
110ninja</userinput></screen>
111
112<screen revision="sysv"><userinput>mkdir build &amp;&amp;
113cd build &amp;&amp;
114
115meson setup --prefix=/usr \
116 --buildtype=release \
117 -Dfribidi=false \
118 -D_systemd=false &amp;&amp;
119ninja</userinput></screen>
120
121 <para>
122 If you have <xref linkend='gi-docgen'/> installed and wish to build
123 the API documentation for this package, issue:
124 </para>
125
126 <!-- To editors: you may wonder why this change makes a
127 /usr/share/doc/vte-&vte-version; with only one subdirectory
128 "vte-2.91" inside. The reason is when -Dgtk4 is enabled,
129 another directory "vte-2.91-gtk4" will also be there. -->
130<screen role='nodump'><userinput>sed -e "/docdir =/s@\$@/ 'vte-&vte-version;'@" \
131 -i ../doc/reference/meson.build &amp;&amp;
132meson configure -Ddocs=true &amp;&amp;
133ninja</userinput></screen>
134
135 <para>
136 To test the results, issue <command>ninja test</command>.
137 </para>
138
139 <para>
140 Now, as the <systemitem class="username">root</systemitem> user:
141 </para>
142
143<screen role="root"><userinput>ninja install &amp;&amp;
144rm -v /etc/profile.d/vte.*</userinput></screen>
145
146 </sect2>
147
148 <sect2 role="commands">
149 <title>Command Explanations</title>
150
151 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
152 href="../../xincludes/meson-buildtype-release.xml"/>
153
154 <para>
155 <command>rm -v /etc/profile.d/vte.*</command>: This command removes two
156 files installed in /etc/profile.d that have no use on a LFS system.
157 </para>
158
159 <para>
160 <parameter>-Dfribidi=false</parameter>: Omit this switch if you want
161 to enable bidirectional capabilities.
162 </para>
163
164 <para>
165 <option>-Dgnutls=false</option>: Add this switch if you do not
166 want to enable GnuTLS support.
167 </para>
168
169 <para>
170 <option>-Dvapi=false</option>: Add this switch if you do not
171 want to enable vala bindings.
172 </para>
173
174 <para>
175 <option>-Dgtk4=false</option>: Add this switch if you do not want to
176 build the GTK-4 version of VTE.
177 </para>
178
179 </sect2>
180
181 <sect2 role="content">
182 <title>Contents</title>
183
184 <segmentedlist>
185 <segtitle>Installed Program</segtitle>
186 <segtitle>Installed Library</segtitle>
187 <segtitle>Installed Directories</segtitle>
188
189<!-- EDITORS NOTE:
190 vte installs a file into /etc/profile.d (/etc/profile.d/vte.sh) so that
191 the environment is suitable for running with it's quirks. Another one
192 is now installed as of 0.60.1 (/etc/profile.d/vte.csh) to support
193 the 'tcsh' shell.
194 As of 4/27/2020, we've elected to remove this.
195-->
196 <seglistitem>
197 <seg>
198 vte-2.&vte-nano; and
199 vte-2.&vte-nano;-gtk4
200 </seg>
201 <seg>
202 libvte-2.&vte-nano;.so and
203 libvte-2.&vte-nano;-gtk4.so
204 </seg>
205 <seg>
206 /usr/include/vte-2.&vte-nano;,
207 /usr/include/vte-2.&vte-nano;-gtk4, and
208 (optional) /usr/share/doc/vte-&vte-version;
209 </seg>
210 </seglistitem>
211 </segmentedlist>
212
213 <variablelist>
214 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
215 <?dbfo list-presentation="list"?>
216 <?dbhtml list-presentation="table"?>
217
218 <varlistentry id="vte291">
219 <term><command>vte-2.&vte-nano;</command></term>
220 <listitem>
221 <para>
222 is a test application for the <application>VTE</application>
223 libraries
224 </para>
225 <indexterm zone="vte vte291">
226 <primary sortas="b-vte2-&vte-nano;">vte-2.&vte-nano;</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231 <varlistentry id="vte291-gtk4">
232 <term><command>vte-2.&vte-nano;-gtk4</command></term>
233 <listitem>
234 <para>
235 is a test application for the GTK-4 version of the
236 <application>VTE</application> libraries
237 </para>
238 <indexterm zone="vte vte291-gtk4">
239 <primary sortas="b-vte2-&vte-nano;-gtk4">vte-2.&vte-nano;-gtk4</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 <varlistentry id="libvte291">
245 <term><filename class="libraryfile">libvte-2.&vte-nano;.so</filename></term>
246 <listitem>
247 <para>
248 is a library which implements a terminal emulator
249 widget for <application>GTK+ 3</application>
250 </para>
251 <indexterm zone="vte libvte291">
252 <primary sortas="c-libvte2-&vte-nano;">libvte-2.&vte-nano;.so</primary>
253 </indexterm>
254 </listitem>
255 </varlistentry>
256
257 <varlistentry id="libvte291-gtk4">
258 <term><filename class="libraryfile">libvte-2.&vte-nano;-gtk4.so</filename></term>
259 <listitem>
260 <para>
261 is a library which implements a terminal emulator
262 widget for <application>GTK-4</application>
263 </para>
264 <indexterm zone="vte libvte291-gtk4">
265 <primary sortas="c-libvte2-&vte-nano;-gtk4">libvte-2.&vte-nano;-gtk4.so</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 </variablelist>
271
272 </sect2>
273
274</sect1>
Note: See TracBrowser for help on using the repository browser.