Pdoc

=====
- New support for PEP 484 Python type annotations.
- Class `__init__` methods are no longer documented separately.
Instead, class docstring now contains `__init__` method's docstring,
and class definition line now shows `__init__` parameters.
This is in line with Sphinx / Python stdlib documentation.
- PDF docs generation via Markdown, ingestible by various
Markdown-to-PDF converters.
- New module import mechanism with improved support for
namespace packages.
- CLI changes:
- New `--config` switch for easier setting of config.mako tunables.
- Deprecated switches in favor of new/standard ones:
- `--overwrite` → `-f, --force`
- `--html-dir` → `-o, --output-dir`
- `--html-no-source`, `--external-links` and `--link-prefix` are
removed in favor of new tunables settable with `--config`.
- `--output-dir` without `--html` outputs a tree of raw Markdown files.
- The semantics of module specified as filesystem path has changed:
before the full relative path was used to construct the python module
path, now only the basename is.
- Bugfixes regarding raw URLs and numpydoc transformations.

=====
- Bugfixes:
- Added support for metaclass subclasses.
- Fix pdoc.Function.params() error in case when keyword-only
parameters have no default values.
- Don't expand `os.environ` parameter default value as exposing it
is a security issue.

=====
- Only close standard input if `--close-stdin` is used. This flips
the previous (hopefully rarely required) default.
- Fix backslashes in relative `Doc.url()` on Windos.
- New support for `.. include::` reST directive that includes
verbatim content from another file.
- Dev web server (`--http`) fixes:
- Unify `--http` and non-`--http` behavior by always adding
cwd to `sys.path`.
- Fix favicon.ico errors in `--http` mode.
- HTML template:
- Make TOC reference lists two- or three-column only if enough room for it.
- Fix: Hyperlink raw URLs.
- New optional sorting of variables, functions, classes.
- New configurable Highlight.js style.

=====
- Add `__main__.py` so users can invoke `python -m pdoc`.
- Fix: List builtin class method descriptors
- Google docstring format fixes:
- Support for 2-space indents.
- Recognize sections even when not preceded by an empty line.
- Recognize additional characters (`,=[]`) in type specifications.
- HTML template fixes:
- Fixed some CSS typos.
- Re-styled View Source button in HTML template.
- Two-column TOC reference lists only when all names are short.
- TOC links for some class no longer lead to its ancestor class.

=====
- Markdown >= 3.0.0 requirement.

=====
- Relicensed as AGPL-3.0.
- Major refactoring, Python 3 compatibility.
- Support Numpydoc, Google-style docstrings, and some reST directives.
- CLI changes:
- Specifying modules/packages to document if mandatory.
- Identifier filtering can be turned on with an optional `--filter`
argument.
- Argument `--all-submodules` is removed.
- To avoid polluting the python package with scattered *.html files,
the default `--html-dir` now points to `./html`.
- Arguments `--http-host` and `--http-port` are removed in favor
of passing a parameter to argument `--http`.
- Program errors if specified template directory is invalid.
- All document objects have a `.obj` property, pointing to the raw
Python object.
- Major template updates:
- Template exceptions are propagated to stderr.
- Major refactoring (modern HTML5) of the HTML template.
- HTML template loads Normalize.css and Highlight.js from CDN.
- HTML template output is minified.
- HTML template includes sub-templates (config.mako, head.mako, logo.mako,
credits.mako) to more easily adapt it.
- In HTML template, module headings are extracted into sidebar TOC.
- `Function.params()` returns only public parameters.
- To disable documenting an identifier with `__pdoc__`, prefer `False`
to `None` (deprecated).