|
800
|
1 *vimball.txt* For Vim version 7.0b. Last change: 2006 Mar 24
|
|
|
2
|
|
|
3 Vimball Archiver
|
|
|
4
|
|
791
|
5 Author: Charles E. Campbell, Jr. <NdrOchip@ScampbellPfamily.AbizM>
|
|
|
6 (remove NOSPAM from Campbell's email first)
|
|
|
7 Copyright: (c) 2004-2006 by Charles E. Campbell, Jr. *Vimball-copyright*
|
|
|
8 The VIM LICENSE applies to Vimball.vim, and Vimball.txt
|
|
|
9 (see |copyright|) except use "Vimball" instead of "Vim".
|
|
|
10 No warranty, express or implied.
|
|
|
11 Use At-Your-Own-Risk!
|
|
|
12
|
|
|
13 ==============================================================================
|
|
|
14 1. Contents *vimball* *vimball-contents*
|
|
|
15
|
|
|
16 1. Contents......................................: |vimball-contents|
|
|
|
17 2. Vimball Manual................................: |vimball-manual|
|
|
|
18 3. Vimball History...............................: |vimball-history|
|
|
|
19
|
|
|
20
|
|
|
21 ==============================================================================
|
|
|
22 2. Vimball Manual *vimball-manual*
|
|
|
23
|
|
|
24 *:MkVimball*
|
|
|
25 :[range]MkVimball[!] filename
|
|
|
26
|
|
|
27 This command takes lines holding a path to files to be included in
|
|
|
28 your vimball; as an example: >
|
|
|
29 plugin/something.vim
|
|
|
30 doc/something.txt
|
|
|
31 < using MkVimball on this range will create a file called
|
|
|
32 "filename.vba" which can be used by Vimball.vim to re-create these
|
|
|
33 files. If the "filename.vba" file already exists, then MkVimball
|
|
|
34 will issue a warning and not create the file.
|
|
|
35
|
|
|
36 However, if you use the exclamation point (!), then MkVimball will
|
|
|
37 create the "filename.vba" file, overwriting it if it already exists.
|
|
|
38 This behavior resembles that for |:w|.
|
|
|
39
|
|
|
40 *vimball-extract*
|
|
|
41 vim filename.vba
|
|
|
42
|
|
|
43 Simply editing a Vimball will cause Vimball.vim to tell the user to
|
|
|
44 source the file to extract its contents.
|
|
|
45
|
|
|
46 Extraction will only proceed if the first line of a putative vimball
|
|
|
47 file holds the "Vimball Archiver by Charles E. Campbell, Jr., Ph.D."
|
|
|
48 line.
|
|
|
49
|
|
|
50 :VimballList *vimball-vimballlist*
|
|
|
51
|
|
|
52 This command will tell Vimball to list the files in the archive, along
|
|
|
53 with their lengths in lines.
|
|
|
54
|
|
|
55
|
|
|
56 ==============================================================================
|
|
|
57 3. Vimball History *vimball-history*
|
|
|
58
|
|
|
59 3 : Mar 20, 2006 * removed query, now requires sourcing to be
|
|
|
60 extracted (:so %). Message to that effect
|
|
|
61 included.
|
|
|
62 * :VimballList now shows files that would be
|
|
|
63 extracted.
|
|
|
64 2 : Mar 20, 2006 * query, :UseVimball included
|
|
|
65 1 : Mar 20, 2006 * initial release
|
|
|
66
|
|
|
67
|
|
|
68 ==============================================================================
|
|
|
69 vim:tw=78:ts=8:ft=help:fdm=marker
|
