DOC: Add clear and other parameter docs to assert_produces_warning

[dave-lewis-alida]

• [GH18996 ] closes DOC: tm.assert_produces_warning kwarg clear is undocumented #18996
• Added information on clear parameter
• Added information on other undocumented parameters (expected_warning, filter_level, check_stacklevel)

[jreback]

{Warning, False, None}

[jreback]

true -> True

[jreback]

make this same length as Examples

[jreback]

can you use * for the bullets.

[codecov]

Codecov Report

Merging #19066 into master will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master   #19066   +/-   ##
=======================================
  Coverage   91.51%   91.51%           
=======================================
  Files         148      148           
  Lines       48780    48780           
=======================================
  Hits        44639    44639           
  Misses       4141     4141

Flag	Coverage Δ
#multiple	89.88% <0%> (ø)	⬆️
#single	41.61% <0%> (+0.01%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 78147e9...f46920c. Read the comment docs.

[dave-lewis-alida]

Thanks for the quick and thorough review @jreback. I've pushed your requested changes.

[jreback]

can you git merge master and push again (generally we want to rebase / merge master anytime you push).

[dave-lewis-alida]

I did git merge master and then git push origin doc_clear on my feature branch in my forked repo. Is that correct? The git messages were "Already up-to-date" and "Everything up-to-date".

[jreback]

git merge upstream sorry you need to pull from the upstream (this should point to the pandas-dev/master.git``

(pandas) bash-3.2$ git remote -v
jreback https://github.com/jreback/pandas.git (fetch)
jreback https://github.com/jreback/pandas.git (push)
upstream        https://github.com/pandas-dev/pandas.git (fetch)
upstream        https://github.com/pandas-dev/pandas.git (push)

[TomAugspurger]

Whoops, looks like some unrelated commits got in here. Do you want help walking through the git commands?

I think the simplest version would be

git reset --soft upstream/master
git commit -m "Fixed git issue"
git push -f origin

That'll rewrite history (which is usually not good, but OK for this PR) and hopefully clean everything up.

[dave-lewis-alida]

@TomAugspurger Hi Tom. I ran the commands above. Are there any additional commands I need to run to deliver this change? Thanks!

[TomAugspurger]

The diff looks good now, thanks. Let us know if you see that the tests all pass before we do.

[dave-lewis-alida]

I need help with troubleshooting the travis-ci errors. I don't understand what the problem is. Thanks!

[TomAugspurger]

I restarted those. I think boto (one of our dependencies) had a bad release yesterday. They've been passing today.

Ping on green :)

[jreback]

thanks!