Ticket #4251 (closed defect: fixed)

Opened 2 months ago

Last modified 2 months ago

[with patch, positive review] typo in installation manual

Reported by: wdj Assigned to: tba
Priority: minor Milestone: sage-3.2
Component: documentation Keywords:
Cc: mhansen

Description

This was reported to by a new user:

Section 2.2 Microsoft Windows in the Installation Guide seems to have a dead line. Maybe "http://www.sagemath.org/SAGEbin/vmware/" should be "http://www.sagemath.org/download.html"?

I'm not sure what milestone to assign this nor how to submit a patch since we are in the process of switching the documentation over to a new system. 

Dear David,
  I went to your first link, went to Windows version, at page:
http://www.sagemath.org/doc/inst/node4.html

where the first link is dead: http://www.sagemath.org/SAGEbin/vmware/

But I got the vmware download through some other path (that I don't remember
right now).
        Mark

-----Original Message-----
From: David Joyner 
Sent: Monday, October 06, 2008 12:06 PM
To: ....
Subject: Re: Sage question

Mark Meyerson wrote:
> Dear Dave,
>
> Is their a "quick start" document on line somewhere for SAGE - brief
> directions for a. installing it on my computer and b. using it?  Thanks.
>
> Mark
>
> -----------      
>
>
>   

Yes.
The installation document
http://www.sagemath.org/doc/inst/inst.html

discusses installation and the tutorial
http://www.sagemath.org/doc/tut/tut.html

and constructions document
http://www.sagemath.org/doc/const/const.html

have lots of examples.

Let me know if you need help.

David

Attachments

trac_4251-typo-install-guide.patch (1.3 kB) - added by wdj on 10/07/2008 05:05:13 PM.
a change to 2 lines of inst.tex, based on 3.1.3.alpha2
4251.patch (1.0 kB) - added by jhpalmieri on 10/17/2008 02:12:55 PM.

Change History

10/07/2008 02:06:56 PM changed by mabshoff

David,

feel free to post a patch to fix the issue with the current TeX based documentation. All fixes are also applied (manually) to the ReST tree and while that is likely to come soon I would not hold off on fairly localizes fixes like the above. I would not start a major rewrite of the documentation ;)

Cheers,

Michael

10/07/2008 05:05:13 PM changed by wdj

  • attachment trac_4251-typo-install-guide.patch added.

a change to 2 lines of inst.tex, based on 3.1.3.alpha2

10/07/2008 05:05:40 PM changed by wdj

The attached patch seems to compile fine for me.

10/07/2008 05:08:30 PM changed by wdj

  • summary changed from typo in installation manual to typo in installation manual [with patch, needs review].

10/17/2008 02:12:40 PM changed by jhpalmieri

  • summary changed from typo in installation manual [with patch, needs review] to [with patch, positive review] typo in installation manual.

The patch looks good to me, but I couldn't get it to apply, I think because the relevant lines contain "\SAGE" instead of "SAGE". I'm attaching a slightly modified patch, which should be used instead. With that, positive review.

10/17/2008 02:12:55 PM changed by jhpalmieri

  • attachment 4251.patch added.

10/18/2008 02:10:42 AM changed by mabshoff

  • status changed from new to closed.
  • resolution set to fixed.

Merged 4251.patch in Sage 3.2.alpha0

10/18/2008 02:11:09 AM changed by mabshoff

  • cc set to mhansen.

Mike,

please make sure to shadow this fix to the ReST documentation.

Cheers,

Michael