Install

• Clewn
• vimGdb

Clewn install

INSTALL.txt - Clewn installation notes.

    a) required
    b) build
    c) install
    d) remote debugging


a) REQUIRED:
------------
    GDB:	    gdb 6.8 or any previous version, starting from gdb 5.3
    VIM:	    any version starting from Vim 6.3 with
		    the |+netbeans_intg| feature enabled
    GNU readline

There is no need for you to check for the existence of the readline library:
when configure is run, a check is made to ensure that readline can be found
on your system. GNU readline can be found at:
    http://cnswww.cns.cwru.edu/php/chet/readline/rltop.html


b) BUILD:
---------
In the clewn directory, run the following commands:

    $ ./configure
    $ make

For a user local installation that does not require root privileges, run
the following configure command:

    $ vimdir=$HOME/.vim  ./configure  --prefix=$HOME

In this case, the clewn program is installed in $HOME/bin, and the vim
runtime files in $vimdir.


c) INSTALL:
-----------
In the clewn directory, run the following command:

    $ make install

You can now use the ":help clewn" command within vim, to get access to the
clewn documentation.

Run 'make uninstall', to uninstall clewn.


d) REMOTE DEBUGGING:
--------------------
When cross-compiling, add the --host and --build argument on the command
line of configure. Then run make. For example, with an arm target:

./configure CC=/path_to_gcc/arm-gcc --build=i686-pc-linux-gnu --host=arm-linux

The readline and curses libraries must be available on the target.

The following commands are run:

    host:	gvim -c "run clewn.vim" -nb:target_ip_address
    target:	clewn -x pathnames_map -nb:target_ip_address


			

vimGdb install

This document describes how to install the patch for vimGdb.


a) You need:

    vim-7.2.tar.bz2         Vim 7.2 source tar ball (from www.vim.org)
    vimgdb72-1.14.tar.gz    this patch


b) Untar all files, apply the patch and make Vim:

    tar xjf vim-7.2.tar.bz2
    tar xzf vimgdb72-1.14.tar.gz

    patch -d vim72 --backup -p0 < vimgdb/vim72.diff

    cd vim72/src
        make	            make vim
        make install        install vim (may require root privileges)

IMPORTANT NOTE: you must run make (not ./configure), and if you run
./configure then you must add the --enable-gdb command line argument
in order to include the gdb feature (vimgdb) in vim.


c) Install vimGdb runtime:
Copy the file vimgdb_runtime.tgz found in the vimgdb tarball, to your
runtime path. To find your runtime path location execute the vim
command (this is usually $HOME/.vim):

    :set runtimepath?

Untar vimgdb_runtime.tgz in your runtime path. After this step, you
should have the following files:

    doc/gdb.txt
    macros/gdb_mappings.vim
    syntax/gdb.vim
    syntax/gdbvim.vim
    syntax/gdbvar.vim

Change to the doc directory, start Vim and run the ":helptags ."
command to process the taglist help file. Without this step, you
cannot jump to the taglist help topics. You can now use the ":help
vimgdb" command to get the vimGdb documentation.