| 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> |
|---|
| 2 | <html> |
|---|
| 3 | <head> |
|---|
| 4 | <title>J User's Guide - Logging</title> |
|---|
| 5 | <LINK REL="stylesheet" HREF="j.css" TYPE="text/css"> |
|---|
| 6 | </head> |
|---|
| 7 | <body> |
|---|
| 8 | <a href="contents.html">Top</a> |
|---|
| 9 | <hr> |
|---|
| 10 | <h1>Logging</h1> |
|---|
| 11 | <hr> |
|---|
| 12 | <p> |
|---|
| 13 | J keeps a log of interesting events in the file ~/.j/log (or C:\.j\log). By |
|---|
| 14 | default, only errors are logged. |
|---|
| 15 | <p> |
|---|
| 16 | When debugging is enabled, debugging information is also logged, and all |
|---|
| 17 | output sent to the log file is also sent to System.err, so it can be seen in |
|---|
| 18 | the console window from which j was started. |
|---|
| 19 | <p> |
|---|
| 20 | You can enable debugging by adding the following line to your |
|---|
| 21 | <a href="preferences.html">preferences</a> file: |
|---|
| 22 | <pre> |
|---|
| 23 | debug = true</pre> |
|---|
| 24 | <p> |
|---|
| 25 | The maximum size of the log file is controlled by the property |
|---|
| 26 | <a href="preferences.html#Log.maxFileSize">Log.maxFileSize</a>; the default is |
|---|
| 27 | 100 KB. When the log file exceeds its maximum size, it is rolled over to the |
|---|
| 28 | file ~/.j/log.0, which in turn is rolled over to ~/.j/log.1, etc. The maximum |
|---|
| 29 | backup index is controlled by the property |
|---|
| 30 | <a href="preferences.html#Log.maxBackupIndex">Log.maxBackupIndex</a>; the |
|---|
| 31 | default is zero, which means one backup is made. |
|---|
| 32 | <p> |
|---|
| 33 | To disable logging entirely, add this line to your |
|---|
| 34 | <a href="preferences.html">preferences</a> file: |
|---|
| 35 | <pre> |
|---|
| 36 | Log.enabled = false</pre> |
|---|
| 37 | <p> |
|---|
| 38 | If logging is disabled, nothing will be written to the log file, but if |
|---|
| 39 | debugging is enabled, log output will still be sent to System.err. |
|---|
| 40 | </body> |
|---|
| 41 | </html> |
|---|
