*pi_tar.txt*	For Vim version 7.3. 最近更新: 2010年8月

       	       	       +====================+
       	       	       |    Tar 文件接口    |
       	       	       +====================+
				译者: Willis
				http://vimcdoc.sf.net

Author:  Charles E. Campbell, Jr.  <NdrOchip@ScampbellPfamily.AbizM>
	  (remove NOSPAM from Campbell's email first)
Copyright 2005-2010: The GPL (gnu public license) applies to	*tar-copyright*
	   tar.vim, tarPlugin.vim, and pi_tar.txt.
	   No warranty, express or implied.  Use At-Your-Own-Risk.

==============================================================================
1. 内容						*tar* *tar-contents*
   1. 内容......................................................|tar-contents|
   2. 用法......................................................|tar-usage|
   3. 选项......................................................|tar-options|
   4. 历史......................................................|tar-history|

==============================================================================
2. 用法						*tar-usage* *tar-manual*

   编辑 *.tar 文件时，此插件进行处理，显示内容页面。移动光标到文件上，然后按
   <return> 键，就可以选择该文件进行编辑。编辑后，可以写回该文件。目前，不能用
   该插件建立新的 tar 归档文件。

						*:Vimuntar*
   VIMUNTAR~

   :Vimuntar [vimhome]

	本命令，如有需要，把 tar 包文件复制到以下目录中的 .vim 或 vimfiles 目
	录: 若 [vimhome] 未指定， 'runtimepath' 的第一个可写目录。不然，
	[vimhome] 参数允许用户自定义该目录。

	复制动作使用 *g:tar_copycmd*  定义的命令，即 >
		cp   用于 cygwin、unix、macunix
		copy 用于 windows (32、95、64、16)
<	提取动作使用 *g:tar_extractcmd* 定义的命令，缺省是 >
		"tar -xf"
<
   禁 止 载 入~

   如果由于某种原因你不想 vim 检查 tar 文件，在 <.vimrc> 中定义两个变量就可以
   不载入 tar 插件: >

	let g:loaded_tarPlugin= 1
	let g:loaded_tar      = 1
<

==============================================================================
3. 选项							*tar-options*

   以下是用户可以改变的变量，通常在 <.vimrc> 文件里设置。
    变量                  缺省值  解释 ~
   *g:tar_browseoptions*  "Ptf"   用于得到内容列表
   *g:tar_readoptions*    "OPxf"  用于从 tar 包里提取文件
   *g:tar_cmd*            "tar"   tar 程序名
   *g:tar_nomax*            0     如果为真，不最大化文件窗口
   *g:tar_secure*         未定义  如果存在:
					使用 "--" 来避免 tar 命令行上不想要的
					选项扩展。
					请确定你用的 tar 命令接受 "--"；Posix
					兼容的 tar 工具都接受。
				  如果不存在:
					tar 插件拒绝接受任何 "-" 开头的 tar 文
					件或成员文件。
				  不是所有的 tar 都支持 "--"，所以这不是缺省行
				  为。
   *g:tar_writeoptions*	  "uf"	  用于更新/替换文件


==============================================================================
4. 历史 (英文)						*tar-history*

   v26 Aug 09, 2010 * uses buffer-local instead of window variables to hold
		      tarfile name
   v25 Jun 19, 2010 * (Jan Steffens) added support for xz compression
   v24 Apr 07, 2009 * :Untarvim command implemented
       Sep 28, 2009 * Added lzma support
   v22 Aug 08, 2008 * security fixes
   v16 Jun 06, 2008 * tarfile:: used instead of tarfile: when editing files
		      inside tarballs.  Fixes a problem with tarballs called
		      things like c:\abc.tar. (tnx to Bill McCarthy)
   v14 May 09, 2008 * arno caught a security bug
       May 28, 2008 * various security improvements.  Now requires patch 299
                      which provides the fnameescape() function
       May 30, 2008 * allows one to view *.gz and *.bz2 files that are in
                      *.tar files.
   v12 Sep 07, 2007 * &shq now used if not the empty string for g:tar_shq
   v10 May 02, 2006 * now using "redraw then echo" to show messages, instead
                      of "echo and prompt user"
   v9 May 02, 2006 * improved detection of masquerading as tar file
   v8 May 02, 2006 * allows editing of files that merely masquerade as tar
                     files
   v7 Mar 22, 2006 * work on making tar plugin work across network
      Mar 27, 2006 * g:tar_cmd now available for users to change the name
                     of the tar program to be used.  By default, of course,
                     it's "tar".
   v6 Dec 21, 2005 * writing to files not in directories caused problems -
                     fixed (pointed out by Christian Robinson)
   v5 Nov 22, 2005 * report option workaround installed
   v3 Sep 16, 2005 * handles writing files in an archive back to the
                     archive
      Oct 18, 2005 * <amatch> used instead of <afile> in autocmds
      Oct 18, 2005 * handles writing to compressed archives
      Nov 03, 2005 * handles writing tarfiles across a network using
                     netrw#NetWrite()
   v2              * converted to use Vim7's new autoload feature by
                     Bram Moolenaar
   v1 (original)   * Michael Toren (see http://michael.toren.net/code/)

==============================================================================
vim:tw=78:ts=8:ft=help
