blob: 51c96ccb50232f85fdf7add1230c43f0e2ebb537 [file] [log] [blame]
Bram Moolenaar9964e462007-05-05 17:54:07 +00001*pi_tar.txt* For Vim version 7.1a. Last change: 2006 Sep 29
Bram Moolenaarc01140a2006-03-24 22:21:52 +00002
Bram Moolenaar9964e462007-05-05 17:54:07 +00003 +====================+
4 | Tar File Interface |
5 +====================+
Bram Moolenaar98358622005-11-28 22:58:23 +00006
7Author: Charles E. Campbell, Jr. <NdrOchip@ScampbellPfamily.AbizM>
8 (remove NOSPAM from Campbell's email first)
9Copyright: The GPL (gnu public license) applies to *tar-copyright*
Bram Moolenaar86e01082005-12-29 22:45:34 +000010 tarPlugin.vim, and pi_tar.txt.
Bram Moolenaar98358622005-11-28 22:58:23 +000011 No warranty, express or implied. Use At-Your-Own-Risk.
12
13==============================================================================
141. Contents *tar* *tar-contents*
15 1. Contents..................................................|tar-contents|
16 2. Usage.....................................................|tar-usage|
Bram Moolenaar910f66f2006-04-05 20:41:53 +000017 3. Options...................................................|tar-options|
18 4. History...................................................|tar-history|
Bram Moolenaar98358622005-11-28 22:58:23 +000019
20==============================================================================
212. Usage *tar-usage* *tar-manual*
22
23 When one edits a *.tar file, this plugin will handle displaying a
24 contents page. Select a file to edit by moving the cursor atop
25 the desired file, then hit the <return> key. After editing, one may
26 also write to the file. Currently, one may not make a new file in
27 tar archives via the plugin.
28
29==============================================================================
Bram Moolenaar910f66f2006-04-05 20:41:53 +0000303. Options *tar-options*
31
32 These options are variables that one may change, typically in one's
33 <.vimrc> file.
Bram Moolenaar9964e462007-05-05 17:54:07 +000034 Default
35 Variable Value Explanation
Bram Moolenaar910f66f2006-04-05 20:41:53 +000036 *g:tar_browseoptions* "Ptf" used to get a list of contents
Bram Moolenaar9964e462007-05-05 17:54:07 +000037 *g:tar_readoptions* "OPxf" used to extract a file from a tarball
38 *g:tar_cmd* "tar" the name of the tar program
39 *g:tar_writeoptions* "uf" used to update/replace a file
Bram Moolenaar910f66f2006-04-05 20:41:53 +000040
41
42==============================================================================
434. History *tar-history*
44
Bram Moolenaar9964e462007-05-05 17:54:07 +000045 v10 May 02, 2006 * now using "redraw then echo" to show messages, instead
46 of "echo and prompt user"
Bram Moolenaard68071d2006-05-02 22:08:30 +000047 v9 May 02, 2006 * improved detection of masquerading as tar file
48 v8 May 02, 2006 * allows editing of files that merely masquerade as tar
Bram Moolenaar9964e462007-05-05 17:54:07 +000049 files
Bram Moolenaar910f66f2006-04-05 20:41:53 +000050 v7 Mar 22, 2006 * work on making tar plugin work across network
51 Mar 27, 2006 * g:tar_cmd now available for users to change the name
Bram Moolenaar9964e462007-05-05 17:54:07 +000052 of the tar program to be used. By default, of course,
Bram Moolenaar910f66f2006-04-05 20:41:53 +000053 its "tar".
Bram Moolenaar86e01082005-12-29 22:45:34 +000054 v6 Dec 21, 2005 * writing to files not in directories caused problems -
Bram Moolenaar9964e462007-05-05 17:54:07 +000055 fixed (pointed out by Christian Robinson)
Bram Moolenaar98358622005-11-28 22:58:23 +000056 v5 Nov 22, 2005 * report option workaround installed
57 v3 Sep 16, 2005 * handles writing files in an archive back to the
Bram Moolenaar9964e462007-05-05 17:54:07 +000058 archive
Bram Moolenaar98358622005-11-28 22:58:23 +000059 Oct 18, 2005 * <amatch> used instead of <afile> in autocmds
60 Oct 18, 2005 * handles writing to compressed archives
61 Nov 03, 2005 * handles writing tarfiles across a network using
Bram Moolenaar9964e462007-05-05 17:54:07 +000062 netrw#NetWrite()
63 v2 * converted to use Vim7's new autoload feature by
64 Bram Moolenaar
Bram Moolenaar98358622005-11-28 22:58:23 +000065 v1 (original) * Michael Toren (see http://michael.toren.net/code/)
66
67==============================================================================
68vim:tw=78:ts=8:ft=help