
  GNU   ,-----.
 +------|      \     gEDA
        |       |--------+
 +------|      /
  EDA   `-----'
         7408

GNU Electronic Design Automation
------------------------------------------------------------------------------


README for gEDA version 1999*

This software is alpha and isn't anywhere near ready for prime time use.


IMPORTANT
	Please read the file NEWS for details on specifics for this release
	Please read the file gschem/BUGS for more info on existing bugs

	Please read the file INSTALL for installation instructions and various
	hints and tips.

	There are several example .sch (schematic) files to look at in the
	examples directory.  

- Programs in gEDA

	geda : Toplevel interface gui to all below tools (highly alpha)
	gschem : Schematic capture (most mature code in gEDA, still alpha) 
	gnetlist : Netlist generator/creator (highly alpha)
	gpcb : Printed Circuit Board (highly pre-alpha)
	gsymcheck : Symbol checker (highly alpha)
	gschcheck : Schematic checker (highly alpha)
	utils : A collection of useful gEDA related utilities


- System Requirements

	A computer:
   	   - at least the processing power of a i486/66
	   - Enough RAM to for X (usually 16 Mbytes but 32 Mbytes recommended)

	Running UNIX:
	   - Semi recent version of UNIX
	   - Compiled on:
		FreeBSD (2.2.5) 	
		Linux (2.0)	 	(and highly tested) 
		IRIX (6.2, 6.3, 6.4)	
		Solaris (2.5)		
		SunOS (4.1.3)	
		HP-UX (9.07)	

	The X window system 	
		- A resolution of at least 800x600
		- A color display
		- 3 button mouse (2 button works, but 3 button is better)

	GTK+ version 1.0.x or greater (and anything gtk requires)
		This version of gschem has been tested with 1.0.6 (latest
		stable 1.0.x at this time).  Old versions may work, but
		they may not.  gtk is still in flux so I have to stay on
		top of the latest version.  Please do not use unstable
		version of gtk+, since they will mostly likely NOT work!

		There is support for gtk+ 1.2.x (the newest stable
		version).  This support is still very ALPHA, so expect
		some instability.

		Gtk can be found at: ftp://ftp.gtk.org/pub/gtk
		
	A C compiler (that understands ANSI, like gcc) 

	GUILE - guile-1.3 is required (and anything guile requires).  Guile
	can be found at: ftp://prep.ai.mit.edu/pub/gnu/guile 

	LibStroke [OPTIONAL] - if you want stroke support.  The homepage
	for LibStroke is: http://www.etla.net/libstroke/

	An understanding that this software is ALPHA release quality :)


- Installation

	See the file INSTALL for more instructions on how to build gEDA



- License  

	gEDA (includes gschem/gnetlist/geda/gsymcheck/gschcheck/gpcb/utils
	and all associated files (such as component symbols)) is placed
	under the GNU Public License (GPL) version 2.0.  See the toplevel
	COPYING file for more information.

        libgeda which resides in the libgeda directory is placed under
        the GNU Library Public License (LGPL) version 2.0.  See the
        COPYING file in the libgeda directory for more information.

	Programs and associated files are:
	Copyright 1998 by Ales V. Hvezda and the respective original
	authors (which are listed on the respective files)



- gEDA Internet resources

	E-mail: geda@geda.seul.org
	Web: http://www.geda.seul.org


	Mailing list:
		To subscribe send an email to: majordomo@geda.seul.org  
	 	with   subscribe geda-dev   in the body.
		
		To unsubscribe send an email to: majordomo@geda.seul.org
	 	with   unsubscribe geda-dev   in the body.

		To send email to the list use the address:

			geda-dev@geda.seul.org

		Remember, geda-dev@geda.seul.org is for the actual traffic.  
		For administrative commands, use majordomo@geda.seul.org.

		The mailing list archive is at:

			http://www.geda.seul.org/mailinglist 

	CVS repository: (coming soon)

	Many thanks to the SEUL project for hosting gEDA!


- Author contact information  

	Ales V. Hvezda
	E-mail: ahvezda@geda.seul.org
	Web: http://www.geda.seul.org/

	See the individual tools/utilities for other author contact 
	information 
