Development of Log4js
Overview
Log4js is currently one JavaScript file and can be modified by any editor. All the environment arount this file is not nessessarily required to continue development, but will support us in having some stable processes in
- verify sources using jsLint
- run unit tests to have stable versions using JSUnit
- regenerate API documetnations from sources using JSDoc
- generate the fully website for publishing
- generate the archives for releases
Building Project
Coming from Java development, the Apache Ant is used building the project. Ant supports several targets which can be invoked.
To use Ant it is first required to have installed JavaTM first. After that, you can download Ant from the download section of the project pages. Please follow the given installation instructions there.
| Task | Description |
|---|---|
| clean | Cleans the project from generated files |
| dist | distributes and compiles to target directory /build. |
| doc | Create the JSDoc files to the directory /build/doc/api. |
| jsLint | verifies all JavaScript files. |
| release | Creates release archives. |
| site | Generates the web site using Apache Forrest. |
| download-dependencies | tries to download all required libraries, like JSDoc, JSLint and extract them to the /toolsdirectory. |
Coding Guide
There are only some coding guidelines:
- Use tabs for intentions to save characters.
- Use descreptive names
- appropriate JSDoc is required
- jsLint should not raise errors
- in future all should be unit tested
How can I contribute?
Every contribution is welcome! There are several ways. Contact us via mailing list, add a feature request or bugfix to the project.
by Stephan Strittmatter
