doc/savannah.txt

   1 Daily Use Guide for using Savannah for lwIP
   2
   3 Table of Contents:
   4
   5 1 - Anonymous CVS checkouts and updates (to be elaborated)
   6 2 - Committers/developers CVS access using SSH (to be written)
   7 3 - How to release lwIP
   8
   9
  10 1 Anonymous CVS checkouts and updates
  11 -------------------------------------
  12
  13 Obtain lwIP from the STABLE tree (on the CVS main trunk)
  14
  15 cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip login
  16 cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip checkout lwip
  17
  18 Or, obtain a specific release as follows:
  19
  20 cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip login
  21 cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip checkout -r STABLE-0_6_3 -d lwip-0.6.3 lwip
  22
  23 Or, obtain a development branch as follows:
  24
  25 cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip login
  26 cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip checkout -r DEVEL -d lwip-devel lwip
  27
  28 3 How to release lwIP
  29 ---------------------
  30
  31 First, checkout a clean copy of the branch to be released. Tag this set with
  32 tag name "STABLE-0_6_3". (I use release number 0.6.3 throughout this example).
  33
  34 Login CVS using pserver authentication, then export a clean copy of the
  35 tagged tree. Export is similar to a checkout, except that the CVS metadata
  36 is not created locally.
  37
  38 cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip login
  39 cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/lwip export -r STABLE-0_6_3 -d lwip-0.6.3 lwip
  40
  41 Archive this directory using tar.
  42
  43 tar czvf lwip-0.6.3.tar.gz lwip-0.6.3
  44
  45 First, make a local release directory to work in, I use "lwip-releases":
  46
  47 mkdir lwip-releases
  48 cd lwip-releases
  49
  50 Now, make a new release by creating a new directory for it (these are
  51 Savannah conventions so that it shows up in the Files list real nice):
  52
  53 mkdir stable.pkg
  54 cd stable.pkg
  55 mkdir 0.6.3
  56 cd 0.6.3
  57
  58 We can now copy the tar archive we made earlier into the release directory:
  59
  60 cp /../../../lwip-0.6.3.tar.gz .
  61
  62 Finally, synchronize this directory upwards to Savannah:
  63
  64 rsync -n -e "ssh -1" -t -u -v -r . likewise@savannah.nongnu.org:/upload/lwip
  65
  66 This does a "dry run": no files are modified! After you have confirmed that
  67 this is what you intended to do, remove "-n" and actually synchronize for
  68 real. The release should now be available here:
  69
  70 http://savannah.nongnu.org/files/?group=lwip
  71
  72 ---
  73 Explanation of rsync options used:
  74
  75 -t: preserve file timestamps
  76 -u: do not overwrite existing files, unless they are older
  77 -v: be verbose (long format file attributes)
  78 -r: recurse into directories
  79 -n: dry-run, do not modify anything.
  80 ---
  81
  82 Additionally, you may post a news item on Savannah, like this:
  83
  84 A new 0.6.3 release is now available here:
  85 http://savannah.nongnu.org/files/?group=lwip&highlight=0.6.3
  86
  87 You will have to submit this via the user News interface, then approve
  88 this via the Administrator News interface.