packages icon
GTK+ Object Builder (GOB)
(George's Obfuscated Bits)

Very simple preprocessor for making GTK+ objects with inline C code so that
generated files are not editted.  Syntax is inspired by java and yacc or lex.
The implementation is intentionaly kept simple, and no C code parsing is done.

Reasons:
	- C is a perfect (well mostly) language, no need for another language
	- Writing a fully featured GTK+ object is a hassle
	- Need for a generator that doesn't require changes to generated code
	- I like how Java writes method code directly into the class
	  definition.

To build:
	(the usual drill :)
	run "./configure;make"

To install:
	run "make install" as root, or just take the gob binary and place
	it anywhere you want.

To use:
	run gob with the .gob file on the command line

What's generated:
	two (.c and .h) files named by the object name with words
	separated by a hyphen (not neccessairly the .gob file prefix)

How to write .gob files?
	1) read "man gob" for some documenation on how to use GOB
	2) if you can't find what you need, read src/test.gob for an
	   example of GOB code
	3) If you still can't find what you need, read src/lexer.l
	   and src/parse.y (in other words: RTFS)

How to include gob inside your project:

	Put the gob distribution into a subdirectory in your main
	project directory.  Use the AC_CONFIG_SUBDIRS to include that
	directory in your configure run.  And finally add a file called
	NOINST_GOB into your toplevel project directory (this can be done
	inside your configure script in fact) so that gob doesn't install
	itself.  Then just use the made gob binary as you would other
	preprocessors.

TODO:
	- clean up code
	- make it behave nice
	- add warnings all over the place
	- get a life

George <jirka@5z.com>