-
Notifications
You must be signed in to change notification settings - Fork 1.1k
PYTHON-2870 Add support for man/text/latex/etc.. docs output #708
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
I think the point of mongodoc is to generate links to dochub references, which are supposed to be stable long term. Are you sure we aren't losing something by getting rid of it? |
We're not loosing anything AFAICT. We're still linking to the dochub pages. The only thing mongodoc does is automatically replace this:
with this:
After this change we just explicitly link to the page:
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I see. Great. LGTM.
Unsing that Makefile soes not make any sense. |
setup.py build_sphinx also works as expected after these changes:
|
…ort for man/text/latex/etc.. docs output
c9ace20
to
1909f9e
Compare
Regenerate sphinx makefile with sphinx-quickstart 3.5.4. Remove problematic mongodoc sphinx extension. (cherry picked from commit f9bfd11)
This PR adds support for building the docs in non-html output formats. For example man/latex/text are now supported. In order to do this I removed the mongodoc extension which doesn't add much value anyway. I also regenerated sphinx's doc/Makefile with sphinx-quickstart 3.5.4.
To build the docs in different formats: