| Bram Moolenaar | 76b92b2 | 2006-03-24 22:46:53 +0000 | [diff] [blame] | 1 | *vimball.txt* For Vim version 7.0b. Last change: 2006 Mar 24 |
| 2 | |
| 3 | Vimball Archiver |
| 4 | |
| Bram Moolenaar | b3656ed | 2006-03-20 21:59:49 +0000 | [diff] [blame] | 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 |