Skip to content
/ pdv Public
forked from tobyS/pdv

PHP Documentor for VIM - Generates PHP docblocks

Notifications You must be signed in to change notification settings

nagodon/pdv

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PDV - PHP Documentor for VIM - 2

This is version 2 of PDV - PHP Documentor for VIM, your tool of choice for generating PHP doc blocks. It is a complete rewrite of version 1, which contained code written back in 2005 and earlier. As a result, the code is now way more maintainable and you gain exciting new features:

  • Templating support through Vmustache
  • Integration with UltiSnips to complete your docs directly after generation

Try it out now.

Requirements

Vmustache is a required plugin for PDV to work

Install

You should install PDV through a VIM plugin manager of your choice. I recommend Vundle for that purpose, but others should work, too. With Vundle you need

Bundle 'tobyS/pdv'

in your .vimrc and then run :BundleInstall in a new VIM instance.

Before using PDV you must set the variable pdv_template_dir which points to your templates. After that, you should map one of the following functions to a key of your choice:

pdv#DocumentCurrentLine()
Generates the doc block as you know it from PDV 1, but using the templates from your template directory.
pdv#DocumentWithSnip()
This function requires UltiSnips as a prerequisite. If you have that installed, your templates will be used as snippets and you will be put into the first tab right after the doc block was generated.

My config for PDV looks like this:

let g:pdv_template_dir = $HOME ."/.vim/bundle/pdv/templates_snip"
nnoremap <buffer> <C-p> :call pdv#DocumentWithSnip()<CR>

There are examples for templates (both a non-snip and a snip version) shipped with PDV.

About

PHP Documentor for VIM - Generates PHP docblocks

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Vim Script 94.4%
  • PHP 5.3%
  • Shell 0.3%