179e1778e4e51e6db69e1fd6d9973bd01b7e3aba
[mir.git] / doc / REPORTING_BUGS
1 last changed: $Date: 2002/12/08 04:59:51 $. 2002 mir-coders
2 --------------------------------------------------------------------------
3
4 BUG REPORTS
5
6 Please read this file before sending in a bug report or patch.
7
8 Where to send
9 =============
10 Send comments, bug reports, patches, etc. to mir-coders@lists.indymedia.org
11
12
13 What to send
14 ============
15 Please specify the relevant versions of the software that you are running Mir
16 under. i.e JVM name and version (IBM, Sun,..), what compiler was used
17 (javac or jikes), tomcat version. 
18
19 Of course, you should always specify what version of Mir you are running. If you
20 are running a version check'out of CVS, please specify when you checked it out
21 and from which branch (e.g MIR_1_0, HEAD..). Also if you can specify the
22 versions of relevant files using "cvs status".
23
24 If you received an Exception while running Mir, please mail in the "Oops" you
25 got (if you got one) and try to find and error in one of the Mir/log/* files.
26 Also, a stack trace can usually be found in one of the tomcat log files. For
27 example, in tomcat4 you can look at the .../logs/catalina.out file or the
28 .../logs/localhost_log.yyyy-mm-dd.txt, where the date is of the last time
29 tomcat was started. Under the Debian package installation, the tomcat logs can
30 be found under /var/log/tomcat... It is probably similar for other
31 distributions. If you are using the tarball from jakarta.apache.org, the logs
32 dir. is directly in the root of the tomcat tree.
33
34 Patches
35 =======
36
37 Please send in patches that are a diff between an unmodified tree and your tree
38 with the changes:
39
40 diff -Nur standard-mir-dir your-mir-dir
41