summaryrefslogtreecommitdiff
path: root/htdocs/arch.php
blob: c877b944abc4faafef3df97957e6be1095bf641b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
<?php
require_once("include/init.inc");
$page_title = "Vim from Arch";

include("header.php");
?>
<h1>The Vim Arch tutorial</h1>

<p>
These are the simple instructions how to obtain the Vim files through Arch.
Use this when you have a reasonably fast internet connection and want to
compile Vim yourself.
It should work well on any system that supports Arch.
</p>

<p>
Below is a <i>very</i> brief tutorial on using GNU Arch to check out versions
of the Vim archive.  Please refer to the Arch tutorial for more
information on doing other things with arch.  It is quite powerful, for
example individual developers can create personal branches off of my
archive, without even telling me.
</p>

<p id='update_freq'>
	<strong>Note:</strong> The Arch repository is updated
	regularly, but not immediately.  Vim's Arch repository may be a
	few days behind the head of development (about the same as the CVS
	repository).  For information on patching Vim with the most up-to-date
	patches, consult the
	<a href='/download.php#patches'>information on patches</a>
</p>

<p>
An alternative is using CVS.  More about that on the
<a href="cvs.php">CVS page</a>.
</p>

<br>

<h1>Obtaining Vim through Arch</h1>

<OL>
<LI>
First, get GNU arch.  <a href="http://regexps.srparish.net/www/">http://regexps.srparish.net/www/</a> is the main
  webpage.  You want version 1.1 (or newer), the source is
  <a href="http://regexps.srparish.net/src/tla/tla-1.1.tar.gz">
  http://regexps.srparish.net/src/tla/tla-1.1.tar.gz</a>.  If you are
  running Debian, the 'tla' package in testing or unstable has this
  version.
  <p>
</LI>

<LI>
You should set your personal identifier.  I'm not sure this is actually needed,
if you don't modify anything.
<pre>
    tla my-id 'My Full Name &lt;mfn@host.com&gt;'
</pre>
Arch is a bit picky about the format.  It wants it to look like a
valid full email address.
  <p>
</LI>

<LI>
Tell arch about the Vim archive.
<pre>
    tla register-archive http://vim-arch.davidb.org/arch/vim-2003
</pre>
  <p>
</LI>

<LI>
Extract the latest version of Vim.
<pre>
    cd ~/work    # or wherever you want it.
    tla get vim@davidb.org--vim-2003/vim--bram--6.2 vim62
</pre>
The last component is the name of the directory.  If you leave it off,
arch will choose a long version of the version you are checking out
(vim--bram--6.2--versionfix-191 for example).
  <p>
</LI>

<LI>
You should now have the latest version of Vim.  From within the
directory you can do some useful stuff.
<pre>
    tla changelog | less    # Show change history.
    tla missing             # Show changes in archive not
                            #   applied locally.
    tla update              # Update current to latest in archive.
    tla changes             # Show what's changed in local dir.
    tla changes --diffs     #   and generate diffs.

    tla help                # Show all of arch's commands.
    tla update --help       # Show help for specific command.
</pre>
</LI>

</OL>

<p>
If you have remarks on this page, please contact David Brown (vim at davidb dot org).
</p>

<?php
include("footer.php");
?>