alexandria-book-collection-manager 0.7.1 → 0.7.2

data/doc/FAQ

@@ -0,0 +1,369 @@
+Copyright (C) 2007 Marco Costantini
+
+########################################################################
+
+Question: I have a ( Bug | Support Request | Patch | Feature Request ).
+
+Answer: You are welcome to report it. Please use the tracker at
+http://rubyforge.org/tracker/?group_id=205
+
+It may be helpful to read the text "How to Report Bugs Effectively", at
+http://www.chiark.greenend.org.uk/~sgtatham/bugs.html
+
+Please, one bug per report, and one report per bug.
+
+Please use a meaningful and specific summary.
+
+In order to let us investigate the bug and fix it for you, we need a clear
+and specific information about how to replicate it. For instance: report
+the ISBN of the book for which the bug happens; report the book provider
+used if relevant; copy and paste the error message. You may also start
+Alexandria in terminal window, and copy and paste the output on that
+window.
+
+In the past we got the bug report [#6767] saying:
+"Entering a valid ISBN number (many different) is rejected by the
+program. Stating to be an invalid ISBN."
+This user didn't report any single non-working ISBN; and didn't explain
+"rejected" enough. Hence, even if further work has been done on this
+topic, we can't know whether this bug was a real one, and whether it has
+been already solved or not.
+
+If you report only the backtrace without saying how to replicate the 
+bug, it is usually impossible to understand and fix the bug.
+
+Please have a look at the already reported bugs or feature request:
+it is useless to report again an already reported one. 
+If you have more information, please add it at the already reported bug,
+instead of opening a new one.
+
+Your bug could be a bug already solved in the development version of
+Alexandria. You can get the development version at
+http://rubyforge.org/scm/?group_id=205
+
+
+########################################################################
+
+
+Question: Where are the Z39.50 stuff, the providers US Library of 
+Congress and British Library, the advanced options, and the window for 
+adding new providers? I can't install Ruby/ZOOM.
+
+Answer: All these things require that the library Ruby/ZOOM,
+version >= 0.2.0 is installed and working. You can get it at
+http://ruby-zoom.rubyforge.org/ Install it according to its
+documentation.
+
+Ruby/ZOOM requires YAZ, http://www.indexdata.dk/yaz/ , compiled with 
+passing the --enable-shared option to the configure script:
+
+./configure --enable-shared
+
+before building YAZ with make.
+
+The following works for me with Ubuntu
+
+sudo apt-get -y install libyaz-dev ruby ruby1.8-dev make gcc
+wget http://rubyforge.org/frs/download.php/6940/ruby-zoom-0.2.2.tar.gz
+tar xfz ruby-zoom-0.2.2.tar.gz
+cd ruby-zoom-0.2.2/
+ruby extconf.rb
+make
+sudo make install
+
+
+
+List of Z39.50 server are at
+http://www.webclarity.info/registry/browse
+http://targettest.indexdata.com/
+
+
+When adding new Z39.50 providers, you must choose the record syntax.
+Currently (March 2007), these are offered: "USMARC", "SUTRS", "UNIMARC".
+
+"USMARC" works, "UNIMARC" works very limited, "SUTRS" doesn't work. 
+Choose a provider that supports "USMARC", or if none is available, one 
+that supports "UNIMARC".
+MARC21 is the same as USMARC (at least for Alexandria).
+
+You must choose also the charset encoding. Some are 
+
+UTF-8
+ISO-8859-1 (also known as Latin-1, Western Europe)
+ISO-8859-15
+ISO_6937-2 (also known as Ala, Ansel)
+
+The list of all possible charset encoding could be at
+/usr/lib/gconv/gconv-modules
+
+
+There is a plan to replace in future the provider British Library with 
+Copac, which includes British Library and others; see
+http://copac.ac.uk/libraries/
+http://en.wikipedia.org/wiki/Copac
+
+
+########################################################################
+
+
+Question: A provider is not working, or only partial information it 
+retrieved from it, or there are books on the providers for which 
+Alexandria fails to retrieve information.
+
+Answer: Yes, the provider may have changed the structure of its
+web pages, and hence it is necessary to update the file for that
+provider; this file is in the directory
+/<something>/alexandria/book_providers/
+
+It is also possible that the file handles only the "simple" cases, and the 
+case of your book is a "complex" one.
+
+Try to get the development version at http://rubyforge.org/scm/?group_id=205 
+because the problem could be already fixed there. 
+
+Try to fix by yourself, and thereafter send us a patch. 
+Otherwise, report the bug, saying for which ISBN this problem happens.
+
+
+########################################################################
+
+
+Question: I know another book provider
+
+Answer: There are many other providers, see 
+http://en.wikipedia.org/wiki/Wikipedia:Book_sources
+That page contains also links to the pages for book providers in other
+languages.
+If you now other providers, please add them to that lists.
+
+
+########################################################################
+
+
+Question: Please add a new provider
+
+Answer: First, choose wisely which provider(s) to ask. Do a 
+search on Internet of the various existing providers for your language 
+(see also, but not only, the previous question). 
+
+You may prefer providers that list also out-of-prints, instead of 
+providers that list only available books. It is also preferable a 
+provider that lists not only the books of your country, but also the 
+books of the neighbor countries.
+
+Check whether the provider supports the Z39.50 protocol. This is probable
+for public libraries, and very unlikely for commercial booksellers. 
+(If the Z39.50 protocol is supported, just go to "Preferences", 
+"Providers", "Advanced Settings", and add the provider there.)
+
+It is useful if you choose a provider that allows to specify the ISBN in 
+the address, such as 
+http://www.internetbookshop.it/ame/ser/serdsp.asp?e=0060748222&shop=1
+or
+http://www.deastore.com/product.asp?isbn=9780060748227
+
+It is necessary that the HTML page of each provider is easily parsable, 
+that is, that the computer can easily find title, author(s), ISBN, 
+publisher, year of publication, binding.
+For instance, the following piece of HTML page is easily parsable.
+
+<span class="BDtitoloLibro">The Krusty Book</span>
+<span class="BDauthLibro">by: Matt 
+Groening </span><span class="BDformatoLibro"><span 
+class="BDEticLibro">Format: </span>paperback</span><span 
+class="BDEticLibro">Publication date: </span><span 
+class="BDdataPubbLibro">10/23/2006</span><span 
+class="BDEticLibro">Publisher: </span><span 
+class="BDeditoreLibro">HarperCollins Publishers (Australia) Pty 
+Ltd</span><br /><span class="BDEticLibro">ISBN: </span><span 
+class="isbn">0-06-074822-2</span><br /><span class="BDEticLibro">ISBN 
+13: </span><span class="isbn">978-0-06-074822-7</span></div>
+
+It is not necessary that the provider reports for each book all the
+information: title, author(s), ISBN, publisher, year of publication,
+binding. In case that one of these is missing, Alexandria will not get 
+it.
+
+It is easier, if the provider doesn't use cookies (however, provider
+Deastore uses cookies and has been implemented).
+
+After the choice of the provider, try by yourself to modify the file for 
+an already implemented provider. Probably it may be only required that 
+you modify some regular expressions. Please send us the patch.
+If you can program already, learning Ruby may require 20 minutes, see 
+http://www.ruby-lang.org/en/documentation/quickstart/
+
+If you can't implement the new provider by yourself, write a 'feature 
+request' at http://rubyforge.org/tracker/?group_id=205
+Please report some ISBNs of books that your provider knows and no other 
+provider implemented by Alexandria knows. Report also how are the words 
+title, author(s), ISBN, publisher, year of publication, binding in the 
+language used by the site. Report any other relevant information.
+
+
+########################################################################
+
+
+Question: What are the ISBN, the ISBN-13, and the EAN? 
+
+Answer: For more information about ISBN, ISBN-13, EAN, see 
+http://en.wikipedia.org/wiki/International_Standard_Book_Number
+
+
+########################################################################
+
+
+Question: Does Alexandria support the ISBN-13? Do I need to enter the 
+ISBN with or without dashes?
+
+Answer: Alexandria support both the 10-digit and 13-digit ISBN, and the 
+dashes entered with the ISBN are ignored. Hence you can enter the book 
+in any of these equivalent forms:
+
+88-06-14930-X
+880614930X
+88-06-14930-x
+880614930x
+978-88-06-14930-7
+9788806149307
+
+
+########################################################################
+
+
+Question: I entered the ISBN exactly as it shows on the book, and 
+Alexandria says that it is invalid.
+
+Answer: You can check whether an ISBN is valid with
+http://www.isbn-check.com/ 
+Sometimes the ISBN reported on the book is wrong. Try to use the
+13-digit one, or to use the ISBN reported on the back of the title page,
+or to search by title/author on a book provider, in order to find the
+correct ISBN.
+
+
+########################################################################
+
+
+Question: Where is stored the data about the books?
+
+Answer: In the files ~/.alexandria/<library_name>/<ISBN>.yaml
+These files are in YAML ( http://www.yaml.org/ ) format, and you can 
+edit them manually. The covers are in the files 
+~/.alexandria/<library_name>/<ISBN>.cover
+These files persist if you install or deinstall Alexandria.
+
+
+########################################################################
+
+
+Question: I was enjoying Alexandria a lot and now it doesn't work any 
+more, I can't enter other books, or crashes when it starts.
+
+Answer: This usually happens when there is some invalid data in one of 
+the .yaml files (see the question above). For one or more of the 
+latest books that you have entered, a bug happened, and now the data 
+stored is invalid and causes trouble. Try to find which book it was, 
+(please send also a bug report), and to delete or to move to another 
+directory that .yaml file or the whole ~/.alexandria directory.
+
+This kind of problem may show only with the manual entered books, and 
+not with the books searched by ISBN.
+
+
+########################################################################
+
+
+Question: can I catalog other objects?
+
+Answer: Yes. Some kinds of object, such as illustrated calendars, or 
+geographical maps, have the ISBN, and can be treated as books.
+
+For other objects, insert the EAN or bar-code number as ISBN. Provider 
+Thalia knows about music CDs, video DVDs, games and software, and can be 
+used to retrieve information about them. Other providers may be added in 
+future (possibly by you). Otherwise, the other objects may be added 
+manually.
+
+
+########################################################################
+
+
+Question: I prefer to have the field "Author" as "Surname, Name" instead 
+of "Name Surname".
+
+Answer: Alexandria relies on what the providers say: 
+some providers report "Surname, Name": Deastore, Renaud, Mcu,
+some "Surname Name": Webster.it, Ibs.it,
+some "Name Surname": Bn, Thalia, Bol.it, Adlibris, L Siciliano, Worldcat,
+and some without any rule: Amazon, Proxis.
+You can change, in the preferences, the order in which the providers are 
+queried.
+
+If Alexandria reports "Name Surname" with one provider, and in the HTML 
+page of that provider there is also (in a parsable way) "Surname, Name", 
+then this is a bug to be reported. In some of these cases, it would be 
+possible to get "Surname, Name", but the code would be complicated and 
+unreliable. 
+
+There is no algorithm that can decide, given the Author as a string, 
+which part of the string is the name and which part is the surname.
+For instance, the name or the surname can be composed by more than one 
+word, or the author may be a collective author, or be a title or a 
+pseudonym, or in the author's country they may use that the surname is 
+the first word and the name is the second, or there may be the 
+patronymic, and so on.
+
+For one provider, for books with more that one author, it's non-trivial 
+even to split the string of all the authors into strings "Name Surname" for 
+each author.
+
+The only possibility to convert "Name Surname" to "Surname, Name" is to do
+that by hand.
+
+If you still believe that it is possible for a software to convert "Name 
+Surname" into "Surname, Name" in a reliable way, here are some cases of 
+real authors for you to try. (Some accented letters have been replaced by 
+the non accented ones.)
+
+"Agente Italiano"
+"Albert Sydney Hornby"
+"Alexandre Dumas fils"
+"Antoine de Saint-Exupery"
+"Boston Women's Health Book Collective"
+"Camilla"
+"Central Intelligence Agency"
+"Christiane F."
+"Dario De Toffoli"
+"Elaine St. James"
+"Ernesto Che Guevara"
+"Francois-Marie Arouet de Voltaire"
+"Gaius Caesar Octavianus Augustus"
+"Geographers A-Z Map Company"
+"Gian Antonio Stella"
+"H G Wells"
+"John Paul II" (the surname is "Wojtyla")
+"Jose Ortega y Gasset"
+"Joseph K. von Eichendorff"
+"Leonardo da Vinci" (he had no surname, "da Vinci" means "from the village
+'Vinci'")
+"Leone Stella" (this only is fictional, from a comic movie, whose main
+characters are some "Leone Stella" and a "Stella Leone"
+"Levi Strauss"
+"Lewis Carroll" ("Lewis" may be both name and surname, and here the 
+surname is "Dodgson")
+"Lorenzo il Magnifico"
+"Lucio Lombado Radice"
+"Luigi Luca Cavalli-Sforza"
+"Malcolm X"
+"Mao Zedong"
+"Martin Luther"
+"Martin Luther King Jr."
+"Mihail Sergeevic Gorbacev"
+"Robert Van der Plas"
+"Saint Augustine"
+"Scuola di Barbiana"
+"Subcomandante Insurgente Marcos"
+"Vladimir Lenin" (the surname is "Ulyanov")
+
+########################################################################

data/doc/HACKING

@@ -0,0 +1,19 @@
+In order to keep the code nice and clean we have a few requirements you'll
+need to stick to in order to get your patch accepted:
+
+    - use 4-space tabs for indentation and expand tabs to spaces
+      (if you use VIM, `set ts=4' and `set et') ; 
+
+    - for code blocks, use { ... } when they can be written into a 
+      single line, otherwise use do ... end ;
+
+    - when accessing properties of Ruby-GNOME2 objects, always use
+      foo= instead of set_foo ;
+
+    - when hacking the user interface, make sure your changes don't
+      break the HIG rules (http://developer.gnome.org/projects/gup/hig/) ;
+
+    - always provide patches in unified form (`cvs diff -u') and with
+      a ChangeLog entry. 
+
+Be bold.

data/doc/NEWS

@@ -0,0 +1,341 @@
+================
+Alexandria
+================
+
+New features:
+ * added the FAQ
+ * Now EAN/ISBN-13 is used
+ * New providers: webster.it, deastore.com, worldcat.org, bol.it. 
+   "Servizio Bibliotecario Nazionale (Italy)"
+ * provider amadeus renamed to thalia (Amadeus was bought by Thalia)
+ * Now thalia supports also music, DVD, software, games
+ * added the country of the provider after the name
+ * the requirement Ruby/Amazon is now optional
+ * added info in case that Alexandria can't load optional libraries
+ * added hotkey "<control>O" for preferences
+ * in the "Book Properties Dialog", added "cancel" button, and renamed 
+   "close" button to "save"
+ * added date when exporting to HTML or BibTeX
+ * added image size when exporting to HTML or Tellico
+ * improved export to ONIX, Tellico, CSV, HTML, BibTeX
+ * improved import from Tellico or ISBN list
+ * improved and refactored the code for Z39.50 providers
+
+Bugs fixed:
+ * several fixes and updates for various providers
+ * converted the encoding from UTF-8, when searching by title/author/keyword
+ * converted the output from the provider to UTF-8
+ * used CGI::unescapeHTML for renaud and thalia
+ * now nul is returned instead of "", "n/a", or "Unknown Binding", when 
+   the provider doesn't return a value
+ * allowed manual entry of books without author
+ * improved error and debug messages
+
+Added translation:
+
+Updated translations:
+* revision of the Italian translation
+
+================
+Alexandria 0.6.0
+================
+
+New features:
+ * Z39.50 support, with the possibility to manage your own sources ;
+ * New book information providers: Internet Bookshop Italia, US Library of 
+   Congress and British Library ;
+ * Complete manual (in English only), available either from the GNOME help
+   application and Alexandria itself (via Help buttons) ;
+ * Autocompletion is available in all fields of the Add Manually Book and
+   Book Properties dialogs ;
+ * Add a heart emblem to covers of books that have a 5 rating ;
+ * Support for American UPC barcodes ;
+ * Display covers in the search results of the Add Book dialog ;
+ * Added a 'Match everything' filtering option ;
+ * New icons ; 
+ * More ONIX compliance. 
+
+Bugs fixed:
+ * Loading the model is now a bit faster ;
+ * Fixed a Proxis bug that was returning all editions of a book from an ISBN
+   search ;
+ * Labels in alert dialogs are now selectable ;
+ * Improved the wording of the status bar text ;
+ * Ignore CVS directories when looking for themes ;
+ * Ignore whitespace characters when extracting numbers for ISBN/EAN/... ;
+ * In the HTML export, create the directory if it does not exist yet ;
+ * In the ONIX export, do not write ProductWebsite elements for providers
+   that return nil URLs ;
+ * Handle low-case 'x' when validating ISBN/EAN/... ;
+ * In the ISBN-list text file import, iterate on the progress bar when 
+   downloading covers ;
+ * In the ISBN-list text file import, start importing if there is at least one
+   valid ISBN in the file ;
+ * Added a backward compatibility hack to upgrade the old developer token
+   to a new valid one ;
+ * Resize all icons in the icon view to have the same height (and not the same 
+   width as before) ;
+ * Handle GConf default values by ourself when the GConf client returns nil
+   values, this should fix all issues related to the installation of GConf 
+   schemas ;
+ * Disable the 'View Online Information' actions if the according providers
+   do not provide a URL for the selected book.
+
+Added translations:
+ * Jiri Pejchal <jiri.pejchal@gmail.com> (cs) ;
+ * Ligia Moreira <ligia.moreira@netvisao.pt> (pt) ;
+ * Lucas Rocha <lucasr@im.ufba.br> (pt_BR). 
+ 
+Updated translations:
+ * David Weinehall <tao@debian.org> (sv) ;
+ * Joachim Breitner <mail@joachim-breitner.de> (de) ;
+ * Laurent Sansonetti <lrz@gnome.org> (fr) ;
+ * Masao Mutoh <mutoh@highway.ne.jp> (ja) ;
+ * Miguel �ngel Garc�a (es) ;
+ * Mirko Maischberger <mirko@lilik.it> (it). 
+
+================
+Alexandria 0.5.1
+================
+
+New features:
+ * Added provider for book information retrieval of the Amadeus Buch online
+   library (Austrian books) ;
+ * Allows user-specific themes in ~/.alexandria/.web-themes ;
+ * Localized .desktop file.
+
+Bugs fixed:
+ * Fixed the wording of some messages ;
+ * Use alternating colours for rows in the search list of the Add Book dialog
+   and the providers list of the Preferences dialog ;
+ * The Amazon provider will cache information on ~/.alexandria/.amazon_cache
+   instead of /tmp/amazon, allowing multiple users with different credentials
+   to use it ;
+ * Really ignores hidden directories in ~/.alexandria ;
+ * Be more intelligent when building the list of providers by taking into 
+   account nil values from the GConf schema ;
+ * Do not display the whole GPL text in the About dialog, just the header ;
+ * Display an confirmation message when trying to move a book into a library 
+   that already has a book with the same ident ;
+ * Fixed the moves action after an import process ;
+ * Display an error message when trying to set an EAN/ISBN that is already
+   used by another book in the same library ;
+ * Forgot to mark some translatable strings ;
+ * Display an error message when trying to add a book with an EAN/ISBN that is 
+   already used by another book in the same library ;
+ * Manually added books were not automatically added in the memory 
+   representation of the library ;
+ * Pack the cover image as non-expandable in the books list view.
+
+Added translation:
+ * Mirko Maischberger <mirko@lilik.it> (it).
+
+Updated translations:
+ * Dafydd Harries <daf@muse.19inch.net> (cy) ;
+ * David Weinehall <tao@debian.org> (sv) ;
+ * Joachim Breitner <mail@joachim-breitner.de> (de) ;
+ * Laurent Sansonetti <lrz@gnome.org> (fr) ;
+ * Masao Mutoh <mutoh@highway.ne.jp> (ja) ;
+ * Miguel �ngel Garc�a (es).
+
+================
+Alexandria 0.5.0
+================
+
+New features:
+ * XHTML export with CSS themes ;
+ * Added provider for book information retrieval of the Spanish Ministry of 
+   Culture ;
+ * Loaning support (very basic though), actually possible to mark a book
+   as loaned and specify a person name and a date ;
+ * Possibility to manually add ISBN-less books ;
+ * The ISBN-list import supports EAN ;
+ * The Amazon provider supports the French and Canadian web-services (via 
+   Ruby/Amazon 0.9.0) ;
+ * Improved the usability of the main, import and export dialogs ;
+ * Performances and memory usage have been improved ;
+ * Migration to new GTK+ 2.6 widgets.
+
+Bugs fixed:
+ * Migrated any reference to Bookcase in the Tellico import/export ;
+ * Fixed a bug where importing an ISBN list file would cause a crash when an 
+   ISBN in the list did not have a cover image ;
+ * In the providers preferences dialog, disable the Setup button if the 
+   selected provider does not have any preferences to setup, instead of 
+   displaying a dialog ;
+ * Catches the SocketError exception when calling providers, and returns an 
+   appropriate message ;
+ * When deleting more than one books, display a single alert dialog instead
+   of an alert dialog for each book ;
+ * Added the possibility to reset the rating in the book properties dialog ;
+ * Fixed a bug  where EAN numbers with a checksum of 10 were incorrectly marked 
+   as invalid ;
+ * Fixed BN.com query regexes ;
+ * Fixed a bug when a book returned by a search by title/authors/keyword
+   contains an invalid ISBN, propose the user to either add the book with a
+   blank ISBN or cancel the add) ;
+ * Added workaround for an Amazon US encoding bug ;
+ * Setup the Amazon online information URL according to the selected locale ;
+ * Filtering text field is more robust ;
+ * Make sure we do not select a library before having setup the moves action 
+   at the beginning ;
+ * Fixed the wording of some messages.
+
+Added translation:
+ * David Weinehall (sv).
+
+Updated translations:
+ * Joachim Breitner (de) ;
+ * Laurent Sansonetti (fr) ;
+ * Masao Mutoh (ja) ;
+ * Miguel �ngel Garc�a (es).
+
+================
+Alexandria 0.4.0
+================
+
+New features:
+ * export libraries into ONIX, Tellico and ISBN-list formats ;
+ * import libraries from Tellico and ISBN-list formats ;
+ * a provider to the Barnes and Noble (bn.com) library has been added ;
+ * CueCat (R) barcode support ;
+ * manual addition of books ;
+ * allow the edition of all fields of the properties of a book (including cover 
+   change) ;
+ * move books between libraries ;
+ * display online information (amazon, proxis, bn) for a book ;
+ * improved the usability of the Add Book dialog (the ISBN text entry grabs the
+   focus at the beginning, the criterion is automatically selected upon clicks
+   on insensitive widgets, the edition and publisher are appended in the search
+   result list for books that have the same title and authors) ;
+ * migration to the new GTK UI manager and file selector widgets. 
+
+Bugs fixed: 
+ * modified the ISBN text entry to allow 18 characters (extended EAN) 
+   instead of 13 ;
+ * bin/alexandria is now automatically generated by the installer, this
+   fixes a bug in the #! line (/usr/bin/env could not pass a parameter to 
+   Ruby) ;
+ * squeezed extra space characters in the data given by Amazon ;
+ * fixed the ISBN validation code for numbers that end with an X ;
+ * recorded the maximize state of the main window in GConf ;
+ * fixed the default rating to 0 instead of 3 (0 means unrated) ; 
+ * erases the 'http_proxy' environment variable if its content is invalid ;
+ * show an error message when trying to rename a library to an empty name, or 
+   to a name that is already used by another library.
+
+Added translations:
+ * Joachim Breitner (de) ;
+ * Miguel Angel Garcia (es).
+
+No translation update in this release due to a Ruby-GetText problem.
+
+================
+Alexandria 0.3.1
+================
+
+Bugs fixed:
+ * removed custom sorting functions as they appear not to make anything
+   work better and may actually cause some problems ; 
+ * fixed the Amazon provider to perform another lookup using the next 
+   locale if the previous one gives no results ;
+ * improved exception handing to have better error messages ;  
+ * calling providers one after one until at least one book has been found ;
+ * sorting by rating books that were not rated yet did crash ; 
+ * sorting by edition and publisher were reversed ;
+ * the Add Book dialog is now resizable in search mode ;
+ * removing a book without a cover image did crash. 
+
+Updated translations:
+ * Dafydd Harries (cy) ;
+ * Laurent Sansonetti (fr) ;
+ * Masao Mutoh (ja). 
+
+================
+Alexandria 0.3.0
+================
+
+New features:
+ * the Add Book dialog allows searches by title, authors and keyword as well  
+   as regular ISBNs ;
+ * ISBNs are now validated before usage ;
+ * the Add Book dialog will autofill the ISBN text entry using the clipboard
+   content if it contains a valid EAN/ISBN ; 
+ * the Add Book dialog will automatically convert EANs to ISBNs ;
+ * a provider to the Proxis library (http://www.proxis.be) has been added ;
+ * HTTP connections to Amazon and Proxis are configured to pass via a proxy
+   or not according to the GNOME preferences.
+
+Bugs fixed:
+ * do not split title icons inside a multibyte character ;
+ * fixed the Amazon provider to not set the manufacturer attribute to nil
+   for some books that are not yet released ; 
+ * enforced the use of UTF-8 for gettext ;
+ * some strings have been ngettexted ;
+ * the data/locale directory is cleaned by install.rb ;
+ * pre-setup.rb doesn't require Ruby-GetText anymore since all this does
+   is run msgfmt. 
+
+Updated translations:
+ * Dafydd Harries (cy) ;
+ * Laurent Sansonetti (fr) ;
+ * Masao Mutoh (ja). 
+
+================
+Alexandria 0.2.0
+================
+
+New features:
+ * full i18n support ;
+ * a preferences dialog has been created, to configure the application and
+   the providers ; 
+ * preferences are saved and restored using a GConf backend ;
+ * notes can be associated with books ;
+ * books can be rated ;
+ * books icons can be sorted ;
+ * the user interface has been improved to be more usable and accessible. 
+
+Bugs fixed:
+ * fixed some UTF-8 encoding problems in data from Amazon ;
+ * allow "-" characters in ISBNs ;  
+ * allow more characters in library names ;
+ * display a default cover icon for a book which cover is not available ;
+ * the treeview is now sortable with UTF-8 data ; 
+ * the 'clicked' signal is used instead of 'pressed' for Gtk::Button widgets ; 
+ * when the current selected library is renamed the title of the application
+   is accordingly renamed.
+ * a lot of code has been refactored.
+
+Added translations:
+ * Dafydd Harries (cy) ;
+ * Laurent Sansonetti (fr) ;
+ * Masao Mutoh (ja). 
+
+================
+Alexandria 0.1.2
+================
+
+Bugs fixed:
+  * did not work with the latest version or Ruby/Amazon (0.8.1) ;
+  * crash when Amazon doesn't provide the author(s) for a book.
+
+New feature:
+ * default to the currently selected library in the Add Book Dialog
+   (contributed by Zachary P. Landau).
+
+================
+Alexandria 0.1.1
+================
+
+This release fixes a bug when Alexandria fails to start if
+the directory ~/.alexandria doesn't exist.
+
+================
+Alexandria 0.1.0
+================
+
+This is the first public release, which:
+  * retrieves book information from Amazon (including cover pictures) ;
+  * saves data using the YAML format ;
+  * features an HIG-compliant user interface ;
+  * shows books in different views (standard list or icons list).