---

Ⅰ. 插件描述

Configurable standalone version of phpDocumentor for Vim

Ⅱ. 基本信息

创建日期：  2011-12-23 使用用户：  13 Github星：  11 插件作者：  Michael Härtl

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'mikehaertl/pdv-standalone'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'mikehaertl/pdv-standalone'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'mikehaertl/pdv-standalone'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/mikehaertl/pdv-standalone

Ⅳ. 文档说明

# PDV standalone

This is a standalone version of Tobias Schlitt's famous phpDocumentor for Vim plugin.

I was pretty happy with Tobias' original plugin (thanks Tobias!) but i had two issues
with it:

• You had to alter the code to configure the plugin
• Tobias integrated the latest version into his new VIP (VIM integration for PHP)

1. but i didn't need/want the rest in there

If you prefer Tobias' original repo, you find it at tobyS/vip.

Installation

You can just download the pdv-standalone.vim file and move it to your ~/.vim/plugin

1. But i'd rather recommend to use a plugin manager like gmarik/vundle.

Configuration

It's recommended to map some keys to PDV. Personally i prefer <C-K>:

nnoremap <C-K> :call PhpDocSingle()<CR>
vnoremap <C-K> :call PhpDocRange()<CR>

As some tags are turned off by default, you should then add default values
for them:

let g:pdv_cfg_Package = 'placeholder'
let g:pdv_cfg_Version = '1.0.0'
let g:pdv_cfg_Author = 'Your Name <your.name@example.com>'
let g:pdv_cfg_Copyright = 'Copyright 2011 by Your Name <your.name@example.com>'
let g:pdv_cfg_License = 'Provided under the GPL (http://www.gnu.org/copyleft/gpl.html)'

Here's the full list of configuration options:

Class level tags:

• g:pdv_cfg_Package: Value of @package tag. Defaults to "" which means off.
• g:pdv_cfg_Version: Value of @version tag. Defaults to "" which means off.
• g:pdv_cfg_Author: Value of @author tag. Defaults to "" which means off.
• g:pdv_cfg_Copyright: Value of @copyright tag. Defaults to "" which means off.
• g:pdv_cfg_License: Value of @license tag. Defaults to "" which means off.

Function tags:

• g:pdv_cfg_ReturnVal: Value of @return tag. Defaults to "void". Use "" to create no return tag.

Options:

• g:pdv_cfg_Type: Default type of attributes and parameters. Defaults to "mixed".
• g:pdv_cfg_Uses: Wether to create @uses tags. Defaults to 0 (off).
• g:pdv_cfg_paste: Wether to :set paste before documenting. Defaults to 1 (on).
• g:pdv_cfg_php4always: Wether PHP4 tags should be set, like @access. Defaults to 0 (off).
• g:pdv_cfg_php4guess: Wether to guess scopes from names ($_foo/_bar()). Defaults to 1 (on).
• g:pdv_cfg_php4guessval: Default scope for matches of g:pdv_cfg_php4guess. Defaults to "protected".

Docblock formatting

• g:pdv_cfg_CommentHead: Start of any comment block. Defaults to "/**"
• g:pdv_cfg_Comment1: Comment prefix of 1st line after start. Defaults to " * "
• g:pdv_cfg_Commentn: Comment prefix of remaining lines. Defaults to " * "
• g:pdv_cfg_CommentTail: End of any comment block. Defaults to " */"
• g:pdv_cfg_CommentSingle: Single line comment prefix. Defaults to "//"