[clg] / README

This package contains Common Lisp bindings to GTK+ v2.0. It currently
only works with CMUCL 19a, but ports to other CL implementations may
be added later.


New versions
------------

The most recent version of this package can be found: in CVS 


Build instructions
------------------

1. When building for CMUCL, first obtain a matching binary and source
   tree (the only source file you will actually need is lisp.h and a
   couple of other header files). On ELF systems you may also have to
   rebuild lisp with -rdynamic added to OS_LINK_FLAGS.


2. Set up paths to reflect your system:

   - Add a logical-pathname-translation to clg in ~/.cmucl-init.lisp
     or some other startup file. Example:

       (setf
         (logical-pathname-translations "clg")
         '(("**;*.*.*" "/home/espen/src/clg/**/")))

   - Set the correct pkg-config search path if your gtk+ installation
     is in an unusual place, by adding it to the PKG_CONFIG_PATH
     environment variable before starting lisp.

   - Set *cmucl-include-path* to point to the directory where the
     lisp.h file resides, if it is not in the default place.  Try "locate 
     'lisp/lisp.h'" if you don't know the location.


3. Compile and load the system:
   
     (asdf:oos 'asdf:load-op :gtk)

   Currently it will fail with:

   Error in function KERNEL::%REDEFINE-DEFSTRUCT:
     Redefining class PCL::SLOT-INFO incompatibly with the current definition.

   Just accept the redefinition (restart 1) to continue building or loading.


4. If everything worked, try (load "hello-world") to see a small
   window pop up, and then run testgtk.lisp in the example directory.


Send comments and patches to clg-devel@lists.sourceforge.net or
espen@users.sourceforge.net.
Commit	Line	Data
560af5c5	1	This package contains Common Lisp bindings to GTK+ v2.0. It currently
f00b458d	2	only works with CMUCL 19a, but ports to other CL implementations may
f00b458d	3	be added later.
560af5c5	4
	5
	6	New versions
	7	------------
	8
f00b458d	9	The most recent version of this package can be found: in CVS
560af5c5	10
	11
	12
	13	Build instructions
	14	------------------
	15
	16	1. When building for CMUCL, first obtain a matching binary and source
f00b458d	17	tree (the only source file you will actually need is lisp.h and a
	18	couple of other header files). On ELF systems you may also have to
	19	rebuild lisp with -rdynamic added to OS_LINK_FLAGS.
560af5c5	20
af2d02f4	21
f00b458d	22	2. Set up paths to reflect your system:
af2d02f4	23
f00b458d	24	- Add a logical-pathname-translation to clg in ~/.cmucl-init.lisp
f00b458d	25	or some other startup file. Example:
af2d02f4	26
f00b458d	27	(setf
	28	(logical-pathname-translations "clg")
	29	'(("*;.." "/home/espen/src/clg/**/")))
	30
	31	- Set the correct pkg-config search path if your gtk+ installation
	32	is in an unusual place, by adding it to the PKG_CONFIG_PATH
	33	environment variable before starting lisp.
	34
	35	- Set cmucl-include-path to point to the directory where the
	36	lisp.h file resides, if it is not in the default place. Try "locate
	37	'lisp/lisp.h'" if you don't know the location.
	38
	39
	40	3. Compile and load the system:
	41
	42	(asdf:oos 'asdf:load-op :gtk)
	43
	44	Currently it will fail with:
	45
	46	Error in function KERNEL::%REDEFINE-DEFSTRUCT:
	47	Redefining class PCL::SLOT-INFO incompatibly with the current definition.
	48
	49	Just accept the redefinition (restart 1) to continue building or loading.
af2d02f4	50
af2d02f4	51
af2d02f4	52	4. If everything worked, try (load "hello-world") to see a small
f00b458d	53	window pop up, and then run testgtk.lisp in the example directory.
f00b458d	54
af2d02f4	55
f00b458d	56	Send comments and patches to clg-devel@lists.sourceforge.net or
f00b458d	57	espen@users.sourceforge.net.
af2d02f4	58
560af5c5	59
	60
	61