Release notes for Koha 3.2.0

Signed-off-by: Galen Charlton <gmcharlt@gmail.com>

misc/release_notes/release_notes_3_2_0.txt

@@ -1,100 +1,295 @@
-RELEASE NOTES FOR KOHA 3.2.0
+RELEASE NOTES FOR KOHA 3.2.0 - 22 October 2010
 ========================================================================
 
-New features
+Koha is the first free and open source software library automation package 
+(ILS). Development is sponsored by libraries of varying types and sizes, 
+volunteers, and support companies from around the world.  
+The website for the Koha project is 
+
+    http://koha-community.org/
+
+Koha 3.2.0 can be downloaded from:
+
+    http://download.koha-community.org/koha-3.02.00.tar.gz
+
+Installation instructions can be found at:
+
+    http://wiki.koha-community.org/wiki/Installation_Documentation
+
+Koha 3.2.0 is a major feature release.
+
+New features in 3.2.0
 ======================
 
   ACQUISITIONS
-    * the acquisitions module has been significantly revamped:
+    * The acquisitions module is significantly revamped:
-      * support for hierarchical funds and budgets
+      * Support for hierarchical funds and budgets
-      * budget planning by calendar and item type
+      * Budget planning by calendar and item type
-      * vendor contract periods
+      * Vendor contract periods
+      * Generation of PDF purchase orders
+      * Ability to place orders on a batch of bibliographic
+        records imported into the catalog from a file or Z39.50 search
 
   ADMINISTRATION
-    * significant usability enhancements to the system preferences
+    * Significant usability enhancements to the system preferences
       editor
-    * many additional granular permissions
+    * Granular permissions are now always on; the GranularPermissions
+      system preference is consequently removed
+    * Many additional granular permissions are added
 
   CATALOGING
-    * bulk item editing
+    * Bulk item editing
-    * revamped inventory/stock-taking
+    * Revamped inventory/stock-taking
-    * ability to export bibliographic information in CSV format
+    * Ability to export bibliographic information in CSV format
       from the staff cart
-    * new quick spine lable print button
+    * New quick spine label print button
-    * support for temporary location and in-process item statuses
+    * Support for temporary location and in-process item statuses
-    * usability enhancements to cataloging workflow:
+    * Usability enhancements to cataloging workflow:
-      * can now choose whether to edit items
+      * Can now choose whether to edit items after saving a bib record
-        after saving a bib record
+      * Option to move an item from one bib to another
-      * option to move an item from one bib to another
+      * Option to delete all items attached to a bib
-      * option to delete all items attached to a bib
+      * Ability to clone an item
-      * ability to clone an item
+      * View bib in OPAC link from the staff interface
-      * view bib in OPAC link from the staff interface
+    * Ability to merge duplicate bibliographic record from the staff
+      lists interface
 
   CIRCULATION
-    * ability to define library transfer limits
+    * Ability to define library transfer limits
-    * email checkout slips
+    * Email checkout slips
-    * option to enable alert sounds during checkin and checkout
+    * Option to enable alert sounds during checkin and checkout
-    * improvements in Koha's ability to express circulation policies
+    * Improvements in Koha's ability to express circulation policies
-      * option to charge fines using suspension days instead of money
+      * Option to charge fines using suspension days instead of money
-      * hold policies are now on the branch/itemtype/categorycode level
+      * Hold policies are now on the library/itemtype/categorycode level
-    * renewal policies are now on the branch/itemtype/categorycode level
+    * Renewal policies are now on the library/itemtype/categorycode level
-    * ability to specify an expiration date for a hold request
+    * Ability to specify an expiration date for a hold request
       when placing it via the staff interface or OPAC
-    * daily batch job to cancel expired holds
+    * Daily batch job to cancel expired holds
-    * improvements to interface to change the priority of hold
+    * Improvements to the interface to change the priority of hold
       requests for a bib in the staff interface
-    * new messaging system for patron records, allowing an unlimited
+    * New messaging system for patron records, allowing an unlimited
       number of patron notes to be stored and managed
+    * Changes to web-based self checkout
+        * Ability to login in automatically to self-check, allowing
+          for unattended self-check stations
+        * Ability to display the patron image in self-check
 
   OPAC
-    * additional patron privacy options
+    * Numerous enhancements to the bib display XML templates
-    * numerous enhancements to the bib display XML templates
+    * Per-patron OPAC search history, with ability for patrons
-    * per-patron OPAC search history, with ability for patrons
       to manage the retention of their search history
-    * support for Syndetics, LibraryThing, and Babeltheque enhanced
+    * Support for Syndetics, LibraryThing, and Babeltheque enhanced
       content
-    * support for RIS and BibTeX export
+    * Support for RIS and BibTeX export
-    * bib details page includes which lists a bib belongs to
+    * Bib details page includes which lists a bib belongs to
-    * can now customize the 'search for this title in' links
+    * Can now customize the 'search for this title in' links
-    * preference to control whether patrons can change their
+    * Preference to control whether patrons can change their
       details in the OPAC
+    * OPAC icon set provided by vokal
 
   REPORTS
-    * guided reports can now take runtime parameters
+    * Guided reports can now take runtime parameters
-    * can now edit SQL reports
+    * Can now edit SQL reports
 
   SERIALS
-    * can now specify the subscription end date, library location,
+    * Can now specify the subscription end date, library location,
       and grace periods
-    * option to automatically place hold requests for members of a
+    * Option to automatically place hold requests for members of a
       serials routing list
-    * numerous bugfixes
+    * Numerous bugfixes
 
   STAFF INTERFACE
-    * the cart has been added to the staff interface
+    * The cart has been added to the staff interface
-    * staff can add items to lists in bulk from search results
+    * Staff can add items to lists in bulk from search results
-    * enhanced patron card and item label creator
+    * Enhanced patron card and item label creator
-    * support for XSLT templates in the staff bib details display
+    * Support for XSLT templates in the staff bib details display
-    * bib details page includes which lists a bib belongs to
+    * Bib details page includes which lists a bib belongs to
 
   WEB SERVICES AND INTERFACE
-    * integration with SOPAC, including support for various
+    * Integration with SOPAC, including support for various
       web services defined by the ILS-DI recommendation
-    * support for CAS single sign-on
+    * Support for CAS single sign-on
-    * improvements to OAI-PMH support
+    * Improvements to OAI-PMH support
+
+  INTERNATIONALIZTION
+    * New initialization SQL files for German, Italian, and Polish
+    * Revamped UNIMARC framework for English
+
+  INTERNALS AND PACKAGING
+    * Koha is now packaged for Debian Squeeze; installation of Koha
+      can now be as simple as apt-get install koha
+    * Improvements to the management of required Perl modules
+    * Improvements to test case coverage
+    * Substantial progress on enabling the warnings pragma in all of
+      Koha's Perl code
+
+  BUGFIXES
+    * Approximately 1,050 tracked bugs and enhancement requests
+      are addressed in this release
+
+System Preferences
+======================
+
+The following system preferences are new in 3.2.0:
+
+    * AcqCreateItem
+    * AllowAllMessageDeletion
+    * AllowHoldDateInFuture
+    * AllowHoldPolicyOverride
+    * AutoSelfCheckAllowed
+    * AutoSelfCheckID
+    * AutoSelfCheckPass
+    * BranchTransferLimitsType
+    * Babeltheque
+    * casAuthentication
+    * casLogout
+    * casServerUrl
+    * ceilingDueDate
+    * CurrencyFormat
+    * DisplayClearScreenButton
+    * DisplayMultiPlaceHold
+    * DisplayOPACiconsXSLT
+    * EnableOpacSearchHistory
+    * FilterBeforeOverdueReport
+    * HidePatronName
+    * ILS-DI
+    * ILS-DI:AuthorizedIPs
+    * ImageLimit
+    * InProcessingToShelvingCart
+    * intranetbookbag
+    * LibraryThingForLibrariesEnabled
+    * LibraryThingForLibrariesID
+    * LibraryThingForLibrariesTabbedView
+    * NewItemsDefaultLocation
+    * numReturnedItemsToShow
+    * OAI-PMH:ConfFile
+    * OpacAddMastheadLibraryPulldown
+    * OPACAllowHoldDateInFuture
+    * OPACAmazonReviews
+    * OPACDisplayRequestPriority
+    * OPACFineNoRenewals
+    * OPACFinesTab
+    * OPACPatronDetails
+    * OPACSearchForTitleIn
+    * opacSerialDefaultTab
+    * OPACSerialIssueDisplayCount
+    * OPACShowCheckoutName
+    * OrderPdfFormat
+    * OverdueNoticeBcc
+    * OverduesBlockCirc
+    * PrintNoticesMaxLines
+    * ReturnToShelvingCart
+    * RoutingListAddReserves
+    * ShowPatronImageInWebBasedSelfCheck
+    * soundon
+    * SpineLabelAutoPrint
+    * SpineLabelFormat
+    * SpineLabelShowPrintOnBibDetails
+    * StaffSerialIssueDisplayCount
+    * SyndeticsAuthorNotes
+    * SyndeticsAwards
+    * SyndeticsClientCode
+    * SyndeticsCoverImages
+    * SyndeticsCoverImageSize
+    * SyndeticsEditions
+    * SyndeticsEnabled
+    * SyndeticsExcerpt
+    * SyndeticsReviews
+    * SyndeticsSeries
+    * SyndeticsSummary
+    * SyndeticsTOC
+    * UseBranchTransferLimits
 
 System requirements
 ======================
+
     Changes since 3.0:
 
     * The minimum version of Perl required is now 5.8.8.
+    * There are a number of new Perl module dependencies.
+      Run ./koha_perl_deps.pl -u -m to get a list of
+      any new modules to install during upgrade.
+
+Upgrades
+======================
+
+The structure of the acquisitions tables have changed significantly
+from 3.0.x.  In particular, the budget hierarchy is quite different.
+During an upgrade, a new database table is created called fundmapping
+that contains a record of how budgets were mapped.  It is strongly
+recommended that users of Koha 3.0.x acquisitions carefully review
+the results of the upgrade before resuming ordering in Koha 3.2.0.
 
 Documentation
 ======================
-As of Koha 3.2, the Koha manual is now maintained in DocBook.
+
+As of Koha 3.2, the Koha manual is now maintained in DocBook.  The
+home page for Koha documentation is 
+
+    http://koha-community.org/documentation/
+
+As of the date of these release notes, several translations of the 
+Koha manual are available:
+
+English: http://koha-community.org/documentation/3-2-manual/
+Spanish: http://koha-community.org/documentation/3-2-manual-es/
+French:  http://koha-community.org/documentation/3-2-manual-fr/
+
+The Git repository for the Koha manual can be found at
+
+    http://git.koha-community.org/gitweb/?p=kohadocs.git;a=summary
+
+Translations
+======================
+
+Complete or near-complete translations of the OPAC and staff
+interface are available in this release for the following languages:
+
+  * Chinese
+  * Danish
+  * English (New Zealand)
+  * English (USA)
+  * French (France)
+  * French (Canada)
+  * German
+  * Greek
+  * Hindi
+  * Italian
+  * Norwegian
+  * Portuguese
+  * Spanish
+  * Turkish
+
+Partial translations are available for various other languages.
+
+The Koha team welcomes additional translations; please see
+
+    http://www.kohadocs.org/usersguide/apb.html 
+
+for information about translating Koha, and join the koha-translate 
+list to volunteer:
+
+    http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-translate
+
+The most up-to-date translations can be found at:
+
+    http://translate.koha.org/
+
+Release Team
+======================
+
+The release team for Koha 3.2 is
+
+Release Manager:        Galen Charlton <gmcharlt@gmail.com>
+Documentation Manager:  Nicole Engard <nengard@gmail.com>
+Translation Manager:    Chris Cormack <chris@bigallofwax.co.nz>
+Release Maintainer (3.0.x):
+                        Henri-Damien Laurent <henridamien.laurent@biblibre.com>
+Release Maintainer (3.2.x):
+                        Chris Nighswonger <cnighswonger@foundations.edu>
 
 Credits
 ======================
+
 We thank the following libraries who are known to have sponsored
 new features in Koha 3.2:
 
@@ -108,9 +303,112 @@ new features in Koha 3.2:
   * Howard County Library, Maryland, USA (http://www.hclibrary.org/)
   * MassCat, Massachussetts, USA
   * Middletown Township Public Library, Middletown, New Jersey, USA
+  * New York University Health Sciences Library, New York, USA
   * Northeast Kansas Library System, Kansas, USA
   * Plano Independent School District, Plano, Texas, USA
   * SAN Ouest Provence, France
   * vokal (Vermont Association of Koha Automated Libraries), 
     Vermont, USA
   * www.digital-loom.com
+
+We thank the following individuals who contributed patches to
+Koha 3.2.0. 
+
+  * Alex Arnaud
+  * Allen Reinmeyer
+  * Amit Gupta
+  * Andrei V. Toutoukine
+  * Andrew Chilton
+  * Andrew Elwell
+  * Andrew Moore
+  * Brendan A. Gallagher
+  * Brian Harrington
+  * Chris Catalfo
+  * Chris Cormack
+  * Chris Nighswonger
+  * Christopher Hyde
+  * Cindy Murdock Ames
+  * Clay Fouts
+  * Colin Campbell
+  * Cory Jaeger
+  * Daniel Sweeney
+  * Danny Bouman
+  * Darrell Ulm
+  * David Birmingham
+  * David Goldfein
+  * Donovan Jones
+  * D. Ruth Bavousett
+  * Eric Olsen
+  * Frédéric Demains
+  * Galen Charlton
+  * Garry Collum
+  * Henri-Damien Laurent
+  * Ian Walls
+  * James Winter
+  * Jane Wagner
+  * Jared Camins-Esakov
+  * Jean-André Santoni
+  * Jesse Weaver
+  * Joe Atzberger
+  * John Beppu
+  * John Soros
+  * Joshua Ferraro
+  * Katrin Fischer
+  * Koustubha Kale
+  * Kyle M Hall
+  * Lars Wirzenius
+  * Liz Rea
+  * Magnus Enger
+  * Marc Chantreux
+  * Marcel de Rooy
+  * Mason James
+  * Matthew Hunt
+  * Matthias Meusburger
+  * Michael Hafen
+  * MJ Ray
+  * Nahuel Angelinetti
+  * Nicolas Morin
+  * Nicole Engard
+  * Owen Leonard
+  * Paul Poulain
+  * Piotr Wejman
+  * Ricardo Dias Marques
+  * Rick Welykochy
+  * Robin Sheat
+  * Ryan Higgins
+  * Savitra Sirohi
+  * Sébastien Hinderer
+  * Srdjan Jankovic
+  * Stan Brinkerhoff
+  * Stephen Edwards
+  * Vincent Danjean
+  * Will Stokes
+  * Wolfgang Heymans
+  * Zeno Tajoli
+
+We regret any omissions.  If a contributor has been inadvertantly missed,
+please send patch against these release notes to 
+koha-patches@lists.koha-community.org.
+
+Revision control notes
+======================
+
+The Koha project uses Git for version control.  The current development 
+version of Koha can be retrieved by checking out the master branch of 
+
+    git://git.koha-community.org/koha.git
+
+The branch for Koha 3.2.x (i.e., this version of Koha and future bugfix
+releases) is 3.2.x.
+
+The next major feature release of Koha will be Koha 3.4.0.
+
+Bugs and feature requests
+======================
+
+Bug reports and feature requests can be filed at the Koha bug
+tracker at
+
+    http://bugs.koha-community.org/
+
+Naku te rourou, nau te rourou, ka ora ai te iwi.