-
Notifications
You must be signed in to change notification settings - Fork 501
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
Improve web docs #2248
Improve web docs #2248
Conversation
when building web docs
when building web docs
7ae9c84
to
5718998
Compare
using pydoc when building web docs.
|
||
#if !DEBUG_MODE | ||
docstring_options doc_options; | ||
doc_options.disable_cpp_signatures(); |
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.
For details about docstring_options see https://www.boost.org/doc/libs/1_82_0/libs/python/doc/html/reference/high_level_components/boost_python_docstring_options_h.html
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.
What's not to love?
Improve HTML rendition of Ledger's man page
Unfortunately groff's HTML output of the Ledger man page isn't too readable due to breaks on lines that belong on the same line and with much space between tabbed content. Use of mandoc(1) remedies that
groff
mandoc
Generate documentation for Ledger Python module using pydoc
A live preview is available at http://projects.surryhill.net/ledger/ledger.html
Future the documentation of the Ledger Python module and package is probably better generated using sphinx and the autodocs extension. For now the result of pydoc is better than offering no documentation at all.
ℹ️ For details on the other changes please see the individual commits