[pyreverse] updated docs for filter-mode

[kidq330]

Type of Changes

	Type
	🐛 Bug fix
	✨ New feature
	🔨 Refactoring
✓	📜 Docs

Description

Improved clarity for pyreverse help docs after some trouble with usage, more details in linked issue

Closes #9805

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 95.79%. Comparing base (6236b91) to head (023e927).
Report is 146 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #9806   +/-   ##
=======================================
  Coverage   95.79%   95.79%           
=======================================
  Files         174      174           
  Lines       18902    18902           
=======================================
  Hits        18107    18107           
  Misses        795      795           

Files with missing lines	Coverage Δ
pylint/pyreverse/main.py	93.75% <ø> (ø)

---- 🚨 Try these New Features:

• Flaky Tests Detection - Detect and resolve failed and flaky tests

[github-actions]

🤖 According to the primer, this change has no effect on the checked open source code. 🤖🎉

This comment was generated for commit 023e927

[DanielNoord]

Thanks for your contribution!

[DanielNoord]

Let's remove this. I'll add the correct label so CI still passes.

[DanielNoord]

Why did you decide to remove the formatting here?

[DudeNr33]

Thanks for the contribution!
The addition to the help message of the 'OTHER' option value is helpful.

Maybe you have already figured it out, but in the issue you mention that -f SPECIAL_A does what you want - that is not entirely true; it is just a side effect. SPECIAL_A is not a valid option value (hence the error message you see).
pyreverse, in that case, does not crash but also not simply stick to the normal default value (PUB_ONLY), instead it simply ignores the value. If SPECIAL_A was the only value passed to this option, this is then equivalent to ALL (not filter at all).

[DudeNr33]

PUB_ONLY is the default, and thus we should not remove this information from the help message.