Do we have any conventions or standards for the use of LaTeX in
docstrings? Consider this:
r"""
This computes the integral homology `H_d(X, ZZ)` of `X` in
dimension `d`.
"""
versus
r"""
This computes the integral homology `H_d(X, \mathbb{Z})` of `X` in
dimension `d`.
"""
(or with \mathbf{Z} instead of \mathbb{Z}). The first of these looks
better with interactive help ('sage: homology?'), and the second looks
better in the reference manual. So which should we use? Should we
have a style guide which settles such issues?
John
--~--~---------~--~----~------------~-------~--~----~
To post to this group, send email to sage-devel@googlegroups.com
To unsubscribe from this group, send email to
sage-devel-unsubscr...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/sage-devel
URLs: http://www.sagemath.org
-~----------~----~----~----~------~----~------~--~---
