Add information about generating keys

We didn't say what `secure=True` does about keys, and given the likelihood of things like https://groups.google.com/forum/#!topic/sage-support/zglN_3QLCPo happening again in the future, it is a good idea to document this better.

HT to Jori Mäntysalo for this placement and essentially the wording.