source: postlfs/editors/emacs.xml@ 00d040d

10.0 10.1 11.0 11.1 11.2 9.1 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 00d040d was 00d040d, checked in by Pierre Labastie <pieere@…>, 3 years ago

Make gtk-update-... and update-desktop-... "nodump": The needed programs are
not mentioned in the dependency paragraphs, so that very often, they are not
installed. Furthermore, our policy respective to this is not clear to me:
a lot more packages install icons or .desktop files, and we do not run
updates for them. Actually, the updates should be run at the end of all
installations, not for individual pacakges...

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

  • Property mode set to 100644
File size: 9.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 emacs-download-http "&gnu-http;/emacs/emacs-&emacs-version;.tar.xz">
8 <!ENTITY emacs-download-ftp "&gnu-ftp;/emacs/emacs-&emacs-version;.tar.xz">
9 <!ENTITY emacs-download-ftp " ">
10 <!ENTITY emacs-md5sum "0a2e4b965d31a7cb1930eae3b79df793">
11 <!ENTITY emacs-size "42 MB">
12 <!ENTITY emacs-buildsize "434 MB">
13 <!ENTITY emacs-time "0.6 SBU (Using parallelism=4)">
14]>
15
16<sect1 id="emacs" xreflabel="Emacs-&emacs-version;">
17 <?dbhtml filename="emacs.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Emacs-&emacs-version;</title>
25
26 <indexterm zone="emacs">
27 <primary sortas="a-Emacs">Emacs</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Emacs</title>
32
33 <para>The <application>Emacs</application> package contains an extensible,
34 customizable, self-documenting real-time display editor.</para>
35
36 &lfs90_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>Download (HTTP): <ulink url="&emacs-download-http;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download (FTP): <ulink url="&emacs-download-ftp;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download MD5 sum: &emacs-md5sum;</para>
48 </listitem>
49 <listitem>
50 <para>Download size: &emacs-size;</para>
51 </listitem>
52 <listitem>
53 <para>Estimated disk space required: &emacs-buildsize;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated build time: &emacs-time;</para>
57 </listitem>
58 </itemizedlist>
59
60 <bridgehead renderas="sect3">Emacs Dependencies</bridgehead>
61
62 <bridgehead renderas="sect4">Recommended</bridgehead>
63 <para role="recommended">
64 <xref linkend="giflib"/>,
65 <xref linkend="gnutls"/>, and
66 <xref linkend="libtiff"/>
67 </para>
68
69 <bridgehead renderas="sect4">Optional</bridgehead>
70 <para role="optional">
71 <xref linkend="x-window-system"/>,
72 <xref linkend="alsa-lib"/>,
73 <xref linkend="dbus"/>,
74 <xref linkend="GConf"/>,
75 <xref linkend="gobject-introspection"/>,
76 <xref linkend="gsettings-desktop-schemas"/>,
77 <xref linkend="gpm"/>,
78 <xref linkend="gtk2"/> or <xref linkend="gtk3"/>,
79 <xref linkend="imagemagick6"/> (see command explanations),
80 <xref linkend="libjpeg"/>,
81 <xref linkend="libpng"/>,
82 <xref linkend="librsvg"/>,
83 <xref linkend="libxml2"/>,
84 <xref linkend="mitkrb"/>,
85 <xref linkend="valgrind"/>,
86 <ulink url="&gnu-http;/intlfonts/">intlfonts</ulink>,
87 <ulink url="http://directory.fsf.org/wiki/Libungif">libungif</ulink>,
88 <ulink url="http://www.nongnu.org/m17n/">libotf</ulink> and
89 <ulink url="http://www.nongnu.org/m17n/">m17n-lib</ulink> - to correctly
90 display such complex scripts as Indic and Khmer, and also for scripts
91 that require Arabic shaping support (Arabic and Farsi), and
92 <ulink url="&xorg-download-http;/lib/">libXaw3d</ulink>
93 </para>
94
95 <para condition="html" role="usernotes">User Notes:
96 <ulink url="&blfs-wiki;/emacs"/></para>
97
98 </sect2>
99
100 <sect2 role="installation">
101 <title>Installation of Emacs</title>
102
103 <para>Install <application>Emacs</application> by running the following
104 commands:</para>
105
106<screen><userinput>./configure --prefix=/usr --localstatedir=/var &amp;&amp;
107make</userinput></screen>
108<!-- make bootstrap only necessary for development versions obtained with git
109-->
110
111 <para>
112 This package does not come with a test suite. If make succeeds, you can
113 test the result by running <command>src/emacs -Q</command>, which is the
114 program that will be installed, with its auxiliary files. This should
115 start and display the application opening screen.
116 </para>
117
118 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
119
120<screen role="root" revision="systemd"><userinput>make install &amp;&amp;
121chown -v -R root:root /usr/share/emacs/&emacs-version;</userinput></screen>
122
123<screen role="root" revision="sysv"><userinput>make install &amp;&amp;
124chown -v -R root:root /usr/share/emacs/&emacs-version; &amp;&amp;
125rm -vf /usr/lib/systemd/user/emacs.service</userinput></screen>
126
127 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
128 href="../../xincludes/gtk-update-icon-cache.xml"/>
129
130 </sect2>
131
132 <sect2 role="commands">
133 <title>Command Explanations</title>
134
135 <para><parameter>--localstatedir=/var</parameter>: Create game score files
136 in <filename class='directory'>/var/games/emacs</filename> instead
137 of <filename class='directory'>/usr/var/games/emacs</filename>.</para>
138
139 <para><option>IMAGEMAGICK_CFLAGS=-I/usr/include/ImageMagick-6
140 IMAGEMAGICK_LIBS="-lMagickCore-6.Q16HDRI -lMagick++-6.Q16HDRI
141 -lMagickWand-6.Q16HDRI" </option>:
142 use these when you invoke configure if you have installed <xref
143 linkend="imagemagick6"/> and wish to link to them (the normal unversioned
144 pkgconfig files collide with <xref linkend="imagemagick"/> which this
145 package cannot use).</para>
146
147 <para><option>--with-gif=no</option>: Use this if you have not installed
148 <xref linkend="giflib"/> or
149 <ulink url="http://directory.fsf.org/wiki/Libungif">libungif</ulink>.</para>
150
151 <para><option>--with-tiff=no</option>: Use this if you have not installed
152 <xref linkend="libtiff"/>.</para>
153
154 <para><option>--with-gnutls=no</option>: Use this if you have not installed
155 <xref linkend="gnutls"/>.</para>
156
157 </sect2>
158
159 <sect2 role="content">
160 <title>Contents</title>
161
162 <segmentedlist>
163 <segtitle>Installed Programs</segtitle>
164 <segtitle>Installed Libraries</segtitle>
165 <segtitle>Installed Directories</segtitle>
166
167 <seglistitem>
168 <seg>ctags,
169 ebrowse,
170 emacs (symlink),
171 emacs-&emacs-version;,
172 emacsclient,
173 etags, and
174 grep-changelog</seg>
175 <seg>None</seg>
176 <seg>/usr/libexec/emacs,
177 /usr/share/emacs, and
178 /var/games/emacs</seg>
179 </seglistitem>
180 </segmentedlist>
181
182 <variablelist>
183 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
184 <?dbfo list-presentation="list"?>
185 <?dbhtml list-presentation="table"?>
186
187 <varlistentry id="ctags">
188 <term><command>ctags</command></term>
189 <listitem>
190 <para>creates cross-reference tagfile database files
191 for source code.</para>
192 <indexterm zone="emacs ctags">
193 <primary sortas="b-ctags">ctags</primary>
194 </indexterm>
195 </listitem>
196 </varlistentry>
197
198 <varlistentry id="ebrowse">
199 <term><command>ebrowse</command></term>
200 <listitem>
201 <para>permits browsing of C++ class hierarchies from
202 within <command>emacs</command>.</para>
203 <indexterm zone="emacs ebrowse">
204 <primary sortas="b-ebrowse">ebrowse</primary>
205 </indexterm>
206 </listitem>
207 </varlistentry>
208
209 <varlistentry id="emacs-prog">
210 <term><command>emacs</command></term>
211 <listitem>
212 <para>is an editor.</para>
213 <indexterm zone="emacs emacs-prog">
214 <primary sortas="b-emacs">emacs</primary>
215 </indexterm>
216 </listitem>
217 </varlistentry>
218
219 <varlistentry id="emacsclient">
220 <term><command>emacsclient</command></term>
221 <listitem>
222 <para>attaches an <command>emacs</command> session to an already
223 running <command>emacsserver</command> instance.</para>
224 <indexterm zone="emacs emacsclient">
225 <primary sortas="b-emacsclient">emacsclient</primary>
226 </indexterm>
227 </listitem>
228 </varlistentry>
229
230 <varlistentry id="etags">
231 <term><command>etags</command></term>
232 <listitem>
233 <para>is another program to generate source code
234 cross-reference tagfiles.</para>
235 <indexterm zone="emacs etags">
236 <primary sortas="b-etags">etags</primary>
237 </indexterm>
238 </listitem>
239 </varlistentry>
240
241 <varlistentry id="grep-changelog">
242 <term><command>grep-changelog</command></term>
243 <listitem>
244 <para>prints entries in Change Logs matching
245 various criteria.</para>
246 <indexterm zone="emacs grep-changelog">
247 <primary sortas="b-grep-changelog">grep-changelog</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251<!--
252 <varlistentry id="rcs-checkin">
253 <term><command>rcs-checkin</command></term>
254 <listitem>
255 <para>is a shell script used to check files into RCS.</para>
256 <indexterm zone="emacs rcs-checkin">
257 <primary sortas="b-rcs-checkin">rcs-checkin</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>-->
261
262 </variablelist>
263
264 </sect2>
265
266</sect1>
Note: See TracBrowser for help on using the repository browser.