|
Size: 4478
Comment:
|
← Revision 94 as of 2022-04-05 05:49:56 ⇥
Size: 0
Comment: outdated
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| #pragma section-numbers off = Use and Contribute to the sage-combinat tree : step by step = == A. Use sage-combinat patches == === 1. Install sage-combinat === {{{ sage -combinat install }}} === 2. Moving around the patches === The sage-combinat is a set of ordered patches. The behavior of moving around those is done like a stack: {{{ hg qpop hg qpush hg qpop -a hg qpush -a }}} To know which is actually on top or which patches are currently applied or unapplied: {{{ hg qapplied hg qunapplied hg qseries hg qtop }}} Important note : after moving around the stack of patches, and before using sage, don't forget to rebuild sage so that it corresonds to the current state of the stack: {{{ sage -b }}} Use {{{ hg qdiff }}} to display the actual modifications of the current top patch or use {{{ hg qstatus }}} to list simply the name of the affected files. == B. Contribute to sage-combinat == Here are the basics steps in order to contribute some of your code to sage-combinat. Note that a patch has a unique owner. Never modify a patch that is not yours. If you already own a patch, you can go directly to paragraph 2. === 1. Create a patch where to put the changes === Changes are always saved to the actual top patch currently applied. So before doing any changes, you must determine the patch where the changes should be saved. If it is your first contribution, first create a patch: {{{ hg qnew my_improvement_AB.patch }}} This creates a new patch right after the current top patch. Usually, a new patch is created on the top of the stack of patches and you can make sure of this by doing: {{{ hg qpush -a hg qnew my_improvement_AB.patch }}} It is suggested to add your initials (here AB) in the name so that everybody knows who owns what. === 2. Do your modifications === First, make sure the current top patch is the good one and that it is yours: {{{ hg qtop qnew my_improvement_AB.patch }}} Edit an or many existing files. Once you are done, you can review your modifications since the last qrefresh (explained below) or since the creation of the patch by doing: {{{ hg diff }}} Use {{{ hg status }}} to list simply the modified files. Note that you can't use qpop and qpush commands once you started modifications. If you added a file, you must specify it by the command: {{{ hg add <filename> }}} === 3. QRefresh the patch === Currently, the modifications are still not part of the patch as seen by the command {{{ hg qdiff hg qstatus }}} that does not display them. Use {{{ hg qrefresh }}} to put the actual modifications in the current top patch. You can make sure that it worked using the command {{{ hg qdiff hg qstatus }}} again that should now display them. Moreover the command {{{ hg diff hg status }}} should now display nothing. Note that you can now use qpop and qpush again since you don't actually have unfreshed modifications. === 4. Do more modifications === More modifications can be done to the same patch or to other patches you have already created. Follow again 1-3. === 5. Commit your changes to the local mercurial database === After having done modifications to one or to many patches, you migth want to commit them to the local mercurial database: {{{ hg qcommit }}} It includes all the changes to the patches done since the last commit. An editor will appear for you to provide a description of all the changes you made. === 6. Merge your changes with other sage-combinat developpers === There is a possibility that somebody else pushed changes to the server since the last time you updated your sage-combinat tree. You will use the local mercurial database to merge those modifications. First pull any recent changes on the server by doing : {{{ cd .hg/patches hg pull -u }}} and {{{ hg merge }}} if there needed. TODO : write about conflicts... === 7. Push your changes to the server === Here is where you must be prudent. Before committing any changes to the server, make sure that sage -br works fine: {{{ hg qpop -a hg qpush -a sage -br }}} and that it passes the tests: {{{ sage -t <filenames> }}} Then push your server after making sure again that there is no changes on the server: {{{ cd .hg/patches hg pull -u hg push }}} |
