Mercurial > vim
annotate runtime/doc/pi_zip.txt @ 19523:a7a24d06d7ce
Update runtime files.
Commit: https://github.com/vim/vim/commit/bc93cebb692f47488d66f078d1728031e9be35e7
Author: Bram Moolenaar <Bram@vim.org>
Date: Wed Feb 26 13:36:21 2020 +0100
Update runtime files.
author | Bram Moolenaar <Bram@vim.org> |
---|---|
date | Wed, 26 Feb 2020 13:45:05 +0100 |
parents | 9b7f90e56753 |
children | 5b7ea82bc18f |
rev | line source |
---|---|
19099 | 1 *pi_zip.txt* For Vim version 8.2. Last change: 2020 Jan 07 |
799 | 2 |
819 | 3 +====================+ |
4 | Zip File Interface | | |
5 +====================+ | |
567 | 6 |
19099 | 7 Author: Charles E. Campbell <NcampObell@SdrPchip.AorgM-NOSPAM> |
567 | 8 (remove NOSPAM from Campbell's email first) |
10211
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
9 Copyright: Copyright (C) 2005-2015 Charles E Campbell *zip-copyright* |
3281 | 10 The VIM LICENSE (see |copyright|) applies to the files in this |
11 package, including zipPlugin.vim, zip.vim, and pi_zip.vim. except use | |
12 "zip.vim" instead of "VIM". Like anything else that's free, zip.vim | |
13 and its associated files are provided *as is* and comes with no | |
14 warranty of any kind, either expressed or implied. No guarantees of | |
15 merchantability. No guarantees of suitability for any purpose. By | |
16 using this plugin, you agree that in no event will the copyright | |
17 holder be liable for any damages resulting from the use of this | |
18 software. Use at your own risk! | |
567 | 19 |
20 ============================================================================== | |
2908 | 21 1. Contents *zip* *zip-contents* |
1201 | 22 1. Contents................................................|zip-contents| |
23 2. Usage...................................................|zip-usage| | |
24 3. Additional Extensions...................................|zip-extension| | |
25 4. History.................................................|zip-history| | |
567 | 26 |
27 ============================================================================== | |
2908 | 28 2. Usage *zip-usage* *zip-manual* |
567 | 29 |
30 When one edits a *.zip file, this plugin will handle displaying a | |
31 contents page. Select a file to edit by moving the cursor atop | |
32 the desired file, then hit the <return> key. After editing, one may | |
33 also write to the file. Currently, one may not make a new file in | |
34 zip archives via the plugin. | |
35 | |
19099 | 36 COMMANDS~ |
10211
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
37 *zip-x* |
19099 | 38 x : extract a listed file when the cursor is atop it |
10211
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
39 |
19099 | 40 OPTIONS~ |
1620 | 41 |
42 *g:zip_nomax* | |
43 | |
44 If this variable exists and is true, the file window will not be | |
45 automatically maximized when opened. | |
46 | |
47 *g:zip_shq* | |
1201 | 48 Different operating systems may use one or more shells to execute |
49 commands. Zip will try to guess the correct quoting mechanism to | |
50 allow spaces and whatnot in filenames; however, if it is incorrectly | |
51 guessing the quote to use for your setup, you may use > | |
52 g:zip_shq | |
1121 | 53 < which by default is a single quote under Unix (') and a double quote |
54 under Windows ("). If you'd rather have no quotes, simply set | |
55 g:zip_shq to the empty string (let g:zip_shq= "") in your <.vimrc>. | |
56 | |
1201 | 57 *g:zip_unzipcmd* |
58 Use this option to specify the program which does the duty of "unzip". | |
1620 | 59 It's used during browsing. By default: > |
1201 | 60 let g:zip_unzipcmd= "unzip" |
61 < | |
62 *g:zip_zipcmd* | |
63 Use this option to specify the program which does the duty of "zip". | |
1620 | 64 It's used during the writing (updating) of a file already in a zip |
1201 | 65 file; by default: > |
66 let g:zip_zipcmd= "zip" | |
67 < | |
10211
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
68 *g:zip_extractcmd* |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
69 This option specifies the program (and any options needed) used to |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
70 extract a file from a zip archive. By default, > |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
71 let g:zip_extractcmd= g:zip_unzipcmd |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
72 < |
2152 | 73 PREVENTING LOADING~ |
74 | |
75 If for some reason you do not wish to use vim to examine zipped files, | |
76 you may put the following two variables into your <.vimrc> to prevent | |
2581 | 77 the zip plugin from loading: > |
2152 | 78 |
79 let g:loaded_zipPlugin= 1 | |
80 let g:loaded_zip = 1 | |
81 < | |
1201 | 82 |
567 | 83 ============================================================================== |
1201 | 84 3. Additional Extensions *zip-extension* |
85 | |
3281 | 86 Apparently there are a number of archivers which generate zip files that |
1201 | 87 don't use the .zip extension (.jar, .xpi, etc). To handle such files, |
88 place a line in your <.vimrc> file: > | |
89 | |
90 au BufReadCmd *.jar,*.xpi call zip#Browse(expand("<amatch>")) | |
91 < | |
1668 | 92 One can simply extend this line to accommodate additional extensions that |
1620 | 93 should be treated as zip files. |
1201 | 94 |
10211
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
95 Alternatively, one may change *g:zipPlugin_ext* in one's .vimrc. |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
96 Currently (11/30/15) it holds: > |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
97 |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
98 let g:zipPlugin_ext= '*.zip,*.jar,*.xpi,*.ja,*.war,*.ear,*.celzip, |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
99 \ *.oxt,*.kmz,*.wsz,*.xap,*.docx,*.docm,*.dotx,*.dotm,*.potx,*.potm, |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
100 \ *.ppsx,*.ppsm,*.pptx,*.pptm,*.ppam,*.sldx,*.thmx,*.xlam,*.xlsx,*.xlsm, |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
101 \ *.xlsb,*.xltx,*.xltm,*.xlam,*.crtx,*.vdw,*.glox,*.gcsx,*.gqsx,*.epub' |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
102 |
1201 | 103 ============================================================================== |
2908 | 104 4. History *zip-history* {{{1 |
19099 | 105 v29 Apr 02, 2017 * (Klartext) reported that an encrypted zip file could |
106 opened but the swapfile held unencrypted contents. | |
107 The solution is to edit the contents of a zip file | |
108 using the |:noswapfile| modifier. | |
10211
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
109 v28 Oct 08, 2014 * changed the sanity checks for executables to reflect |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
110 the command actually to be attempted in zip#Read() |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
111 and zip#Write() |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
112 * added the extraction of a file capability |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
113 Nov 30, 2015 * added *.epub to the |g:zipPlugin_ext| list |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
114 Sep 13, 2016 * added *.apk to the |g:zipPlugin_ext| list and |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
115 sorted the suffices. |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
116 v27 Jul 02, 2013 * sanity check: zipfile must have "PK" as its first |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
117 two bytes. |
b7da8d4c594c
commit https://github.com/vim/vim/commit/d07969093a9b3051511c478d71c36de6fc33c0d6
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
118 * modified to allow zipfile: entries in quickfix lists |
4339 | 119 v26 Nov 15, 2012 * (Jason Spiro) provided a lot of new extensions that |
120 are synonyms for .zip | |
3281 | 121 v25 Jun 27, 2011 * using keepj with unzip -Z |
122 (consistent with the -p variant) | |
4339 | 123 * (Ben Staniford) now uses |
124 has("win32unix") && executable("cygpath") | |
125 before converting to cygwin-style paths | |
2908 | 126 v24 Jun 21, 2010 * (Cédric Bosdonnat) unzip seems to need its filenames |
127 fnameescape'd as well as shellquote'd | |
128 * (Motoya Kurotsu) inserted keepj before 0d to protect | |
129 jump list | |
1620 | 130 v17 May 09, 2008 * arno caught a security bug |
131 v15 Sep 07, 2007 * &shq now used if not the empty string for g:zip_shq | |
1201 | 132 v14 May 07, 2007 * using b:zipfile instead of w:zipfile to avoid problem |
133 when editing alternate file to bring up a zipfile | |
1121 | 134 v10 May 02, 2006 * now using "redraw then echo" to show messages, instead |
135 of "echo and prompt user" | |
136 * g:zip_shq provided to allow for quoting control for the | |
137 command being passed via :r! ... commands. | |
826 | 138 v8 Apr 10, 2006 * Bram Moolenaar reported that he received an error message |
1121 | 139 due to "Pattern not found: ^.*\%0c"; this was caused by |
826 | 140 stridx finding a Name... at the beginning of the line; |
141 zip.vim tried 4,$s/^.*\%0c//, but that doesn't work. | |
142 Fixed. | |
797 | 143 v7 Mar 22, 2006 * escaped some characters that can cause filename handling |
1121 | 144 problems. |
622 | 145 v6 Dec 21, 2005 * writing to files not in directories caused problems - |
1121 | 146 fixed (pointed out by Christian Robinson) |
567 | 147 v5 Nov 22, 2005 * report option workaround installed |
148 v3 Oct 18, 2005 * <amatch> used instead of <afile> in autocmds | |
149 v2 Sep 16, 2005 * silenced some commands (avoiding hit-enter prompt) | |
1121 | 150 * began testing under Windows; works thus far |
567 | 151 * filetype detection fixed |
152 Nov 03, 2005 * handles writing zipfiles across a network using | |
1121 | 153 netrw#NetWrite() |
567 | 154 v1 Sep 15, 2005 * Initial release, had browsing, reading, and writing |
155 | |
156 ============================================================================== | |
19116 | 157 vim:tw=78:ts=8:noet:ft=help:fdm=marker |