You are viewing a plain text version of this content. The canonical link for it is here.
Posted to log4cxx-user@logging.apache.org by "Jacob L. Anawalt" <ja...@geckosoftware.com> on 2008/02/26 19:04:30 UTC
Seeking documentation
Hello,
I'm starting to try log4cxx in a C++ program developed on Debian 4.0 (etch). I
read the short introduction [1] and then adapted information from there into my
program. It has been pleasant to have everything so far 'just work'.
I think I am now to the point where I understand everything in the introduction,
but am not familiar enough with log4cxx, or even log4j, to make the jump from
the introduction to the doxygen reference. After reading the brief FAQ on the
wiki, trying for a couple of weeks to hit links to the mailing lists and other
places pointing to the unresponsive nagoya.apache.org [2,3,4,5], and reading
log4j articles I feel only slightly closer to my current questions and others
that loom on the horizon.
Are there any other suggested places to read about implementing, configuring and
using log4cxx?
Should all the nagaya references be replaced with service names like
mail-archives or issues? [6]
[1] http://logging.apache.org/log4cxx/manual.html
[2] http://wiki.apache.org/logging-log4cxx/ (link to search user mailing list
archives)
[3] http://marc.info/?l=log4cxx-user&m=114413383713402&w=2
[4] http://www.apache.org/dev/machines.html#nagoya
[5] http://monitoring.apache.org/status/
[6]
http://mail-archives.apache.org/mod_mbox/tomcat-dev/200501.mbox/%3C20050101123839.67438.qmail@minotaur.apache.org%3E
--
Jacob Anawalt
Gecko Software, Inc.
janawalt@geckosoftware.com
435-752-8026
Re: Seeking documentation
Posted by "Jacob L. Anawalt" <ja...@geckosoftware.com>.
Curt Arnold wrote:
> log4cxx has minimal independent documentation since it attempts to mimic
> log4j. Unfortunately, log4j also has a gap between the freely available
> intro and the freely available source code. There are two commercial
> log4j books but they are not products of the Apache Software
> Foundation. The priority on log4j would be to move on the log4j 2.0 and
> document it during development instead of documenting log4j 1.2 5 years
> or so after initial release.
I am planning on getting the book as a reference and to help other developers
who may work on my project get up to speed, but I wanted to get slightly deeper
proof of concept code going before we commit to it.
I wasn't expecting anything new to be written for the older code, just hoping
others knew of some additional handy resources. I was also wondering if I just
"didn't get it" when using the Wiki. When I search I often get results like 7
results of 704 pages doing a full text search for "log4cxx" but the title index
is only 20 pages so I wondered if somehow I was missing something. Maybe it's
just all the wiki help pages in lots of languages.
At this point I think I'll ask individual questions here when I don't find the
answer in the archives, and update the wiki when I think I have a nice summary
to add.
> nagoya should be replaced by issues when it refers to JIRA. Please feel
> free to change those on the Wiki.
I couldn't find eyebrowse anywhere. Maybe it's been replaced by mod_mbox like
the project mailing lists page links to? If so then I think I have the mailing
list links set up correctly on the wiki.
--
Jacob Anawalt
Gecko Software, Inc.
janawalt@geckosoftware.com
435-752-8026
Re: Seeking documentation
Posted by Curt Arnold <ca...@apache.org>.
On Feb 26, 2008, at 12:04 PM, Jacob L. Anawalt wrote:
> Hello,
>
> I'm starting to try log4cxx in a C++ program developed on Debian 4.0
> (etch). I read the short introduction [1] and then adapted
> information from there into my program. It has been pleasant to have
> everything so far 'just work'.
>
> I think I am now to the point where I understand everything in the
> introduction, but am not familiar enough with log4cxx, or even
> log4j, to make the jump from the introduction to the doxygen
> reference. After reading the brief FAQ on the wiki, trying for a
> couple of weeks to hit links to the mailing lists and other places
> pointing to the unresponsive nagoya.apache.org [2,3,4,5], and
> reading log4j articles I feel only slightly closer to my current
> questions and others that loom on the horizon.
>
The Wiki is publicly writable and I've had minimal personal
involvement other than the occasional removal of defacement. After
the upcoming log4cxx 0.10.0 release, it would be good to go through
the Wiki and flag articles that might be outdated.
> Are there any other suggested places to read about implementing,
> configuring and using log4cxx?
log4cxx has minimal independent documentation since it attempts to
mimic log4j. Unfortunately, log4j also has a gap between the freely
available intro and the freely available source code. There are two
commercial log4j books but they are not products of the Apache
Software Foundation. The priority on log4j would be to move on the
log4j 2.0 and document it during development instead of documenting
log4j 1.2 5 years or so after initial release.
>
> Should all the nagaya references be replaced with service names like
> mail-archives or issues? [6]
>
nagoya should be replaced by issues when it refers to JIRA. Please
feel free to change those on the Wiki.
Re: Seeking documentation
Posted by "Jacob L. Anawalt" <ja...@geckosoftware.com>.
renny.koshy@rubixinfotech.com wrote:
> Try this link -- it's a good tutorial on Log4J -- the concepts apply to
> Log4CXX directly:
>
> http://www.vipan.com/htdocs/log4jhelp.html
>
Thank you. It was nice to have a list of some of the Appender's
PropertyConfigurator options.
I am interested in using a SyslogAppender. While wandering though the Doxygen
output reference I found that the ApenderSkeleton class reference seems to be a
reasonable place to get the list of appenders available in my version of the
log4cxx API. Among the classes inheriting from it is SyslogAppender.
What is the fully.qualified.name.of.appender.class?
The intro shows org.apache.log4j.PatternLayout while the log4cxx documentation
for Appender shows just SyslogAppender or RollingFileAppender. Is just the last
part of the name parsed? (I suspect that is the reason for bug LOGCXX-102 [1])
[1] http://issues.apache.org/jira/browse/LOGCXX-102
I see all the methods. Where do I look to see what setFacility for example looks
like in a PropertyConfigurator file? The Appender documentation shows SyslogHost
being set. Is everything with a get/set method pair a valid option for
PropertyConfigurator (and possibly the setOption function)?
Where do I learn how to use the DOMConfigurator?
The Doxygen output says there are sample XML files included in the package but I
can't find them (possibly a Debian package issue if they really were available
and should have been in the -doc package, or the files really weren't part of
the package.) The DTD link [2] in the online log4j 1.2 JavaDoc output for the
DOMConfigurator [3] is broken.
[2] http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/xml/log4j.dtd
[3] http://logging.apache.org/log4j/1.2/apidocs/index.html
--
Jacob Anawalt
Gecko Software, Inc.
janawalt@geckosoftware.com
435-752-8026
Re: Seeking documentation
Posted by re...@rubixinfotech.com.
Jacob -
Try this link -- it's a good tutorial on Log4J -- the concepts apply to
Log4CXX directly:
http://www.vipan.com/htdocs/log4jhelp.html
Renny Koshy
President & CEO
--------------------------------------------
RUBIX Information Technologies, Inc.
www.rubixinfotech.com
"Jacob L.
Anawalt"
<janawalt@geckoso To
ftware.com> log4cxx-user@logging.apache.org
cc
02/26/2008 01:04
PM Subject
Seeking documentation
Please respond to
"Log4CXX User"
<log4cxx-user@log
ging.apache.org>
Hello,
I'm starting to try log4cxx in a C++ program developed on Debian 4.0
(etch). I
read the short introduction [1] and then adapted information from there
into my
program. It has been pleasant to have everything so far 'just work'.
I think I am now to the point where I understand everything in the
introduction,
but am not familiar enough with log4cxx, or even log4j, to make the jump
from
the introduction to the doxygen reference. After reading the brief FAQ on
the
wiki, trying for a couple of weeks to hit links to the mailing lists and
other
places pointing to the unresponsive nagoya.apache.org [2,3,4,5], and
reading
log4j articles I feel only slightly closer to my current questions and
others
that loom on the horizon.
Are there any other suggested places to read about implementing,
configuring and
using log4cxx?
Should all the nagaya references be replaced with service names like
mail-archives or issues? [6]
[1] http://logging.apache.org/log4cxx/manual.html
[2] http://wiki.apache.org/logging-log4cxx/ (link to search user mailing
list
archives)
[3] http://marc.info/?l=log4cxx-user&m=114413383713402&w=2
[4] http://www.apache.org/dev/machines.html#nagoya
[5] http://monitoring.apache.org/status/
[6]
http://mail-archives.apache.org/mod_mbox/tomcat-dev/200501.mbox/%3C20050101123839.67438.qmail@minotaur.apache.org%3E
--
Jacob Anawalt
Gecko Software, Inc.
janawalt@geckosoftware.com
435-752-8026