NEWS
====

Awn is maintained again!

The code has been moved to github. The following repositories hold code related to AWN:

 - https://github.com/p12tic/awn
 - https://github.com/p12tic/awn-extras
 - https://github.com/p12tic/libdesktop-agnostic

This PPA contains packages for testing:

 - https://launchpad.net/~awn-testing/+archive/ppa

Bugs & Feature Requests
===================
Please report bugs here https://bugs.launchpad.net/awn/+filebug. Bugs related to specific applets should be filed here https://bugs.launchpad.net/awn-extras/+filebug. In both cases please install the latest testing packages available https://launchpad.net/~awn-testing/+archive/ppa to check whether the bug has not been fixed already.

Currently no support is provided for older packages in the Ubuntu or Debian repositories. All bugs that have been fixed in the PPA-provided packages are marked as [Fix Released] in the bug tracker.

 If the bug is a feature request, please add "[feature request]" as a prefix to the bug title.

Want to contribute?
===============

There are many 'easy tasks' suitable for new contributors. AWN is primarily a C codebase that is currently slowly moving towards C++ (C++11 included). While we haven't switched to Gtkmm yet, there's plenty of places where the code can be improved by using C++ APIs*. For example:
 * use std::string instead of plain gchar* strings
 * use boost::filesystem instead of GLib file API
 * use standard containers instead of GLib equivalents
 * etc.

Most of such changes are comparatively local and have low risk. Thus you don't need to know the codebase well in order to contribute. Nor you have to be a C++ guru. Just open any *.cc file, search for a gchar* C string being allocated and freed within the same function and change it to std::string. It's just that easy :) All similar contributions are welcome.

--
* while switching to C++ by itself has little benefit, practices such as RAII vastly reduce the chance of common bugs.