Skip to content

junkblocker/patchreview-vim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

90 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

patchreview.vim

The Patch Review plugin allows easy single or multipatch code or diff reviews.

It opens each affected (modified/added/deleted) file in the patch or in a version controlled workspace diff in a diff view in a separate tab.

VIM provides the :diffpatch command to do single file reviews but can not handle patch files containing multiple patches as is common with software development projects. This plugin provides that missing functionality.

It also does not pollute the workspace like :diffpatch does by writing files in the workspace.

It does automatic diff generation for various version control systems by running their respective diff commands.

(Keywords: codereview, codereviews, code review, patch, patchutils, diff, diffpatch, patchreview, patchreviews, patch review, vcs, scm, mercurial, bazaar, hg, bzr, cvs, monotone, mtn, git, perforce, fossil)

  1. Vim 7.0 or higher built with +diff option.

  2. A gnu compatible patch command installed. This is the standard patch command on any Linux, Mac OS X, *BSD, Cygwin or /usr/bin/gpatch on newer Solaris/OpenSolairs.

    For Windows, UnxUtils ( http://unxutils.sourceforge.net/ ) provides a compatible patch implementation. However, you might need to set:

    let g:patchreview_patch_needs_crlf = 1

    in your .vimrc file.

Use your favorite vim package manager to install from the github repository for the project. Examples:

" With vim-plug
Plug 'junkblocker/patchreview-vim'

" With NeoBundle
NeoBundle 'junkblocker/patchreview-vim'

" With dein.vim
call dein#add('junkblocker/patchreview-vim')

" With Vundle
Bundle 'junkblocker/patchreview-vim'
% cd ~/.vim/bundle
% git clone https://github.com/junkblocker/patchreview-vim
  1. Extract the zip from http://www.vim.org/scripts/script.php?script_id=1563 in your $HOME/.vim or $VIM/vimfiles directory and restart vim. The directory location relevant to your platform can be seen by running:

    :help add-global-plugin

    in vim.

    Alternatively, if installing from extracted form, copy the directories by hand:

    % cp -r autoload doc plugin $HOME/.vim/
  2. Generate help tags to use help

    :helptags $HOME/.vim/doc

    or, for example on Windows if you installed under $VIM/vimfiles:

    :helptags $VIM/vimfiles/doc

    etc.

  • Reviewing current changes in your workspace:

    :DiffReview
  • Reviewing staged git changes:

    :DiffReview git staged --no-color -U5
  • Reviewing a patch:

    :PatchReview some.patch
  • Reviewing a previously applied patch (AKA reverse patch review):

    :ReversePatchReview some.patch
  • See

    :h patchreview

    for usage details.

The plugin can not handle diffs/patches which change the line ending types between DOS, UNIX and Mac etc. This is a general patching problem and is not specific to this plugin.

Fork this project at https://github.com/junkblocker/patchreview-vim