What version are you running?
1.7.7.1, current
What's the URL of the page containing the problem?
What steps will reproduce the problem?
1. cd to docs/manual.
2. Fix the conf.py to it can even get started
3. make your selection of doc type, sit back and watch
What is the expected output? What do you see instead?
What operating system are you using? What browser?
gentoo linux, never mind about a browser.
Please provide any additional information below.
The manual folder would be to me the most valuable if the 3 there, but a doc build stumbles over firstly absent settings, then an unsataisfiable setting.
Fist, edit conf.py in docs/manual to
```import reviewboard
from reviewboard import settings
from reviewboard.settings import EXTENSIONS_STATIC_ROOT
from django.core.management import setup_environ
from django import conf
from settings_local import DATABASES
conf.EXTENSIONS_STATIC_ROOT=EXTENSIONS_STATIC_ROOT
conf.settings.DATABASES=DATABASES
setup_environ(settings)
```
To get past that first barrier list of errors. Once there, then do e.g. a make pickle, well make any selection +- a PYTHONPATH=.:..
reading sources... [ 60%] webapi/2.0/resources/change
Exception occurred:
File "/usr/lib64/python2.7/site-packages/django/utils/functional.py", line 185, in inner
return func(self._wrapped, *args)
AttributeError: 'Settings' object has no attribute 'ROOT_URLCONF'
The full traceback has been saved in /tmp/sphinx-err-yzAD8b.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
Either send bugs to the mailing list at <http://groups.google.com/group/sphinx-dev/>,
or report them in the tracker at <http://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
make: *** [pickle] Error 1
This has nothing to do with sphinx I don't believe.
According to
/usr/lib64/python2.7/site-packages/django/utils/functional.py.
the 'Settings' object' is settings imported from django.conf, and since this all centres around django that makes some sense, except that django itself has no such setting. Also I still can't figure why is cites Settings and not settings, however that appears a triviality.
So vital question number one.
Why is django.conf. demanding a setting for itself that it doesn't inherently have set?
Bemused question number 1.
Is this because it gets reviewboard.settings tangled with django.conf.settings?
Let's move on and give the missing django.conf.settings.ROOT_URLCONF a value. Having nothing better to select than the only one around, into conf.py, add
from reviewboard.settings import EXTENSIONS_STATIC_ROOT, ROOT_URLCONF
conf.settings.ROOT_URLCONF=ROOT_URLCONF
and
```
reading sources... [ 60%] webapi/2.0/resources/change
Exception occurred:
File "/usr/lib64/python2.7/site-packages/django/core/urlresolvers.py", line 332, in url_patterns
raise ImproperlyConfigured("The included urlconf %s doesn't have any patterns in it" % self.urlconf_name)
ImproperlyConfigured: The included urlconf djblets.util.rooturl doesn't have any patterns in it
The full traceback has been saved in /tmp/sphinx-err-OiEojy.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
Either send bugs to the mailing list at <http://groups.google.com/group/sphinx-dev/>,
or report them in the tracker at <http://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
make: *** [pickle] Error 1
```
It doesn't even like it.
In addition. cd into docs/codebase
docs/codebase $ PYTHONPATH=.:../../ make pickle
mkdir -p _build/pickle _build/doctrees
python `which sphinx-build` -b pickle -d _build/doctrees . _build/pickle
Running Sphinx v1.1.3
Unable to import settings_local.py: No module named settings_local
Please see http://www.reviewboard.org/docs/manual/dev/admin/
for help setting up Review Board.
make: *** [pickle] Error 1
docs/codebase $ ln -sf ../../contrib/internal/conf/settings_local.py .
docs/codebase $ PYTHONPATH=.:../../ make pickle
-------------------------------------------------------
-------------------------------------------------------
build succeeded, 9 warnings.
Build finished; now you can process the pickle files.
It's missing a needed settings_local.py
