@@ -177,12 +177,44 @@ Note in addition to the ``RST`` prefix alone you can use partial codes
177177like ``RST2 `` meaning ``RST200 ``, ``RST201 ``, ... and so on.
178178
179179
180+ Configuration
181+ -------------
182+
183+ We assume you are familiar with `flake8 configuration
184+ <http://flake8.pycqa.org/en/latest/user/configuration.html> `_.
185+
186+ If you are using Sphinx or other extensions to reStructuredText, you will
187+ want to define any additional directives or roles you are using to avoid
188+ false positive ``RST303 `` and ``RST304 `` violations.
189+
190+ You can set these at the command line if you wish::
191+
192+ $ flake8 --rst-roles class,func,ref --rst-directives envvar,exception ...
193+
194+ We recommend using the following settings in your ``flake8 `` configuration,
195+ for example in your ``.flake8 ``, ``setup.cfg ``, or ``tox.ini `` file, e.g.::
196+
197+ [flake8]
198+ rst-roles =
199+ class,
200+ func,
201+ ref,
202+ rst-directives =
203+ envvar,
204+ exception,
205+
206+ Note that flake8 allows splitting the comma separated lists over multiple
207+ lines, and allows including of hash comment lines.
208+
209+
180210Version History
181211---------------
182212
183213======= ========== ===========================================================
184214Version Released Changes
185215------- ---------- -----------------------------------------------------------
216+ v0.0.11 2019-08-7 - Configuration options to define additional directives and
217+ roles (e.g. from Sphinx) for ``RST303 `` and ``RST304 ``.
186218v0.0.10 2019-06-17 - Fixed flake8 "builtins" parameter warning (contribution
187219 from `Ruben, @ROpdebee <https://github.com/ROpdebee >`_).
188220v0.0.9 2019-04-22 - Checks positive and negative examples in test framework.
0 commit comments