Updated TempoSpanner API entry. NEW FUNCTIONALITY.

NEW: the tempo spanner is now good to go for initial use.

Consult the series of 10 incremental examples in the API entry.

Other edge cases are possible. But the class is now stable and we can implement
the edge cases as needed.