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
=============================================================
|