#17592: rephrase "LaTeX formating" and "Writing doctests"
-------------------------+-------------------------------------------------
Reporter: | Owner:
ncohen | Status: needs_review
Type: | Milestone: sage-6.5
enhancement | Resolution:
Priority: major | Merged in:
Component: | Reviewers:
documentation | Work issues:
Keywords: | Commit:
Authors: | 216eb972fcb5c224243db440fa0a43c1ec85498c
Nathann Cohen | Stopgaps:
Report Upstream: N/A |
Branch: |
public/17592 |
Dependencies: |
#17589 |
-------------------------+-------------------------------------------------
Comment (by ncohen):
Hello John !
First, let me say that I have absolutely nothing against seeing this patch
reviewed very soon, but it has a dependency that must be reviewed first
otherwise we are sure to have conflict between the two of them. So if you
have some time to review a doc ticket, could you start with #17589 ? It is
very short !
> This is not entirely accurate: in ReST documentation, you can't use
dollar signs; those are only available in Sage's documentation. Maybe say
"In Sage's ReST documentation ..."?
I see. We may also not mention those dollar signs as we try always use
backticks anyway nowadays ?...
> I would also point out that `$$math expression$$` is old-fashioned and
deprecated in LaTeX; `\[math expression]\]$` is much preferred.
I never used that, but I can make the change. To me all about LaTeX is
old-fashioned and deprecated. This thing cannot detect a syntax error
properly.
> Why remove the instructions about `:nowrap:`? Is the warning about it no
longer accurate?
It just does not seem to work. I first wanted to add an illustration of
this nowrap as I did for the examples above, and it had no effect. Then I
looked for ":nowrap:" in Sage's source code and found out that it was used
only once.... and that it had no effect either.
Nathann
--
Ticket URL: <http://trac.sagemath.org/ticket/17592#comment:3>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.
