Changeset 673b0d8 for chapter06/vim.xml


Ignore:
Timestamp:
05/03/2004 10:59:46 AM (20 years ago)
Author:
Matthew Burgess <matthew@…>
Branches:
10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.0, 6.1, 6.1.1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, v5_1, v5_1_1, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
Children:
0c43171, 2ec64b3, a4a675f
Parents:
287ea55
Message:
  • Merged newxml into HEAD

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3435 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

File:
1 edited

Legend:

Unmodified
Added
Removed

  • chapter06/vim.xml

    r287ea55 r673b0d8  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     3  <!ENTITY % general-entities SYSTEM "../general.ent">
     4  %general-entities;
     5]>
    16<sect1 id="ch-system-vim" xreflabel="Vim">
    2 <title>Installing Vim-&vim-version;</title>
    3 <?dbhtml filename="vim.html" dir="chapter06"?>
     7<title>Vim-&vim-version;</title>
     8<?dbhtml filename="vim.html"?>
     9
     10<indexterm zone="ch-system-vim"><primary sortas="a-Vim">Vim</primary></indexterm>
    411
    512<para>The Vim package contains a powerful text editor.</para>
    613
    7 <screen>&buildtime; &vim-time;
    8 &diskspace; &vim-compsize;</screen>
     14<screen>&buildtime; 0.4 SBU
     15&diskspace; 34 MB</screen>
    916
    10 &aa-vim-down;
    11 &aa-vim-dep;
     17<para>Vim installation depends on: Bash, Binutils, Coreutils, Diffutils,
     18GCC, Glibc, Grep, Make, Ncurses, Sed.</para>
    1219
    13 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
     20
    1421
    1522<sect2>
    … …  
    2027</sect2>
    2128
    22 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
    2329
    2430<sect2>
    … …  
    2632
    2733<para>First change the default locations of the <filename>vimrc</filename> and
    28 <filename>gvimrc</filename> configuration files to <filename
    29 class="directory">/etc</filename>.</para>
     34<filename>gvimrc</filename> configuration files to <filename class="directory">/etc</filename>.</para>
    3035
    3136<screen><userinput>echo '#define SYS_VIMRC_FILE "/etc/vimrc"' &gt;&gt; src/feature.h
    … …  
    4045<screen><userinput>make</userinput></screen>
    4146
    42 <para>To have the results tested, you can issue:
     47<para>To test the results, you can issue:
    4348<userinput>make check</userinput>. However, this test suite outputs a lot of
    4449seemingly garbage characters to the screen, and this can wreak havoc with the
    … …  
    4651is strictly optional.</para>
    4752
    48 <para>And install the package:</para>
     53<para>Now install the package:</para>
    4954
    5055<screen><userinput>make install</userinput></screen>
    5156
    52 <para>When called as <command>vi</command>, <command>vim</command>
    53 will run in old-fashioned vi-mode. To allow this, create a symlink:</para>
     57<para>Many users are used to using <command>vi</command>, instead of
     58<command>vim</command>. To let them execute <command>vim</command> when
     59they habitually enter <command>vi</command>, create a symlink:</para>
    5460
    5561<screen><userinput>ln -s vim /usr/bin/vi</userinput></screen>
    … …  
    6268</sect2>
    6369
    64 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
    6570
    66 <sect2><title>Configuring Vim</title>
     71<sect2 id="conf-vim"><title>Configuring Vim</title>
     72<indexterm zone="conf-vim"><primary sortas="e-/etc/vim">/etc/vim</primary></indexterm>
    6773
    68 <para>By default, <command>vim</command> runs in vi-compatible mode. Some
    69 people might like this, but we prefer to run <command>vim</command> in its
     74<para>By default, <command>vim</command> runs in vi-incompatible mode. Some
     75people might not like this, but we prefer to run <command>vim</command> in its
    7076own mode (else we wouldn't have included it in this book, but the original
    71 <command>vi</command>). Create a default vim configuration file by running
     77<command>vi</command>). We've included the setting of "nocompatible"
     78below to high-light the fact that the new behavior is being used. It
     79also reminds those who would change to "compatible" mode that it should
     80appear first because it changes other settings and overrides must come
     81after this setting. Create a default vim configuration file by running
    7282the following:</para>
    7383
    … …  
    8292<userinput>EOF</userinput></screen>
    8393
    84 <para>The <emphasis>set nocompatible</emphasis> will make
    85 <command>vim</command> behave in a more useful way than the default
    86 vi-compatible manner. The <emphasis>set backspace=2</emphasis> allows
    87 backspacing over line breaks, autoindent and the start of insert. And the
    88 <emphasis>syntax on</emphasis> switches on <command>vim</command>'s
    89 semantic colouring.</para>
     94<para>The <emphasis>set nocompatible</emphasis> makes
     95<command>vim</command> behave in a more useful way (the default) than the
     96vi-compatible manner. Remove the "no" if you want the old <command>vi</command>
     97behavior. The <emphasis>set backspace=2</emphasis> allows
     98backspacing over line breaks, autoindents and the start of insert. The
     99<emphasis>syntax on</emphasis> enables <command>vim</command>'s
     100semantic coloring.</para>
    90101
    91102</sect2>
    92103
    93 &aa-vim-shortdesc;
    94 &aa-vim-desc;
     104
     105<sect2 id="contents-vim"><title>Contents of Vim</title>
     106
     107<para><emphasis>Installed programs</emphasis>: efm_filter.pl, efm_perl.pl, ex
     108(link to vim), less.sh, mve.awk, pltags.pl, ref, rview (link to vim), rvim
     109(link to vim), shtags.pl, tcltags, vi (link to vim), view (link to vim), vim,
     110vim132, vim2html.pl, vimdiff (link to vim), vimm, vimspell.sh, vimtutor
     111and xxd</para>
     112
     113</sect2>
     114
     115<sect2><title>Short descriptions</title>
     116
     117<indexterm zone="ch-system-vim efm_filter.pl"><primary sortas="b-efm_filter.pl">efm_filter.pl</primary></indexterm>
     118<para id="efm_filter.pl"><command>efm_filter.pl</command> is a filter for creating an error
     119file that can be read by vim.</para>
     120
     121<indexterm zone="ch-system-vim efm_perl.pl"><primary sortas="b-efm_perl.pl">efm_perl.pl</primary></indexterm>
     122<para id="efm_perl.pl"><command>efm_perl.pl</command> reformats the error messages of the
     123Perl interpreter for use with the <quote>quickfix</quote> mode of vim.</para>
     124
     125<indexterm zone="ch-system-vim ex"><primary sortas="b-ex">ex</primary></indexterm>
     126<para id="ex"><command>ex</command> starts vim in ex mode.</para>
     127
     128<indexterm zone="ch-system-vim less.sh"><primary sortas="b-less.sh">less.sh</primary></indexterm>
     129<para id="less.sh"><command>less.sh</command> is a script that starts vim with less.vim.</para>
     130
     131<indexterm zone="ch-system-vim mve.awk"><primary sortas="b-mve.awk">mve.awk</primary></indexterm>
     132<para id="mve.awk"><command>mve.awk</command> processes vim errors.</para>
     133
     134<indexterm zone="ch-system-vim pltags.pl"><primary sortas="b-pltags.pl">pltags.pl</primary></indexterm>
     135<para id="pltags.pl"><command>pltags.pl</command> creates a tags file for perl code,
     136for use by vim.</para>
     137
     138<indexterm zone="ch-system-vim ref"><primary sortas="b-ref">ref</primary></indexterm>
     139<para id="ref"><command>ref</command> checks the spelling of arguments.</para>
     140
     141<indexterm zone="ch-system-vim rview"><primary sortas="b-rview">rview</primary></indexterm>
     142<para id="rview"><command>rview</command> is a restricted version of view: no shell
     143commands can be started and view can't be suspended.</para>
     144
     145<indexterm zone="ch-system-vim rvim"><primary sortas="b-rvim">rvim</primary></indexterm>
     146<para id="rvim"><command>rvim</command> is a restricted version of vim: no shell
     147commands can be started and vim can't be suspended.</para>
     148
     149<indexterm zone="ch-system-vim shtags.pl"><primary sortas="b-shtags.pl">shtags.pl</primary></indexterm>
     150<para id="shtags.pl"><command>shtags.pl</command> generates a tag file for perl scripts.</para>
     151
     152<indexterm zone="ch-system-vim tcltags"><primary sortas="b-tcltags">tcltags</primary></indexterm>
     153<para id="tcltags"><command>tcltags</command> generates a tag file for TCL code.</para>
     154
     155<indexterm zone="ch-system-vim view"><primary sortas="b-view">view</primary></indexterm>
     156<para id="view"><command>view</command> starts vim in read-only mode.</para>
     157
     158<indexterm zone="ch-system-vim vim"><primary sortas="b-vim">vim</primary></indexterm>
     159<para id="vim"><command>vim</command> is the editor.</para>
     160
     161<indexterm zone="ch-system-vim vim132"><primary sortas="b-vim132">vim132</primary></indexterm>
     162<para id="vim132"><command>vim132</command> starts vim with the terminal in
     163132-column mode.</para>
     164
     165<indexterm zone="ch-system-vim vim2html.pl"><primary sortas="b-vim2html.pl">vim2html.pl</primary></indexterm>
     166<para id="vim2html.pl"><command>vim2html.pl</command> converts vim documentation to
     167HTML.</para>
     168
     169<indexterm zone="ch-system-vim vimdiff"><primary sortas="b-vimdiff">vimdiff</primary></indexterm>
     170<para id="vimdiff"><command>vimdiff</command> edits two or three versions of a file with
     171vim and show differences.</para>
     172
     173<indexterm zone="ch-system-vim vimm"><primary sortas="b-vimm">vimm</primary></indexterm>
     174<para id="vimm"><command>vimm</command> enables the DEC locator input model on a
     175remote terminal.</para>
     176
     177<indexterm zone="ch-system-vim vimspell.sh"><primary sortas="b-vimspell.sh">vimspell.sh</primary></indexterm>
     178<para id="vimspell.sh"><command>vimspell.sh</command> is a script which spells a file and generates the syntax
     179statements necessary to highlight in vim.</para>
     180
     181<indexterm zone="ch-system-vim vimtutor"><primary sortas="b-vimtutor">vimtutor</primary></indexterm>
     182<para id="vimtutor"><command>vimtutor</command> teaches you the basic keys and commands
     183of vim.</para>
     184
     185<indexterm zone="ch-system-vim xxd"><primary sortas="b-xxd">xxd</primary></indexterm>
     186<para id="xxd"><command>xxd</command> makes a hex dump of the given file. It can
     187also do the reverse, so it can be used for binary patching.</para>
     188
     189</sect2>
     190
     191
    95192
    96193</sect1>
    97 
Note: See TracChangeset for help on using the changeset viewer.