document "%edit" in the tutorial

[jhpalmieri]

The attached patch adds documentation for the %edit command in the Sage tutorial.

---

Apply attachment: trac_11219-ipython-edit.v2.patch.

CC: @kcrisman

Component: documentation

Author: John Palmieri

Reviewer: John Cremona

Merged: sage-4.7.rc0

Issue created by migration from https://trac.sagemath.org/ticket/11219

[jhpalmieri]

comment:1

Attachment: trac_11219-ipython-edit.patch.gz

[jhpalmieri]

comment:2

This is related to #7586, by the way.

[JohnCremona]

comment:3

The patch applies and builds fine. I learned a lot from reading the tutorial after testing that!

One thing does not work as advertised, I think: using logstart. I could not load unless I gave the logfile a suffix such as .sage or .py, note that the stored commands are preparsed before being stored. But when the file is loaded in another session I do not see this

Loading log file <setup> one line at a time...
    Finished replaying log file <setup>

but rather this

sage: load "setup.py"
Activating auto-logging. Current session state plus future input saved.
Filename       : setup.py
Mode           : backup
Output logging : False
Raw input log  : False
Timestamping   : False
State          : active

which does load the stuff but also overwrites the file setup.py!!!

So I'm giving this a positive review but want the other thing fixed before we forget all about it.

[jhpalmieri]

Reviewer: John Cremona

[jhpalmieri]

comment:4

In response to kcrisman's comment on sage-devel, I added a little bit about commands run in the background not being preparsed. Could you do another review on that? I'm posting a new patch ("...v2.patch") and another patch showing the difference, for easy reference.

[jhpalmieri]

Attachment: trac_11219-ipython-edit.v2.patch.gz

apply only this patch

[jhpalmieri]

difference between versions 1 and 2, for reference only

[jhpalmieri]

comment:5

Attachment: trac_11219-ipython-edit.delta.patch.gz

[jdemeyer]

comment:7

Looks safe enough for sage-4.7-rc0.

[jdemeyer]

Merged: sage-4.7.rc0

[kcrisman]

comment:9

This never made it into the translations of the tutorial - German, French, or Russian. I don't know if they existed at the time in any case, but I've opened #14051 for this. I don't know if the newer translations not yet in I reference their have this stuff or not.