[REF] rewrap very long lines in the documentation and remove trailing spaces

Because it's just ugly in some editors.

No other change in this PR (it might be done later)