Project name: I2C2P
Project homepage: http://i2c2p.twibright.com
Project feedback 3-ma!l: clock -=at=- twibright -=dot=- com

This is I2C2P source tree.

What can be done with the source
--------------------------------
* Compilation
* Autogenerated files cleanup
* Displaying over Apache with PHP on WWW
* Revision control 
* Hacking of course

Feedback
--------

Trivial patches 3-ma!l: clock -=at=- twibright -=dot=- com
Complicated questions: 
* SILC http://ronja.twibright.com/mlist.php
* If you are allergic to mailing lists, then use the above 3-ma!l too.

Compilation requirements
------------------------

For the project to compile (by typing "make" at the toplevel directory) you
need to have the following installed on your system:

* GCC http://gcc.gnu.org/ (works with 3.2.3)
* gschem http://geda.seul.org/tools/gschem/index.html (works with 20040111)
* gnetlist http://geda.seul.org/tools/gnetlist/index.html
  (works with 20040111)
* GNU make http://www.gnu.org/software/make/ (works with 3.79.1)
* ImageMagick http://www.imagemagick.org/ (works with 5.5.3)
* GhostScript http://www.ghostscript.com/ (works with 7.00)

The versions should be important (we strive for portability, at all :) ).
But if you experience problems and don't want to wait for support, you may
try those listed if they work for you.
This list is maybe still incomplete. If you get a crash dues to missing
program, exercise the support please :)

Compilation
-----------
Go to the toplevel directory (i. e. i2c2p/ typically, datasheet/ will be your
subdirectory). Ensure you are running under X Window System (DISPLAY variable
is set) and type "make". On a 3700 bogomips machine it takes about 8 minutes.

Cleaning the source
-------------------
The same as above, but type "make clean". This will clean all autogenerated
sources

Displaying over Apache with PHP
-------------------------------

You need to have Apache with mod_php (or php) installed:
* Apache http://httpd.apache.org/ (works with 2.0.50)
* PHP http://www.php.net/ (works with 5.0.1)
Then ensure that the toplevel i2c2p/ directory is directly visible under a
host (no subdirectory), so that e. g. http://foo.bar.com/ points directly
to i2c2p/ . This should display you the I2C2P titlepage when you
access http://foo.bar.com then. You might need to set up VirtualHost
for this (see http://httpd.apache.org/docs-2.0/mod/core.html#virtualhost ).

Revision control
----------------
Ronja runs on GNU Arch (aka tla): http://www.gnu.org/software/gnu-arch/.
GNU Arch seems to be better than CVS which Ronja used until recently.