The local lib directory is not used anymore and respective references
were removed. The java dependencies are now specified in the build.xml
and taken from their installed locations.

In addition to git, openjdk-6-jdk and ant the following java packages
have to be installed:
 - libcommons-codec-java
 - libcommons-compress-java
 - junit4

Minor tweaks by Karsten Loesing.

Milliseconds are simply ignored, because SimpleDateFormat only looks at
"yyyy-MM-dd HH:mm:ss" and ignores everything after that.

Related to #9286 where we discovered that some relays include milliseconds
in their descriptors.

For example, see "other" entry in:

  exit-kibibytes-read 80=505190490,182=25102395,443=61873906,
    6881=47999666,8989=8657674,17173=7910494,21762=9138992,
    45682=5154543,50500=6086469,51413=62394452,other=2282907805

Fixes #8798.

Pointed out by atagar.

Spotted by atagar; see #7867.

Spotted by atager in related ticket #7826.

Support for $fingerprint=nickname was previously added in 6a46f46b.

Sanitized bridge descriptors contain transport lines with just the
transport name.  However, there are now relays including unsanitized
transport lines, most likely because of a configuration problem.  Don't
reject the entire descriptor when encountering those lines.

So far, the only way to prevent files from being parsed repeatedly in
distinct runs was to specify a history file that only metrics-lib was
supposed to read and write.  However, some applications may want to
specify the list of files to exclude themselves, or they may want to learn
which files have been excluded and which have been parsed.  These
applications shouldn't be forced to mess with the history file.

Add three methods to the descriptor reader for these applications.  They
should also play nicely together with the history file approach.

AFAIK, stem has methods with the same purpose but a slightly different
semantic.

Spotted by Damian.

- Annotation lines starting with @ are now recognized.
- Unrecognized keywords in "w" lines are now ignored.

moria1 added a Capped= keyword to debug #2286 which made DocTor and
metrics-db freak out.  The correct behavior is to ignore unknown keywords.

For the moment, we still disallow blank lines in all other descriptors.
If this is not correct, we can easily fix that.

Using Tor's control port as a data source could be useful in some cases,
but Damian and I decided it's not worth the effort.  We wouldn't learn
much new stuff compared to running a Tor client/relay and reading the
cached-* files.  Damian says that a good workaround for file permission
issues with cached-* files is to run the Tor process and Java process as
the same user.

Having a database as a data source was a nice idea, too, but we don't have
such a database.  Once we have a good database we can still write a
metrics-lib wrapper for it.