diff options
Diffstat (limited to 'src/site/apt/index.apt')
-rw-r--r-- | src/site/apt/index.apt | 56 |
1 files changed, 56 insertions, 0 deletions
diff --git a/src/site/apt/index.apt b/src/site/apt/index.apt new file mode 100644 index 0000000..8148e75 --- /dev/null +++ b/src/site/apt/index.apt @@ -0,0 +1,56 @@ +~~ Licensed to the Apache Software Foundation (ASF) under one or more +~~ contributor license agreements. See the NOTICE file distributed with +~~ this work for additional information regarding copyright ownership. +~~ The ASF licenses this file to You under the Apache License, Version 2.0 +~~ (the "License"); you may not use this file except in compliance with +~~ the License. You may obtain a copy of the License at +~~ +~~ http://www.apache.org/licenses/LICENSE-2.0 +~~ +~~ Unless required by applicable law or agreed to in writing, software +~~ distributed under the License is distributed on an "AS IS" BASIS, +~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +~~ See the License for the specific language governing permissions and +~~ limitations under the License. + ------ +Short introduction to Apache log4cxx + ------ + ------ + ------ + +Short introduction to Apache log4cxx + + Apache log4cxx is currently undergoing Incubation at the Apache Software Foundation. + + Apache log4cxx is a logging framework for C++ patterned after + {{{http://logging.apache.org/log4j}Apache log4j}}, which uses + {{{http://apr.apache.org}Apache Portable Runtime}} for most platform-specific code and should + be usable on any platform supported by APR. Apache log4cxx is licensed under the + {{{http://www.apache.org/licenses}Apache License}}, an open source license certified by the + {{{http://www.opensource.org}Open Source Initiative}}. + + Almost every large application includes its own logging or tracing API. Inserting log + statements into code is a low-tech method for debugging it. It may also be the only way because + debuggers are not always available or applicable. This is usually the case for multithreaded + applications and distributed applications at large. + + Experience indicates that logging is an important component of the development cycle. It offers + several advantages. It provides precise <em>context</em> about a run of the application. Once + inserted into the code, the generation of logging output requires no human intervention. + Moreover, log output can be saved in persistent medium to be studied at a later time. In + addition to its use in the development cycle, a sufficiently rich logging package can also be + viewed as an auditing tool. + + Logging does have its drawbacks. It can slow down an application. If too verbose, it can cause + scrolling blindness. To alleviate these concerns, log4cxx is designed to be reliable, fast and + extensible. Since logging is rarely the main focus of an application, the log4cxx API strives + to be simple to understand and to use. + +Disclaimer + + Apache log4cxx is an effort undergoing incubation at The Apache Software Foundation (ASF), + sponsored by Apache Logging Services. Incubation is required of all newly accepted + projects until a further review indicates that the infrastructure, communications, and decision + making process have stabilized in a manner consistent with other successful ASF projects. While + incubation status is not necessarily a reflection of the completeness or stability of the code, + it does indicate that the project has yet to be fully endorsed by the ASF.
\ No newline at end of file |