scripts/mir-setup/README: update with link to new doc on wiki
[mir.git] / doc / REPORTING_BUGS
1 last changed: $Date: 2002/12/23 02:56:17 $. 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 please also take the time to enter a bug in our bug-tracking system:
13
14 https://prod.indymedia.nl/mantis
15
16 What to send
17 ============
18 If the bug is re-producible, please tell us how to reproduce it.
19
20 Please specify the relevant versions of the software that you are running Mir
21 under. i.e JVM name and version (IBM, Sun,..), what compiler was used
22 (javac or jikes), tomcat version, browser version...
23
24 Of course, you should always specify what version of Mir you are running. If you
25 are running a version check'out of CVS, please specify when you checked it out
26 and from which branch (e.g MIR_1_0, HEAD..). Also if you can specify the
27 versions of relevant files using "cvs status".
28
29 If you received an Exception while running Mir, please mail in the "Oops" you
30 got (if you got one) and try to find and error in one of the Mir/log/* files.
31 Also, a stack trace can usually be found in one of the tomcat log files. For
32 example, in tomcat4 you can look at the .../logs/catalina.out file or the
33 .../logs/localhost_log.yyyy-mm-dd.txt, where the date is of the last time
34 tomcat was started. Under the Debian package installation, the tomcat logs can
35 be found under /var/log/tomcat... It is probably similar for other
36 distributions. If you are using the tarball from jakarta.apache.org, the logs
37 dir. is directly in the root of the tomcat tree.
38
39 Patches
40 =======
41
42 Please send in patches that are a diff between an unmodified tree and your tree
43 with the changes:
44
45 diff -Nur standard-mir-dir your-mir-dir
46