                gNewt - Gtk Not Erik's Windowing Toolkit


gNewt is a Newt compatible gtk+ based library. Newt was originaly written by
Erik Troan at Red Hat Software. gNewt was written by O'ksi'D.

gNewt 0.03 is compatible with newt 0.50.

gNewt's license is LGPL (see COPYING file for details).

If you want to develop a software which must be compatible with both gNewt and 
newt, you should use newt as the reference during the development. 

HACKING :
=========

There is 6 test programs in the gNewt source code :
	test 		: C main test program
	testgrid 	: C grid layout and dialog windows test
	testtree	: C CheckboxTree widget test
	peanuts.py	: Python gsnack module test
	testtcl.tcl	: TCL whiptcl module test
	testwhiptail.sh : shell gwhiptail test script

By simply setting the LD_PRELOAD environmental variable, every C, Python,
TCL or whiptail program dynamicaly linked to newt can be dynamicaly linked 
at runtime to gNewt. No need to recompile anything.
	export LD_PRELOAD=/usr/lib/libgnewt.so

But if you don't like this feature, you have another choice :
- To use an existing newt C program with gNewt, you should :
    Edit the program's Makefile. Remove the "slang" and "newt" library form
    list of library to be linked. Add the "gnewt", "gtk" and "gdk" library
    to the list of library to be linked. Recompile the program. That's it.

- To use a newt Python script with gNewt, you should replace :
	from snack import *
by :
	from gsnack import *

- To use a newt TCL scripts with gNewt, you should replace :
	load /usr/lib/whiptcl.so
by :
	load /usr/lib/gwhiptcl.so

- To use a whiptail script with gwhiptail, you should add something like 
this at the top of the script :
	#!/bin/bash
	if  test "x$DISPLAY" != "x" ; then
		if  test -x "`which gwhiptail`"  ; then
			whiptail () { gwhiptail "$@" ; }
		fi
	fi


To override the font size, you can set the GNEWT_FONT_SIZE environmental 
variable : 
	export GNEWT_FONT_SIZE=20x8
This can be usefull to have a full screen display.


Install procedure :
===================
        tar -xvzf gnewt_0.03.tgz
	cd gnewt-0.03
	./configure
	make
	make install
	make install-sh
	 
Contacts :
==========
Please, report bugs or send comments to :

	mailto:nickasil@linuxbox.com

	home page : http://oksid.linuxbox.com/gnewt/

	O'ksi'D    
	Jean-Marc Lienher
	Rue de la Cheminee 1
	CH-2065 Savagnier
	Switzerland 

