which is actually the most important for the user

teor authored 6 years ago and juga committed 6 years ago

Also:
* document the location of latest.v3bw
* document the atomic creation of latest.v3bw
* explain how to atomically create latest.v3bw when transferring it to
  another host

Closes tor trac 26740.

- Remove started_at file in config et al.
- Add state_fname to config et al.
- Remove read/write functions for the started_at file in scanner.py
  and genearte.py

GH: ref #166

reading the whole file is already in other test and software version
changes with every release

reading from the file created in the same test

**Important changes**:

- The way users configure logging has changed. No longer are most users
  expected to be familiar with how to configure python's standard logging
library with a config file. Instead we've abstracted out the setting of log
level, format, and destinations to make these settings more accessible to
users. Expert users familiar with [the logging config file format][logconffmt]
can still make tweaks.

Summary of changes:

- Make logging configuration easier for the user.
- Add UML diagrams to documentation. They can be found in docs/source/images/
  and regenerated with `make umlsvg` in docs/.

[logconffmt]: https://docs.python.org/3/library/logging.config.html#logging-config-fileformat