added UPGRADING tips
[mir.git] / doc / UPGRADING.mir
1 MIR UPGRADING HOWTO
2 ----------------------------------------------------------------
3
4 Due to weaknesses of the current Mir configuration system, many folks get
5 bitten after doing an update of their cvs tree. Suddenly Mir starts throwing
6 weird exceptions, etc.. The cause is usually a new config option in the
7 source/config.properties-dist that is missing from your
8 source/config.properties file (the one that is actually used).
9
10 a good way to check for this is to do the following (in the mir/ directory):
11
12 cd source
13 diff -u config.properties config.properties-dist
14
15 for this unfamiliar with the diff(1) program, you'll see a bunch of lines, some
16 starting with a "+" or "-". Look for a bunch of consecutive "+" symbols not
17 immeadiately followed by a "-". that usually is a new config option that you
18 should copy/paste (without the "+"'s of course) over to your existing
19 config.properties file and modify if necessary.
20
21 ----------------------------------------------------------------
22
23 2002 - the Mir coders