bring incomplete docs into a shape that can be released

close documentation branch docs/3.1

merge documentation branch

finalize CHANGELOG

improve consistency in compare.h documentation

use reallocate instead of re-allocate

(0) -1000 -300 -100 -30 -10 -6 +6 +10 +30 +100 tip

mercurial