source: postlfs/editors/vim.xml@ 1ba83240

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 1ba83240 was 4967eaf6, checked in by Bruce Dubbs <bdubbs@…>, 17 years ago

Revert an explanation in vim

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

  • Property mode set to 100644
File size: 9.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!-- Inserted as a reminder to do this. The mention of a test suite
8 is usually right before the root user installation commands. Please
9 delete these 12 (including one blank) lines after you are done.-->
10
11 <!-- Use one of the two mentions below about a test suite,
12 delete the line that is not applicable. Of course, if the
13 test suite uses syntax other than "make check", revise the
14 line to reflect the actual syntax to run the test suite -->
15
16 <!-- <para>This package does not come with a test suite.</para> -->
17 <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
18
19 <!ENTITY vim-download-http "http://ftp.at.vim.org/pub/vim/unix/vim-&vim-version;.tar.bz2">
20 <!ENTITY vim-download-ftp "ftp://ftp.vim.org/pub/vim/unix/vim-&vim-version;.tar.bz2">
21 <!ENTITY vim-md5sum "4ca69757678272f718b1041c810d82d8">
22 <!ENTITY vim-size "6.3 MB">
23 <!ENTITY vim-buildsize "73 MB">
24 <!ENTITY vim-time "0.8 SBU">
25]>
26
27<sect1 id="vim" xreflabel="Vim-&vim-version;">
28 <?dbhtml filename="vim.html"?>
29
30 <sect1info>
31 <othername>$LastChangedBy$</othername>
32 <date>$Date$</date>
33 </sect1info>
34
35 <title>Vim-&vim-version;</title>
36
37 <indexterm zone="vim">
38 <primary sortas="a-Vim">Vim</primary>
39 </indexterm>
40
41 <sect2 role="package">
42 <title>Introduction to Vim</title>
43
44 <para>The <application>Vim</application> package, which is an
45 abbreviation for VI IMproved, contains a <command>vi</command>
46 clone with extra features as compared to the original
47 <command>vi</command>.</para>
48
49 <para>The default LFS instructions install <application>vim</application>
50 as a part of the base system. If you would prefer to link
51 <application>vim</application> against <application>X</application>,
52 you should recompile <application>vim</application> to enable GUI mode.
53 There is no need for special instructions since
54 <application>X</application> support is automatically detected.</para>
55
56 <bridgehead renderas="sect3">Package Information</bridgehead>
57 <itemizedlist spacing="compact">
58 <listitem>
59 <para>Download (HTTP): <ulink url="&vim-download-http;"/></para>
60 </listitem>
61 <listitem>
62 <para>Download (FTP): <ulink url="&vim-download-ftp;"/></para>
63 </listitem>
64 <listitem>
65 <para>Download MD5 sum: &vim-md5sum;</para>
66 </listitem>
67 <listitem>
68 <para>Download size: &vim-size;</para>
69 </listitem>
70 <listitem>
71 <para>Estimated disk space required: &vim-buildsize;</para>
72 </listitem>
73 <listitem>
74 <para>Estimated build time: &vim-time;</para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
79 <itemizedlist spacing='compact'>
80 <listitem>
81 <para>Recommended Patch: <ulink
82 url="&patch-root;/vim-&vim-version;-fixes-14.patch"/></para>
83 </listitem>
84 <listitem>
85 <para>Recommended Patch: <ulink
86 url="&patch-root;/vim-&vim-version;-mandir-1.patch"/></para>
87 </listitem>
88 <listitem>
89 <para>Translated Vim messages: <ulink
90 url="http://ftp.at.vim.org/pub/vim/extra/vim-&vim-version;-lang.tar.gz"/>
91 </para>
92 </listitem>
93 </itemizedlist>
94
95 <bridgehead renderas="sect3">Vim Dependencies</bridgehead>
96
97 <bridgehead renderas="sect4">Recommended</bridgehead>
98 <para role="recommended"><xref linkend="x-window-system"/></para>
99
100 <bridgehead renderas="sect4">Optional</bridgehead>
101 <para role="optional"><xref linkend="gtk2"/> OR
102 <xref linkend="lesstif"/> OR
103 <xref linkend="GTK"/>,
104 <xref linkend="python"/>,
105 <xref linkend="tcl"/>,
106 <xref linkend="ruby"/>, and
107 <xref linkend="gpm"/></para>
108
109 <para condition="html" role="usernotes">User Notes:
110 <ulink url="&blfs-wiki;/vim"/></para>
111
112 </sect2>
113
114 <sect2 role="installation">
115 <title>Installation of Vim</title>
116
117 <note>
118 <para>If you recompile <application>Vim</application> to link against
119 <application>X</application>, and your <application>X</application>
120 libraries are not on the root partition, you will no longer have an editor
121 for use in emergencies. You may choose to install an additional editor,
122 not link <application>Vim</application> against
123 <application>X</application>, or move the current <command>vim</command>
124 executable to the <filename class="directory">/bin</filename> directory
125 under a different name such as <filename>vi</filename>.</para>
126 </note>
127
128 <para>If desired, unpack the translated messages archive:</para>
129
130<screen><userinput>tar -xf ../vim-&vim-version;-lang.tar.gz --strip-components=1</userinput></screen>
131
132 <para>Install <application>Vim</application> by running the following
133 commands:</para>
134
135<screen><userinput>patch -Np1 -i ../vim-&vim-version;-fixes-14.patch &amp;&amp;
136patch -Np1 -i ../vim-&vim-version;-mandir-1.patch &amp;&amp;
137echo '#define SYS_VIMRC_FILE "/etc/vimrc"' &gt;&gt; src/feature.h &amp;&amp;
138echo '#define SYS_GVIMRC_FILE "/etc/gvimrc"' &gt;&gt; src/feature.h &amp;&amp;
139./configure --prefix=/usr --with-features=huge &amp;&amp;
140make</userinput></screen>
141
142 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
143
144<screen role="root"><userinput>make install</userinput></screen>
145
146 <para>In UTF-8 locales, the <command>vimtutor</command> program tries to
147 convert the tutorials from ISO-8859-1 to UTF-8. Since some tutorials are
148 not in ISO-8859-1, the text in them is thus made unreadable. If you
149 unpacked the <filename>vim-&vim-version;-lang.tar.gz</filename> archive and
150 are going to use a UTF-8 based locale, remove non-ISO-8859-1 tutorials. An
151 English tutorial will be used instead.</para>
152
153<screen><userinput>rm -f /usr/share/vim/vim64/tutor/tutor.{gr,pl,ru,sk}
154rm -f /usr/share/vim/vim64/tutor/tutor.??.*</userinput></screen>
155
156 </sect2>
157
158 <sect2 role="commands">
159 <title>Command Explanations</title>
160
161 <para><command>patch &hellip;</command>: These patches are the same as LFS
162 and update the package with upstream patches and ensure the man pages
163 are placed in the proper locations.</para>
164
165 <para><parameter>--with-features=huge</parameter>: This switch enables all
166 the additional features available in <application>Vim</application>.</para>
167
168 <para><option>--enable-gui=no</option>: This will prevent compilation of the
169 GUI. <application>Vim</application> will still link against
170 <application>X</application> so that some nice eye-candy such as updating the
171 title bar of an <application>Xterm</application> window are available.</para>
172
173 <para><option>--without-x</option>: If you prefer not to link
174 <application>Vim</application> against <application>X</application>, use
175 this switch.</para>
176
177 </sect2>
178
179 <sect2 role="content">
180 <title>Contents</title>
181
182 <para>A list of the reinstalled files, along with their short
183 descriptions can be found at <ulink
184 url="&lfs-root;/chapter06/vim.html#contents-vim"/>.</para>
185
186 <segmentedlist>
187 <segtitle>Installed Programs</segtitle>
188 <segtitle>Installed Libraries</segtitle>
189 <segtitle>Installed Directory</segtitle>
190
191 <seglistitem>
192 <seg>gview, gvim, gvimdiff, rgview, and rgvim</seg>
193 <seg>None</seg>
194 <seg>/usr/share/vim</seg>
195 </seglistitem>
196 </segmentedlist>
197
198 <variablelist>
199 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
200 <?dbfo list-presentation="list"?>
201 <?dbhtml list-presentation="table"?>
202
203 <varlistentry id="gview">
204 <term><command>gview</command></term>
205 <listitem>
206 <para>starts <command>gvim</command> in read-only mode.</para>
207 <indexterm zone="vim gview">
208 <primary sortas="b-gview">gview</primary>
209 </indexterm>
210 </listitem>
211 </varlistentry>
212
213 <varlistentry id="gvim">
214 <term><command>gvim</command></term>
215 <listitem>
216 <para>is the editor that runs under <application>X</application>
217 and includes a GUI.</para>
218 <indexterm zone="vim gvim">
219 <primary sortas="b-gvim">gvim</primary>
220 </indexterm>
221 </listitem>
222 </varlistentry>
223
224 <varlistentry id="gvimdiff">
225 <term><command>gvimdiff</command></term>
226 <listitem>
227 <para>edits two or three versions of a file with
228 <command>gvim</command> and shows the differences.</para>
229 <indexterm zone="vim gvimdiff">
230 <primary sortas="b-gvimdiff">gvimdiff</primary>
231 </indexterm>
232 </listitem>
233 </varlistentry>
234
235 <varlistentry id="rgview">
236 <term><command>rgview</command></term>
237 <listitem>
238 <para>is a restricted version of <command>gview</command>.</para>
239 <indexterm zone="vim rgview">
240 <primary sortas="b-rgview">rgview</primary>
241 </indexterm>
242 </listitem>
243 </varlistentry>
244
245 <varlistentry id="rgvim">
246 <term><command>rgvim</command></term>
247 <listitem>
248 <para>is a restricted version of <command>gvim</command>. </para>
249 <indexterm zone="vim gvim">
250 <primary sortas="b-gvim">gvim</primary>
251 </indexterm>
252 </listitem>
253 </varlistentry>
254
255 </variablelist>
256
257 </sect2>
258
259</sect1>
Note: See TracBrowser for help on using the repository browser.