-
Notifications
You must be signed in to change notification settings - Fork 446
Fix documentation and math display errors #448
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
This fixes the following errors, which made the last two bullets display incorrectly. python-control/doc/conventions.rst:229: WARNING: Bullet list ends without a blank line; unexpected unindent. python-control/doc/conventions.rst:232: WARNING: Bullet list ends without a blank line; unexpected unindent.
This also fixes the following warnings: python-control/control/statefbk.py:docstring of control.lqe:6: WARNING: Unexpected indentation. python-control/control/statefbk.py:docstring of control.lqe:36: WARNING: Unexpected indentation.
bnavigator
left a comment
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.
LGTM, except the scipy reference
control/timeresp.py
Outdated
| ----- | ||
| For discrete time systems, the input/output response is computed using the | ||
| :scipy-signal:ref:`scipy.signal.dlsim` function. | ||
| scipy.signal.dlsim function. |
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.
Just fix the broken intersphinx mapping:
| scipy.signal.dlsim function. | |
| :func:`scipy.signal.dlsim` function. |
Lines 99 to 101 in ec8cbf0
| intersphinx_mapping = \ | |
| {'scipy':('https://docs.scipy.org/doc/scipy/reference', None), | |
| 'numpy':('https://docs.scipy.org/doc/numpy', None)} |
Edit: Turns out the intersphinx setup is broken because of defining the mapping twice:
Lines 198 to 199 in ec8cbf0
| # Example configuration for intersphinx: refer to the Python standard library. | |
| intersphinx_mapping = {'https://docs.python.org/': None} |
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.
Thanks! I've updated the commits to fix it.
The link to dlsim was broken, producing a warning. The links to lsim were missing.
This left-over example configuration caused the intended intersphinx_mapping not to work, thus breaking links to scipy and numpy. Now the links should work again.
2aee9ed to
69c33e5
Compare
|
Thanks for the review. I've adapted it based on your feedback and fixed the screenshot above. |
|
I submitted a PR into your branch to take this even further: pybricks#1 |
|
Sounds good - I just merged those into this PR. |


This changes
to:
This changes:
to
Inverse has now been changed to
^{-1}as well.This changes:
to:
and a few other minor fixes.