| 40 | | Then edit your MacPorts sources.conf file {{{/opt/local/etc/macports/sources.conf}}} to add ~/myports to the list before the main rsync source at rsync.macports.org, e.g.: |
| 41 | | |
| 42 | | {{{ |
| 43 | | file:///Users/<YourSystemUserName>/myports |
| 44 | | }}} |
| 45 | | |
| 46 | | To work on a copy of a port from MacPorts trunk, use `svn copy`. For example, to test changes on the cableswig port, you can copy the repository trunk (at the HEAD revision) to your new user branch: |
| | 40 | Then edit the MacPorts sources.conf file {{{/opt/local/etc/macports/sources.conf}}} to add ~/myports to the list before the main rsync source at rsync.macports.org, e.g.: |
| | 41 | |
| | 42 | {{{ |
| | 43 | file:///Users/<YourSystemUserName>/myports [nosync] |
| | 44 | }}} |
| | 45 | |
| | 46 | To work on a copy of a port from the MacPorts trunk, use `svn copy`. For example, to test changes on the cableswig port, copy the repository trunk (at the HEAD revision) into the user branch: |
| | 72 | |
| | 73 | Now make experimental changes to the port in the sandbox. Whenever a signficant change is made, note the change with a commit to the sandbox and when all the changes are complete commit the final change to the sandbox with a meaningful commit message. |
| | 74 | |
| | 75 | The main trunk Portfile and the sandbox Portfile are now out of sync. Someone may make changes to the main trunk Portfile while changes are made to the sandbox Portfile. Let's assume that all the experimental changes are successful, so the Portfile needs to be integrated back into the main trunk, where other changes may have occurred. This merge process requires a few steps. Let's assume there are checkouts for the sandbox in ~/myports and the trunk in ~/macports. |
| | 76 | |
| | 77 | First update the sandbox and the trunk checkouts, e.g.: |
| | 78 | |
| | 79 | {{{ |
| | 80 | cd ~/myports |
| | 81 | svn update |
| | 82 | cd ~/macports |
| | 83 | svn update |
| | 84 | }}} |
| | 85 | |
| | 86 | Note that the revision numbers should be the same (because the sandbox and the main trunk belong to the same svn repository). |
| | 87 | |
| | 88 | Next, find out where the experimental changes left off from the trunk and create a bash variable (any shell variable) to store the value of the revision number where the branch copy occurred (the revision number will be the last one in the log): |
| | 89 | |
| | 90 | {{{ |
| | 91 | cd ~/myports/devel/cableswig |
| | 92 | svn log --stop-on-copy Portfile |
| | 93 | EXP_BRANCH_REV=54362 |
| | 94 | }}} |
| | 95 | |
| | 96 | For the curious, leave off the `--stop-on-copy` to see the entire commit log history (it should all be there if there is a continuous and reliable use of svn to manage the file from it's "birth" in the svn repository). |
| | 97 | |
| | 98 | Now take a look at the commit log for the main trunk, to get some hints about what has changed to the file since the experimental branch was forked off. |
| | 99 | |
| | 100 | {{{ |
| | 101 | cd ~/macports/dports/devel/cableswig |
| | 102 | svn log Portfile | more |
| | 103 | }}} |
| | 104 | |
| | 105 | Look through the log to find the revision number where the experimental copy took place. If that is the first revision number in the log, there have been no changes in the trunk. Otherwise, changes have occurred in the trunk that are not in the experimental branch. There could be trunk changes that complement the experimental branch, or they may be in conflict. Try to merge all these changes using the revision number of the experimental copy: |
| | 106 | |
| | 107 | {{{ |
| | 108 | cd ~/macports/dports/devel/cableswig |
| | 109 | svn merge -r ${EXP_BRANCH_REV}:HEAD https://svn.macosforge.org/repository/macports/users/<YourMacPortsUserName>/devel/cableswig/Portfile Portfile |
| | 110 | }}} |
| | 111 | |
| | 112 | Now resolve any conflicts, if any, in the trunk Portfile. All work continues in the trunk (until the next time a sandbox is required). Once the merge looks good, commit all the changes to the trunk with a meaningful commit message, |
| | 113 | |
| | 114 | {{{ |
| | 115 | cd ~/macports/dports/devel/cableswig |
| | 116 | svn commit "merged sandbox changes from ${EXP_BRANCH_REV}:HEAD back into trunk" Portfile |
| | 117 | }}} |
| | 118 | |
| | 119 | Finally, to have the port system revert to using the rsync distribution, it's possible to remove the sandbox port. No information is lost from the svn system, so removing the sandbox port is really harmless (in any case, all the changes are now back in the trunk). For example, |
| | 120 | |
| | 121 | {{{ |
| | 122 | sudo port clean --all cableswig |
| | 123 | cd ~/myports/devel |
| | 124 | svn remove cableswig |
| | 125 | svn commit -m "done with sandbox for cableswig" |
| | 126 | svn update |
| | 127 | cd ~/myports |
| | 128 | portindex |
| | 129 | }}} |
| | 130 | |
