Re: [sphinx-dev] Feature Request: Auto-Extracting Examples

2012-01-07 Thread Marius Gedminas
xamples. Hm. There's http://packages.python.org/manuel/, it may be of some assistance if all you want to do is run automated tests on the code fragments. Marius Gedminas -- The most straightforward thing to assume was that the BIOS was stupid (which is, to be fair, my default assumption) and s

Re: [sphinx-dev] Re: Underfull \hbox (badness 10000) in paragraph at lines... in Sphinx 1.1.2

2012-01-01 Thread Marius Gedminas
s unable to hyphenate it by itself (no idea how to do that in Sphinx, though, but I'm sure the excellent docs cover it). Or you can look at the PDF, decide it is fine, and ignore the warning. Marius Gedminas -- There is an almost obvious extension of interfaces that would allow formal s

Re: [sphinx-dev] Re: Howto autodoc utility script

2011-01-07 Thread Marius Gedminas
-like-this is desirable for a script, I'd be inclined to keep it short, e.g.: #!/usr/bin/python import mypackage.scripts.namelikethis namelikethis.main() and move the bulk of the code into an importable module. Another advantage of this is that you can then use setuptools entry point

Re: [sphinx-dev] Referencing a file outside of the document root

2010-12-09 Thread Marius Gedminas
t includes snippets from README.txt, although I at the moment cheat by having my Sphinx directory be the project root. Marius Gedminas -- 2B OR NOT 2B == FF signature.asc Description: Digital signature