___________________________________
|      |  |  |     |  _  |     |  |
|  |___|  |  |  |  |    _|  |  |  |    GNU GLOBAL source code tag system
|  |   |  |  |  |  |     |     |  |
|  ~~  |   ~~|     |  ~  |  |  |   ~~|          for all hackers.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 Copyright (c) 2000, 2002, 2003, 2004, 2006 Tama Communications Corporation

 This file is free software; as a special exception the author gives
 unlimited permission to copy and/or distribute it, with or without
 modifications, as long as this notice is preserved.

 This program is distributed in the hope that it will be useful, but
 WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
 implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

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

Installation of GNU GLOBAL.

[Note]  Though GNU GLOBAL supports only UNIX(POSIX) environment,
        some outside projects develop DOS or Windows 32 version of it.
        Please see:
                http://www.gnu.org/software/global/download.html

1. Preparation.

o If you want to use the -I option of global(1) then idutils(1) is needed.

   You can get idutils at:

	ftp://ftp.gnu.org/pub/gnu/idutils/
  
o If you want to use the --form(-f) or --dynamic(-D) option of htags(1) then
  Perl version 4 or later is needed.

   If you don't have it, you can fetch it from this site.

	http://www.perl.com/CPAN/

2. How to install.

	$ ./configure
	$ make
	# make install

3. Using GLOBAL with editors.

o Nvi-1.81.5

   Please get nvi-1.81.5 at:


	   http://www.kotnet.org/~skimo/nvi/

   build it with '--enable-perlinterp' option and do the followings.
   ($HOME/perl is an example. Please replace it with any directory you like.)

	$ mkdir $HOME/perl
	$ cp gtags.pl $HOME/perl
	$ vi $HOME/.nexrc
	+-----------------------------------------
	|perl use lib qw($ENV{HOME}/perl)
	|perl require 'gtags.pl'
	|map ^P :tagprev^M
	|map ^N :tagnext^M
	|map ^] :perl tag^M
	|ab gtag perl tag qw(
	|ab gta perl tag qw(
	|ab gt perl tag qw(

   ('gtags.pl' is included in GLOBAL package.)

o Emacs

   Global supports GNU Emacs and XEmacs. If you meet some troubles,
   please mail to bug-global@gnu.org.

   You can get them at:

	GNU emacs:
		ftp://ftp.gnu.org/pub/gnu/emacs/
	XEmacs:
		http://www.xemacs.org

   Please copy gtags.el file to emacs lisp library directory or place it in
   a directory (for example "~/lisp") and write $HOME/.emacs like this.

	+-----------------------------------------------
	|(setq load-path (cons "~/lisp" load-path))

o Elvis

   You need Elvis 2.1 or later. You can get it at:

	http://elvis.vi-editor.org/

   You need not any patch for it.

o Vim

   You can get them at:

	http://www.vim.org/

   Please copy gtags.vim file to your plug-in directory.

	$ cp /usr/local/share/gtags/gtags.vim $HOME/.vim/plugin

Good luck!
