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

   General / Summary

	* The biggest change in this release is the addition of gtk+ 2.2.x
	  support.  Now you can build gEDA/gaf with either gtk+ 1.2.x or
	  gtk+ 2.2.x.  Some programs like setup and geda still require
	  gtk+ 1.2.x, but that will be fixed in a future release.
	  The original gtk+ 2.2.x patch was by Ye Ma (Thanks!).

	* Added --with-gtk12 commandline flag to all ./configure scripts
	  to force the use of gtk+ 1.2.x.  Just add this to the opt=
	  variable in the toplevel Makefile to force all of gEDA/gaf to
	  use gtk+ 1.2.x instead of gtk+ 2.2.x.  The default used gtk+
	  library if both 1.2.x and 2.2.x are installed is gtk+ 2.2.x.

	* In order support above, pkg-config is now REQUIRED to successfully
  	  ./configure the packages.  pkg-config is also required if you
	  are building/linking against gtk+ 1.2.x.   You can get pkg-config
    	  from either:
		http://www.geda.seul.org/dist
	  	or http://www.freedesktop.org/software/pkgconfig/

	* If you do not keep all of your packages installed in one
	  place or if it is not in a standard location (like
	  /usr/lib/pkgconfig), then you must tell pkg-config where
	  to look by using the PKG_CONFIG_PATH environment variable.
	  I keep all of my *.pc files in /usr/local/lib/pkgconfig,
	  so my PKG_CONFIG_PATH is set like this:

          export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
 
	* Rewrote and simplified all the ./configure.ac files.	Here are
	  the versions of the auto* tools I use:

		autoconf (GNU Autoconf) 2.54
		automake (GNU automake) 1.7.1
		ltmain.sh (GNU libtool) 1.4.2
		aclocal (GNU automake) 1.7.1
		gettext (GNU gettext) 0.11.5
		
	  If you use any other versions, good luck. :-)

   libgeda

	* Shared library version number now at 19.

	* Removed libgeda-config, replaced with libgeda.pc (pkg-config file).
	  In order for gschem and the other libgeda programs to find this
	  file during the ./configure stage, you must set the PKG_CONFIG_PATH
   	  environment variable to something like this:

          export PKG_CONFIG_PATH=$HOME/geda/lib/pkgconfig:$PKG_CONFIG_PATH

	  The settings for this variable is printed when you type 'make'
	  in the upper most directory (toplevel) where you untarred all
	  the source tarballs.

	* libgdgeda 2.0.15 is now required to build libgeda.

	* No significant code changes.

   gschem

	* Applied Carlos Nieves Onega's multi attribute patch.	With this
	  patch, the multi attribute add/edit dialog box behaves a lot
	  more intelligently when adding or changing attributes.  

	* Bunch of work to support both gtk+ 1.2.x and 2.2.x.  

	* Rewrote the exit dialog box to look better under both 1.2.x
	  and 2.2.x.  Quite a few of the dialog box look bad under
	  1.2.x, but look absolutely dreadful under 2.2.x, so they
	  will be recreated (and hopefully improved in the process)
	  in future releases.

   gnetlist

	* Applied Carlos Nieves Onega's commandline (-l filename) load
	  scheme patch.  The scheme code is loaded and executed from the
	  specified file before the backend is loaded.  

	* Added the -m commandline flag which allows scheme code to be 
	  loaded from a file after the backend is loaded but before it is
	  executed.

	* Integrated Carlos Nieves Onega's DRC2 backend.  

	* Applied Carlos Nieves Onega's warning cleanup patch. 

	* The required work to get gnetlist to work with both gtk+ 1.2.x and
	  2.2.x.
	
	* Added Bill Wilson's gnet-gsch2pcb backend.  

	* Applied Stuart Brorson's latest changes to the spice-sdb
	  netlister.  His changes included the -s command line flag
	  (sort output netlist) and the gnetlist:get-calling-flags as
	  well as improvements to the spice-sdb backend itself.

   gsymcheck

	* No significant changes other than the gtk+ 2.2.x support changes.

   symbols

	* Werner Hoch updated a bunch of symbols in various directories
	  including memory and 74.  

	* Removed gesym-config.  The new ./configure.ac files do not use
	  this file anymore.

	* Added a bunch of contributed symbols (not all though, some are 
	  still pending for various reasons).

	* The author= and email= attribute on five symbols have been 
	  merged into one (author=).

   geda (gManager)

	* No changes

   setup

	* No changes

   utils
	
	* Finally integrated Werner Hoch's tragesym 0.0.5 into the
	  utils package.  tragesym is a symbol creator for gEDA/gaf written
	  in python.

	* Applied patch by Holger Dietze to update gmk_sym to be current. 

	* Integrated Bill Wilson's gsch2pcb package.  
	  gsch2pcb is conceptually based on the gschem2pcb shell script
	  distributed with gnetlist, but additionally handles multiple
	  schematics, handles element file footprints, and removes pc
	  board elements corresponding to components deleted from the
	  schematics.  It also forward annotates component value changes

	* The necessary changes to support gtk+ 2.2.x.

	* Integrated pads backannotation script by Dan McMahill.
	  A perl program which implements backannotation from Pads
	  PowerPCB board layouts to gschem schematics.

   docs

	* Documented the merge of author= and email= (suggestion by 
	  Werner Hoch) 

	* Updated spice-sdb document with a the latest version from
	  Stuart Brorson.

	* Added Dan McMahill's documentation for the pads_backannotate
	  script.

   examples

	* No changes.


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


BUGS/ERRATA/LAST MINUTE ISSUES

	* I noticed that gschem's i18n support when using gtk+ 2.2.x
	  does not work 100%.  Please help me fix this.

	* I discovered several last minute (and fixed them) bugs right 	
  	  before I uploaded the code.  This means that there are probably
	  more bugs, probably caused by the new ./configure scripts.  

	* Several people have commented on some rather bizarre behavior
	  of the "Attributes/Autonumber text..." gschem menu command.
	  There are several bugs filed against this and it needs some
	  work.  Please use the external refdes_renum script instead
	  for the time being.

	* Many thanks to all who contributed to this release.

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


DOWNLOAD:

   http://www.geda.seul.org/source.html
   http://ftp.sunet.se/geda/source.html


 
SOURCE TARBALLS:

md5sum                           Name                              Size
-------------------------------- -------------------------------   ---- 
c92889f314669b454067c40852e896bd *Makefile			    28K
22c9cab31350835e3b857eaa2fb3629a *geda-20030901.tar.gz		   240K
16598ba4bab8ef49e74d9414f943ad28 *geda-docs-20030901.tar.gz	   660K
a8b8ec26e13384a8a4d00dc0a2ee8b69 *geda-examples-20030901.tar.gz    240K
1e33f3a3bcac190bf209af58c31ccf93 *geda-gnetlist-20030901.tar.gz	   260K
4e97993302e6b30835d997e179c0e145 *geda-gschem-20030901.tar.gz	  1352K
e841d4ba32d57593fc1f9ea09ff49dbd *geda-gsymcheck-20030901.tar.gz   108K
a77656b1549f2aa99fd1f4758d738b69 *geda-setup-20030901.tar.gz       296K
5d5c3d58ce99d233d662378bb6ba40cf *geda-symbols-20030901.tar.gz     508K
f0b1a682c6796b418c48e3a843ab0fb2 *geda-utils-20030901.tar.gz       196K
01f973c45b98c75d8d0620f4dd4dc33c *libgeda-20030901.tar.gz          832K
                                                                   ----
                                                          Total    ~5 Megs

REQUIRED LIBRARIES/PROGRAMS:

   Most can be found at: http://www.geda.seul.org/dist

   Required libraries:
   * guile 1.4.1 or 1.6.3  
   * Install either gtk+ 1.2.x or gtk+ 2.2.x 
     For version 20030901, setup and geda still require gtk+ 1.2.x

     gtk+ 1.2.x 
     --------------------
     glib ≥ 1.2.3     
     gtk+ ≥ 1.2.3    

     gtk+ 2.2.x
     --------------------
     glib ≥ 2.2.2
     atk ≥ 1.2.4
     pango ≥ 1.2.4
     gtk+ ≥ 2.2.2

   Required programs 
   * GNU gettext = 0.11.5  (0.10.35 will NOT work)
     There have been reports of GNU gettext ≥ 0.12.x NOT working.
   * pkg-config ≥ 0.15.0 
     NOTE: You MUST install pkg-config starting with version 20030901.

   Optional libraries 
   * LibStroke ≥ 0.5.1   
   * libgdgeda > 2.0.15  
     NOTE: You MUST install 2.0.15, 2.0.9 or earlier versions will not work.
   * 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, LD_LIBRARY_PATH, and
      PKG_CONFIG_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.
   NOTE: You need to update the setup/src/setup.cfg by replacing 20030525
         with 20030901 for this to work correctly.
   NOTE: make xinstall has not been tested with gtk+ 2.2.x.
  
   -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

e xinstall has not been tested with gtk+ 2.2.x. NOTE: make xinstall has not completely stablized, so you are better of using make install or doing the manual ./configure ; make install. UNDER DEVELOPMENT UNDER DEVELOPMENT UNDER DEVELOPMENT UNDER DEVELOPMENT