|
2152
|
1 *pi_zip.txt* For Vim version 7.2. Last change: 2010 Apr 12
|
|
799
|
2
|
|
819
|
3 +====================+
|
|
|
4 | Zip File Interface |
|
|
|
5 +====================+
|
|
567
|
6
|
|
|
7 Author: Charles E. Campbell, Jr. <NdrOchip@ScampbellPfamily.AbizM>
|
|
|
8 (remove NOSPAM from Campbell's email first)
|
|
2152
|
9 Copyright: Copyright (C) 2005-2009 Charles E Campbell, Jr *zip-copyright*
|
|
1121
|
10 Permission is hereby granted to use and distribute this code,
|
|
819
|
11 with or without modifications, provided that this copyright
|
|
|
12 notice is copied with it. Like anything else that's free,
|
|
|
13 zip.vim, zipPlugin.vim, and pi_zip.txt are provided *as is*
|
|
|
14 and it comes with no warranty of any kind, either expressed or
|
|
|
15 implied. By using this plugin, you agree that in no event will
|
|
|
16 the copyright holder be liable for any damages resulting from
|
|
|
17 the use of this software.
|
|
567
|
18
|
|
|
19 ==============================================================================
|
|
|
20 1. Contents *zip* *zip-contents*
|
|
1201
|
21 1. Contents................................................|zip-contents|
|
|
|
22 2. Usage...................................................|zip-usage|
|
|
|
23 3. Additional Extensions...................................|zip-extension|
|
|
|
24 4. History.................................................|zip-history|
|
|
567
|
25
|
|
|
26 ==============================================================================
|
|
|
27 2. Usage *zip-usage* *zip-manual*
|
|
|
28
|
|
|
29 When one edits a *.zip file, this plugin will handle displaying a
|
|
|
30 contents page. Select a file to edit by moving the cursor atop
|
|
|
31 the desired file, then hit the <return> key. After editing, one may
|
|
|
32 also write to the file. Currently, one may not make a new file in
|
|
|
33 zip archives via the plugin.
|
|
|
34
|
|
1201
|
35 OPTIONS
|
|
1620
|
36
|
|
|
37 *g:zip_nomax*
|
|
|
38
|
|
|
39 If this variable exists and is true, the file window will not be
|
|
|
40 automatically maximized when opened.
|
|
|
41
|
|
|
42 *g:zip_shq*
|
|
1201
|
43 Different operating systems may use one or more shells to execute
|
|
|
44 commands. Zip will try to guess the correct quoting mechanism to
|
|
|
45 allow spaces and whatnot in filenames; however, if it is incorrectly
|
|
|
46 guessing the quote to use for your setup, you may use >
|
|
|
47 g:zip_shq
|
|
1121
|
48 < which by default is a single quote under Unix (') and a double quote
|
|
|
49 under Windows ("). If you'd rather have no quotes, simply set
|
|
|
50 g:zip_shq to the empty string (let g:zip_shq= "") in your <.vimrc>.
|
|
|
51
|
|
1201
|
52 *g:zip_unzipcmd*
|
|
|
53 Use this option to specify the program which does the duty of "unzip".
|
|
1620
|
54 It's used during browsing. By default: >
|
|
1201
|
55 let g:zip_unzipcmd= "unzip"
|
|
|
56 <
|
|
|
57 *g:zip_zipcmd*
|
|
|
58 Use this option to specify the program which does the duty of "zip".
|
|
1620
|
59 It's used during the writing (updating) of a file already in a zip
|
|
1201
|
60 file; by default: >
|
|
|
61 let g:zip_zipcmd= "zip"
|
|
|
62 <
|
|
2152
|
63 PREVENTING LOADING~
|
|
|
64
|
|
|
65 If for some reason you do not wish to use vim to examine zipped files,
|
|
|
66 you may put the following two variables into your <.vimrc> to prevent
|
|
|
67 the tar plugin from loading: >
|
|
|
68
|
|
|
69 let g:loaded_zipPlugin= 1
|
|
|
70 let g:loaded_zip = 1
|
|
|
71 <
|
|
|
72 <
|
|
1201
|
73
|
|
567
|
74 ==============================================================================
|
|
1201
|
75 3. Additional Extensions *zip-extension*
|
|
|
76
|
|
|
77 Apparently there are a number of archivers who generate zip files that
|
|
|
78 don't use the .zip extension (.jar, .xpi, etc). To handle such files,
|
|
|
79 place a line in your <.vimrc> file: >
|
|
|
80
|
|
|
81 au BufReadCmd *.jar,*.xpi call zip#Browse(expand("<amatch>"))
|
|
|
82 <
|
|
1668
|
83 One can simply extend this line to accommodate additional extensions that
|
|
1620
|
84 should be treated as zip files.
|
|
1201
|
85
|
|
|
86 ==============================================================================
|
|
|
87 4. History *zip-history* {{{1
|
|
1620
|
88 v17 May 09, 2008 * arno caught a security bug
|
|
|
89 v15 Sep 07, 2007 * &shq now used if not the empty string for g:zip_shq
|
|
1201
|
90 v14 May 07, 2007 * using b:zipfile instead of w:zipfile to avoid problem
|
|
|
91 when editing alternate file to bring up a zipfile
|
|
1121
|
92 v10 May 02, 2006 * now using "redraw then echo" to show messages, instead
|
|
|
93 of "echo and prompt user"
|
|
|
94 * g:zip_shq provided to allow for quoting control for the
|
|
|
95 command being passed via :r! ... commands.
|
|
826
|
96 v8 Apr 10, 2006 * Bram Moolenaar reported that he received an error message
|
|
1121
|
97 due to "Pattern not found: ^.*\%0c"; this was caused by
|
|
826
|
98 stridx finding a Name... at the beginning of the line;
|
|
|
99 zip.vim tried 4,$s/^.*\%0c//, but that doesn't work.
|
|
|
100 Fixed.
|
|
797
|
101 v7 Mar 22, 2006 * escaped some characters that can cause filename handling
|
|
1121
|
102 problems.
|
|
622
|
103 v6 Dec 21, 2005 * writing to files not in directories caused problems -
|
|
1121
|
104 fixed (pointed out by Christian Robinson)
|
|
567
|
105 v5 Nov 22, 2005 * report option workaround installed
|
|
|
106 v3 Oct 18, 2005 * <amatch> used instead of <afile> in autocmds
|
|
|
107 v2 Sep 16, 2005 * silenced some commands (avoiding hit-enter prompt)
|
|
1121
|
108 * began testing under Windows; works thus far
|
|
567
|
109 * filetype detection fixed
|
|
|
110 Nov 03, 2005 * handles writing zipfiles across a network using
|
|
1121
|
111 netrw#NetWrite()
|
|
567
|
112 v1 Sep 15, 2005 * Initial release, had browsing, reading, and writing
|
|
|
113
|
|
|
114 ==============================================================================
|
|
1201
|
115 vim:tw=78:ts=8:ft=help:fdm=marker
|
