Ticket #3479 (new enhancement)

Opened 7 months ago

Last modified 5 months ago

[with patch, needs work] update dsage portion of tut.tex

Reported by: yi Assigned to: tba
Priority: major Milestone: sage-3.4
Component: documentation Keywords: editor_mhansen
Cc:

Description

This patch provides 2 more examples on how to use the distributed map() function in dsage as well as the @parallel decorator.

To get the tutorial to build correctly I needed to remove all the temporary files and run the 'build_pdf' script twice to generate the index.

This patch depends on #3467 and the @parallel decorator patches going in.

Attachments

3479_dsage_tut.patch (1.8 kB) - added by yi on 06/19/2008 03:30:08 PM.
Patch for doc/tut/tut.tex

Change History

06/19/2008 03:30:08 PM changed by yi

  • attachment 3479_dsage_tut.patch added.

Patch for doc/tut/tut.tex

06/19/2008 03:31:35 PM changed by mhansen

Yi, does your patch apply with #3347 applied?

06/19/2008 03:31:47 PM changed by yi

  • milestone set to sage-3.1.1.

06/19/2008 03:37:37 PM changed by mhansen

  • keywords set to editor_mhansen.

08/13/2008 12:13:22 PM changed by jhpalmieri

  • summary changed from [with patch, needs review] update dsage portion of tut.tex to [with patch, needs work] update dsage portion of tut.tex.

The patch fails against the current version of the tutorial.

When applied manually, the patch seems okay, and passes all doctests. A few comments:

In example 3, item 5, I would suggest changing $f$ to \code{f}, for the sake of better latex to html conversion.

In example 4, the verbatim block looks odd, especially in the live version of the tutorial.

If you fix at least example 3, and produce a patch against the current tutorial, I'll give it a positive review.

(In general, I find the style of using numbered instructions, as in all of the dsage examples, at odds with the style of the rest of the tutorial. It would be nice if this were rewritten, but that can wait for a separate trac item and patch.)

08/13/2008 02:00:33 PM changed by jhpalmieri

By the way, what does "% (fold)" mean? This only appears in the dsage part of the tutorial, and I don't know what role it plays.