Mercurial > vim
annotate runtime/doc/pi_zip.txt @ 2238:3d0a7beb0d75 vim73
Made reading/writing undo info a bit more robust.
| author | Bram Moolenaar <bram@vim.org> |
|---|---|
| date | Sun, 30 May 2010 20:40:11 +0200 |
| parents | 7c8c7c95a865 |
| children | 733f0dc510c3 12b829477c60 |
| rev | line source |
|---|---|
|
2154
7c8c7c95a865
First step in the Vim 7.3 branch. Changed version numbers.
Bram Moolenaar <bram@zimbu.org>
parents:
2152
diff
changeset
|
1 *pi_zip.txt* For Vim version 7.3a. 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 |