hanchenye-llvm-project/lldb/utils/vim-lldb
James Y Knight 5d71fc5d7b Adjust documentation for git migration.
This fixes most references to the paths:
 llvm.org/svn/
 llvm.org/git/
 llvm.org/viewvc/
 github.com/llvm-mirror/
 github.com/llvm-project/
 reviews.llvm.org/diffusion/

to instead point to https://github.com/llvm/llvm-project.

This is *not* a trivial substitution, because additionally, all the
checkout instructions had to be migrated to instruct users on how to
use the monorepo layout, setting LLVM_ENABLE_PROJECTS instead of
checking out various projects into various subdirectories.

I've attempted to not change any scripts here, only documentation. The
scripts will have to be addressed separately.

Additionally, I've deleted one document which appeared to be outdated
and unneeded:
  lldb/docs/building-with-debug-llvm.txt

Differential Revision: https://reviews.llvm.org/D57330

llvm-svn: 352514
2019-01-29 16:37:27 +00:00
..
doc
plugin
python-vim-lldb
README

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