[IPython-dev] IPython documentation

Ville M. Vainio vivainio@gmail....
Thu Jun 12 06:37:46 CDT 2008


On Thu, Jun 12, 2008 at 3:58 AM, Fernando Perez <fperez.net@gmail.com> wrote:

> Thanks for doing this, it was needed.  For one thing, search was
> broken with the single-file one.

Actually, with single file, search is just ctrl + F away ;-)

Additional advantage of a single big file is that it's easy to print
(both the source and built documentation), if need be (e.g. if you
don't happen have the pdf handy). The .rst document is usable as a
documentation as such, on systems that don't have viewers for other
file systems.

It's true, though, that Sphinx is optimized for multiple source files,
so either way is fine.

-- 
Ville M. Vainio - vivainio.googlepages.com
blog=360.yahoo.com/villevainio - g[mail | talk]='vivainio'


More information about the IPython-dev mailing list