GNU readline

1.  Summary

	This fast-track introduces GNU readline, version 5.2,
	into the Solaris WOS.

	Patch release binding is requested.

2.  Discussion

	GNU readline is a library used for reading lines of
	text with interactive input and history editing.
	It is used by a variety of open-source applications
	including virsh (part of libvirt, which has recently
	been submitted to ARC [1]).  A private copy of readline
	is currently included with PostgreSQL, which can be
	removed when this version is integrated.

	Readline is delivered as two libraries, libreadline
	and libhistory.  The functions for editing lines are
	in libreadline and the functions for saving and recalling
	previous command-line history are in libhistory. Both
	libraries can be used independently, if desired.

	GNU readline is currently available in the Solaris
	Companion CD (CCD).  This proposal removes it from the
	CCD and adds it to the SFW consolidation.

	Further information on readline, including APIs and
	user and programming guides are available at the GNU
	readline website [2] and copies of the manuals are
	in the case directory.

	GNU readline will be installed in /usr as per the
	guidelines of PSARC/2007/047, /usr/gnu [3].

3.  Interfaces

	Exported Interfaces
	===================
	SUNWgnu-readline			Uncommitted	Package name

	/usr/lib/libreadline.so.4		Uncommitted	Shared object library
	/usr/lib/libreadline.so			Uncommitted	Symbolic link

	/usr/lib/libhistory.so.4		Uncommitted	Shared object library
	/usr/lib/libhistory.so			Uncommitted	Symbolic link

	/usr/share/man/man3/readline.3		Uncommitted	manpage

	/usr/share/info/readline.info		Uncommitted	Info document
	/usr/share/info/rluserman.info		Uncommitted	Info document
	/usr/share/info/history.info		Uncommitted	Info document

	/usr/include/readline			Uncommitted	Directory
	/usr/include/readline/chardefs.h	Uncommitted	Header file
	/usr/include/readline/history.h		Uncommitted	Header file
	/usr/include/readline/keymaps.h		Uncommitted	Header file
	/usr/include/readline/readline.h	Uncommitted	Header file
	/usr/include/readline/rlconf.h		Uncommitted	Header file
	/usr/include/readline/rlstdc.h		Uncommitted	Header file
	/usr/include/readline/rltypedefs.h	Uncommitted	Header file
	/usr/include/readline/tilde.h		Uncommitted	Header file

	/usr/demo/readline/Inputrc		Uncommitted	Example init file

4.  References

	[1] Mark Johnson, PSARC/2007/157: libvirt - a LGPL library to control guest domains
	[2] http://cnswww.cns.cwru.edu/php/chet/readline/rltop.html
	[3] S. Hahn, B. Smaalders, and R. Orth, PSARC/2007/047: /usr/gnu

APPENDIX A

	[ copy of http://cnswww.cns.cwru.edu/php/chet/readline/readline.html ]

APPENDIX B

	[ copy of http://cnswww.cns.cwru.edu/php/chet/readline/history.html ]

APPENDIX C

	[ copy of http://cnswww.cns.cwru.edu/php/chet/readline/rluserman.html ]