llvm-project

History

Daniel Malea bb43721a35 Fixed continue issues with process attach/detach - added code for tracking transition from eStateAttaching to eStateStopped in event listener and handling process continuation there. Patch by Arthur Evstifeev! llvm-svn: 182806		2013-05-28 21:27:03 +00:00
..
doc	Improve vim-lldb expression commands for objective-c and implement evaluate-under-cursor:	2013-05-23 21:34:26 +00:00
plugin	Improve vim-lldb expression commands for objective-c and implement evaluate-under-cursor:	2013-05-23 21:34:26 +00:00
python-vim-lldb	Fixed continue issues with process attach/detach	2013-05-28 21:27:03 +00:00
README	Add Vim frontend to LLDB.	2013-02-11 17:18:14 +00:00

README

=================
LLDB Vim Frontend
=================

Prerequisites
-------------

This plugin is known to work with the following flavours of Vim:

  * Linux (tested on Ubuntu 12.04/12.10):
      * vim/gvim (from vim-gnome package version 7.3)

  * Mac OS X (tested on Mountain Lion)
      * Vim command-line (7.3 from Xcode)
      * MacVim 7.3

To install the plugin, ensure you have
  * a working version of lldb on your path, or the environment variable LLDB
    pointing to the lldb binary you would like to use.
  * a python-enabled vim (check with ":python print 2")


Installation
------------

1) Install the Vim pathogen plugin (it keeps installed plugins organized):

    https://github.com/tpope/vim-pathogen

  Or, for the impatient:

mkdir -p ~/.vim/autoload ~/.vim/bundle; \
curl -Sso ~/.vim/autoload/pathogen.vim \
    https://raw.github.com/tpope/vim-pathogen/master/autoload/pathogen.vim

2) Symlink (or copy) ~/.vim/bundle/vim-lldb to this directory:

ln -sf <lldb-dir>/utils/vim-lldb ~/.vim/bundle/vim-lldb

3) Update your help-tags. Start vim, do:

    :Helptags

4) Have fun!


Usage/Getting Help
------------------
All LLDB commands (with tab-completion) can be accessed in Vim's
command mode. Try it out by typing:

:L<tab>

There are several sources of help available:

:help lldb                  -- Documentation for this plugin
:Lhelp                      -- LLDB's built-in help system (i.e lldb 'help' command)
:Lscript help (lldb)        -- Complete LLDB Python API reference