Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
fork of log4r that adds some hierarchy features from log4j
Ruby JavaScript
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
doc
examples
src
tests
INSTALL
LICENSE
LICENSE.LGPLv3
README
Rakefile
TODO

README

Log4r - A flexible logging library for Ruby


This release:      1.1.2 
Release date:      2009/09/25
License:           Ruby's 
Maintainer:        Colby Gutierrez-Kraybill
Contributors:      Leon Torres          Original Maintainer
                   Martain Stannard     RollingFileOutputter
                   Steve Lumos          SyslogOutputter
                   Andreas Hund         YamlConfigurator
                   Jamis Buck           log4r.gemspec
Homepage:          http://rubyforge.org/projects/log4r/
Download:          http://rubyforge.org/frs/?group_id=203

Summary
-------

Log4r is a comprehensive and flexible logging library written in Ruby for use 
in Ruby programs. It features a hierarchical logging system of any number of 
levels, custom level names, logger inheritance, multiple output destinations 
per log event, execution tracing, custom formatting, thread safteyness, XML 
and YAML configuration, and more.


Requirements
------------

* (required) Ruby >= 1.7.0 (use log4r 1.0.2 for Ruby 1.6)
* (optional) RubyGems for installing Log4r as a gem
* (optional) Ruby syslog library for SyslogOutputter
* (optional) XML configuration requires REXML
* (optional) Remote logging requires ROMP 


More Info
---------

* Installation instructions are in the file INSTALL

* Comprehensive examples are provided in examples/ and can be run right away

* Log4r homepage: doc/index.html
  Online: http://log4r.sourceforge.net/

* Manual: doc/manual.html
  Online: http://rubyforge.org/docman/?group_id=203
  
* RDoc API reference: doc/rdoc/index.html 
  Online: http://rubyforge.org/docman/index.php?group_id=203
  
* The changelog

* Log4r is hosted by RubyForge, which provides news, bug tracking and a forum

* Feel free to bug the maintainer with any questions (listed at top of file)


Usability
---------

Log4r works really well, so please take advantage of it right away! :)
All versions since 0.9.2 have been stable and backward-compatible. The
code is stable enough that updates are infrequent and usually only for
adding features or keeping the code up to date with Ruby.


Platform Issues
---------------

Log4r is known to work on Linux and WindowsXP. It's safe to assume that Log4r 
will work on any Ruby-supported platform.


When Trouble Strikes
--------------------

Log4r comes with an internal logger. To see its output, create a logger
named 'log4r' before any others and give it a suitable outputter,

  trouble = Logger.new['log4r']
  trouble.add Outputter.stdout

Try running the unit tests provided (run the file tests/runtest.rb). Let
the maintainer know what's up and feel free to explore and fix the 
code yourself. It's well documented and written in Ruby. :)

Also, try out the bug/request tracking system at 
http://rubyforge.org/tracker/?group_id=203

Version: $Id: README,v 1.6 2009/09/25 20:34:01 colbygk Exp $
Something went wrong with that request. Please try again.