source: BOOK/temp-system/common/vim.xml@ 3accd6a

sysvinit
Last change on this file since 3accd6a was 714950f, checked in by William Harrington <kb0iic@…>, 8 years ago

Update Vim to 8.0.

  • Property mode set to 100644
File size: 4.8 KB
RevLine 
[ffbc9152]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
8<sect1 id="ch-temp-system-vim" role="wrap">
9 <?dbhtml filename="vim.html"?>
10
11 <title>Vim-&vim-version;</title>
12
13 <indexterm zone="ch-temp-system-vim">
14 <primary sortas="a-Vim">Vim</primary>
15 <secondary>temporary system</secondary>
16 </indexterm>
17
[dabbced]18 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
[ffbc9152]19 href="../../final-system/common/vim.xml"
20 xpointer="xpointer(//*[@role='package'])"/>
21
22 <sect2 role="installation">
23 <title>Installation of VIM</title>
24
[227ae5a]25 <para os="a">We will cross-compile Vim so that we can have a text editor in
26 <filename class="directory">/tools</filename>. Vim is not technically
27 necessary in the temporary system, in that it is not there to satisfy any
28 package dependencies in the final system, but we believe that a text editor
29 is an extremely useful tool to have there.<!-- If you prefer a different
30 editor, you may check the hints project at <ulink url="&hints-root;" />
[80c037c]31 for information on cross-compiling other text editors. (placeholder -
[227ae5a]32 uncomment this sentence if/when such information actually exists)--></para>
33
[dabbced]34 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
[ffbc9152]35 href="../../final-system/common/vim.xml"
36 xpointer="xpointer(//*[@os='p1'])"/>
37
[dabbced]38 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
[ffbc9152]39 href="../../final-system/common/vim.xml"
40 xpointer="xpointer(//*[@os='p2'])"/>
41
[878afd8]42 <para os="c1">The <command>configure</command> script is full of logic
[58598c1]43 that aborts at the first sign of cross compiling. Work around this by
44 setting the cached values of several tests with the following
45 command:</para>
[ffbc9152]46
47<screen os="c2"><userinput>cat &gt; src/auto/config.cache &lt;&lt; "EOF"
48vim_cv_getcwd_broken=no
49vim_cv_memmove_handles_overlap=yes
50vim_cv_stat_ignores_slash=no
51vim_cv_terminfo=yes
52vim_cv_toupper_broken=no
53vim_cv_tty_group=world
[714950f]54vim_cv_tgent=zero
[ffbc9152]55EOF</userinput></screen>
56
[878afd8]57 <para os="b">Change the default location of
58 the <filename>vimrc</filename> configuration file to <filename
59 class="directory">/tools/etc</filename>:</para>
[ffbc9152]60
61<screen os="c"><userinput>echo '#define SYS_VIMRC_FILE "/tools/etc/vimrc"' &gt;&gt; src/feature.h</userinput></screen>
62
[dabbced]63 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
[ffbc9152]64 href="../../final-system/common/vim.xml"
65 xpointer="xpointer(//*[@os='d'])"/>
66
[b27081c4]67<screen os="e"><userinput>./configure \
68 --build=${CLFS_HOST} \
69 --host=${CLFS_TARGET} \
70 --prefix=/tools \
71 --enable-gui=no \
72 --disable-gtktest \
73 --disable-xim \
74 --disable-gpm \
75 --without-x \
76 --disable-netbeans \
77 --with-tlib=ncurses</userinput></screen>
[ffbc9152]78
[05efce1]79 <variablelist os="f">
80 <title>The meaning of the new configure options:</title>
81
[d0ebf86]82 <varlistentry>
[e96dda3]83 <term><parameter>--enable-gui=no --disable-gtktest --disable-xim --disable-gpm --without-x --disable-netbeans</parameter></term>
[d0ebf86]84 <listitem>
85 <para>These options prevent Vim from trying to link to libraries
86 that might be on the host but won't exist inside the temporary
87 build environment.</para>
88 </listitem>
89 </varlistentry>
90
[852824db]91 <varlistentry>
92 <term><parameter>--with-tlib=ncurses</parameter></term>
93 <listitem>
94 <para>Tells Vim to use Ncurses as its terminal library.</para>
95 </listitem>
96 </varlistentry>
97
[05efce1]98 </variablelist>
99
[dabbced]100 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
[ffbc9152]101 href="../../final-system/common/vim.xml"
102 xpointer="xpointer(//*[@os='g'])"/>
103
[dabbced]104 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
[ffbc9152]105 href="../../final-system/common/vim.xml"
106 xpointer="xpointer(//*[@os='h'])"/>
107
[dabbced]108 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
[ffbc9152]109 href="../../final-system/common/vim.xml"
110 xpointer="xpointer(//*[@os='j'])"/>
111
[8b80c22]112 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
113 href="../../final-system/common/vim.xml"
114 xpointer="xpointer(//*[@os='k'])"/>
[ffbc9152]115
[dabbced]116 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
[ffbc9152]117 href="../../final-system/common/vim.xml"
[750bc5d]118 xpointer="xpointer(//*[@os='l'])"/>
[ffbc9152]119
[750bc5d]120<screen os="m"><userinput>ln -sv vim /tools/bin/vi</userinput></screen>
[ffbc9152]121
[6cb444f]122 <para os="tv1">Create a temporary vimrc to make it function more the way you may
[0f90f2f]123 expect it to. This is explained more in the final system:</para>
124
125<screen os="tv2"><userinput>cat &gt; /tools/etc/vimrc &lt;&lt; "EOF"
[320c461]126<literal>" Begin /tools/etc/vimrc
[0f90f2f]127
128set nocompatible
129set backspace=2
130set ruler
131syntax on
132
[320c461]133" End /tools/etc/vimrc</literal>
[0f90f2f]134EOF</userinput></screen>
135
[ffbc9152]136 </sect2>
137
138 <sect2 role="content">
139 <title/>
140
141 <para>Details on this package are located in <xref
142 linkend="contents-vim" role="."/></para>
143
144 </sect2>
145
146</sect1>
Note: See TracBrowser for help on using the repository browser.