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

clfs-3.0.0-systemdsystemd
Last change on this file since a15d1d7 was a15d1d7, checked in by Chris Staub <chris@…>, 10 years ago

Remove obsolete --enable-multibyte switch from Vim instructions

  • 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
[21f0998]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;" />
31    for information on cross-compiling other text editors. (placeholder -
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
54EOF</userinput></screen>
55
[878afd8]56    <para os="b">Change the default location of
57    the <filename>vimrc</filename> configuration file to <filename
58    class="directory">/tools/etc</filename>:</para>
[ffbc9152]59
60<screen os="c"><userinput>echo '#define SYS_VIMRC_FILE "/tools/etc/vimrc"' &gt;&gt; src/feature.h</userinput></screen>
61
[dabbced]62    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
[ffbc9152]63    href="../../final-system/common/vim.xml"
64    xpointer="xpointer(//*[@os='d'])"/>
65
[a15d1d7]66<screen os="e"><userinput>./configure --build=${CLFS_HOST} --host=${CLFS_TARGET} \
67    --prefix=/tools --enable-gui=no --disable-gtktest --disable-xim \
68    --disable-gpm --without-x --disable-netbeans --with-tlib=ncurses</userinput></screen>
[ffbc9152]69
[05efce1]70    <variablelist os="f">
71      <title>The meaning of the new configure options:</title>
72
[d0ebf86]73      <varlistentry>
[67e6980]74        <term><parameter>--enable-gui=no --disable-gtktest --disable-xim --disable-gpm --without-x --disable-netbeans</parameter></term>
[d0ebf86]75        <listitem>
76          <para>These options prevent Vim from trying to link to libraries
77          that might be on the host but won't exist inside the temporary
78          build environment.</para>
79        </listitem>
80      </varlistentry>
81
[852824db]82      <varlistentry>
83        <term><parameter>--with-tlib=ncurses</parameter></term>
84        <listitem>
85          <para>Tells Vim to use Ncurses as its terminal library.</para>
86        </listitem>
87      </varlistentry>
88
[05efce1]89    </variablelist>
90
[dabbced]91    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
[ffbc9152]92    href="../../final-system/common/vim.xml"
93    xpointer="xpointer(//*[@os='g'])"/>
94
[dabbced]95    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
[ffbc9152]96    href="../../final-system/common/vim.xml"
97    xpointer="xpointer(//*[@os='h'])"/>
98
[dabbced]99    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
[ffbc9152]100    href="../../final-system/common/vim.xml"
101    xpointer="xpointer(//*[@os='j'])"/>
102
[563e1e2]103    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
104    href="../../final-system/common/vim.xml"
105    xpointer="xpointer(//*[@os='k'])"/>
[ffbc9152]106
[dabbced]107    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
[ffbc9152]108    href="../../final-system/common/vim.xml"
[a63f1057]109    xpointer="xpointer(//*[@os='l'])"/>
[ffbc9152]110
[a63f1057]111<screen os="m"><userinput>ln -sv vim /tools/bin/vi</userinput></screen>
[ffbc9152]112
[e5ca899d]113    <para os="tv1">Create a temporary vimrc to make it function more the way you may
[0f90f2f]114    expect it to. This is explained more in the final system:</para>
115
116<screen os="tv2"><userinput>cat &gt; /tools/etc/vimrc &lt;&lt; "EOF"
[320c461]117<literal>" Begin /tools/etc/vimrc
[0f90f2f]118
119set nocompatible
120set backspace=2
121set ruler
122syntax on
123
[320c461]124" End /tools/etc/vimrc</literal>
[0f90f2f]125EOF</userinput></screen>
126
[ffbc9152]127  </sect2>
128
129  <sect2 role="content">
130    <title/>
131
132    <para>Details on this package are located in <xref
133    linkend="contents-vim" role="."/></para>
134
135  </sect2>
136
137</sect1>
Note: See TracBrowser for help on using the repository browser.