source: postlfs/editors/emacs.xml@ eede1a3

11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since eede1a3 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 years ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 9.6 KB
RevLine 
[b5951ec]1<?xml version="1.0" encoding="ISO-8859-1"?>
[6732c094]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[b5951ec]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
[8dfc5c3]7 <!ENTITY emacs-download-http "&gnu-http;/emacs/emacs-&emacs-version;.tar.xz">
8 <!ENTITY emacs-download-ftp "&gnu-ftp;/emacs/emacs-&emacs-version;.tar.xz">
[a72cdddf]9 <!ENTITY emacs-download-ftp " ">
[8404399]10 <!ENTITY emacs-md5sum "4c3d9ff35b2ab2fe518dc7eb3951e128">
11 <!ENTITY emacs-size "43 MB">
12 <!ENTITY emacs-buildsize "620 MB">
13 <!ENTITY emacs-time "0.6 SBU (Using parallelism=4)">
[b5951ec]14]>
15
[a7a755a]16<sect1 id="emacs" xreflabel="Emacs-&emacs-version;">
[ed59474e]17 <?dbhtml filename="emacs.html"?>
18
19 <sect1info>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Emacs-&emacs-version;</title>
24
25 <indexterm zone="emacs">
26 <primary sortas="a-Emacs">Emacs</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Emacs</title>
31
[f716ef4]32 <para>
33 The <application>Emacs</application> package contains an extensible,
34 customizable, self-documenting real-time display editor.
35 </para>
[ed59474e]36
[f3d413ca]37 &lfs101_checked;
[e237c169]38
[ed59474e]39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
[f716ef4]42 <para>
43 Download (HTTP): <ulink url="&emacs-download-http;"/>
44 </para>
[ed59474e]45 </listitem>
46 <listitem>
[f716ef4]47 <para>
48 Download (FTP): <ulink url="&emacs-download-ftp;"/>
49 </para>
[ed59474e]50 </listitem>
51 <listitem>
[f716ef4]52 <para>
53 Download MD5 sum: &emacs-md5sum;
54 </para>
[ed59474e]55 </listitem>
56 <listitem>
[f716ef4]57 <para>
58 Download size: &emacs-size;
59 </para>
[ed59474e]60 </listitem>
61 <listitem>
[f716ef4]62 <para>
63 Estimated disk space required: &emacs-buildsize;
64 </para>
[ed59474e]65 </listitem>
66 <listitem>
[f716ef4]67 <para>
68 Estimated build time: &emacs-time;
69 </para>
[ed59474e]70 </listitem>
71 </itemizedlist>
72
[c0a34eb]73 <bridgehead renderas="sect3">Emacs Dependencies</bridgehead>
[ed59474e]74
[043a3842]75 <bridgehead renderas="sect4">Recommended</bridgehead>
76 <para role="recommended">
[8404399]77 <xref linkend="harfbuzz"/>,
[96fcf51]78 <xref linkend="giflib"/>,
[8404399]79 <xref linkend="gnutls"/>,
80 <xref linkend="jansson"/>, and
[96fcf51]81 <xref linkend="libtiff"/>
[043a3842]82 </para>
83
[ed59474e]84 <bridgehead renderas="sect4">Optional</bridgehead>
[54666831]85 <para role="optional">
86 <xref linkend="x-window-system"/>,
87 <xref linkend="alsa-lib"/>,
[8404399]88 <xref linkend="cairo"/>,
[54666831]89 <xref linkend="dbus"/>,
[6608c8f]90 <xref linkend="GConf"/>,
[54666831]91 <xref linkend="gobject-introspection"/>,
[6608c8f]92 <xref linkend="gsettings-desktop-schemas"/>,
[54666831]93 <xref linkend="gpm"/>,
[cac7f93]94 <xref role="nodep" linkend="gtk2"/> or <xref linkend="gtk3"/>,
[918c149]95 <xref linkend="imagemagick"/>,
[8404399]96 <xref linkend="lcms2"/>,
[54666831]97 <xref linkend="libjpeg"/>,
98 <xref linkend="libpng"/>,
99 <xref linkend="librsvg"/>,
[b9f3ff5c]100 <xref linkend="libxml2"/>,
[6608c8f]101 <xref linkend="mitkrb"/>,
[b9f3ff5c]102 <xref linkend="valgrind"/>,
[8dfc5c3]103 <ulink url="&gnu-http;/intlfonts/">intlfonts</ulink>,
[6608c8f]104 <ulink url="http://directory.fsf.org/wiki/Libungif">libungif</ulink>,
[8404399]105 <ulink url="http://www.nongnu.org/m17n/">libotf</ulink>, and
[6608c8f]106 <ulink url="http://www.nongnu.org/m17n/">m17n-lib</ulink> - to correctly
107 display such complex scripts as Indic and Khmer, and also for scripts
[8404399]108 that require Arabic shaping support (Arabic and Farsi),
109 <ulink url="https://mailutils.org/">mailutils</ulink>, and
[e622c0b]110 <ulink url="&xorg-download-http;/lib/">libXaw3d</ulink>
[54666831]111 </para>
[ed59474e]112
[3597eb6]113 <para condition="html" role="usernotes">User Notes:
114 <ulink url="&blfs-wiki;/emacs"/></para>
115
[ed59474e]116 </sect2>
117
118 <sect2 role="installation">
119 <title>Installation of Emacs</title>
120
[f716ef4]121 <para>
122 Install <application>Emacs</application> by running the following
123 commands:
124 </para>
[ed59474e]125
[8404399]126<screen><userinput>./configure --prefix=/usr &amp;&amp;
[ca8bcae9]127make</userinput></screen>
128<!-- make bootstrap only necessary for development versions obtained with git
129-->
[ed59474e]130
[6608c8f]131 <para>
132 This package does not come with a test suite. If make succeeds, you can
[5d5234b]133 test the result by running <command>src/emacs -Q</command>, which is the
[6608c8f]134 program that will be installed, with its auxiliary files. This should
135 start and display the application opening screen.
136 </para>
[c1ac942]137
[f716ef4]138 <para>
139 Now, as the <systemitem class="username">root</systemitem> user:
140 </para>
[ed59474e]141
[2ab28c8]142<screen role="root" revision="systemd"><userinput>make install &amp;&amp;
[755379cb]143chown -v -R root:root /usr/share/emacs/&emacs-version;</userinput></screen>
[ed59474e]144
[2ab28c8]145<screen role="root" revision="sysv"><userinput>make install &amp;&amp;
146chown -v -R root:root /usr/share/emacs/&emacs-version; &amp;&amp;
147rm -vf /usr/lib/systemd/user/emacs.service</userinput></screen>
148
[00d040d]149 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
150 href="../../xincludes/gtk-update-icon-cache.xml"/>
[cdabd810]151
[ed59474e]152 </sect2>
153
[32ccdf34]154 <sect2 role="commands">
155 <title>Command Explanations</title>
156
[8404399]157 <!-- With 27.2, it writes scores to ~/.emacs.d/games
[f716ef4]158 <para>
[8404399]159 <parameter>- -localstatedir=/var</parameter>: Create game score files
[f716ef4]160 in <filename class='directory'>/var/games/emacs</filename> instead
161 of <filename class='directory'>/usr/var/games/emacs</filename>.
162 </para>
[8404399]163 -->
[755379cb]164
[f716ef4]165 <para>
[918c149]166 <option>--with-imagemagick</option>: Use this if you have installed
167 <xref linkend="imagemagick"/> and wish to link against it.
[f716ef4]168 </para>
[d113301]169
[f716ef4]170 <para>
171 <option>--with-gif=no</option>: Use this if you have not installed
172 <xref linkend="giflib"/> or
173 <ulink url="http://directory.fsf.org/wiki/Libungif">libungif</ulink>.
174 </para>
[043a3842]175
[f716ef4]176 <para>
177 <option>--with-tiff=no</option>: Use this if you have not installed
178 <xref linkend="libtiff"/>.
179 </para>
[96fcf51]180
[f716ef4]181 <para>
182 <option>--with-gnutls=no</option>: Use this if you have not installed
183 <xref linkend="gnutls"/>.
184 </para>
[96fcf51]185
[8404399]186 <para>
187 <option>--without-harfbuzz</option>: Use this if you have not installed
188 <xref linkend="harfbuzz"/>.
189 </para>
190
191 <para>
192 <option>--with-json=no</option>: Use this if you have not installed
193 <xref linkend="jansson"/>.
194 </para>
195
[32ccdf34]196 </sect2>
197
[ed59474e]198 <sect2 role="content">
199 <title>Contents</title>
200
201 <segmentedlist>
202 <segtitle>Installed Programs</segtitle>
203 <segtitle>Installed Libraries</segtitle>
204 <segtitle>Installed Directories</segtitle>
205
206 <seglistitem>
[f3429309]207 <seg>ctags,
208 ebrowse,
209 emacs (symlink),
[473f435]210 emacs-&emacs-version;,
[8404399]211 emacsclient, and
212 etags</seg>
[ed59474e]213 <seg>None</seg>
[8404399]214 <seg>/usr/libexec/emacs and
215 /usr/share/emacs</seg>
[ed59474e]216 </seglistitem>
217 </segmentedlist>
218
219 <variablelist>
220 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
221 <?dbfo list-presentation="list"?>
222 <?dbhtml list-presentation="table"?>
223
224 <varlistentry id="ctags">
[550ca80]225 <term><command>ctags</command></term>
[ed59474e]226 <listitem>
[f716ef4]227 <para>
228 creates cross-reference tagfile database files
[4c24eb0a]229 for source code
[f716ef4]230 </para>
[ed59474e]231 <indexterm zone="emacs ctags">
232 <primary sortas="b-ctags">ctags</primary>
233 </indexterm>
234 </listitem>
235 </varlistentry>
236
237 <varlistentry id="ebrowse">
238 <term><command>ebrowse</command></term>
239 <listitem>
[f716ef4]240 <para>
241 permits browsing of C++ class hierarchies from
[4c24eb0a]242 within <command>emacs</command>
[f716ef4]243 </para>
[ed59474e]244 <indexterm zone="emacs ebrowse">
245 <primary sortas="b-ebrowse">ebrowse</primary>
246 </indexterm>
247 </listitem>
248 </varlistentry>
249
250 <varlistentry id="emacs-prog">
251 <term><command>emacs</command></term>
252 <listitem>
[f716ef4]253 <para>
[4c24eb0a]254 is an editor
[f716ef4]255 </para>
[ed59474e]256 <indexterm zone="emacs emacs-prog">
257 <primary sortas="b-emacs">emacs</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="emacsclient">
263 <term><command>emacsclient</command></term>
264 <listitem>
[f716ef4]265 <para>
266 attaches an <command>emacs</command> session to an already
[4c24eb0a]267 running <command>emacsserver</command> instance
[f716ef4]268 </para>
[ed59474e]269 <indexterm zone="emacs emacsclient">
270 <primary sortas="b-emacsclient">emacsclient</primary>
271 </indexterm>
272 </listitem>
273 </varlistentry>
274
275 <varlistentry id="etags">
276 <term><command>etags</command></term>
277 <listitem>
[f716ef4]278 <para>
279 is another program to generate source code
[4c24eb0a]280 cross-reference tagfiles
[f716ef4]281 </para>
[ed59474e]282 <indexterm zone="emacs etags">
283 <primary sortas="b-etags">etags</primary>
284 </indexterm>
285 </listitem>
286 </varlistentry>
287
[8404399]288<!-- Not seen with 27.2
[ed59474e]289 <varlistentry id="grep-changelog">
290 <term><command>grep-changelog</command></term>
291 <listitem>
[f716ef4]292 <para>
293 prints entries in Change Logs matching
[4c24eb0a]294 various criteria
[f716ef4]295 </para>
[ed59474e]296 <indexterm zone="emacs grep-changelog">
297 <primary sortas="b-grep-changelog">grep-changelog</primary>
298 </indexterm>
299 </listitem>
300 </varlistentry>
[8404399]301-->
[2bf87d8]302<!--
[ed59474e]303 <varlistentry id="rcs-checkin">
304 <term><command>rcs-checkin</command></term>
305 <listitem>
[f716ef4]306 <para>
307 is a shell script used to check files into RCS.
308 </para>
[ed59474e]309 <indexterm zone="emacs rcs-checkin">
310 <primary sortas="b-rcs-checkin">rcs-checkin</primary>
311 </indexterm>
312 </listitem>
[2bf87d8]313 </varlistentry>-->
[a7a755a]314
[ed59474e]315 </variablelist>
[b5951ec]316
[ed59474e]317 </sect2>
[f45b1953]318
319</sect1>
Note: See TracBrowser for help on using the repository browser.