Summary: add usage note to clarify thread safety
Reviewed-by: briangoetz, mduigou
Contributed-by: jim.gish@oracle.com