Project name: SBC
Official project homepage: http://www.dlharmon.com/sbc.html
Unofficial project homepage: http://sbc.twibright.com
Project feedback 3-ma!l: website -=[at]=- dlahrmon dot com

This is unofficial SBC 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

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)
* eps2png http://www.squirrel.nl/people/jvromans/sw_eps2png.html
  (works with 3.2.2)

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. ronja/ typically, datasheets/ will be
your subdirectory) and type "make". On a 3700 bogomips machine it takes
about 6 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 ronja/ directory is directly visible under a
host (no subdirectory), so that e. g. http://foo.bar.com/ points directly
to ronja/ . This should display you the Ronja poster and 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
----------------
SBC runs on GNU Arch (aka tla): http://www.gnu.org/software/gnu-arch/.
GNU Arch is better than CVS which Ronja used until recently.