I just improved the manual a little bit.
(To avoid many separate posts, I document the changes in the history.)