[Koha-cvs] CVS: koha/misc/release notes release_notes_213.txt,NONE,1.1 release_notes_22RC1.txt,NONE,1.1

[Paul POULAIN]

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

Added Files:
        release_notes_213.txt release_notes_22RC1.txt 
Log Message:
release notes

***** Bogus filespec: notes
--- NEW FILE ---
RELEASE NOTES
=============
(HELP NEEDED chapter at the end of document)

ROADMAP : 
A roadmap for Koha 2.2 is available here :
http://www.saas.nsw.edu.au/koha_wiki/index.php?page=KohaRoadmap


This is the 4nd UNSTABLE VERSION of the future Koha 2.2.
Please install this version only if you want to test and give some help to the 
team that develops this software.
NEVER, NEVER, NEVER use it on a production machine.

WARNING : 
* This version is ONLY available in ENGLISH. biblio frameworks are only 
available in UNIMARC - french.
* This version is tested only with mozilla. Should work (partially) with IE.
* Any 2.1.0 install must be uninstalled before installing 2.1.3 No update is 
provided for 2.1.0.

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 :
UPGRADE TO A 2.0.0 version before upgrading to 2.1.3
This will be mandatory for the 2.2 official release.

UPDATE from a 2.1.x version is NOT AVAILABLE. Don't install 2.1.3 on a 2.1.x 
test database. A lot of DB changes have been done since 2.1.x & could not be 
handled by the DB updater.

============
WHAT'S NEW
============
* A lot of bugfixes. The list is too long to be done.
* adding possibility to order orders by publisher and/or budget/publisher
* adding search history feature in orders
* adding minor features to barcode generator :
        - possibility to print continuous barcodes numbers, but not from items 
        - possibility to replace the title/author by a manually typed text 
under the barcode itself.
* The borrowernote field is shown on issue and transfer
* The textmessaging field appears in OPAC when the user logs in
* When a field is repeated, the new field is now created after the existing one
* a plugin has been added for UNIMARC for 210c (editor) and 225a (collection)
- create a authority category called "EDITORS"
- set :
200$a => ISBN
200$b => editor
200$c => (repeatable) collection.

Then enter, for example :
$a 23
$b Hachette Litterature
$c collection1|collection2|collection3

map your "editor" field to plugin 210c, your "collection" field to plugin 225a
Once you arrive on the editor field, if the beginning of the ISBN exists, the 
editor is automatically found.
Once you arrive on collection field, click on ... you can choose in the 
collection list.

The 210c / 225a comes from the UNIMARC editor/collection field, but should work 
as well with MARC21.

===========
WHAT'S NEXT
===========
This version is quite stable. The next one should be called "2.2.0RC1".
It still requires some work in LDAP handling.
--- NEW FILE ---
RELEASE NOTES
=============

Welcome to the 1st Release Candidate of the 2.2 version of Koha.
Koha is the 1st Open-Source Integrated Library System.
Released at first in New zealand, in 2000 januaray, it is maintained by a team 
of volunteers from around the globe, the Koha system is a full catalogue, opac, 
circulation and acquisitions system.

Koha 2.2 is more than 247 000 lines of code, developped by more than 30 
differents developpers (excluding translators !).

With the 2.2 version, Koha is now a mature product, with a lot of nice 
features. It's used in more than 50 libraries, from all kinds (public, schools, 
search, religious...), of all size (from 1 to 8 branches, from 1000 to 300 000 
items).

========
WARNING
========
* This version is in the stable tree of Koha, but still evaluated as "Release 
Candidate". A few bugs are still known or have to be found, maybe by you. But 
it's stable enough to be used in production.
* This version is ONLY available in ENGLISH and FRENCH. Many languages to come.
* Biblio frameworks :
  - In UNIMARC - french. Frameworks are defined and can be set up during 
installation for : old documents, cartographies, electronic documents, 
microfilms, monographies, serials, films and images, "tire à part"
  - In English, only a default framework is provided. If you define specific 
frameworks, mail paul _at_ koha-fr.org or a koha mailing list to know how to 
add them to official release.
* the librarian interface is tested only with mozilla/firefox. Should work 
(partially) with IE. OPAC should work fine with any navigator.
* Any 2.1.x install must be uninstalled before installing 2.2.0 No update is 
provided for 2.1.0.

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

READING what is on screen during installation is VERY important. Some decisions 
you make during install stage are very hard to reproduce after.


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 :
********
UPGRADE TO A 2.0.0 version before upgrading

UPGRADE from a 2.1.x version is NOT AVAILABLE. Don't install 2.2 on a 2.1.x 
test database. A lot of DB changes have been done since 2.1.x & cannot be 
handled by the DB updater.

=============
NEW FEATURES
=============
Koha 2.2 has, of course, all the previous features from Koha (acquisition, 
cataloguing, circulation, members modules, OPAC, complete MARC support...) plus 
the following new ones :

General :
*********
* (almost) complete rewrite of librarian GUI : now Koha uses CSS, and is easier 
to use. However, users of Koha 2.0.0 won't be lost, as the general organisation 
of the product has not changed.
* Online Help : an online help is available everywhere in the librarian 
interface. It's complete in the parameters section of Koha and for new 
features. It will be completed for the rest of the product.
* Better LDAP suport : Koha 2.2 can be "connected" to a LDAP server and get all 
borrower informations from there (including borrower category where 
applicable). However, to avoid problems for libraries without LDAP server, the 
LDAP features have been stored in modules/C4/Auth_with_ldap.pm file. The 
standard Auth.pm don't use it. If you want LDAP, just perldoc Auth_with_ldap.pm 
and manually tune your Auth package !

Acquisition :
*************
* suggestion : borrowers can suggest items to buy in OPAC. Then, the librarian 
can manage (accept or refuse) and order them.
* possibility to close a basket, he can't be modified then
* order a basket by publisher or by bookfund/publisher
* search order history

Cataloguing :
*************
* Cataloguing frameworks : you can define as many frameworks as you want. A 
framework describes how a material is catalogued (which fields, subfields, 
which constraints on them...)
* MARC authorities : Koha now supports authorities in MARC. You can define the 
MARC structure for authorities like for biblios.
* New contraints can be set for subfields :
  - subfield is hidden : appears in MARC editor, but not in OPAC.
  - subfield is an URL : the field can be cliqued
  - related fields : a search made on a subfield also uses other subfields 
automatically. Using this feature, a search on "title" can search title, but 
also subtitle, uniform title,...
* Item location can now be done on 3 levels : the branch, the location (room), 
the callnumber.
* The callnumber can now be calculated from the LC, the dewey, or be freely 
(and manually) entered.
* Duplicate finder : this powerful feature help your cataloguers avoiding 
duplicate biblios.
* ISBD view : in librarian interface as well as in OPAC biblios can be shown in 
standard (default) presentation, in MARC (human readable) or ISBD. The ISBD 
view can be tuned by the librarian team.

Serial cataloguing :
********************
Koha 2.2 manage serial subscriptions and issuing of those subscriptions.

Catalogue search :
******************
* Search in OPAC and librarian interface has been improved. They now are 
exactly the same.
* Spelling suggestion : before sending a request, the user can ask for spelling 
suggestion. This shows other forms of words entered that would give results.
* The user can select the order of the results

Circulation :
*************
* New issuing rules : Issuing can be set for branch / borrower type / item 
category, by number of days and number of items available.
* "joker" issuing rules : the library can set issuing rules for "any branch" or 
"any borrower type", or "any item category".
Both issuing rules are cumulative : a library can set issuing rules to 10 
books, 5 CD, but 12 total (books or CD).

OPAC :
******
In Koha 2.2, koha has :
* baskets. A basket can be printed or sent by mail to the borrower
* virtual shelves : a virtual shelf can be created and filled by any logged 
borrower. A given virtual shelf can be private or public. Or even free-for-all.
* language chooser : the borrower can change the language on the fly. The 
default language being still choosen by the library

Barcode printing :
******************
A new module has been added to the parameters section : barcode printing. It 
requires the PDF::Api2 Perl package and can print barcode on 

============
KNOWN BUGS
============
* bug with biblio management for libraries with MARC=OFF systempreference
* modifying an order seems to duplicate the order line
* french OPAC is OK, french librarian interface seems to be a little buggy.

============
Koha Future
============
The future of Koha is being discussed on mailing lists and on koha wiki : 
http://www.saas.nsw.edu.au/koha_wiki/index.php?page=KohaRoadmap2.2.x