Submodule exclusion - differences between approaches

Problem Description

Despite what the documentation suggests, when it comes to submodule exclusion specifying __all__ does not have the same effect as passing negative regular expression !patterns as part of the module specification.

Specifically, specifing submodules in __all__ will render the modules’ docstrings, as well as generate the API Documentation section; the same is not true when using the alternative approach.

I uderstand the difference in approaches, just thought it would be worth pointing out so as to make the documentation clearer. Related: Perhaps allow for documentation specific issues? They don’t really fit in with the bugs/enhancement options currently in place.

Steps to reproduce the behavior:

1. Generate docs using pdoc foo; __all__ = ["bar"] in foo/__init__.py
2. Generate docs using pdoc foo !foo.baz; no specified __all__ in foo/__init__.py
3. Compare results

System Information

pdoc: 9.0.0
Python: 3.10.1
Platform: Windows-10-10.0.22000-SP0

[mhils]

This is now fixed in pdoc 10, thanks again! 🍰

[mhils]

I’ve pushed experimental changes for approach 1) to main, see CHANGELOG.md. 😃