#10190: developer's guide: warnings & notes about commit message, cloning and
setting the text editor
-------------------------------+--------------------------------------------
Reporter: mvngu | Owner: mvngu
Type: enhancement | Status: needs_review
Priority: major | Milestone: sage-4.6.1
Component: documentation | Keywords: Mercurial, developer's guide
Author: Minh Van Nguyen | Upstream: N/A
Reviewer: | Merged:
Work_issues: |
-------------------------------+--------------------------------------------
Changes (by mvngu):
* status: needs_work => needs_review
Old description:
> Add a new chapter to the Developer's Guide on advanced uses of Mercurial.
>
> See the following URL for the rebuilt Developer's Guide after applying
> the patch [attachment:trac-10190_advanced-mercurial.patch] to Sage
> 4.6.rc0:
>
> http://mvngu.googlecode.com/hg/10190-mercurial/index.html
New description:
Add a new chapter to the Developer's Guide on advanced uses of Mercurial.
--
Comment:
Updated patch takes into account most reviewer comments. I scrapped the
idea of creating a new chapter on advanced Mercurial usage. That can wait
for another ticket. The new patch has warnings and notes about commit
message, cloning, and setting the text editor all within the walk-through
chapter. Here's a summary of changes proposed by the patch:
* Warnings about the inefficiency of cloning and point out that Mercurial
queues fits naturally into the patch management problem.
* Some typo fixes.
* Explain that you can write a commit message that spans multiple lines.
* Instructions on writing/editing a commit message with Vi(m) and then
quit the Vi(m) editor.
* Explain that Sage's interface to Mercurial is very basic and that
directly using Mercurial can allow you to be much more productive.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/10190#comment:10>
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 post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en.
