You can't complain too much because it's open source and the contributors don't get paid for it! If you want a more comprehensive manual, pitch in and write it yourself, or buy the commercial manual!
I've always thought that the short introduction to log4j at http://logging.apache.org/log4j/docs/manual.html was very well written and more than adequate! It gets you up to speed quickly, and for those things you can't figure out there is the javadoc, the code, and the mailing list! I think log4j is better documented than the average open source product. It's pretty well documented! By the way, the short introduction is a little bit out of date now. For example, it doesn't mention that log4j now FIRST looks for an xml file instead of a properties file. That one tripped me up recently. ----- Original Message ---- From: Hans Schwaebli <[EMAIL PROTECTED]> To: Log4J Users List <log4j-user@logging.apache.org> Sent: Thursday, July 26, 2007 9:57:29 AM Subject: Re: log4j Manual, where? Wayne interessierts, so I did not overlook something. The simple fact is that there is no good official manual and no good unofficial free manual. It seems that log4j can afford that, since not many people jump to other logging frameworks. Wayne Cannon <[EMAIL PROTECTED]> wrote: Hans, I agree with you to a limited extent. The for-a-fee manual , or the "Pro Apache Log4j " book, have indexes; but none of them are really well-organized (like the "Ant in Action" book or the online Ant manual you mention). However, I've found that the links on the "http://logging.apache.org/log4j/docs/documentation.html";; page are about as thorough as the books or PDF that you have to pay for and some are at least as good for a step-by-step tutorial format. The "Don't Use System.out.println! Use Log4j by Vipan Singla" is terse/succinct, but contains a pretty thorough set of examples The book is probably best reference for configuring Log4j integrated with a Web application (I'm not using it that way; but I say that only because there is quite a bit of information in the book on the topic). The book also has more information on writing your own custom modules. After purchasing both the downloadable manual and the book, I still find myself going to the links on the above web page and finding them pretty satisfactory, if not well-organized and indexed. Regards, Wayne Hans Schwaebli wrote: > Why is there no good log4j manual? > I can't find it anywhere. If I missed it, please tell me where it is. > The turk who programmed log4j has written a manual, but it is not free. I am > looking for a free manual. > If you don't know what I mean, I mean something like the Ant manual, where > everything is documented. > Thanks. > --------------------------------- Building a website is a piece of cake. Yahoo! Small Business gives you all the tools to get online. ____________________________________________________________________________________ Choose the right car based on your needs. Check out Yahoo! Autos new Car Finder tool. http://autos.yahoo.com/carfinder/
