[Refdb-cvs] CVS: refdb UPGRADING,1.6,1.7

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

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

Modified Files:
	UPGRADING 
Log Message:
added initial blurb, fixed instruction titles

Index: UPGRADING
===================================================================
RCS file: /cvsroot/refdb/refdb/UPGRADING,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -U2 -r1.6 -r1.7
--- UPGRADING	31 Dec 2003 00:28:07 -0000	1.6
+++ UPGRADING	6 Jan 2004 18:07:30 -0000	1.7
@@ -1,7 +1,24 @@
-Migrating your existing RefDB installation from <0.9.4 to 0.9.4
-===============================================================
+RefDB UPGRADING
+===============
 
 $Id$
 
+This file contains instructions how to upgrade RefDB without losing
+your precious data. There is one section for each version that
+introduced backwards-incompatible changes requiring a rebuild of your
+databases:
+
+0.9.3 -> 0.9.4
+0.9/0.9.1/0.9.2 -> 0.9.3
+<0.9 -> 0.9
+
+Please visit the refdb-users mailing list archives for further hints
+on how to apply this information to pre-releases.
+
+
+
+Migrating your existing RefDB installation from 0.9.3 to 0.9.4
+===============================================================
+
 __________
 Background
@@ -27,6 +44,14 @@
 
 - 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.
+  command "getref -t ris -o dbname.ris :ID:>0" to dump your reference
+  databases to RIS files. Please note that this will export the
+  personal information of the current user only. If you share your
+  database with other users, you should re-run this command for each
+  user separately:
+  "set username otheruser"
+  "set passwd *"
+  "getref -t ris -o dbname-otheruser.ris -P :ID:>0". 
+  Using risx output is not recommended as the output
+  was not bug-free in 0.9.3.
 
 - Unless you kept copies of your bibliography styles in XML files,
@@ -43,10 +68,12 @@
 
 - Create new reference databases and read back your existing data
-  with the refdbc command "addref -t risx dbname.xml"
+  with the refdbc command "addref -t ris dbname.ris". If you have
+  dumps for other users as well, run "updateref -t ris -P -U otheruser
+  dbname-otheruser.ris" in turn for each user.
 
 
 
-Migrating your existing RefDB databases from <0.9.3 to 0.9.3
-============================================================
+Migrating your existing RefDB databases from 0.9/0.9.1/0.9.2 to 0.9.3
+=====================================================================
 
 __________
@@ -83,5 +110,5 @@
 
 
-Upgrading your existing RefDB installation from <0.9 to >=0.9
+Upgrading your existing RefDB installation from <0.9 to 0.9
 =============================================================