Re: pgAdmin III commit: Database Designer (milestone 1 of GSoC 2011)

On Tue, Jul 19, 2011 at 8:06 PM, Guillaume Lelarge
<guillaume(at)lelarge(dot)info> wrote:
>> There's no Makefile there. Did you forget to check it in?
>>
>>
>
> Oops, forgot this one. The fact that Makefile is in the .gitignore file
> didn't help.

So I'm thinking we should probably check that in as "Makefile.sphinx",
and then add a "docs" target to the top level Makefile that does
something like:

cd docs/en_US && make -f Makefile.sphinx htmlhelp SPHINXBUILD="${sphinx}"

where ${sphinx} is set to the path & filename of the sphinx
executable, from a configure option.

Thoughts?

Oh, and when I try to build, I get an error (another file to be
checked in I guess):

raptor:en_US dpage$ make htmlhelp SPHINXBUILD=sphinx-build-2.7
sphinx-build-2.7 -b htmlhelp -d _build/doctrees . _build/htmlhelp
Making output directory...
Running Sphinx v1.0.7
loading pickled environment... not yet created
building [htmlhelp]: targets for 54 source files that are out of date
updating environment: 54 added, 0 changed, 0 removed
reading sources... [100%] using
looking for now-outdated files... none found
pickling environment... done
checking consistency...
/Users/dpage/GIT-Trees/pgadmin3-docs/docs/en_US/connect-error.rst::
WARNING: document isn't included in any toctree
/Users/dpage/GIT-Trees/pgadmin3-docs/docs/en_US/gqb.rst:: WARNING:
document isn't included in any toctree
/Users/dpage/GIT-Trees/pgadmin3-docs/docs/en_US/gridopts.rst::
WARNING: document isn't included in any toctree
/Users/dpage/GIT-Trees/pgadmin3-docs/docs/en_US/kerberos.rst::
WARNING: document isn't included in any toctree
/Users/dpage/GIT-Trees/pgadmin3-docs/docs/en_US/macros.rst:: WARNING:
document isn't included in any toctree
/Users/dpage/GIT-Trees/pgadmin3-docs/docs/en_US/openssl.rst:: WARNING:
document isn't included in any toctree
/Users/dpage/GIT-Trees/pgadmin3-docs/docs/en_US/pgscript.rst::
WARNING: document isn't included in any toctree
/Users/dpage/GIT-Trees/pgadmin3-docs/docs/en_US/search.rst:: WARNING:
document isn't included in any toctree
done
preparing documents... done
writing output... [100%] using
writing additional files... genindex
copying images... [100%] _static/main.png
copying static files...
Exception occurred:
File "/opt/local/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/shutil.py",
line 81, in copyfile
with open(src, 'rb') as fsrc:
IOError: [Errno 2] No such file or directory:
'/Users/dpage/GIT-Trees/pgadmin3-docs/docs/en_US/logo-ltr.jpg'
The full traceback has been saved in
/var/folders/w3/w3pWkaA1HXu6YdlU06kyuU+++TI/-Tmp-/sphinx-err-zJDLDY.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: *** [htmlhelp] Error 1

--
Dave Page
Blog: http://pgsnake.blogspot.com
Twitter: @pgsnake

EnterpriseDB UK: http://www.enterprisedb.com
The Enterprise PostgreSQL Company