[Koha-cvs] CVS: koha/misc/release notes release_notes_191.txt,NONE,1.1 release_notes_192.txt,NONE,1.1 release_notes_193.txt,NONE,1.1 release_notes_200pre1.txt,NONE,1.1 release_notes_200pre2.txt,NONE,1.1 release_notes_200pre3.txt,NONE,1.1 release_notes_200pre4.txt,NONE,1.1 release_notes_200pre5.txt,NONE,1.1 release_notes_200RC1.txt,NONE,1.1 release_notes_200RC2.txt,NONE,1.1 release_notes_200RC3.txt,NONE,1.1 release_notes_200RC4.txt,NONE,1.1

[Paul POULAIN]

Update of /cvsroot/koha/koha/misc/release notes
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv30323/release notes

Added Files:
	release_notes_191.txt release_notes_192.txt 
	release_notes_193.txt release_notes_200pre1.txt 
	release_notes_200pre2.txt release_notes_200pre3.txt 
	release_notes_200pre4.txt release_notes_200pre5.txt 
	release_notes_200RC1.txt release_notes_200RC2.txt 
	release_notes_200RC3.txt release_notes_200RC4.txt 
Log Message:
moving release notes to specific directory

***** Bogus filespec: notes
--- NEW FILE ---
RELEASE NOTES
* standard acquisition and MARC cataloguing now both useable at the same time.
* MANY bugfixes.
* almost everything now templated. A few admin scripts still to template.
* inclusion of some  pictures to say "add", "modify", "delete" in many places.
* the koha-html cvs tree is now UNUSED, and no mode included in this release. the koha cvs project contains everything.

TODO
* z39.50 support. A port from the 1.2.x z39.50 support needs to be done. Should be quick,
* fixing bugs. If you find a bug in this version, please take the plane and go for a trip to : bugs.koha.org

FEATURE FREEZE
feature freeze is there... only z39.50 will be added until 2.0RC1, which should be the next release !

KNOWN BUGS *IMPORTANT* :
* koha does NOT work with MARC::Record 1.12. It works fine with MARC::Record 0.93, and maybe with other versions.
* repeted subfields in MARC/iso2709 works poorly : only the 1st subfield is stored, other are ignored. At least, the 1st is right ! (in the 1.9.0, the 1st was buggied by other subfields too)
* In the MARC search, the "not" flag does not work : the result of the query is very strange !
* en and fr are the only languages well supported in this version. Other translator teams are waiting for more stable templates :-)
--- NEW FILE ---
RELEASE NOTES
=============
* koha does NOT work with MARC::Record 1.12. It works fine with MARC::Record 0.93, and maybe with other versions.
* In the MARC search, the "not" flag does not work : the result of the query is very strange !
* en and fr are the only languages well supported in this version. Other translator teams are waiting for more stable templates.
* see interim.txt, which contains install notes

BUG FIXED (see bugs.koha.org for more infos)
=========
XXX Error in biblio modification
248 French page titles in English language Koha - Members
227 Confirm newmember lists items you can't enter
254 Next link goes to the wrong page
230 Wrong DOB entry information given in add member
234 The buildrelease script or the installer script does not kno
263 HLT isms still on Add Member page
278 Internal Server Error on Categories
249 Addl. French titles in English language Koha
228 Modifying member info scrambles DOB
255 Form fields too small for text
231 z3950servers.pl mistitled branches admin
260 Error during install - the sample data doesn't load,
235 Koha login link listed twice and I'm already logged in
266 HLT isms on member details page.
244 stats.pl needs to be templated
226 Bookfund admin page - rows not lining up under heading
250 Parameters titled Catalogue
229 Members birth years 1913 and earlier are changed to 2000's
257 Fields named wrong on modify budget page
233 OPAC - User update doesn't work.
262 Ethnicity select list still in add a member page
240 Search results page - has Log In to Koha link - already log
277 Internal Server Error in Add Institution and Add Child
291 Joining date dateformat not consistent
241 Extra td in html creates an extra little rectangle.
259 Enter stopwords field too long
290 Missing image seen briefly on log-in page.

IMPROVEMENTS
=============
* An About page has been added, showing versions of Koha, Apache, MySQL, Perl
* repetable subfields now correctly stored : enter a repeted subfield in the form, separated by | and watch the result in the catalogue.

Bugs still opens in bugs.koha.org
=======================
196 user input not checked for HTML tags
293 Error Issuing Book - 1
191 View Account cannot see charges
264 Day phone not output on confirm record.
208 Confirmation screen for addition of institutional member is
236 Reserve book on future date doesn't work or copy is wrong
242 Current loan output is blank
193 Multiple search criteria in OPAC gives misleading feedback
267 Day phone not displayed on update details
237 Can request to reserve a book with an end reserve date in t
130 Branch data entry form has unlabelled check box
258 Budget treats a comma as a period.
223 Editing budget creates additinal budget for same book fund.
239 Issue limit doesn't work - able to check out more items than
251 Wrong title for image
276 Tables overlap when there are a lot of patron notes.
297 Images missing on View Account page
252 Add category page titled add authorised value
245 No mechanism provided for changing the Locations
275 Wrong size text boxes in admin/itemtypes
300 Reading record - full output same as regular reading record
292 missing image is seen when mousing to the left of search.
298 In circulation Acquistion & MARC links are blue not grey
217 querying with barcode to modify biblio

TODO
=====
* script for migration from koha 1.2.x -> 2.0.0
* script to upload MARC datas and items in active DB
* script to upload CSV biblio and items in active DB
* z3950 client


--- NEW FILE ---
RELEASE NOTES
=============
This release add a lot of bugfixes, a 1st z3950 support, and a script for migration from previous ILS.

FEATURE FREEZE !
---------
This version is the last version with new features before 2.0.
Please, report bugs on bugs.koha.org, and feel free to fix them (through patch or cvs commit)


PACKAGE NEEDED :
---------
Update your MARC::Record to get the latest version (1.26).
Koha won't work with old versions, and bulkmarcimport.pl need MARC::Batch.pm, whichi is recent.
MARC::Record 1.25 works to, but reports hundred of warnings in error_log. pls upgrage to 1.26 !


DB modifications :
---------
* the marc_breeding table has been modified. A row "encoding" varchar(40) has been added. It's used to manage character encoding.
* the z3950_servers table has been modified. A row "syntax" varchar(40) has been added. It's used to manage character encoding.

z3950 :
---------
* the z3950 script in admin part of Koha has been fixed and can be used and translated.
* z3950 cataloguing : when you reach the MARC-cataloguing screen, a new link appear : z3950 search.
* If you click on this link, a popup appears, and the search begins. The window is refreshed every 2 seconds, until all servers answered.
* The avaible records are shown in the popup. Click on the one you want, and... the popup closes and the biblio is copied in the cataloguing screen.

This works ONLY IF the z3950 daemon is launched. It's located at $kohadir/scripts/z3950daemon/
* MODIFY the scripts to fit you directory structure.
* Warning : due to a small bug, processqueue is in $kohadir/cgi-bin/z3950/ directory, not in the script one.
* Start daemon in a non-X shell, or launch processqueue in a shell, and KEEP IT OPEN.

iso2709 file import :
---------
This tools is very important and was waiting by libraries that plans to migrate from a previous ILS.
VERY IMPORTANT :
BEFORE using this script, take care of your MARC parameters, and check them twice. If they are wrong, you will get wrong results...

It's located (in CVS tree) at $koharoot/misc/bulkmarcimport.pl

It loads an iso2709 file into the ACTIVE Database. My 1st tests on sample files shows it works quite fine.
Feel free to try it.
How it works ? enter ./bulkmarcimport in a console, and look.

KNOWN LIMIT : If the barcode of an item does not exists, the scripts report an SQL error, and continue. BUT the corresponding item is not in the non-marc db, so it can't be requested or loaned.

sample file :
---------
The sample file has been removed from this release, as it's buggy (no MARC datas, making it quite useless)

Templates & translations :
---------
* Most images have been dropped from templates (all -except bugs- in french templates
* english is uptodate, and french should be too.

BUG FIXED (see bugs.koha.org for more infos)
=========
A lot... (around 35).
Thanks to Mike that fixed a lot,
Steve that fixes some,
MJ Ray that upgraded the installer for non-root install,
and Chris that fixed some and begins backport of non-marc stuff from 1.2

Bugs still open in bugs.koha.org
=======================
A lot... (around 60. some being really trivial to fix, some being more important)

TODO
=====
* some GUI reordering, as planned with Rachel from Katipo and others (paul & others)
* finishing backport of non-marc cataloguing & non-marc simple acquisition from 1.2 version (chris)
* bug fixes (everybody)
* cleaning z3950 old searches (more than 1 hour/day old ?) (paul)


--- NEW FILE ---
RELEASE NOTES
=============
This release add many bugfixes, and some improvment in z3950 and repetable fields management.
It has been placed in the "unstable tree" because there are still some bugs.
But it's fully usable, and should not be modified a lot until a stable version is released.

PACKAGE NEEDED :
---------
Nothing new. Note MARC::Record has new releases, but older one (1.26) works fine.

DB modifications :
---------
* added field in aqbudget, primary key :
	aqbudgetid tinyint(4) NOT NULL auto_increment
  PRIMARY KEY  (aqbudgetid)
* added field in systempref :
	options text
* bibliothesaurus
	field father changed to char(80) (was bigint)
	added full text index : FULLTEXT KEY category_2 (category,freelib)


z3950 :
---------
* works on biblio adding & modifying
* works on ISBN, author, title, the 1st found being the one used.

various :
----------
* added subject and subtitle to MARC subfields mapped to Koha old-DB.
* reordered bookfunds/budget admin tools.

languages/languages :
-------------
DEFAULT template :
* english works.
* french should work, mostly. If you experiment some problems, test with english templates, and report the problem as general of french specific
NEW template :
a "unido" template is in this release. It's uncomplete, and based on vanilla template.

GUI reordering
------------------
* Some unused links have been dropped.
* a "submenu" shows some operation below main menu.
* the MARC link disappeared. It's managed by the MARC=ON/OFF systempref. (the breeding import is now in Parameters section)
* acquisition and cataloguing are now separated. acquisition=simple/normal in systempref and cataloguing is MARC/nonMARC depending on MARC=ON/OFF systempref.

Should be easier to understand.

Bugs still open in bugs.koha.org
=======================
always some, but less than in 1.9.3 (40 at this time. more than 20 of them are minor : spellcheck, image missing...)
Some of them (for more details, see http://bugs.koha.org) :
* 426 Reserving a book (with a reserve fee) results in a hostile message
* 452 Payment due flags not showing up for children
* 185 Barcode not auto-calculated when autobarcode is on
* 425 Add new website feature doesn't work
* 318 allow or not a book to be loan
* 236 Reserve book on future date doesn't work or copy is wrong
*
bugs not reported here are either unconfirmed, not understood, minor, or partially fixed.




Feel free to ask for bugfixes and new features in bugs.koha.org.
NOTE that NEW FEATURES or IMPROVEMENTS will only be for 2.0.1 unless it's a very trivial or blocking one.

TODO
=====
* bug fixes (everybody)
* cleaning z3950 old searches (more than 1 hour/day old ?) (paul)

--- NEW FILE ---
RELEASE NOTES
=============
Bugfixes & some improvements (security & perf only)
It has been placed in the "unstable tree" because there are still some bugs.
But it's fully usable, and should not be modified a lot until a stable version is released.

DB modifications :
---------
None, but check that your systempreferences table is :
CREATE TABLE systempreferences (
  variable varchar(50) NOT NULL default '',
  value varchar(200) default NULL,
  explanation varchar(200) NOT NULL default '',
  options text,
  type varchar(20) default NULL,
  PRIMARY KEY  (variable)
) PACK_KEYS=1;

If you installed a 2.0.0pre1 from scratch, it should be ok.
If your version was a 1.9.x, it should not be ok.

SYSTEMPREFS :
---------
In systempreferences, add a gist field. Used to calculate gst when ordering, in acquisition module. Enter 0.12 for 12% rate.

IMPROVMENTS :
---------
* checkmarc.pl : added a check on fields mapped to item marc tag (by Paul).
* overdue books backported from 1.2.x (& templated) (by Chris)
* some additionals check to verify a borrower can borrow a book (by Esiee)
* MARC search (in intranet) :
- dramaticaly improving the speed of a MARC search in case of a A OR B search (by Paul)
- Users can search using more than 3 criterias (criterias are now added dynamically) (by Esiee)
- Results can be displayed using 20,50 or 100 results per page. (by Esiee)
- Added arrows and numbers to walk through the results (as in OPAC) (by Esiee)

BUGS FIXED :
---------
* 2 stupids & majors bug in MARC editor, due to too fast copy/paste. (fixed by Paul)
* bug 479 : I have problem to assign a Sticky due date, it uses day date as year due date !!! (fixed by ?)
* bug 471 : missing next / previous in itemtype admin page, in case there is more than 20 itemtypes (fixed by Paul)
* bug 474 : alternate contact no more required (fixed by Paul)
* bug 478 : value modification with single quote now works (in parameters section) (fixed by Paul)
* bug 489 : poor file copying during install (fixed by MJR)
* bug 526 : gst rate hardcoded. Moved to systempref (see SYSTEMPREFS chapter). (fixed by Paul)
				If supplier parameters are set to do it, the gst are now auto calculated with javascript.
* bug 512 : bibliosubject table is not being populated (fixed by Paul)
* bug 513 : marclinks: default mapping typo (fixed by Paul)
* updatedatabase bugs : now, the updatedatabase script (located in scripts/updater) works and update your DB structure.
	note it only adds fields & tables. The MARC parameter tables won't be populated, neither the MARC-DB. (fixed by Paul)

KNOWN BUGS :
-------
* bug 510 : new doc needs to be integrated
* bug 487 : upgrade problem from a previous version. If you install from scratch, it should be fine.
* bug 515 : biblio.notes ignores Marclinks mapping durring import
* bug 293 : Error Issuing Book - 1 in some specific cases
* bug 523 : requests does not store dates in reserves table
plus some other, less critical.

--- NEW FILE ---
RELEASE NOTES
=============

This version of Koha is still in the "unstable" directory, because some bugs are still reported. But it's fully useable and used in (at least) 3 libraries in "real world" :
* Nelsonville Public Library, Ohio, USA
* Esiee, high school, France
* Dombes Abbey, France

The next version should/might be the 2.0.0RC1.
The only missing features are :
* a migration tool for libraries already using Koha1.2.x
* an automated upgrading tool for future version. It's possible to upgrade manually.

IMPROVEMENTS :
---------
* adding a demo setup : if you set "demo=1" in /etc/koha.conf, Koha is in "demo mode". In this mode, user can connect with "demo/demo", even if this user is not in members table.
He can do everything, except that any modif/add/delete done in systempref or marc structure is NOT saved in the DB. This avoid demo user breaking the demo config.
* adding javascript function to focus on 1st field for issues / returns. Thus, librarian don't need manual mouse focus & can scan barcode immediatly.
* authories/thesaurus management : adding the possibility to add an authority directly.

UPGRADING :
---------
People using a previous 2.0.0preX version can upgrade code and use the same DB, there's no DB change.
To upgrade mannually :
- mv /etc/koha.conf /etc/koha.conf_previous
- install in a new directory /var/www/html/koha_200pre3 for example.
- delete the 2.0.0pre3 DB
- modify /etc/koha.conf to point to 2.0.0pre3 DB
- modify httpd.conf to have Koha root directory pointing to 200pre3 install instead of 200pre2
- restart Apache.

Note : you can use the 2.0.0pre2 login/password.
If you do, mySQL may complaint about "already existing DB user". It's not a problem.

Note : you can also use "CVS symlink installation" of Koha if you prefer. See http://www.saas.nsw.edu.au/wiki/index.php?page=CVSSymLinkInstallation

BUGFIXES :
---------
(the bug number refers to bugzilla number. See bugs.koha.org)
512 : bibliosubject table is not being populated
564 : Member card number not checked unique
567 : classlist not filled in when using catalogue-home.pl
593 : data duplication in MARC-DB
562 : Returns not showing 'on reserve' message for holds
565 : item barcode not checked unique
516 : biblioitems.itemtype does not load
556 : OPAC subject search with class specified returns error
103 : Need additional Perl module checks in installer.pl
570 : Subject search returns duplicate results
493 : add member error
563 : Keyword search does not search author names
583 : values in marc_word table should have quotation marks, etc,
499 : Members display by letter
561 : Javascript link doesn't work
164 : Editing member details loses postal address
233 : OPAC - User update doesn't work.
525 : If itemtype is not set, we get a broken more detail page, We
129 : Choosing to install MARC tables gave errors
152 : Install.pm missing from main branch
363 : Searching on contains works only with full names.
553 : broken html (neither valid nor well-formed)
582 : Move error message contents out of newmember.pl
153 : opachtdocs and intrahtdocs in koha.conf not initialized
474 : Alternate contact should not be required
558 : Member search results table doesn't show alternating colors
542 : Move HTML out of itemtypes.pl
490 : Poor display
558 : Member search results table doesn't show alternating colors
548 : Spelling of Catalog/Catalogue
547/546 : some improvements in koha docs (located at docs/kohadoc.sgml)
540 : Missing requests.gif or equivalent
XXX : Many french translation improvements.
XXX : some installer improvments.
XXX : fix for publicationyear : extracting numeric value from MARC string, like for copyrightdate.
XXX : fixing font size bug, & minor change in submenu look.
XXX : modifying MARC21 default setup : using Nelsonville setup, that is working. User just need to define  itemtypes.
XXX : fixing small bug : escaping twice the ' in title & author.

(XXX : bugfixes not in bugs.koha.org)
--- NEW FILE ---
RELEASE NOTES
=============

This version of Koha is still in the "unstable" directory, because some bugs are still reported. But it's fully useable and used in (at least) 4 libraries in "real world" :
* Nelsonville Public Library, Ohio, USA
* Esiee, high school, France
* Dombes Abbey, France
* Wesford school, France

This release fixes a few bugs, and MANY french translation fixes/improvements.

BUGFIXES/IMPROVEMENTS
---------
* new script : koha/koha/misc/overduenotices.pl
   This is a script for the use of printing, and emailing overdue notices.
   The script must be run from the command line
   Documentation is contained in the script
* fix for bug 603 : patron searches are wonky when first letter of first and last name are the same
* removing trailing "," in subject.
* fixing some bugs in charges.pl, script that fills the categoryitem table.
   The categoryitem table contains fines for every itemtype-borrowercategory.
   Still has to be templated and added to admin part of Koha
* notforloan bug fix : now, if a specific item is "notforloan" and the itemtype "forloan", the "notforloan" is used. Before this fix, it was overwritted by the itemtype info/
* fixing a bug that deleted the MARC part of a biblio when using full acqui system.
   Now, when you acquire a book through full acqui system, what you enter during acqui appears in the right MARC fields in MARC editor.

FRENCH SPECIFIC
---------
More than 30 improvements/bugfixes in french templates.

--- NEW FILE ---
RELEASE NOTES
=============
this version of Koha is the last one of the 2.0.0 series in the "unstable" tree.
5 libraries are using it, so it's quite useable.
2 last problems have to be solved before 2.0.0RC1 :
* biblio deletion : at the moment, biblio deletion is buggy (does not work in MARC, delete only non-marc data)
* upgrader is provided for the 1st time, so it's probably buggy.

If you want to use Koha, you're welcomed, but you're warned that this version still has some bugs and missing features.

INSTALLATION
==========
* Download the package
* tar xvfz koha-version.tar.gz
* cd koha-version
* ./installer.pl
* follow the instructions.

NOTE: You will need to add lines to your main httpd.conf to include
/etc/koha-httpd.conf and to make sure it is listening on the right ports
(using the Listen directive). Previous versions updated the httpd.conf file,
some users thought it was bad/poor decision.


UPGRADE from previous 2.0.0preX version
=======
* Download the package
* tar xvfz koha-version.tar.gz
* cd koha-version
* ./koha.upgrade
* follow the instructions.

UPGRADE from previous 1.2.x version
=======
This upgrade is possible with this release for the 1st time.
EXPECT IT TO HAVE SOME BUGS SOMEWHERE.
USE IT ONLY IF YOU KNOW HOW TO GO BACK TO PREVIOUS SITUATION.
Otherwise, WAIT for next version or so.
* Download the package
* tar xvfz koha-version.tar.gz
* cd koha-version
* ./koha.upgrade
* follow the instructions.
* launch Koha
* Go to Parameters >> Marc structure option and Koha-MARC links option.
* Modify default MARC structure to fit your needs.
* open a console/term
* Enter :
cd /path/to/koha/misc
export PERL5LIB=/path/to/koha
./koha2marc.pl
the old DB is "copied" in the new MARC one.
Koha 2.0.0 is ready.

BUGFIXES/IMPROVEMENTS
=======
BUGS FIXED :
+++++++++
619 : Visiting selectbranchprinter.pl automatically resets branch
618 : Add member process does not check for duplicate barcode
532 : Can't assign new password without changing UserID
599 : edited items are stored incorrectly in old Koha DB (aka : barcode non mandatory bug)
616 : MARCgetbiblio doesn't create leader
500 : [INTRANET]Only 21 items are displayed in the search result
595 : 'Add field' link in /acqui.simple/addbiblio.pl adds incorrect field.
622 : processz3950queue fails
576 : add install locale test
39 : Update Dirs in z3950 scripts
536 : bulkmarcimport.pl generates subtitle error
436 : circulation.pl only partially templated (this bug is partially fixed)

IMPROVEMENTS
+++++++++
* Polish version of Koha (courtesy of Benedykt)
* some useful tools in misc directory to manage the DB
* adding "fines" entry in parameters section : to manage fees when a book is returned too late

--- NEW FILE ---
RELEASE NOTES
=============
This version of Koha is the first in the 2.0 "stable" series.
It does not mean that it has no bugs, but least five libraries are using it and don't encounter impossible problems.
If you want to adopt Koha, please do, but you're warned that this release candidate version may still have some bugs and missing features. If you test it and let us know about any we haven't seen yet, it will help us to fix them.


INSTALLATION

* Download the package
* tar xvfz koha-version.tar.gz
* cd koha-version
* ./installer.pl
* Follow the instructions


UPGRADE from previous 2.0.0preX version

* Download the package
* tar xvfz koha-version.tar.gz
* cd koha-version
* ./koha.upgrade
* Follow the instructions


UPGRADE from previous 1.2.x version

This is the first koha 2 version that contains this upgrade.
It may have bugs. Please take backups and be sure that you can go back to your previous version if needed.
Otherwise, WAIT for 2.0.0RC2 or later.

* Download the package
* tar xvfz koha-version.tar.gz
* cd koha-version
* ./koha.upgrade
* Follow the instructions
* Open a browser to Koha
* Go to Parameters >> Marc structure option and Koha-MARC links option.
* Modify default MARC structure to fit your needs
* Open a command-line on the koha server
* Enter :
cd /path/to/koha/misc
export PERL5LIB=/path/to/koha/modules
./koha2marc.pl
This "copies" the old DB to the new MARC one.
Now Koha 2.0.0RC1 is ready for you to test.


BUGFIXES/IMPROVEMENTS

BUGS FIXED:
* biblio deletion now works in MARC & non MARC tables as well. tools for deletion added in MARCeditor (biblio & item deletion)
* bug in circulation that breaked the 1st circ screen
* biblio subject adding  when more than 1 subject.
* bibliothesaurus : a fulltext index was missing. The updatedatabase script now creates it.
* 621 ; Returns not marking reserves waiting
* 649 : french word in english template
* 639 : unclosed <form> & other HTML error
* 592 : Re-issuing book does not renew correctly
* 654 : missing image
* 535 : major display problem with issues
* 678 : odd case usage in opac
* 634 : MARC21/USMARC confusion
* 385 : crash when trying to open an empty MARC::Record
* 564 : duplicate member number

IMPROVEMENTS:
* removing some unused code
* improved polish version
* improved installer & updater for non "standard" locations (/etc...)
* adding the classification column to the variables available to the template
* new plugin for unimarc, for field 60X.


DB change :
* fulltext index added in bibliothesaurus.
* added missing columns in deletedXXX tables

KNOWN BUGS :
* some bugs in circulation : english-only messages, errors issuing books, or returning books with reserves, cancelling reserves.
Note that those bugs doesn't appear everytime (they need specific circumstances it seems).
* MARC upload fails silently (in breeding farm)
* autobarcode not calculated even if autobarcode system parameter is set.
* the MARC21 english default parameter setup is working, but some librarians reports that some choices are poor. If you use MARC21, tweak some setups to fit your needs.

--- NEW FILE ---
RELEASE NOTES
=============
This version of Koha is the second in the 2.0 "stable" series.
It does not mean that it has no bugs, but many libraries are using it and don't encounter unsolvable problems.
If you want to adopt Koha, please do, but you're warned that this release candidate version may still have some bugs and missing features.
If you test it and let us know about any we haven't seen yet, it will help us to fix them.

The 2.0.x series version is "feature freezed". Only bugs or minor changes will be made in this branch.
The koha team is already working on the 2.2.x version. In CVS (HEAD branch), developpers can already get 1st draft of a working z3950 server.


INSTALLATION

* Download the package
* tar xvfz koha-version.tar.gz
* cd koha-version
* ./installer.pl
* Follow the instructions


UPGRADE from previous 2.0.0preX version

* Download the package
* tar xvfz koha-version.tar.gz
* cd koha-version
* ./koha.upgrade
* Follow the instructions


UPGRADE from previous 1.2.x version

This is the second koha 2 version that contains this upgrade. Nobody reported a problem during update with 2.0.0RC1.
It may have bugs. Please take backups and be sure that you can go back to your previous version if needed.
Otherwise, WAIT for 2.0.0RC3 or later.

* Download the package
* tar xvfz koha-version.tar.gz
* cd koha-version
* ./koha.upgrade
* Follow the instructions
* Open a browser to Koha
* Go to Parameters >> Marc structure option and Koha-MARC links option.
* Modify default MARC structure to fit your needs
* Open a command-line on the koha server
* Enter :
cd /path/to/koha/misc
export PERL5LIB=/path/to/koha/modules
./koha2marc.pl
This "copies" the old DB to the new MARC one.
Now Koha 2.0.0RC2 is ready for you to test.


BUGFIXES/IMPROVEMENTS

BUGS FIXED:
* 318 : allow or not a book to be loan
* 537 : in borrower screen, the "fine & debts" now shows only amount due if >0, "nothing due" if borrower has no debts.
* 557 : spelling error in message for no search criteria entered
* 564 : Member card number not checked unique
* 586 : additem.tmpl displays incorrect biblio number
* 605 : circulation.pl only shows one waiting item (1 small problem remaining, see bugs.koha.org)
* 614 : opac-user.pl doesn't show which items are waiting
* 625 : dateformat under system prefs is confusing
* 646 : Member flag must be either 'parameters' or 'superlibrarian' to log in (now, any flag enable login)
* 662 : poor SQL calls, that could be used for SQL injection (security problem)
* 671 : Add institutional member confirmation screen has no details
* 672 : readingrec can not be reordered
* 675 : "logged in" info missing
* 683 : Search for barcode or illustrator says ' You did not specify any seach criteria'
* minor HTML modifs & tweaks
* minor improvements/bugfixes in installer
* biblio & item deletion bugs fixed.
* bug fixed in MARC editor, that appeared on specific MARC configuration & makes biblio adding impossible.


IMPROVEMENTS:
* z3950 client daemon improved a lot : many deadlock situations solved, improved problem reporting, ignoring invalid z3950 servers (or server not responding)
* new french translation. Note that only english and french are up to date. Other won't work, probably. Note also that a tool for translator is now ready, and should ease a lot translating and maintaining translations.
* new OPAC theme. it's called "css". It's a XHTML1.0 strict OPAC. In librarian interface, just change systempref opactheme to css to get it. Will be the default opac in 2.2
* publisher added in acquisition process (the one with basket & supplier) Basket now ordered by publisher.
* notforloan field management added in itemtype administration screen
* new migration script : misc/rebuildthesaurus.pl => this script can rebuild thesaurus/authority file after importing records with misc/bulkmarcimport.pl

DB change :
*index added into z3950results table UNIQUE KEY query_server (queryid,server)  (added by installer & updater)

KNOWN BUGS :
* MARC upload fails silently (in breeding farm) if the file provided is not iso2709 (works fine with a valid file)
* autobarcode not calculated even if autobarcode system parameter is set and MARC=on.
* the MARC21 english default parameter setup is working, but some librarians reports that some choices are poor. If you use MARC21, tweak some setups to fit your needs.

--- NEW FILE ---
RELEASE NOTES
=============
This version of Koha is the 3rd in the 2.0 "stable" series.
It does not mean that it has no bugs, but many libraries are using it and don't encounter unsolvable problems.
If you want to adopt Koha, please do, but you're warned that this release candidate version may still have some bugs and missing features.
If you test it and let us know about any we haven't seen yet, it will help us to fix them.

The 2.0.x series version is "feature freezed". Only bugs or minor changes will be made in this branch.
The koha team is already working on the 2.2.x version. In CVS (HEAD branch), developpers can already get 1st draft of a working z3950 server.


INSTALLATION

* Download the package
* tar xvfz koha-version.tar.gz
* cd koha-version
* ./installer.pl
* Follow the instructions


UPGRADE from previous 2.0.0preX version

* Download the package
* tar xvfz koha-version.tar.gz
* cd koha-version
* ./koha.upgrade
* Follow the instructions


UPGRADE from previous 1.2.x version

This is the second koha 2 version that contains this upgrade. Nobody reported a problem during update with 2.0.0RC1.
It may have bugs. Please take backups and be sure that you can go back to your previous version if needed.
Otherwise, WAIT for 2.0.0RC3 or later.

* Download the package
* tar xvfz koha-version.tar.gz
* cd koha-version
* ./koha.upgrade
* Follow the instructions
* Open a browser to Koha
* Go to Parameters >> Marc structure option and Koha-MARC links option.
* Modify default MARC structure to fit your needs
* Open a command-line on the koha server
* Enter :
cd /path/to/koha/misc
export PERL5LIB=/path/to/koha/modules
./koha2marc.pl
This "copies" the old DB to the new MARC one.
Now Koha 2.0.0RC2 is ready for you to test.


BUGFIXES/IMPROVEMENTS

BUGS FIXED since 2.0.0RC2 :
* LOT of bugs in french translation
* fixed bug in z3950 client daemon that makes "mySQL connection lost during query".
* 605 : circulation.pl only shows one waiting item
* 293 : Error Issuing Book  - 1
IMPROVEMENTS since 2.0.0RC2 :
NONE

BUGS FIXED in RC2 :
* 318 : allow or not a book to be loan
* 537 : in borrower screen, the "fine & debts" now shows only amount due if >0, "nothing due" if borrower has no debts.
* 557 : spelling error in message for no search criteria entered
* 564 : Member card number not checked unique
* 586 : additem.tmpl displays incorrect biblio number
* 605 : circulation.pl only shows one waiting item (1 small problem remaining, see bugs.koha.org)
* 614 : opac-user.pl doesn't show which items are waiting
* 625 : dateformat under system prefs is confusing
* 646 : Member flag must be either 'parameters' or 'superlibrarian' to log in (now, any flag enable login)
* 662 : poor SQL calls, that could be used for SQL injection (security problem)
* 671 : Add institutional member confirmation screen has no details
* 672 : readingrec can not be reordered
* 675 : "logged in" info missing
* 683 : Search for barcode or illustrator says ' You did not specify any seach criteria'
* minor HTML modifs & tweaks
* minor improvements/bugfixes in installer
* biblio & item deletion bugs fixed.
* bug fixed in MARC editor, that appeared on specific MARC configuration & makes biblio adding impossible.


IMPROVEMENTS in RC2:
* z3950 client daemon improved a lot : many deadlock situations solved, improved problem reporting, ignoring invalid z3950 servers (or server not responding)
* new french translation. Note that only english and french are up to date. Other won't work, probably. Note also that a tool for translator is now ready, and should ease a lot translating and maintaining translations.
* new OPAC theme. it's called "css". It's a XHTML1.0 strict OPAC. In librarian interface, just change systempref opactheme to css to get it. Will be the default opac in 2.2
* publisher added in acquisition process (the one with basket & supplier) Basket now ordered by publisher.
* notforloan field management added in itemtype administration screen
* new migration script : misc/rebuildthesaurus.pl => this script can rebuild thesaurus/authority file after importing records with misc/bulkmarcimport.pl

DB change in RC2:
*index added into z3950results table UNIQUE KEY query_server (queryid,server)  (added by installer & updater)

--- NEW FILE ---
RELEASE NOTES
=============
This version of Koha is the 4rd in the 2.0 "stable" series.
It does not mean that it has no bugs, but many libraries are using it and don't encounter unsolvable problems.
If you want to adopt Koha, please do, but you're warned that this release candidate version may still have some bugs and missing features.
If you test it and let us know about any we haven't seen yet, it will help us to fix them.

INSTALLATION

* Download the package
* tar xvfz koha-version.tar.gz
* cd koha-version
* ./installer.pl
* Follow the instructions


UPGRADE from previous 2.0.0preX or RCx version

* Download the package
* tar xvfz koha-version.tar.gz
* cd koha-version
* ./koha.upgrade
* Follow the instructions


UPGRADE from previous 1.2.x version

This is the second koha 2 version that contains this upgrade. Nobody reported a problem during update with 2.0.0RC1.
It may have bugs. Please take backups and be sure that you can go back to your previous version if needed.
Otherwise, wait for next version.

* Download the package
* tar xvfz koha-version.tar.gz
* cd koha-version
* ./koha.upgrade
* Follow the instructions
* Open a browser to Koha
* Go to Parameters >> Marc structure option and Koha-MARC links option.
* Modify default MARC structure to fit your needs
* Open a command-line on the koha server
* Enter :
cd /path/to/koha/misc
export PERL5LIB=/path/to/koha/modules
./koha2marc.pl
This "copies" the old DB to the new MARC one.
Now Koha 2.0.0RC4 is ready for you to test.

BUGFIXES/IMPROVEMENTS:

BUGS FIXED:
major :
* #293 : Error Issuing Book  - 1 (a very old one...)
* #605 : circulation.pl only shows one waiting item
* #661 : Set three variables for the circ template: gna, lost, and dbarred
* biblio deletion : in some cases, the biblio deletion was done on another biblio than the one asked.
* indicators where stored but not displayed in MARC editor/viewer.
* book shelves work again (note bookshelves are not avaible in OPAC. they will be added in 2.2.0)
minor :
* it's now impossible to create a basket for an inactive supplier (it's of course possible to change supplier datas and recieve a past order)
* removing "bulk", useless field, in admin/categorie.pl list (NOT in DB, in case someone uses the field)
* removing forced order in admin/thesaurus.pl => mySQL returns datas ordered by relevance in fulltext index if you don't force an order.
* Next borrower didn't work in circulation.pl (didn't return to borrower form)
* in circulation.pl, removing <br> to have all informations without sidebar on a 1024x768 screen.
* in circulation.pl, ODUES are in red in borrower header
* quoting correctly titles with a " inside, in MARC editor

IMPROVEMENTS:
* Minor translation & HTML fixes.
* Adding >>> in biblio editor to change tab.
* Adding a "print" link in MARCbiblio : popup a small windows, print the biblio, and closes. Nice for libraries still having a paper catalog.