source: trunk/j/doc/logging.html @ 2

Last change on this file since 2 was 2, checked in by piso, 18 years ago

Initial checkin.

File size: 1.4 KB
Line 
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>
13J keeps a log of interesting events in the file ~/.j/log (or C:\.j\log). By
14default, only errors are logged.
15<p>
16When debugging is enabled, debugging information is also logged, and all
17output sent to the log file is also sent to System.err, so it can be seen in
18the console window from which j was started.
19<p>
20You 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>
25The maximum size of the log file is controlled by the property
26<a href="preferences.html#Log.maxFileSize">Log.maxFileSize</a>; the default is
27100 KB. When the log file exceeds its maximum size, it is rolled over to the
28file ~/.j/log.0, which in turn is rolled over to ~/.j/log.1, etc. The maximum
29backup index is controlled by the property
30<a href="preferences.html#Log.maxBackupIndex">Log.maxBackupIndex</a>; the
31default is zero, which means one backup is made.
32<p>
33To 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>
38If logging is disabled, nothing will be written to the log file, but if
39debugging is enabled, log output will still be sent to System.err.
40</body>
41</html>
Note: See TracBrowser for help on using the repository browser.