I gave the 1536-add-docs branch a shot.
Looks fine without the docs dependencies installed, building docs gets
skipped as expected.
After installing all dependencies, `make` fails with:
Making all in share
Making all in doc
Making all in build
../../../build-aux/sphinx-build \
-b texinfo -d doctrees -n -c ./../src \ -A local=1 ./../src ./texinfo
Traceback (most recent call last):
File "/usr/local/bin/sphinx-build", line 8, in <module>
load_entry_point('Sphinx==1.1.3', 'console_scripts', 'sphinx-build')()
File "/Library/Python/2.7/site-packages/sphinx/__init__.py", line 47, in
main
from sphinx import cmdline
File "/Library/Python/2.7/site-packages/sphinx/cmdline.py", line 18, in
<module>
from docutils.utils import SystemMessage
File "/Library/Python/2.7/site-packages/docutils/utils/__init__.py", line
19, in <module>
from docutils.io import FileOutput
File "/Library/Python/2.7/site-packages/docutils/io.py", line 18, in
<module>
from docutils.error_reporting import locale_encoding, ErrorString,
ErrorOutput
File "/Library/Python/2.7/site-packages/docutils/error_reporting.py",
line 47, in <module>
locale_encoding = locale.getlocale()[1] or locale.getdefaultlocale()[1]
File
"/System/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/locale.py",
line 496, in getdefaultlocale
return _parse_localename(localename)
File
"/System/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/locale.py",
line 428, in _parse_localename
raise ValueError, 'unknown locale: %s' % localename
ValueError: unknown locale: UTF-8
make[4]: *** [info.stamp] Error 1
make[3]: *** [all-recursive] Error 1
make[2]: *** [all-recursive] Error 1
make[1]: *** [all-recursive] Error 1
make: *** [all] Error 2
The `locale` settings are:
> locale
LANG=
LC_COLLATE="C"
LC_CTYPE="UTF-8"
LC_MESSAGES="C"
LC_MONETARY="C"
LC_NUMERIC="C"
LC_TIME="C"
LC_ALL=
Setting:
LC_CTYPE=C
export LC_CTYPE
Passes the doc build, but make fails with:
make[2]: *** No rule to make target `THANKS', needed by `THANKS.gz'. Stop.
make[1]: *** [all-recursive] Error 1
make: *** [all] Error 2
Cheers
Jan
--
On Dec 3, 2012, at 04:22 , Noah Slater <[email protected]> wrote:
> Hey devs,
>
> After my epic weekend of hacking, I am now satisfied that the docs branch
> is ready to merge (or be cherry picked, or whatever it is you cool kids
> want to do with this "Git" thing we use) into 1.3.x and master.
>
> Dave and Adam ran into a bug today which is blocking us actually making the
> release. I will let Dave reply to this and provide more details.
>
> Thanks,
>
> --
> NS