<?xml version="1.0"?> | |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> | |
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> | |
<head> | |
<title>log4javascript documentation</title> | |
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" /> | |
<meta name="author" content="Tim Down - tim@log4javascript.org" /> | |
<meta name="description" content="log4javascript, a logging framework for JavaScript based on log4j" /> | |
<meta name="robots" content="all" /> | |
<link rel="stylesheet" type="text/css" media="screen,print" href="../main.css" title="Default" /> | |
</head> | |
<body> | |
<div id="container" class="nonav"> | |
<div id="header"> | |
<h1><a href="../index.html">log4javascript</a></h1> | |
<div id="nav"> | |
<a class="navitem" href="../index.html">home</a> | |
| <a class="navitem" href="http://sourceforge.net/projects/log4javascript" target="_blank" title="Download (opens in new window)">download</a> | |
| <span class="navitem">docs</span> | |
| <a class="navitem" href="quickstart.html">quick start</a> | |
| <a class="navitem" href="../demos/index.html">demos</a> | |
| <a class="navitem" href="http://log4javascript.org" target="_blank">website</a> | |
| <a class="navitem" href="http://www.timdown.co.uk" target="_blank">timdown.co.uk</a> | |
</div> | |
</div> | |
<div id="content"> | |
<h1>log4javascript 1.4 documentation</h1> | |
<div id="links"> | |
<h2>Links</h2> | |
<ul> | |
<li><a href="quickstart.html">Quick start</a></li> | |
<li><a href="distribution.html">Details of the log4javascript distribution</a></li> | |
<li><a href="backwardsincompatibilities.html">Backwards incompatibilities</a></li> | |
<li><a href="whatsnew.html">What's new in this release</a></li> | |
<li><a href="../changelog.txt">Change log</a></li> | |
<li><a href="manual.html">log4javascript manual</a></li> | |
<li><a href="lite.html">log4javascript Lite</a></li> | |
<li><a href="manual_lite.html">log4javascript Lite manual</a></li> | |
<li><a href="../demos/basic.html">Basic demo</a></li> | |
<li><a href="../demos/ajax.html">Ajax demo</a></li> | |
</ul> | |
</div> | |
<div id="contents"> | |
<h2>Contents</h2> | |
<ul> | |
<li><a href="#whatitis">What it is</a></li> | |
<li><a href="#whofor">Who it's for</a></li> | |
<li><a href="#previousversions">Note on previous versions</a></li> | |
<li><a href="#features">Features</a></li> | |
<li><a href="#browsers">Browser support</a></li> | |
<li><a href="#licence">Licence</a></li> | |
<li><a href="#furtherreading">Further reading</a></li> | |
</ul> | |
</div> | |
<div id="whatitis"> | |
<h2>What it is</h2> | |
<p> | |
log4javascript is a JavaScript logging framework based on the Java | |
logging framework <a href="http://logging.apache.org/log4j/docs/index.html" | |
title="log4j home page (opens in new window)" target="_blank">log4j</a>. | |
</p> | |
<p> | |
log4javascript implements a subset of log4j (primarily loggers, appenders | |
and layouts) and has a few convenience methods of its own for | |
quick JavaScript development. It can be used to debug JavaScript | |
applications of all sizes, including Ajax applications. | |
</p> | |
<p> | |
If you just want to start using it, try the <a href="quickstart.html">quickstart | |
tutorial</a>. | |
</p> | |
<p class="linktotop"> | |
<a href="#container">Top</a> | |
</p> | |
</div> | |
<div id="whofor"> | |
<h2>Who it's for</h2> | |
<p> | |
log4javascript is aimed at JavaScript developers. | |
</p> | |
<p class="linktotop"> | |
<a href="#container">Top</a> | |
</p> | |
</div> | |
<div id="previousversions"> | |
<h2>Note on previous versions</h2> | |
<p> | |
Documentation for previous versions of log4javascript are not available here. | |
However, documentation is bundled with every previous version, all of which | |
are <a href="http://sourceforge.net/projects/log4javascript" | |
target="_blank" title="Download (opens in new window)">available to download</a>. | |
</p> | |
</div> | |
<div id="features"> | |
<h2>Features</h2> | |
<ul> | |
<li>can be initialized with one JavaScript include and one line of code;</li> | |
<li> | |
by default logs to a pop-up console window with powerful search (including | |
regular expression) and filtering features. This console window can also | |
be used inline as an iframe in the main page; | |
</li> | |
<li> | |
can send log messages to the server via HTTP (Ajax, if you like); | |
</li> | |
<li> | |
highly configurable using familiar methods from log4j, including the | |
powerful <code><a href="manual.html#patternlayout">PatternLayout</a></code> | |
which gives the developer complete control over the format of the log messages. | |
</li> | |
</ul> | |
<p class="linktotop"> | |
<a href="#container">Top</a> | |
</p> | |
</div> | |
<div id="browsers"> | |
<h2>Browser support</h2> | |
<h3>Fully supported browsers:</h3> | |
<ul> | |
<li>All versions Firefox back to 0.6</li> | |
<li>Other Mozilla-based browsers, as far back as Netscape 7</li> | |
<li>Internet Explorer 5 and higher for Windows</li> | |
<li>Safari 1.3 and higher (untested on earlier versions)</li> | |
<li>Opera 8.01 and higher (pre- version 9 browsers have a rendering | |
bug related to scrolling that affects searching in PopUpAppender and InPageAppender)</li> | |
<li>Konqueror 3.4.3 and higher (untested on earlier versions)</li> | |
<li>Google Chrome</li> | |
</ul> | |
<h3>Partially supported browsers:</h3> | |
<ul> | |
<li>Older Mozilla-based browsers, e.g. Netscape 6.2 (generally OK except for | |
display problems searching and filtering PopUpAppender and InPageAppender)</li> | |
<li>Opera 7.0 - 8.0 (InPageAppender not supported until version 7.5, plus some display | |
problems searching PopUpAppender and InPageAppender. AjaxAppender not supported at all)</li> | |
</ul> | |
<h3>Unsupported browsers:</h3> | |
<ul> | |
<li> | |
Internet Explorer for Mac. There are no plans to make log4javascript work | |
in this browser. | |
</li> | |
</ul> | |
<p class="linktotop"> | |
<a href="#container">Top</a> | |
</p> | |
</div> | |
<div id="licence"> | |
<h2>Licence</h2> | |
<p> | |
log4javascript is licenced under the <a href="http://www.apache.org/licenses/LICENSE-2.0.html" | |
title="Apache License, Version 2.0 (opens in new window)" target="_blank">Apache License, | |
Version 2.0</a>. The Apache website has <a href="http://www.apache.org/foundation/licence-FAQ.html#WhatDoesItMEAN" | |
title="View licence (opens in new window)" target="_blank">more details</a>. | |
</p> | |
<p class="linktotop"> | |
<a href="#container">Top</a> | |
</p> | |
</div> | |
<div id="furtherreading"> | |
<h2>Further reading</h2> | |
<p> | |
In order to gain an understanding of the ideas behind log4j and therefore log4javascript, | |
I highly recommend reading the <a href="http://logging.apache.org/log4j/docs/manual.html">short | |
introduction to log4j</a> from the log4j website. log4javascript borrows heavily from | |
log4j but does not carry over all its concepts - for example, Filters and Renderers are not | |
implemented. | |
</p> | |
<p> | |
<a href="manual.html">The full log4javascript manual</a> | |
</p> | |
<p class="linktotop"> | |
<a href="#container">Top</a> | |
</p> | |
</div> | |
</div> | |
<div id="footer"> | |
<span class="externallinkinfo"> | |
<strong>NB.</strong> All external links open in a new window. | |
</span> | |
Written by Tim Down. <a href="mailto:tim@log4javascript.org">tim@log4javascript.org</a> | |
<br /> | |
log4javascript is distributed under the <a href="http://www.apache.org/licenses/LICENSE-2.0.html" | |
title="Apache License, Version 2.0 (opens in new window)" target="_blank">Apache License, | |
Version 2.0</a> | |
</div> | |
</div> | |
</body> | |
</html> |