DOC: Add clear and other parameter docs to assert_produces_warning
- [GH18996 ] closes #18996
- Added information on `clear` parameter 
- Added information on other undocumented parameters (expected_warning, filter_level, check_stacklevel)
