Improve pickle's documentation.

There is still much to be done, but I am committing my changes
incrementally to avoid losing them again (for a third time now).