--
-- RELEASE
--
-- release instructions.
--
-- Copyright (C) 2004, 2006, 2011 Stefan Jahn <stefan@lkcc.org>
--
-- This is free software; you can redistribute it and/or modify
-- it under the terms of the GNU General Public License as published by
-- the Free Software Foundation; either version 2, or (at your option)
-- any later version.
--
-- This software is distributed in the hope that it will be useful,
-- but WITHOUT ANY WARRANTY; without even the implied warranty of
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-- GNU General Public License for more details.
--
-- You should have received a copy of the GNU General Public License
-- along with this package; see the file COPYING.  If not, write to
-- the Free Software Foundation, Inc., 51 Franklin Street - Fifth Floor,
-- Boston, MA 02110-1301, USA.
--


Distribution process:
---------------------

* Ensure the release is complete.
  - Check the TODO, NEWS and BUGS files for pending or completed tasks.
  - Make sure INSTALL, THANKS and README files are up to date.

* Test build and packaging.
  - Maintainance currently requires the following software packages:
     + Autoconf version 2.57 (at least)
     + GNU automake 1.7.0 (at least)
     + Qt installation >= version 4.6 (by Digia)
  - Get latest `config.guess' and `config.sub' from GNU servers or run the
    command `automake -a -f -c' with latest automake version installed.
  - Run `make distclean', `sh autogen.sh' and `make all'.
  - Run `make distcheck'.
  - Check this status into GIT and tag it.

* Bump up version.
  - Add a ChangeLog entry in toplevel directory.
  - Add new section in NEWS.
  - Bump up version number in `configure.ac'.
  - Check into GIT.

* Distribute the package.
  - Upload the package to the SourceForge server and add a News item.
  - Announce the release at Freshmeat.
  - Send an announcement to <qucs-help@lists.sourceforge.net>.


Full distribution process:
--------------------------

Qucs is currently split into two packages, i.e. qucs (the GUI) and
qucs-core (the backend command line simulator).  In order to
distribute a complete package you need to run the distribution process
as described in both the RELEASE files up to the point where you have
the tarballs created using `make distcheck'.

* Ensure you hit the current requirements.
  - Autoconf version 2.57 (at least)
  - GNU automake 1.7.0 (at least)
  - flex 2.5.31 (but at least 2.5.9)
  - GNU Bison 2.6+
  - Qt installation >= version 4.6 (by Digia)

* Unpack the packages in a temporary directory.
  - mkdir /temporary-dir and cd /temporary-dir
  - tar xvzf qucs-<version>.tar.gz first and then `cd qucs-<version>'
  - tar xvzf qucs-core-<version>.tar.gz and `mv qucs-core-<version> qucs-core'

* Slightly modify and rebuild package.
  - Modify the lines marked with "release specific" in the `configure.ac'
    file.
  - Run `sh autogen.sh' first in the qucs-core directory and then in main
    directory.
  - Run `make all' and finally `make distcheck'.

* Distribute the package.
  - Upload the package to the SourceForge server and add a News item.
  - Announce the release at Freshmeat.
  - Send an announcement to <qucs-help@lists.sourceforge.net>.
