refdb-cvs

[Markus H. <mho...@us...>]

Update of /cvsroot/refdb/refdb
In directory sc8-pr-cvs1:/tmp/cvs-serv25739

Modified Files:
	INSTALL NEWS README UPGRADING 
Log Message:
updated for 0.9.4

Index: INSTALL
===================================================================
RCS file: /cvsroot/refdb/refdb/INSTALL,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -U2 -r1.6 -r1.7
--- INSTALL	19 Feb 2003 22:59:38 -0000	1.6
+++ INSTALL	30 Dec 2003 23:51:36 -0000	1.7
@@ -9,7 +9,6 @@
 The following libraries have to be installed:
 
-- libdbi (0.6.7 or newer, earlier versions do *NOT* work)
-- libdbi-drivers (0.2 or newer, 0.1 does *NOT* work; required for the
-  embedded SQLite database engine only)
+- libdbi (0.7.0 or newer, earlier versions do *NOT* work)
+- libdbi-drivers (0.7.0 or newer, earlier versions do *NOT* work)
 - libreadline
 - expat
@@ -70,5 +69,5 @@
 
 Apparently you use a platform that RefDB has not been ported to. RefDB
-has so far been tested only on Linux, FreeBSD, Solaris, and
+has so far been tested only on Linux, FreeBSD, NetBSD, OSX, Solaris, and
 WinNT/Cygwin. This might be an outstanding opportunity to gain 15
 minutes of fame by providing a port to your platform. Otherwise you

Index: NEWS
===================================================================
RCS file: /cvsroot/refdb/refdb/NEWS,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -U2 -r1.16 -r1.17
--- NEWS	17 Aug 2003 16:53:22 -0000	1.16
+++ NEWS	30 Dec 2003 23:51:36 -0000	1.17
@@ -3,4 +3,60 @@
 
 ______________________________
+Version 0.9.4 (December 2003)
+
+Bugfixes:
+
+- fixed a serious bug when updating personal information which may
+  lead to data loss
+
+- fixed risx output
+
+- added publication type HEAR to the risx DTD
+
+- fixed a possible segfault if messages are not logged in a custom file
+
+- fixed case mismatches in DocBook XML driver files
+
+- fixed bug in bibliography code for subsequent multiple citations
+
+- fixed deleteref return message if the requested reference does not
+  exist
+
+- fixed junk error messages if refdbc was run in batch mode without
+  specifying a default database.
+
+
+Improvements:
+
+- added XHTML support to the getref command and to DocBook XML
+  bibliographies
+
+- added support for extended notes. Extended notes can be linked to
+  any number of references, keywords, author names, and periodical
+  names in your database. You can search for references and display
+  all notes attached to them, or you can search for notes and display
+  which references they are linked to. You can search for notes which
+  are attached to particular references and vice versa. The new
+  refdbc commands addnote, updatenote, deletenote, and getnote work
+  essentially like their *ref counterparts. The new refdbc command
+  addlink adds or removes links from notes to other database objects.
+
+- by default refdbd answers only connections from localhost. The new
+  -I switch allows remote connections as well.
+
+- deleteref will refuse to delete a reference if it is in the personal
+  lists of more than one user.
+
+- reference databases now carry additional meta information like the
+  refdb version they were created with and the dates of creation and
+  last modification. This information is available through the
+  refdbc:whichdb command.
+
+- listdb will now only return RefDB reference databases
+
+- the refdbnd script was enhanced to simplify generating a Makefile
+  for an existing SGML or XML document
+
+______________________________
 Version 0.9.3 (August 2003)
 

Index: README
===================================================================
RCS file: /cvsroot/refdb/refdb/README,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -U2 -r1.13 -r1.14
--- README	29 May 2003 21:35:14 -0000	1.13
+++ README	30 Dec 2003 23:51:36 -0000	1.14
@@ -10,8 +10,9 @@
 scientists, publishers, and anyone else writing publications to keep
 track of journal articles, books, and other printed or electronic
-material and to automatically generate bibliographies for all kinds of
-publications. The primary output formats are RIS, DocBook SGML/XML, TEI
-XML, and TeX compatible with bibtex/natbib. Other SGML and XML
-document types can be added by creating suitable stylesheets.
+material, to associate notes with their material, and to automatically
+generate bibliographies for all kinds of publications. The primary
+output formats are RIS, DocBook SGML/XML, TEI XML, and TeX compatible
+with bibtex/natbib. Other SGML and XML document types can be added by
+creating suitable stylesheets.
 
 refdb runs on Linux, FreeBSD, NetBSD, Darwin/OSX, Solaris,
@@ -29,6 +30,6 @@
 
 Creating DocBook or TEI XML documents with automatically generated
-bibliographies requires a XSL engine and DocBook or TEI XSL
-stylesheets, respectively.
+bibliographies requires a XSLT engine and DocBook or TEI XSL
+stylesheets, respectively. xsltproc is an excellent choice.
 
 refdb is at home at http://refdb.sourceforge.net.
@@ -39,4 +40,12 @@
 Backwards incompatible changes
 ******************************
+_______
+V 0.9.4
+
+Both the system database (now called refdb instead of refdb1 to allow
+parallel installations of new and older versions) and the reference
+databases use different layouts compared to older versions. In order
+to use your existing reference data with 0.9.4, make sure to follow
+the instructions in UPGRADING.
 
 _______

Index: UPGRADING
===================================================================
RCS file: /cvsroot/refdb/refdb/UPGRADING,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -U2 -r1.4 -r1.5
--- UPGRADING	8 Jul 2003 19:45:40 -0000	1.4
+++ UPGRADING	30 Dec 2003 23:51:36 -0000	1.5
@@ -1,2 +1,48 @@
+Migrating your existing RefDB installation from <0.9.4 to 0.9.4
+===============================================================
+
+__________
+Background
+
+The citation and bibliography styles now support the full range of
+fields in the reference databases. The system database uses a
+different schema to accommodate the new data.
+
+RefDB now supports extended notes which can be attached to any number
+of references, author names, keywords, or periodical names. To store
+these data, the reference database schema was changed as well.
+
+In order to use your existing data, you'll have to migrate your
+databases to the new version.
+
+_________
+Procedure
+
+- Make all sorts of backups of your existing databases. Use the native
+  tools of your database server to create SQL dumps. In case of MySQL or
+  SQLite databases, you can also make copies of the subdirectories and
+  files, respectively.
+
+- While still running your existing installation, use the refdbc
+  command "getref -t risx -o dbname.xml :ID:>0" to dump your reference
+  databases to XML files.
+
+- Unless you kept copies of your bibliography styles in XML files,
+  export these as well, using the refdba command getstyle:
+  "getstyle -o stylename.xml stylename"
+
+- Now install 0.9.4. Make sure to restart refdbd if it is running.
+
+- Follow the instructions to generate the system database and make
+  sure it is called "refdb".
+
+- Add any of your custom styles using the refdba command addstyle:
+  "addstyle stylename.xml"
+
+- Create new reference databases and read back your existing data
+  with the refdbc command "addref -t risx dbname.xml"
+
+
+
 Migrating your existing RefDB databases from <0.9.3 to 0.9.3
 ============================================================