Ticket #13009 (closed enhancement: fixed)
Add blank lines for a couple plots in reference manual
| Reported by: | kcrisman | Owned by: | jason, was |
|---|---|---|---|
| Priority: | trivial | Milestone: | sage-5.1 |
| Component: | graphics | Keywords: | beginner, sd40.5 |
| Cc: | Work issues: | ||
| Report Upstream: | N/A | Reviewers: | Karl-Dieter Crisman |
| Authors: | Dan Drake | Merged in: | sage-5.1.beta4 |
| Dependencies: | Stopgaps: |
Description
In graphics.py, we have
plot(sin(pi*x), (x, -8, 8)) # Labels not so helpful plot(sin(pi*x), (x, -8, 8), ticks=2) # Multiples of 2 plot(sin(pi*x), (x, -8, 8), ticks=[[-7,-3,0,3,7],[-1/2,0,1/2]]) # Your choices plot(sin(pi*x), (x, -8, 8), ticks=[[],[]]) # No ticks at all!
but then in the live documentation only the last one shows up, so we should separate them with
::
things.
Attachments
Change History
comment:2 Changed 12 months ago by kcrisman
Well, whatever. We've basically been doing it this way for a while, and since plot(foo) does indeed implicitly call show, it's a little easier. There are some doctests out there that use the show() syntax. But I do prefer the :: business.
comment:3 Changed 12 months ago by ddrake
- Status changed from new to needs_review
- Authors set to Dan Drake
Note: See
TracTickets for help on using
tickets.


Oh, is that why there are so many extra :: in Sage docstrings? I wondered about that.
Why not just wrap them with show() or put them in a single "line" by wrapping them with parentheses and semicolons?
or