Release notes for the gEDA/gaf 20030525 development snapshot
------------------------------------------------------------
CHANGES:

   General / Summary

	* This release is mainly a packaging release.  Several 
	  contributed pieces were integrated into the gEDA/gaf 
	  release framework including:

		- Piotr Miarecki's geda (gManager) 
		- Piotr's gEDA Suite setup.  
		- geda-examples which is a tarball of various 
		  examples of gEDA/gaf in action.

	* Two new backends were also incorporated (switcap and spice-sdb)

	* Improved the toplevel Makefile a little bit.  Now if you are 
	  building from a CVS checkout, you can: 1) set the PATH and 
	  LD_LIBRARY_PATH variables (as usual) and 2) type: make install
	  and the Makefile will take care of running auto* as required. 

   libgeda

	* Shared library version number still at 18 (unchanged).

	* No changes for libgeda.

   gschem

	* Applied patch by Mario Klebsch for bug #43: "If gschemdoc is
	  not install, gschem crashes".

	* Fixed a crash when you press the q key or any other "no-action"
	  key.  This was changed behavior when using guile 1.6.3.

	* Added "reset-component-library" and "reset-source-library" rc
	  keywords.  Now from either ~/.gEDA/gschemrc (or gnetlistrc)
	  or a local gschemrc (or gnetlistrc) file, you can empty out
	  all the default libraries and set your own.

	* Fixed the x_multimulti.nw build problem that some people ran into.

	* Updated the Brazilian translation (new file supplied by Antonio).
	
   gnetlist

	* Applied a patch by Dan McMahill to get the PCBboard backend working
	  with guile 1.6.3

	* Integrated Stuart Brorson's advanced spice backend (spice-sdb).
	  Please see the howto in the docs directory (docs/spice-sdb/)
	  for more info on this backend.  The only changes I made to
	  Stuart's original code was to lowercase the name of the backend
	  (from spice-SDB to spice-sdb).  Also check out his spice website
	  at: http.

	* Integrated Dan McMahill's switchcap backend.  Please see the 
	  gnetlist/docs/README.switcap for more info.  Also see the
	  documentation in the docs package (docs/switcap) for even more
	  info.

	* Applied a patch from Dan to the gnetlist.1 manpage. 

   gsymcheck

	* No changes for gsymcheck.

   symbols

	* Werner Hoch updated a bunch of symbols in the max symbol library 
	  along with adding a few new symbols.  Thanks!

	* Integrated a few new symbols for Stuart's spice backend.

	* Integrated a few new symbols for Dan's switcap backend.

	* Fixed 93Cx6-1.sym to include power information (patch by 
	  Holger Dietze). (Bug#65)

	* Applied Wojciech Kazubski's --with-docdir patch.  Now you can 
	  specify where the documentation is installed using --with-docdir
	  at the ./configure stage.

	* Fixed 74/7408-2.sym and 74/7409-2.sym, these symbols were swapped.
	  Pointed out by Mario Klebsch.

	* Integrated a bunch of symbols from various people (thanks)
	  who used the website upload mechanism.  Btw, the website symbol
	  upload is so much easier for me, so please continue using it.
	  I think I have a few symbols I still need to finish integrating.

   geda (gManager)

	* From the README: 

		"gEDA Suite Project Manager is a start point for 
		 everything what you may want to do. It is used to 
	         organize your files and easy running tools. It 
		 simplifies your job."

	  Even though it is called gManager or Project Manager, the 
	  built executable is called "geda".  Please play with it and 
	  let Piotr know of any suggestions or bugs.

	* This is the first release of this program inside the gEDA/gaf 
	  framework. 

	* Integrated this program into the toplevel Makefile (so that it gets
	  built when you type make install etc...) 

	* If you build using the toplevel Makefile from now on, you must
	  have geda in the current directory.

   setup

	* This is Piotr's gEDA Suite Setup program.  

	* This is the first release of this program inside of the gEDA/gaf
	  framework.   Please send all bug reports to Piotr.

	* Here's how you use it:

	   1) Download all the gaf files and the required libraries
	      and put them all into one directory.
	   2) Download guile-1.4.1.tar.gz and put it also into the
	      above directory.  
	   3) Type: make xinstall
           4) Follow the GUI.

	  Setup will build and install all of gEDA/gaf.  Eventually this
	  will be extended to build/install the rest of gEDA and gEDA
	  related programs.  Please let Piotr know of any suggestions or
	  bugs. 

	  Make sure you have guile-1.4.1.tar.gz in the current directory
	  along with all the gaf tarballs.

	* If you build using the toplevel Makefile from now on, you must
	  have setup in the current directory.

   utils

	* Applied a patch by Charles Lepple to fix a build problem on OSX.

	* Applied Wojciech Kazubski's --with-docdir patch here as well.

   docs

	* Integrated documentation for Dan's and Stuart's new backends.

	* Applied Wojciech Kazubski's --with-docdir patch here as well. 

   examples

	* This is the first release of the example package inside of
	  the gEDA/gaf framework.

	* This package includes:

	  - Stefan's gTAG : An example of hierarchical schematics using gaf.

	  - Terry Porter's lightning_detector: An example of how to use
	    gEDA/gaf with PCB.

	  - Stuart Brorson's TwoStageAmp and RF_Amp : Examples of how
	    to use spice-sdb for single page and hierarchical SPICE
	    simulation using gEDA/gaf.

	  If anybody else has some projects they would be willing to allow
	  me to distribute, please let me know!  I'm always looking for 
	  examples of gEDA/gaf in real use.

	* The examples are not installed, but the toplevel Makefile expects
	  the tarball to be untarred in the current directory. 


   For more a detailed ChangeLog please look in the appropriate source 
   directories.


BUGS/ERRATA/LAST MINUTE ISSUES

	* The following features/bugs did not make it into this release:

	  - I have a working version of gaf using gtk+ 2.2.1.  I still
	    need to finish up the changes to the various ./configure
	    scripts so that gaf can use either 1.2.x and 2.2.x.  I didn't
	    get to doing this in this release.  I still have some more
	    time before gtk+ 2.2.x takes over.

	  - I also have a new better looking and easier to use
	    print dialog box.  A whole slew of bugs prevented me from
	    checking this code in.  Still working on this one.

	* Thanks to all who contributed to this release.

	* As usual, send all bug reports and suggestions to geda-dev / 
	  geda-user or directly to me.  Thanks.


DOWNLOAD:

   http://www.geda.seul.org/source.html
   http://www.geda.coelacanth.com/source.html
   http://ieee.ing.uniroma1.it/geda/source.html
   http://ftp.sunet.se/geda/source.html

 
SOURCE TARBALLS:

md5sum                            Name                             Size
--------------------------------- -------------------------------  ---- 
18dbd24d55e0e87acb534c4f5cf9e746 *Makefile                          28k
ec5457cf96c4e5dc3345aeeb50ca6a7b *geda-20030525.tar.gz             240k
8b401b45a144578e839965d9ef0beeb7 *geda-docs-20030525.tar.gz        896k
4f840cb9c72515ceeb12771e58547356 *geda-examples-20030525.tar.gz    240k
1bfcfe2d150af7c421598e75d0911ee0 *geda-gnetlist-20030525.tar.gz    284k
f46e477e054aeec7e9ec18433f518823 *geda-gschem-20030525.tar.gz     1352k
5856f9b9a7f968f73ff5a46245fb5e2c *geda-gsymcheck-20030525.tar.gz   140k
a97292293d92b04ae4932abd724fd5e9 *geda-setup-20030525.tar.gz       292k
be61cb20cae4ea3fd46e386dd4940291 *geda-symbols-20030525.tar.gz     524k
cfe95566504fa6a06bb6b5cc81c8afd7 *geda-utils-20030525.tar.gz       200k
49c4807f03761136cca8f8005de6539e *libgeda-20030525.tar.gz          864k
                                                                   ----
                                                          Total    ~5 Megs

   Required libraries (http://www.geda.seul.org/dist):
   * glib >= 1.2.3     
   * gtk+ >= 1.2.3    
   * guile 1.4.1 or 1.6.3  
 
   Required programs (http://www.geda.seul.org/dist):
   * GNU gettext >= 0.11.5  (0.10.35 will NOT work)

   Optional libraries (http://www.geda.seul.org/dist):
   * LibStroke 0.5.1   
   * libgdgeda 2.0.9    
   * zlib 1.1.x      
   * libpng 1.2.x   


BINARIES:

   Unix 
   None yet
  
   MinGW (Win32)
   None yet


BUILDING, INSTALLING, RUNNING:

   1) Download *all* the above files and the required libraries.
   2) Build and install the required and optional libraries.
   3) Untar all of the geda tar files in the same directory.
   4) Set the prefix= variable in the Makefile
   5) Run: make   and set the specified variables (PATH and LD_LIBRARY_PATH)
   6) Run: make install 

   -OR-

   1) Download *all* the above files and the required libraries and put them
      all into one directory.
   2) Download guile-1.4.1.tar.gz and put it also into the above directory.
   3) Type: make xinstall
   4) Follow the GUI.
	
   -OR-

   1) Download all the above files and the required libraries.
   2) Build and install the required and optional libraries.
   3) Untar all of the geda tar files in the same directory.
   4) Go into each directory and run:
         ./configure            [ with --prefix=$HOME/geda if you wish ]
         make install
        
      You must build and install the packages in the following order:

         1. libgeda
         2. symbols
         3. gschem
         4. gnetlist
         5. gsymcheck
	 6. geda
         7. utils
         8. docs
         9. examples