frozen API

Hi All,

Just to let you know that current development code has been frozen for
its API specification. Still remains some documentation to review before
starting the pre-release phase, but all API related documentation are
updated (I still have to review them to fix probable bad spelling and
bad English phrases...)

Some words about the new API.

First, yes, it is a new API. But the old API (4.4.x version) is still
available through a compatibility wrapper included in libdar. So if you
do not want to take advantage of libdar's new features in your program
but want to be able to compile and link against the new API with a
minimum effort, you will have to include "libdar_4_4.hpp" in place of
"libdar.hpp" and use the namespace "libdar_4_4" in place of "libdar".
That's all. Compilation and linking stay the same.

Why yet a new API?

Mainly because for each new feature a new argument to a method somewhere
had to be added, which broke backward compatibility (see API version
4.4.x compared to major release version 2.4.x).

What are the changes between 4.4.x and 5.0.0 API?

Well, first, there is no more any method with a ton of arguments. This
should let code more readable and avoid argument mix. So now, how this
info get passed to libdar? Thanks to a new set of "option" classes.