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

On Tue, 2011-07-19 at 21:44 +0100, Dave Page wrote:
> 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?
>

Yes, that would work. I don't really understand why you want to build
htmlhelp files on Unix. It would only create the .hhp project file, but
not the CHM.

> 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
>

That's just me trying things, and commiting unwanted changes. Sorry
about this. This is now fixed in the docs branch, with the rename of the
Makefile.

--
Guillaume
http://blog.guillaume.lelarge.info
http://www.dalibo.com