diff options
Diffstat (limited to 'branch-master/logging-api.html')
| -rw-r--r-- | branch-master/logging-api.html | 213 |
1 files changed, 114 insertions, 99 deletions
diff --git a/branch-master/logging-api.html b/branch-master/logging-api.html index 33835508..5a575bc0 100644 --- a/branch-master/logging-api.html +++ b/branch-master/logging-api.html @@ -37,7 +37,7 @@ namespace. </ul> <span class="toc-header">Namespaces</span> <ul id="left-sidebar-list"> - <li><a href="accumulators-api.html" class="wiki_link">accumulators</a></li><li><a href="agent-utils-api.html" class="wiki_link">agent-utils</a></li><li><a href="apply-macro-api.html" class="wiki_link">apply-macro</a></li><li><a href="base64-api.html" class="wiki_link">base64</a></li><li><a href="classpath-api.html" class="wiki_link">classpath</a></li><li><a href="combinatorics-api.html" class="wiki_link">combinatorics</a></li><li><a href="command-line-api.html" class="wiki_link">command-line</a></li><li><a href="complex-numbers-api.html" class="wiki_link">complex-numbers</a></li><li><a href="cond-api.html" class="wiki_link">cond</a></li><li><a href="condition-api.html" class="wiki_link">condition</a></li><li><a href="core-api.html" class="wiki_link">core</a></li><li><a href="dataflow-api.html" class="wiki_link">dataflow</a></li><li><a href="datalog-api.html" class="wiki_link">datalog</a></li><li><a href="def-api.html" class="wiki_link">def</a></li><li><a href="duck-streams-api.html" class="wiki_link">duck-streams</a></li><li><a href="error-kit-api.html" class="wiki_link">error-kit</a></li><li><a href="except-api.html" class="wiki_link">except</a></li><li><a href="fcase-api.html" class="wiki_link">fcase</a></li><li><a href="find-namespaces-api.html" class="wiki_link">find-namespaces</a></li><li><a href="fnmap-api.html" class="wiki_link">fnmap</a></li><li><a href="gen-html-docs-api.html" class="wiki_link">gen-html-docs</a></li><li><a href="generic.arithmetic-api.html" class="wiki_link">generic.arithmetic</a></li><li><a href="generic.collection-api.html" class="wiki_link">generic.collection</a></li><li><a href="generic.comparison-api.html" class="wiki_link">generic.comparison</a></li><li><a href="generic.functor-api.html" class="wiki_link">generic.functor</a></li><li><a href="generic.math-functions-api.html" class="wiki_link">generic.math-functions</a></li><li><a href="graph-api.html" class="wiki_link">graph</a></li><li><a href="greatest-least-api.html" class="wiki_link">greatest-least</a></li><li><a href="http.agent-api.html" class="wiki_link">http.agent</a></li><li><a href="http.connection-api.html" class="wiki_link">http.connection</a></li><li><a href="import-static-api.html" class="wiki_link">import-static</a></li><li><a href="io-api.html" class="wiki_link">io</a></li><li><a href="jar-api.html" class="wiki_link">jar</a></li><li><a href="java-utils-api.html" class="wiki_link">java-utils</a></li><li><a href="javadoc.browse-api.html" class="wiki_link">javadoc.browse</a></li><li><a href="jmx-api.html" class="wiki_link">jmx</a></li><li><a href="json-api.html" class="wiki_link">json</a></li><li><a href="lazy-seqs-api.html" class="wiki_link">lazy-seqs</a></li><li><a href="lazy-xml-api.html" class="wiki_link">lazy-xml</a></li><li><a href="logging-api.html" class="wiki_link">logging</a></li><li><a href="macro-utils-api.html" class="wiki_link">macro-utils</a></li><li><a href="macros-api.html" class="wiki_link">macros</a></li><li><a href="map-utils-api.html" class="wiki_link">map-utils</a></li><li><a href="math-api.html" class="wiki_link">math</a></li><li><a href="miglayout-api.html" class="wiki_link">miglayout</a></li><li><a href="mmap-api.html" class="wiki_link">mmap</a></li><li><a href="mock-api.html" class="wiki_link">mock</a></li><li><a href="monadic-io-streams-api.html" class="wiki_link">monadic-io-streams</a></li><li><a href="monads-api.html" class="wiki_link">monads</a></li><li><a href="ns-utils-api.html" class="wiki_link">ns-utils</a></li><li><a href="pprint-api.html" class="wiki_link">pprint</a></li><li><a href="priority-map-api.html" class="wiki_link">priority-map</a></li><li><a href="probabilities.finite-distributions-api.html" class="wiki_link">probabilities.finite-distributions</a></li><li><a href="probabilities.monte-carlo-api.html" class="wiki_link">probabilities.monte-carlo</a></li><li><a href="probabilities.random-numbers-api.html" class="wiki_link">probabilities.random-numbers</a></li><li><a href="profile-api.html" class="wiki_link">profile</a></li><li><a href="properties-api.html" class="wiki_link">properties</a></li><li><a href="prxml-api.html" class="wiki_link">prxml</a></li><li><a href="reflect-api.html" class="wiki_link">reflect</a></li><li><a href="repl-ln-api.html" class="wiki_link">repl-ln</a></li><li><a href="repl-utils-api.html" class="wiki_link">repl-utils</a></li><li><a href="seq-api.html" class="wiki_link">seq</a></li><li><a href="seq-utils-api.html" class="wiki_link">seq-utils</a></li><li><a href="server-socket-api.html" class="wiki_link">server-socket</a></li><li><a href="set-api.html" class="wiki_link">set</a></li><li><a href="shell-api.html" class="wiki_link">shell</a></li><li><a href="shell-out-api.html" class="wiki_link">shell-out</a></li><li><a href="singleton-api.html" class="wiki_link">singleton</a></li><li><a href="sql-api.html" class="wiki_link">sql</a></li><li><a href="str-utils-api.html" class="wiki_link">str-utils</a></li><li><a href="str-utils2-api.html" class="wiki_link">str-utils2</a></li><li><a href="stream-utils-api.html" class="wiki_link">stream-utils</a></li><li><a href="string-api.html" class="wiki_link">string</a></li><li><a href="strint-api.html" class="wiki_link">strint</a></li><li><a href="swing-utils-api.html" class="wiki_link">swing-utils</a></li><li><a href="test-complex-numbers-api.html" class="wiki_link">test-complex-numbers</a></li><li><a href="test-contrib.mock-test.test-adapter-test-api.html" class="wiki_link">test-contrib.mock-test.test-adapter-test</a></li><li><a href="test-core-api.html" class="wiki_link">test-core</a></li><li><a href="test-dataflow-api.html" class="wiki_link">test-dataflow</a></li><li><a href="test-def-api.html" class="wiki_link">test-def</a></li><li><a href="test-fnmap-api.html" class="wiki_link">test-fnmap</a></li><li><a href="test-graph-api.html" class="wiki_link">test-graph</a></li><li><a href="test-greatest-least-api.html" class="wiki_link">test-greatest-least</a></li><li><a href="test-io-api.html" class="wiki_link">test-io</a></li><li><a href="test-is-api.html" class="wiki_link">test-is</a></li><li><a href="test-jmx-api.html" class="wiki_link">test-jmx</a></li><li><a href="test-json-api.html" class="wiki_link">test-json</a></li><li><a href="test-lazy-seqs-api.html" class="wiki_link">test-lazy-seqs</a></li><li><a href="test-logging-api.html" class="wiki_link">test-logging</a></li><li><a href="test-macro-utils-api.html" class="wiki_link">test-macro-utils</a></li><li><a href="test-math-api.html" class="wiki_link">test-math</a></li><li><a href="test-miglayout-api.html" class="wiki_link">test-miglayout</a></li><li><a href="test-mock-api.html" class="wiki_link">test-mock</a></li><li><a href="test-monads-api.html" class="wiki_link">test-monads</a></li><li><a href="test-profile-api.html" class="wiki_link">test-profile</a></li><li><a href="test-properties-api.html" class="wiki_link">test-properties</a></li><li><a href="test-prxml-api.html" class="wiki_link">test-prxml</a></li><li><a href="test-repl-utils-api.html" class="wiki_link">test-repl-utils</a></li><li><a href="test-seq-api.html" class="wiki_link">test-seq</a></li><li><a href="test-shell-api.html" class="wiki_link">test-shell</a></li><li><a href="test-sql-api.html" class="wiki_link">test-sql</a></li><li><a href="test-string-api.html" class="wiki_link">test-string</a></li><li><a href="test-strint-api.html" class="wiki_link">test-strint</a></li><li><a href="test-trace-api.html" class="wiki_link">test-trace</a></li><li><a href="test-with-ns-api.html" class="wiki_link">test-with-ns</a></li><li><a href="trace-api.html" class="wiki_link">trace</a></li><li><a href="types-api.html" class="wiki_link">types</a></li><li><a href="with-ns-api.html" class="wiki_link">with-ns</a></li><li><a href="zip-filter-api.html" class="wiki_link">zip-filter</a></li> + <li><a href="accumulators-api.html" class="wiki_link">accumulators</a></li><li><a href="agent-utils-api.html" class="wiki_link">agent-utils</a></li><li><a href="base64-api.html" class="wiki_link">base64</a></li><li><a href="classpath-api.html" class="wiki_link">classpath</a></li><li><a href="combinatorics-api.html" class="wiki_link">combinatorics</a></li><li><a href="command-line-api.html" class="wiki_link">command-line</a></li><li><a href="complex-numbers-api.html" class="wiki_link">complex-numbers</a></li><li><a href="cond-api.html" class="wiki_link">cond</a></li><li><a href="condition-api.html" class="wiki_link">condition</a></li><li><a href="core-api.html" class="wiki_link">core</a></li><li><a href="dataflow-api.html" class="wiki_link">dataflow</a></li><li><a href="datalog-api.html" class="wiki_link">datalog</a></li><li><a href="def-api.html" class="wiki_link">def</a></li><li><a href="error-kit-api.html" class="wiki_link">error-kit</a></li><li><a href="except-api.html" class="wiki_link">except</a></li><li><a href="fcase-api.html" class="wiki_link">fcase</a></li><li><a href="find-namespaces-api.html" class="wiki_link">find-namespaces</a></li><li><a href="fnmap-api.html" class="wiki_link">fnmap</a></li><li><a href="gen-html-docs-api.html" class="wiki_link">gen-html-docs</a></li><li><a href="generic.arithmetic-api.html" class="wiki_link">generic.arithmetic</a></li><li><a href="generic.collection-api.html" class="wiki_link">generic.collection</a></li><li><a href="generic.comparison-api.html" class="wiki_link">generic.comparison</a></li><li><a href="generic.functor-api.html" class="wiki_link">generic.functor</a></li><li><a href="generic.math-functions-api.html" class="wiki_link">generic.math-functions</a></li><li><a href="graph-api.html" class="wiki_link">graph</a></li><li><a href="greatest-least-api.html" class="wiki_link">greatest-least</a></li><li><a href="import-static-api.html" class="wiki_link">import-static</a></li><li><a href="io-api.html" class="wiki_link">io</a></li><li><a href="jar-api.html" class="wiki_link">jar</a></li><li><a href="jmx-api.html" class="wiki_link">jmx</a></li><li><a href="json-api.html" class="wiki_link">json</a></li><li><a href="lazy-seqs-api.html" class="wiki_link">lazy-seqs</a></li><li><a href="lazy-xml-api.html" class="wiki_link">lazy-xml</a></li><li><a href="logging-api.html" class="wiki_link">logging</a></li><li><a href="macro-utils-api.html" class="wiki_link">macro-utils</a></li><li><a href="macros-api.html" class="wiki_link">macros</a></li><li><a href="map-utils-api.html" class="wiki_link">map-utils</a></li><li><a href="math-api.html" class="wiki_link">math</a></li><li><a href="miglayout-api.html" class="wiki_link">miglayout</a></li><li><a href="mmap-api.html" class="wiki_link">mmap</a></li><li><a href="mock-api.html" class="wiki_link">mock</a></li><li><a href="monadic-io-streams-api.html" class="wiki_link">monadic-io-streams</a></li><li><a href="monads-api.html" class="wiki_link">monads</a></li><li><a href="ns-utils-api.html" class="wiki_link">ns-utils</a></li><li><a href="priority-map-api.html" class="wiki_link">priority-map</a></li><li><a href="probabilities.finite-distributions-api.html" class="wiki_link">probabilities.finite-distributions</a></li><li><a href="probabilities.monte-carlo-api.html" class="wiki_link">probabilities.monte-carlo</a></li><li><a href="probabilities.random-numbers-api.html" class="wiki_link">probabilities.random-numbers</a></li><li><a href="profile-api.html" class="wiki_link">profile</a></li><li><a href="properties-api.html" class="wiki_link">properties</a></li><li><a href="prxml-api.html" class="wiki_link">prxml</a></li><li><a href="reflect-api.html" class="wiki_link">reflect</a></li><li><a href="repl-ln-api.html" class="wiki_link">repl-ln</a></li><li><a href="repl-utils-api.html" class="wiki_link">repl-utils</a></li><li><a href="seq-api.html" class="wiki_link">seq</a></li><li><a href="server-socket-api.html" class="wiki_link">server-socket</a></li><li><a href="set-api.html" class="wiki_link">set</a></li><li><a href="singleton-api.html" class="wiki_link">singleton</a></li><li><a href="sql-api.html" class="wiki_link">sql</a></li><li><a href="stream-utils-api.html" class="wiki_link">stream-utils</a></li><li><a href="string-api.html" class="wiki_link">string</a></li><li><a href="strint-api.html" class="wiki_link">strint</a></li><li><a href="swing-utils-api.html" class="wiki_link">swing-utils</a></li><li><a href="trace-api.html" class="wiki_link">trace</a></li><li><a href="types-api.html" class="wiki_link">types</a></li><li><a href="with-ns-api.html" class="wiki_link">with-ns</a></li><li><a href="zip-filter-api.html" class="wiki_link">zip-filter</a></li> </ul> <div class="BranchTOC"> <span class="toc-header">Other Versions</span> @@ -58,12 +58,8 @@ namespace. <div style="margin-left: 1em;" class="toc-section"> <a href="#toc0">Overview</a> <div style="margin-left: 1em;" class="toc-entry"> - <a href="#clojure.contrib.logging/*allow-direct-logging*">*allow-direct-logging*</a> - </div><div style="margin-left: 1em;" class="toc-entry"> <a href="#clojure.contrib.logging/*force*">*force*</a> </div><div style="margin-left: 1em;" class="toc-entry"> - <a href="#clojure.contrib.logging/*impl-name*">*impl-name*</a> - </div><div style="margin-left: 1em;" class="toc-entry"> <a href="#clojure.contrib.logging/*log-factory*">*log-factory*</a> </div><div style="margin-left: 1em;" class="toc-entry"> <a href="#clojure.contrib.logging/*logging-agent*">*logging-agent*</a> @@ -74,6 +70,8 @@ namespace. </div><div style="margin-left: 1em;" class="toc-entry"> <a href="#clojure.contrib.logging/LogFactory">LogFactory</a> </div><div style="margin-left: 1em;" class="toc-entry"> + <a href="#clojure.contrib.logging/commons-logging">commons-logging</a> + </div><div style="margin-left: 1em;" class="toc-entry"> <a href="#clojure.contrib.logging/debug">debug</a> </div><div style="margin-left: 1em;" class="toc-entry"> <a href="#clojure.contrib.logging/debugf">debugf</a> @@ -114,6 +112,8 @@ namespace. </div><div style="margin-left: 1em;" class="toc-entry"> <a href="#clojure.contrib.logging/log-uncapture!">log-uncapture!</a> </div><div style="margin-left: 1em;" class="toc-entry"> + <a href="#clojure.contrib.logging/log4j-logging">log4j-logging</a> + </div><div style="margin-left: 1em;" class="toc-entry"> <a href="#clojure.contrib.logging/logf">logf</a> </div><div style="margin-left: 1em;" class="toc-entry"> <a href="#clojure.contrib.logging/logp">logp</a> @@ -195,17 +195,6 @@ in the user namespace, and :warn or higher in all other namespaces.</pre> <div id="var-entry"> <br /> <hr /> - <h2 id="clojure.contrib.logging/*allow-direct-logging*">*allow-direct-logging*</h2> - <span id="var-type">var</span><br /> - <pre id="var-usage"></pre> - <pre id="var-docstr">A boolean indicating whether direct logging (as opposed to via an agent) is -allowed when not operating from within a transaction. Defaults to true.</pre> - - - -</div><div id="var-entry"> - <br /> - <hr /> <h2 id="clojure.contrib.logging/*force*">*force*</h2> <span id="var-type">var</span><br /> <pre id="var-usage"></pre> @@ -213,17 +202,7 @@ allowed when not operating from within a transaction. Defaults to true.</pre> agent. Defaults to nil. See log* for details.</pre> - <a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L94" id="var-source">Source</a> -</div><div id="var-entry"> - <br /> - <hr /> - <h2 id="clojure.contrib.logging/*impl-name*">*impl-name*</h2> - <span id="var-type">var</span><br /> - <pre id="var-usage"></pre> - <pre id="var-docstr">The name of the logging implementation used.</pre> - - - + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L94" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -236,18 +215,18 @@ returned from find-factory. Can be rebound to provide alternate logging implementations</pre> - <a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L488" id="var-source">Source</a> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L488" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> <h2 id="clojure.contrib.logging/*logging-agent*">*logging-agent*</h2> <span id="var-type">var</span><br /> <pre id="var-usage"></pre> - <pre id="var-docstr">The default agent used for performing logging durng a transaction or when -direct logging is disabled.</pre> - + <pre id="var-docstr">The default agent used for performing logging when direct logging is +disabled. See log* for details.</pre> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L84" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -258,7 +237,7 @@ direct logging is disabled.</pre> running transaction. Defaults to #{:info :warn}. See log* for details.</pre> - <a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L89" id="var-source">Source</a> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L89" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -287,15 +266,27 @@ this library.</pre> </div><div id="var-entry"> <br /> <hr /> + <h2 id="clojure.contrib.logging/commons-logging">commons-logging</h2> + <span id="var-type">function</span><br /> + <pre id="var-usage">Usage: (commons-logging) +</pre> + <pre id="var-docstr">Returns a commons-logging-based implementation of the LogFactory protocol, or +nil if not available. End-users should not need to call this.</pre> + + + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L334" id="var-source">Source</a> +</div><div id="var-entry"> + <br /> + <hr /> <h2 id="clojure.contrib.logging/debug">debug</h2> <span id="var-type">macro</span><br /> - <pre id="var-usage">Usage: (debug message) - (debug message throwable) + <pre id="var-usage">Usage: (debug level message & more) + (debug level throwable message & more) </pre> - <pre id="var-docstr">Logs a message at the debug level.</pre> - + <pre id="var-docstr">Debug level logging using print-style args.</pre> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L265" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -307,7 +298,7 @@ this library.</pre> <pre id="var-docstr">Debug level logging using format.</pre> - <a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L301" id="var-source">Source</a> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L301" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -321,19 +312,19 @@ should only be necessary if one needs to execute alternate code paths beyond whether the log should be written to.</pre> - + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L164" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> <h2 id="clojure.contrib.logging/error">error</h2> <span id="var-type">macro</span><br /> - <pre id="var-usage">Usage: (error message) - (error message throwable) + <pre id="var-usage">Usage: (error level message & more) + (error level throwable message & more) </pre> - <pre id="var-docstr">Logs a message at the error level.</pre> - + <pre id="var-docstr">Error level logging using print-style args.</pre> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L283" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -345,19 +336,19 @@ whether the log should be written to.</pre> <pre id="var-docstr">Error level logging using format.</pre> - <a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L319" id="var-source">Source</a> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L319" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> <h2 id="clojure.contrib.logging/fatal">fatal</h2> <span id="var-type">macro</span><br /> - <pre id="var-usage">Usage: (fatal message) - (fatal message throwable) + <pre id="var-usage">Usage: (fatal level message & more) + (fatal level throwable message & more) </pre> - <pre id="var-docstr">Logs a message at the fatal level.</pre> - + <pre id="var-docstr">Fatal level logging using print-style args.</pre> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L289" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -369,7 +360,7 @@ whether the log should be written to.</pre> <pre id="var-docstr">Fatal level logging using format.</pre> - <a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L325" id="var-source">Source</a> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L325" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -382,13 +373,14 @@ slf4j-logging, log4j-logging, or java-util-logging. End-users should not need to call this.</pre> - <a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L475" id="var-source">Source</a> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L475" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> <h2 id="clojure.contrib.logging/impl-enabled?">impl-enabled?</h2> - <span id="var-type">var</span><br /> - <pre id="var-usage"></pre> + <span id="var-type">function</span><br /> + <pre id="var-usage">Usage: (impl-enabled? log level) +</pre> <pre id="var-docstr">Implementation-specific check if a particular level is enabled. End-users should not need to call this.</pre> @@ -398,10 +390,11 @@ should not need to call this.</pre> <br /> <hr /> <h2 id="clojure.contrib.logging/impl-get-log">impl-get-log</h2> - <span id="var-type">var</span><br /> - <pre id="var-usage"></pre> - <pre id="var-docstr">Returns an implementation-specific log by string namespace. End-users should -not need to call this.</pre> + <span id="var-type">function</span><br /> + <pre id="var-usage">Usage: (impl-get-log factory log-ns) +</pre> + <pre id="var-docstr">Returns an implementation-specific Log by namespace. End-users should not +need to call this.</pre> @@ -420,10 +413,11 @@ not need to call this.</pre> <br /> <hr /> <h2 id="clojure.contrib.logging/impl-write!">impl-write!</h2> - <span id="var-type">var</span><br /> - <pre id="var-usage"></pre> - <pre id="var-docstr">Implementation-specific write of a log message. End-users should not need to -call this.</pre> + <span id="var-type">function</span><br /> + <pre id="var-usage">Usage: (impl-write! log level throwable message) +</pre> + <pre id="var-docstr">Implementation-specific write of a log message. End-users should not need +to call this.</pre> @@ -432,13 +426,13 @@ call this.</pre> <hr /> <h2 id="clojure.contrib.logging/info">info</h2> <span id="var-type">macro</span><br /> - <pre id="var-usage">Usage: (info message) - (info message throwable) + <pre id="var-usage">Usage: (info level message & more) + (info level throwable message & more) </pre> - <pre id="var-docstr">Logs a message at the info level.</pre> - + <pre id="var-docstr">Info level logging using print-style args.</pre> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L271" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -450,7 +444,7 @@ call this.</pre> <pre id="var-docstr">Info level logging using format.</pre> - <a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L307" id="var-source">Source</a> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L307" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -462,21 +456,22 @@ call this.</pre> or nil if not available. End-users should not need to call this.</pre> - <a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L439" id="var-source">Source</a> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L439" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> <h2 id="clojure.contrib.logging/log">log</h2> <span id="var-type">macro</span><br /> <pre id="var-usage">Usage: (log level message) - (log level message throwable) - (log level message throwable log-ns) + (log level throwable message) + (log log-ns level throwable message) + (log log-factory log-ns level throwable message) </pre> - <pre id="var-docstr">Logs a message, either directly or via an agent. Also see the level-specific -convenience macros.</pre> - + <pre id="var-docstr">Evaluates and logs a message only if the specified level is enabled. See log* +for more details.</pre> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L124" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -498,21 +493,27 @@ One can override the above by setting *force* to :direct or :agent; all subsequent writes will be direct or via an agent, respectively.</pre> - <a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L99" id="var-source">Source</a> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L99" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> <h2 id="clojure.contrib.logging/log-capture!">log-capture!</h2> <span id="var-type">function</span><br /> <pre id="var-usage">Usage: (log-capture! log-ns) + (log-capture! log-ns out-level err-level) </pre> - <pre id="var-docstr">Captures System.out and System.err, redirecting all writes of those streams -to :info and :error logging, respectively. The specified log-ns value will -be used to namespace all redirected logging. NOTE: this will not redirect -output of *out* or *err*; for that, use with-logs.</pre> - + <pre id="var-docstr">Captures System.out and System.err, piping all writes of those streams to +the log. If unspecified, levels default to :info and :error, respectively. +The specified log-ns value will be used to namespace all log entries. + +Note: use with-logs to redirect output of *out* or *err*. + +Warning: if the logging implementation is configured to output to System.out +(as is the default with java.util.logging) then using this function will +result in StackOverflowException when writing to the log.</pre> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L207" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -520,11 +521,10 @@ output of *out* or *err*; for that, use with-logs.</pre> <span id="var-type">function</span><br /> <pre id="var-usage">Usage: (log-stream level log-ns) </pre> - <pre id="var-docstr">Creates a PrintStream that will output to the log. End-users should not need -to invoke this.</pre> - + <pre id="var-docstr">Creates a PrintStream that will output to the log at the specified level.</pre> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L189" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -535,7 +535,19 @@ to invoke this.</pre> <pre id="var-docstr">Restores System.out and System.err to their original values.</pre> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L227" id="var-source">Source</a> +</div><div id="var-entry"> + <br /> + <hr /> + <h2 id="clojure.contrib.logging/log4j-logging">log4j-logging</h2> + <span id="var-type">function</span><br /> + <pre id="var-usage">Usage: (log4j-logging) +</pre> + <pre id="var-docstr">Returns a log4j-based implementation of the LogFactory protocol, or nil if +not available. End-users should not need to call this.</pre> + + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L405" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -548,7 +560,7 @@ to invoke this.</pre> throwable as its second arg. See level-specific macros, e.g., debugf.</pre> - <a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L151" id="var-source">Source</a> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L151" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -561,7 +573,7 @@ throwable as its second arg. See level-specific macros, e.g., debugf.</pre> second arg. See level-specific macros, e.g., debug.</pre> - <a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L138" id="var-source">Source</a> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L138" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -573,31 +585,32 @@ second arg. See level-specific macros, e.g., debug.</pre> not available. End-users should not need to call this.</pre> - <a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L369" id="var-source">Source</a> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L369" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> <h2 id="clojure.contrib.logging/spy">spy</h2> <span id="var-type">macro</span><br /> <pre id="var-usage">Usage: (spy expr) + (spy level expr) </pre> - <pre id="var-docstr">Evaluates expr and outputs the form and its result to the debug log; returns -the result of expr.</pre> - + <pre id="var-docstr">Evaluates expr and writes the form and its result to the log. Returns the +result of expr. Defaults to debug log level.</pre> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L173" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> <h2 id="clojure.contrib.logging/trace">trace</h2> <span id="var-type">macro</span><br /> - <pre id="var-usage">Usage: (trace message) - (trace message throwable) + <pre id="var-usage">Usage: (trace level message & more) + (trace level throwable message & more) </pre> - <pre id="var-docstr">Logs a message at the trace level.</pre> - + <pre id="var-docstr">Trace level logging using print-style args.</pre> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L259" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -609,19 +622,19 @@ the result of expr.</pre> <pre id="var-docstr">Trace level logging using format.</pre> - <a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L295" id="var-source">Source</a> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L295" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> <h2 id="clojure.contrib.logging/warn">warn</h2> <span id="var-type">macro</span><br /> - <pre id="var-usage">Usage: (warn message) - (warn message throwable) + <pre id="var-usage">Usage: (warn level message & more) + (warn level throwable message & more) </pre> - <pre id="var-docstr">Logs a message at the warn level.</pre> - + <pre id="var-docstr">Warn level logging using print-style args.</pre> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L277" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> @@ -633,20 +646,22 @@ the result of expr.</pre> <pre id="var-docstr">Warn level logging using format.</pre> - <a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L313" id="var-source">Source</a> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L313" id="var-source">Source</a> </div><div id="var-entry"> <br /> <hr /> <h2 id="clojure.contrib.logging/with-logs">with-logs</h2> <span id="var-type">macro</span><br /> <pre id="var-usage">Usage: (with-logs log-ns & body) + (with-logs [log-ns out-level err-level] & body) </pre> - <pre id="var-docstr">Evaluates exprs in a context in which *out* and *err* are bound to :info and -:error logging, respectively. The specified log-ns value will be used to -namespace all redirected logging.</pre> - + <pre id="var-docstr">Evaluates exprs in a context in which *out* and *err* write to the log. The +specified log-ns value will be used to namespace all log entries. + +By default *out* and *err* write to :info and :error, respectively.</pre> + <a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L236" id="var-source">Source</a> </div> |