Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]
Groups > comp.lang.python > #3748
| From | andrew cooke <andrew@acooke.org> |
|---|---|
| Newsgroups | comp.lang.python |
| Subject | Re: Language & lib reference in man format ? |
| Date | 2011-04-20 13:14 -0700 |
| Organization | http://groups.google.com |
| Message-ID | <0409f387-e13e-417c-9e73-1187e13338bc@glegroupsg2000goo.googlegroups.com> (permalink) |
(1) Python's docs use Sphinx, which uses restructured text as a markup. You can generate man pages from restructured text using rst2man (which is installed on my computer, probably as part of python/docutils). HOWEVER I imagine it's not going to work very well, if at all, because Sphinx uses lots of fancy extensions. But... (2) Sphinx itself has a "builder" for man pages. It's described at http://sphinx.pocoo.org/builders.html#sphinx.builders.manpage.ManualPageBuilder So you should be able to configure Sphinx to use that. So you will need to download the docs package, install Sphinx, and then tweak the Sphinx configuration as described at the link above and at http://sphinx.pocoo.org/config.html#confval-man_pages This second approach should work. Andrew
Back to comp.lang.python | Previous | Next | Find similar
Re: Language & lib reference in man format ? andrew cooke <andrew@acooke.org> - 2011-04-20 13:14 -0700
csiph-web