| Daily Use Guide for using Savannah for lwIP |
| |
| Table of Contents: |
| |
| 1 - Anonymous CVS checkouts and updates (to be elaborated) |
| 2 - Committers/developers CVS access using SSH (to be written) |
| 3 - Merging from DEVEL branch to main trunk (stable branch) |
| 4 - How to release lwIP |
| |
| |
| 1 Anonymous CVS checkouts and updates |
| ------------------------------------- |
| |
| Obtain lwIP from the STABLE tree (on the CVS main trunk) |
| |
| cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip login |
| cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip checkout lwip |
| |
| Or, obtain a specific release as follows: |
| |
| cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip login |
| cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip checkout -r STABLE-0_6_3 -d lwip-0.6.3 lwip |
| |
| Or, obtain a development branch as follows: |
| |
| cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip login |
| cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip checkout -r DEVEL -d lwip-devel lwip |
| |
| |
| 3 Merging from DEVEL branch to main trunk (stable branch) |
| --------------------------------------------------------- |
| |
| Merging from DEVEL to main requires that the DEVEL branch |
| has a tag indicating the previous merger. This tag is |
| called 'merged_from_DEVEL_to_main'. |
| |
| IMPORTANT: AFTER COMMITTING A SUCCESFUL MERGE IN THE |
| REPOSITORY, THE TAG MUST BE SET ON THE SOURCE OF THE |
| MERGE BRANCH (REPLACING EXISTING TAGS WITH THE SAME NAME). |
| |
| Merge all changes in DEVEL since our last merge to main: |
| |
| In the working copy of the main trunk: |
| cvs update -P -jmerged_from_DEVEL_to_main -jDEVEL |
| |
| Now move the tag in the DEVEL branch to this merge point, |
| so we can use this for future merges. |
| |
| cvs -z4 rtag -F -r DEVEL merged_from_DEVEL_to_main lwip |
| |
| 4 How to release lwIP |
| --------------------- |
| |
| First, checkout a clean copy of the branch to be released. Tag this set with |
| tag name "STABLE-0_6_3". (I use release number 0.6.3 throughout this example). |
| |
| Login CVS using pserver authentication, then export a clean copy of the |
| tagged tree. Export is similar to a checkout, except that the CVS metadata |
| is not created locally. |
| |
| cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip login |
| cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip export -r STABLE-0_6_3 -d lwip-0.6.3 lwip |
| |
| Archive this directory using tar. |
| |
| tar czvf lwip-0.6.3.tar.gz lwip-0.6.3 |
| |
| First, make a local release directory to work in, I use "lwip-releases": |
| |
| mkdir lwip-releases |
| cd lwip-releases |
| |
| Now, make a new release by creating a new directory for it (these are |
| Savannah conventions so that it shows up in the Files list real nice): |
| |
| mkdir stable.pkg |
| cd stable.pkg |
| mkdir 0.6.3 |
| cd 0.6.3 |
| |
| We can now copy the tar archive we made earlier into the release directory: |
| |
| cp /../../../lwip-0.6.3.tar.gz . |
| |
| Finally, synchronize this directory upwards to Savannah: |
| |
| rsync -n -e "ssh -1" -t -u -v -r . likewise@savannah.nongnu.org:/upload/lwip |
| |
| This does a "dry run": no files are modified! After you have confirmed that |
| this is what you intended to do, remove "-n" and actually synchronize for |
| real. The release should now be available here: |
| |
| http://savannah.nongnu.org/files/?group=lwip |
| |
| --- |
| Explanation of rsync options used: |
| |
| -t: preserve file timestamps |
| -u: do not overwrite existing files, unless they are older |
| -v: be verbose (long format file attributes) |
| -r: recurse into directories |
| -n: dry-run, do not modify anything. |
| --- |
| |
| Additionally, you may post a news item on Savannah, like this: |
| |
| A new 0.6.3 release is now available here: |
| http://savannah.nongnu.org/files/?group=lwip&highlight=0.6.3 |
| |
| You will have to submit this via the user News interface, then approve |
| this via the Administrator News interface. |