pecl docstring tweak

This moves the notice that the new "defaults" argument will be available
in 0.17.0 to a "note" section for greater emphasis.
Merge pull request #6174 from terminalmage/docs

pecl docstring tweak