improve documentation
Merge commit '9318c27314' into iso8601.doc-advanced-cycling
update old cycle references
fix stop clock
tidy up documentation & other changes
documentation: fix latex reference
fix example...
Merge pull request #968 from benfitzpatrick/iso8601.doc-advanced-cycling

#119: improve documentation