Clarify that defaults() does not modify global defaults

This has come up several times recently, for example #1150 and #1249.
Merge pull request #1251 from nylen/document-defaults

Clarify that defaults() does not modify global defaults