How can I help ?
One easy way to help is to write a description for your favorite config file; you don't need to be a developer to do that.
If you want to roll up your sleeves and help, the Todo list has some items that desparately need somebody to look at, including some items that only take a few minutes but would be enormously useful to us to make sure Augeas correctly processes as many files as possible.
Where is the mailing list ?
The mailing list is firstname.lastname@example.org. Subscribe by going to the list page.
The list is for any discussion around Augeas, be it bug reports, feature requests, trouble writing file format descriptions etc.
Where is the IRC channel ?
The best place to find somebody connected to Augeas on IRC is #augeas on Freenode. Use the following settings in your IRC client:
- Server: chat.freenode.net
- Port: 6667 (the default IRC port)
- Channel: #augeas
Where is the Bugtracker ?
Bugs are kept in the GitHub project issues.
Where is the source ?
Sources are in a GitHub repository. To check out the code, run
git clone https://github.com/hercules-team/augeas.git
If you want to follow repository changes, you can use GitHub's "Watch" feature on that repository.
To build and explore, you need to:
cd augeas ./autogen.sh && make # Start a session with augtool that reads lens descriptions from ./lenses # and runs with AUGEAS_ROOT=./build/try, populated from ./tests/root/ ./src/try cli
What language bindings are available ?
Ruby bindings have been contributed by Bryan Kearney and can be found in a separate GitHub repository. To check them out, run
git clone https://github.com/hercules-team/ruby-augeas.git
To build them, you need rake. Simply run rake build to compile them.
Python bindings have been contributed by Harald Hoyer and can be found in their own GitHub repository. To check them out, run
git clone https://github.com/hercules-team/python-augeas.git
git clone git://git.annexia.org/git/ocaml-augeas.git
Lua bindings are maintained by the lua-augeas project.
Node.js bindings are maintained by Igor Pashev. Sources are kept in this git repository.
Bindings for the Go language have been contributed by Dominik Honnef. Sources are kept in this git repository.
Tcl bindings have been contributed by Danyil Bohdan. Sources are kept in this git repository.