#18618: sandpile revisions
-------------------------------------+-------------------------------------
Reporter: dperkinson | Owner:
Type: enhancement | Status: needs_work
Priority: major | Milestone: sage-6.8
Component: graph theory | Resolution:
Keywords: sandpile | Merged in:
Authors: David Perkinson | Reviewers:
Report Upstream: N/A | Work issues:
Branch: | Commit:
u/dperkinson/sandpile_revisions | 9b10bf5e5372b9f2dcb3dd9857304bb4dc43547e
Dependencies: | Stopgaps:
-------------------------------------+-------------------------------------
Comment (by dperkinson):
Replying to [comment:19 tscrim]:
> Replying to [comment:18 dperkinson]:
> > I have just pushed changes in response to the (very helpful) comments
above. The INPUT sections of the docstrings are all standardized now, as
are the NOTE, WARNING, etc., sections. ``!SandpileExamples`` has the
"new-class" style. The help functions are now automated rather than hard-
wired, as advised.
>
> Looks good. This could potentially be used as a model for other parts of
Sage.
>
> > Should I remove every instance of INPUT for which there is no input
(None) and, separately, every instance of OUTPUT for which there is no
output (None)? The documentation for developers at sagemath.org states
that every function must have an INPUT and OUTPUT statement, and further
that this "is not optional".
>
> *tries to put politics aside* These add clutter to the docstring and are
a ''very'' good exception to the rule. So yes, please remove them.
>
Just to be completely clear: suppose, for example, that I have a docstring
with None listed under INPUT and integer listed under OUTPUT. Then I
should remove the INPUT section, leaving the OUTPUT section, right?
> > At any rate, for this new version, with my local version of Sage, all
tests passed for "sage -t", and the html and pdf documentation built
without problems.
>
> However there is currently a merge conflict with the latest beta. So
you'll need to rebase it.
I am new to git, so I could use some guidance here. I have been working
in a directory called git-trac-command. The output from "git branch"
shows two branches: ``master`` and ``t/18618/sandpile_revisions``, with an
asterisk next to the latter. After my initial git push command, I have
modified files in another, separate, copy of sage. When I done making and
testing the revisions, I copy the relevant modified files (sandpile.py,
examples.py, etc.) to git-trac-command/src/sage/sandpiles. I then run
``./sage -br``, ``git add NEW FILES``, ``git commit``, and ``git trac
push``.
What is the sequence of commands I should enter to resolve the current
conflict? Also, what should I have done originally to have avoided the
conflict?
Thanks very much for your time and advice!
--
Ticket URL: <http://trac.sagemath.org/ticket/18618#comment:20>
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 unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.