split reference out from customizing and fix all links.

also reformat a couple of lists.

Still to do verify that references to customizing.txt from the rest of
the docs should still point there.

Author: rouilj