===============
Formatting Help
===============
The way the :class:`~clap.base.Base` classes format help is determined by a
help formatter class. By changing a base's
:attr:`~clap.base.Base.help_formatter` attribute, you can make it display help
in a different way.


.. currentmodule:: clap.help

The Base Formatter
==================
All help formatters should subclass from :class:`BaseHelpFormatter`.

.. autoclass:: BaseHelpFormatter
   :members:


Included Formatters
===================
The :class:`HelpFormatter` class has some sensible defaults for formatting
help. It's not the nicest looking help ever, but it works.
If you want indented sections, you can use the :class:`IndentedHelpFormatter`
class.
The :class:`ANSIHelpFormatter` uses ANSI boldface effects on section titles
and usage strings.

Of course, you can always implement your own help formatters.