[IPython-dev] IPython documentation

Ville M. Vainio vivainio at gmail.com
Thu Jun 12 07:37:46 EDT 2008

On Thu, Jun 12, 2008 at 3:58 AM, Fernando Perez <fperez.net at 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