Polish documentation for the sets modules

Ensure that the first sentence describing each function makes sense
by itself when shown in the Summary part of the documentation.

Consistently mark examples using `## Examples`.

While at it, also remove comments for documented functions, and
remove out-commented code, and do some other minor clean ups.