Multiple "invalid option block" errors when building docs
|Reported by:||Carl Meyer||Owned by:||nobody|
|Has patch:||no||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
Using Sphinx 1.07, I get 8 errors like this on a fresh docs build:
/home/carljm/projects/django/django/django-git/docs/topics/i18n/localization.txt:262: (ERROR/3) Error in "note" directive: invalid option block. .. note:: The default :file:`settings.py` file created by :djadmin:`django-admin.py startproject <startproject>` includes :setting:`USE_L10N = True <USE_L10N>` for convenience.
I think it's from lines beginning with a colon inside a directive (usually
.. note or
.. warning), which Sphinx is trying to interpret as option blocks for that directive.
If there's a way we could just turn that error off, that'd be nice. Otherwise we should probably fix these cases manually and try to avoid introducing new ones, it's a barrier to new docs contributors to have a bunch of "known errors" in the docs build.