WHAT'S THIS ?

   This is a core database and software for birdwatchers and ornithologists
   to develop software, data and knowledge.  Well... er... a starting point
   indeed for that and much more (I hope).


HISTORY

   V0.3.1-dev: translated scripts for PostgrSQL support.
   V0.3.0-dev: created new tables (eubirdb_species, eubirdb_families) out
   of existing data (eubirdb_species and eubirdb_euring2000 respectively)
   and updated script check.mysql

   V0.2.0-alpha: Existing code (see V0.1.0) has been ported, rearranged for
   new data format and (hopefully;-) improoved.  The cross-reference table
   is still the data in use. PHP is the only language binding available as now
   and a properly configured web server is required for PHP execution.

   V0.1.0-alpha: This is the first public (GPL) code & data release.
   A dated prototype software has been running for years at
   http://www.franzoni.info/mauro/dbird (pages are in italian only,
   formerly hosted on other domains) using data collected, edited,
   updated for over 10 yeas.


COPYING

   This is free software, and you are welcome to redistribute it
   under certain conditions; see the file COPYING for details.

   This software is OSI Certified Open Source Software.
   OSI Certified is a certification mark of the Open Source Initiative.

   You may want to check http://www.franzoni.info/open for up to date
   version.


   COPYRIGHT NOTICE: The following copyright notice is reported in the document:
      "EURING exchanges-code 2000"
      Speek, G., Clark, J.A., Rohde, Z., Wassenaar, R.D. & Van Noordwijk, A.J. 
      Heteren, the Netherlands
      Vogeltrekstation Arnhem
      Dutch Ringing Centre
      Sep 23, 2003
   
      (C) Copyright EURING. All rights reserved. No part of this publication may
      be reproduced (or stored in a retrieval system, or transmitted in any form
      or by any means) for commercial use, without the prior written permission
      of the copyright owner. When using this copyrighted file, which we
      promote, see to the proper citation, and please send EURING a copy of your
      publication.

      Since the the EURING code and listing has been extracted from the just
      above mentioned document and used in this product as database index and
      to rewiew existing data, both the GPL and EURING's copyrights applies.
      In doubt, the strictest rules apply.

      See the file EURINGCOPY for details.
      

INSTALLATION

   Development files are available in the CVS tree on sourceforge
   ( http://sourceforge.net/cvs/?group_id=111894 ).
   Check out the files with your own CVS client to a directory configured
   in your web server.

   If you got the tarball distribution, extract the content to a directory
   configured in your web server. Check the project pages on sourcefoge for
   latest available version.

   Run the database/setup.mysql script (through a mysql client)
   WARNING: The database/setup.mysql WILL DROP any existing eubirdb database:
   please BACKUP YOUR DATA BEFORE RUNNING THE SCRIPT !!!

   Rename the php/inc/database.php_DIST file to php/inc/database.php (if you
   don't already have your own copy from a previous version) and edit it
   as required.

   At last access the php/index.php file through your web browser to see
   how it works (both index.html or index.php at the top level of installation
   will redirect to php/index.php).


TODO

   - The check.mysql script can't check for record present in just one source
     create a (php) script to replace it (EURING vs crosslist)
   - Translate eubird_families
   - Localization
   - Implementation of WySQL for dbms access
   - Arrange definitive tables and indexes from the cross-reference table.
   - Adjust code for definitive data format.
   - Add advanced search (with regular expressions)
   - Add bindigs for other languages / interface
   - Photo databank
   - PDA version (wouldn't a checklist be useful while birdwatching ?)
   - Too many other things to list in this file ;-)))) :-(


BUGS

    Please report any bug to the address below.  Suggestions are also
    welcome.

    No known bugs so far :-)


CONTACT INFO:

    Mauro Franzoni
    Via Torbole 1
    I-21100 VARESE
    ITALY

    e-mail: info@franzoni.info
    http://www.franzoni.info/open