VERSION                 VPAC-0.2              
=============  READ THIS BEFORE BUILDING ==============

------------DO NOT BUILD THIS PROGRAM AS ROOT-----------------

MUST BE BUILT AND INSTALLED AS A USER IN A USER HOME DIRECTORY.

--------------------------------------------------------------

IMPORTANT BEFORE YOU BEGIN:
Read this file for build and installation instructions.

YOU SHOULD HAVE INSTALLED AND WORKING GCC AND PERL
Versions should be a least at the following revision.
gcc version 3.2.3 20030502 (Red Hat Linux 3.2.3-49)
perl, v5.8.0 built for i386-linux-thread-multi

YOU WILL NEED 2 ADDITIONAL PACKAGES INSTALLED:
nasm version 0.98.37 or better [assembly language program]
ald  version 0.1.5a or better  [assembly language debugger]

They can be found at kernel.org/software/devel/nasm/source
and the ald debugger at sourceforge.net
or visit the Nasm Homepage for other locations of these packages.

These packages are used along with perl and gcc/g++ to create
the programmers vpac(Vim-Perl-Asm-C/C++). 

Build:
======
Copy vpac-0.2.tar.gz to /home/your_user_name/any_directory
example: /home/your_user_name/temp
gzip -df vpac-0.0.2.gz
tar xvf vpac.tar
cd vpac-0.2/
In the vpac directory run: 
./configure
make install

This will install the binary,man  and configuration files in:
/home/your_user_name/bin
/home/your_user_name/etc
/home/your_user_name/man/man1

These sub directories will be created if they don't already exist.

Installation to /bin,/usr/bin,usr/local/bin is not recommended as 
vpac was designed to be run only from the users $HOME/bin 
directory.

Install: (continued)
====================
Next step is to make sure your bin directory is in the environment path.
Assuming you are using bash as your shell. Edit the .bash_profile
file in your home directory to add the home/bin path.

example:    PATH=$PATH:$HOME/bin
			export PATH
	    
For csh and tcsh shells:
place
setenv PATH"$PATH:/home/your_user_name/bin"
in your .profile file

Your $HOME/bin/ should now contain:
[ vpac vpacd vpacr vpacs vpact vpacm vip mlfilter ]

Your $HOME/etc should now contain:  
[ asm_libraries  cc_libraries  c_libraries          ]
[ asm_options    cc_options    c_options    gdbinit ]

Your $HOME/man/man1 should now contain:
vp.1  
Check vp.1 by running at a shell prompt: man vp or info vp
This is the manual page for Vpac.
The /etc and /bin files and their usage will be explained in the
various documents in the vpac/doc directory.

Next edit your $HOME/.bashrc file and place the following alias in it.
alias vm='vip $1'
This will allow you to change comment styles whilst using vpac.
Finally if you already have a .vimrc file in you $HOME directory then
make a backup of it. Then copy the VIMRC file from
/home/your_user_name/temp/vpac-0.2/VIMRC    to 
/home/your_user_name/.vimrc
This will setup Vpac to work in Vim.
Either log out and back in again or open a fresh Shell(Window) 
and enter vim.  Press the F3 key and you should get the following
response:
:!vpact
Args: OFF
This will create the cmdline.arg file in $HOME/etc.(Used as toggle) 
That's the build and installation completed.
Exit Vim.

Next read the howto.txt and the VP.html in the /doc directory of this
package.
