[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
0d07716f	1	This package contains Common Lisp bindings to GTK+ v2.0. It currently
594fef42	2	only works with CMUCL 19a, but ports to other CL implementations may
594fef42	3	be added later.
0d07716f	4
	5
	6	New versions
	7	------------
	8
594fef42	9	The most recent version of this package can be found: in CVS
0d07716f	10
	11
	12
	13	Build instructions
	14	------------------
	15
	16	1. When building for CMUCL, first obtain a matching binary and source
594fef42	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.
0d07716f	20
e3e38b41	21
594fef42	22	2. Set up paths to reflect your system:
e3e38b41	23
594fef42	24	- Add a logical-pathname-translation to clg in ~/.cmucl-init.lisp
594fef42	25	or some other startup file. Example:
e3e38b41	26
594fef42	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.
e3e38b41	50
e3e38b41	51
e3e38b41	52	4. If everything worked, try (load "hello-world") to see a small
594fef42	53	window pop up, and then run testgtk.lisp in the example directory.
594fef42	54
e3e38b41	55
594fef42	56	Send comments and patches to clg-devel@lists.sourceforge.net or
594fef42	57	espen@users.sourceforge.net.
e3e38b41	58
0d07716f	59
	60
	61