#	$Id: INSTALL,v 1.16 1999-04-05 00:14:23+09 hayashi Exp $

1. How to Install Term::ReadLine::Gnu

1.1 Install GNU Readline library 2.1 or later and their header files.

	See the section `How to Install GNU Readline Library'.

1.2 Edit Makefile.PL

	Specify directory for libreadline.a ($libreadlinedir) and
	include files of GNU Readline library ($increadlinedir).

1.3 Make and install

	% perl Makefile.PL
	% make
	% make test
	% make install

1.4 Trouble Shooting

	If you have any troubles during using this module, please let
	me (hiroo.hayashi@computer.org) know them by E-Mail.  It may
	help people who has same problem.  I'm sorry that I cannot
	watch all articles on comp.lang.perl.modules.

	When you report me your trouble, send me the result of `perl
	-V' and which compiler you use to compile the GNU Readline
	Library (libreadline.a).


2. How to Install GNU Readline Library

	Now this module supports only GNU Readline Library 2.1, 2.2.1 and
	4.0. (readline-2.[12].tar.gz, readline-4.0.tar.gz or libraries
	which are included in the GNU Bash version 2.0 or later) Executing
	`perl Makefile.PL` detects which version of the GNU Readline
	Library is already installed and warns you if you have the
	unsupported version.

	Note that some free Unix distribution and Cygwin32-b19 include
	the GNU Readline Library 2.0 which is not supported by this
	module.  (I can make readline-2.2 by ordinary configure and
	make process even on Window 95 with Cygwin32 environment.  But
	my perl for Windows 95/NT does not work with it.  Your
	suggestion will be welcome.)

	In the following example, the install prefix directory is
	`/usr/local/gnu'.  If you install the library and header files
	in another directory, you must edit `LIBS' and/or `INC'
	section in Makefile.PL.

	You DON'T have to build the library as shared library.  If you
	want, you can do.  If you want to build it, use readline-4.0 (and
	later).  Type `make shared' instead of `make' to build shared
	library.
	
	Since the GNU Readline Library is 8 bit clean, I use Japanese
	characters without any patch.  But I have to hit Backspace key
	twice to erase a Japanese character.  If you want to handle
	Japanese characters better, check the following URL.

		ftp://ftp.yynet.tama.tokyo.jp/pub/misc/readline/

	I've not tried it, but it should work with my module.

2.1. readline-4.0.tar.gz, readline-2.2.1.tar.gz

	readline-2.2.tar.gz has some bugs, so I strongly recommend you
	to use readline-2.2.1.tar.gz or later instead.

	1. get and extract readline-XX.tar.gz

	2. configure
		% ./configure --prefix=/usr/local/gnu
	3. make and install
		% make install

2.2. readline-2.1.tar.gz

	1. get and extract readline-2.1.tar.gz

	2. add following patch;
========================================================================
*** Makefile.in.orig	Wed Jun  4 00:29:31 1997
--- Makefile.in	Sun Jul 13 23:31:09 1997
***************
*** 194,200 ****
  	-test -n "$(RANLIB)" && -$(RANLIB) -t $(libdir)/libreadline.a
  	-( if test -d doc ; then \
  		cd doc && \
! 		${MAKE} ${MFLAGS} infodir=$(infodir) INSTALL_DATA=$(INSTALL_DATA) $@; \
  	  fi )
  
  installdirs: $(srcdir)/support/mkdirs
--- 194,200 ----
  	-test -n "$(RANLIB)" && -$(RANLIB) -t $(libdir)/libreadline.a
  	-( if test -d doc ; then \
  		cd doc && \
! 		${MAKE} ${MFLAGS} infodir=$(infodir) INSTALL_DATA="$(INSTALL_DATA)" $@; \
  	  fi )
  
  installdirs: $(srcdir)/support/mkdirs
========================================================================

	3. configure
		% ./configure --prefix=/usr/local/gnu
	4. make and install
		% make install

2.3. libreadline.a in bash-2.0.tar.gz

# I reported this patch to Chet Ramey, the bash maintener, but he
# fixed Makefile.in as follows;
#
# $ grep -A2 ^install: bash-2.02/lib/readline/Makefile.in 
# install:
#        @echo "This version of the readline library should not be installed."
#
# Get readline-2.2.1.tar.gz and install it.

	The libreadline.a which is made when you make bash does not
	work as stand-alone library.  You must make it without defining
	a CPP macro `SHELL'.

	1. get and extract bash-2.0.tar.gz
	2. add following patch
	  (I reported this patch to bug-bash@prep.ai.mit.edu, so I
	   hope this patch will not be required by the future
	   releases.)

========================================================================
*** lib/readline/Makefile.in.orig	Tue Nov 26 02:40:21 1996
--- lib/readline/Makefile.in	Fri Dec 27 00:16:50 1996
***************
*** 4,9 ****
--- 4,16 ----
  #								   #
  ####################################################################
  
+ # Include some boilerplate Gnu makefile definitions.
+ prefix = @prefix@
+ 
+ exec_prefix = @exec_prefix@
+ libdir = $(exec_prefix)/lib
+ includedir = @includedir@
+ 
  srcdir = @srcdir@
  VPATH = .:@srcdir@
  topdir = @top_srcdir@
***************
*** 108,114 ****
  	done
  	-${MV} $(libdir)/libreadline.a $(libdir)/libreadline.old
  	${INSTALL_DATA} libreadline.a $(libdir)/libreadline.a
! 	-test -n "$(RANLIB)" && $(RANLIB) -t $(bindir)/libreadline.a
  
  installdirs:	$(topdir)/support/mkdirs
  	$(SHELL) $(topdir)/support/mkdirs $(includedir) \
--- 115,121 ----
  	done
  	-${MV} $(libdir)/libreadline.a $(libdir)/libreadline.old
  	${INSTALL_DATA} libreadline.a $(libdir)/libreadline.a
! 	-test -n "$(RANLIB)" && $(RANLIB) -t $(libdir)/libreadline.a
  
  installdirs:	$(topdir)/support/mkdirs
  	$(SHELL) $(topdir)/support/mkdirs $(includedir) \

========================================================================

	3. configure
		% ./configure --prefix=/usr/local/gnu
	4. change directory to the Readline Library directory
		% cd lib/readline
	5. remove *.a and *.o, if you made libreadline.a for bash in
	   the directory
		% make clean
	6. make
		% make
	7. install
		% make install

EOF
