Update the docs to describe what affects how much secure memory may
be needed, and also to describe the limitations imposed by
PTHREAD_KEYS_MAX.