Dear @ppurka thanks so much - i am now finally back at home with my trusty Macs and hopefully will be able to do the above, eventually .... :)
For me this is entering an exciting new phase! Thanks again. Best regards Gary On Sat, Apr 20, 2013 at 6:00 PM, P Purkayastha <ppu...@gmail.com> wrote: > On 04/18/2013 03:13 AM, Gary McConnell wrote: > >> I am very keen to help - my problem is utter incompetence at following >> the high-level instructions in the manual for developers. Also I am on >> the VM and I cannot access the sage directories directly. Is there a way >> you could send me a manual file that I could modify and send back to >> you? Sorry :( I promise I will learn this one day ... >> >> the page I was referring to is >> http://www.sagemath.org/doc/**reference/numerical/sage/** >> numerical/optimize.html#sage.**numerical.optimize.minimize<http://www.sagemath.org/doc/reference/numerical/sage/numerical/optimize.html#sage.numerical.optimize.minimize> >> >> Also there are presumably many functions to which this syntax difference >> applies ... how can I find them? >> >> Thanks! >> > > I failed to notice this reply earlier. > > I think it is better if you can submit a patch to trac. The patch is > generated by mercurial and it can automatically populate the author > attribution and other information. These information is used by a patchbot > that automatically tests the patches for validity and performs other tests. > > To generate the patch, you can either install the sage library code. > > If you don't want to install the sage from source, you can download the > sage spkg and work with that. This is OK since you intend to do only > documentation changes. In this case, follow the steps below: > > 1. download the sage spkg from http://www.sagemath.org/** > packages/standard/sage-5.8.**spkg<http://www.sagemath.org/packages/standard/sage-5.8.spkg> > This contains the source code. > > 2. Create a file in $HOME/.hgrc containing your name as mentioned here: > http://www.sagemath.org/doc/**developer/producing_patches.**html<http://www.sagemath.org/doc/developer/producing_patches.html> > > 3. Open a ticket in trac so that you can get the ticket number. Let's say > the number is 12345. > > 4. Use the inbuilt mercurial inside Sage to create the patch. > i) First change directory to the unpacked sage/sage directory > ii) Next, run the command (where /path/to/sage is where the sage script is > present and 12345 is the ticket number) > /path/to/sage -hg qnew 12345_documentation.patch > iii) Hack hack hack and make your changes :) > You will need to follow the developer documentation for syntax and > formatting. > iv) Now that you are satisfied with your changes, run > /path/to/sage -hg qref -m "a one line description of your changes" > v) Make hg generate the patch: > /path/to/sage -hg export qtip > ~/$(/path/to/sage -hg qtop) > > 5. Go back to the ticket and upload the patch that is present at > ~/12345_documentation.patch > > Hopefully, this procedure will become much simpler after the move to git, > since trivial changes can be made directly in github (if the project > remains hosted in github). > > > -- > You received this message because you are subscribed to a topic in the > Google Groups "sage-support" group. > To unsubscribe from this topic, visit https://groups.google.com/d/** > topic/sage-support/**3mekDq5Stvk/unsubscribe?hl=en<https://groups.google.com/d/topic/sage-support/3mekDq5Stvk/unsubscribe?hl=en> > . > To unsubscribe from this group and all its topics, send an email to > sage-support+unsubscribe@**googlegroups.com<sage-support%2bunsubscr...@googlegroups.com> > . > To post to this group, send email to sage-support@googlegroups.com. > Visit this group at > http://groups.google.com/**group/sage-support?hl=en<http://groups.google.com/group/sage-support?hl=en> > . > For more options, visit > https://groups.google.com/**groups/opt_out<https://groups.google.com/groups/opt_out> > . > > > -- You received this message because you are subscribed to the Google Groups "sage-support" group. To unsubscribe from this group and stop receiving emails from it, send an email to sage-support+unsubscr...@googlegroups.com. To post to this group, send email to sage-support@googlegroups.com. Visit this group at http://groups.google.com/group/sage-support?hl=en. For more options, visit https://groups.google.com/groups/opt_out.