Document new PIPE_ONCE macro

Document how to use the new PIPE_ONCE macro.

Other changes are just trailing whitespace eaten by my editor.