Daiki Kato / mbed-os-lychee

mbed-os for GR-LYCHEE

Dependents:   mbed-os-example-blinky-gr-lychee GR-Boads_Camera_sample GR-Boards_Audio_Recoder GR-Boads_Camera_DisplayApp ... more

features/FEATURE_LWIP/lwip-interface/lwip/doc/savannah.txt@0:f782d9c66c49, 2018-02-02 (annotated)

Committer:
dkato
Date:
Fri Feb 02 05:42:23 2018 +0000
Revision:
0:f782d9c66c49
mbed-os for GR-LYCHEE

Who changed what in which revision?

UserRevisionLine numberNew contents of line
dkato 0:f782d9c66c49 1 Daily Use Guide for using Savannah for lwIP
dkato 0:f782d9c66c49 2
dkato 0:f782d9c66c49 3 Table of Contents:
dkato 0:f782d9c66c49 4
dkato 0:f782d9c66c49 5 1 - Obtaining lwIP from the Git repository
dkato 0:f782d9c66c49 6 2 - Committers/developers Git access using SSH
dkato 0:f782d9c66c49 7 3 - Merging a development branch to master branch
dkato 0:f782d9c66c49 8 4 - How to release lwIP
dkato 0:f782d9c66c49 9
dkato 0:f782d9c66c49 10
dkato 0:f782d9c66c49 11
dkato 0:f782d9c66c49 12 1 Obtaining lwIP from the Git repository
dkato 0:f782d9c66c49 13 ----------------------------------------
dkato 0:f782d9c66c49 14
dkato 0:f782d9c66c49 15 To perform an anonymous Git clone of the master branch (this is where
dkato 0:f782d9c66c49 16 bug fixes and incremental enhancements occur), do this:
dkato 0:f782d9c66c49 17 git clone git://git.savannah.nongnu.org/lwip.git
dkato 0:f782d9c66c49 18
dkato 0:f782d9c66c49 19 Or, obtain a stable branch (updated with bug fixes only) as follows:
dkato 0:f782d9c66c49 20 git clone --branch DEVEL-1_4_1 git://git.savannah.nongnu.org/lwip.git
dkato 0:f782d9c66c49 21
dkato 0:f782d9c66c49 22 Or, obtain a specific (fixed) release as follows:
dkato 0:f782d9c66c49 23 git clone --branch STABLE-1_4_1 git://git.savannah.nongnu.org/lwip.git
dkato 0:f782d9c66c49 24
dkato 0:f782d9c66c49 25
dkato 0:f782d9c66c49 26 2 Committers/developers Git access using SSH
dkato 0:f782d9c66c49 27 --------------------------------------------
dkato 0:f782d9c66c49 28
dkato 0:f782d9c66c49 29 The Savannah server uses SSH (Secure Shell) protocol 2 authentication and encryption.
dkato 0:f782d9c66c49 30 As such, Git commits to the server occur through a SSH tunnel for project members.
dkato 0:f782d9c66c49 31 To create a SSH2 key pair in UNIX-like environments, do this:
dkato 0:f782d9c66c49 32 ssh-keygen -t dsa
dkato 0:f782d9c66c49 33
dkato 0:f782d9c66c49 34 Under Windows, a recommended SSH client is "PuTTY", freely available with good
dkato 0:f782d9c66c49 35 documentation and a graphic user interface. Use its key generator.
dkato 0:f782d9c66c49 36
dkato 0:f782d9c66c49 37 Now paste the id_dsa.pub contents into your Savannah account public key list. Wait
dkato 0:f782d9c66c49 38 a while so that Savannah can update its configuration (This can take minutes).
dkato 0:f782d9c66c49 39
dkato 0:f782d9c66c49 40 Try to login using SSH:
dkato 0:f782d9c66c49 41 ssh -v your_login@git.sv.gnu.org
dkato 0:f782d9c66c49 42
dkato 0:f782d9c66c49 43 If it tells you:
dkato 0:f782d9c66c49 44 Linux vcs.savannah.gnu.org 2.6.32-5-xen-686 #1 SMP Wed Jun 17 17:10:03 UTC 2015 i686
dkato 0:f782d9c66c49 45
dkato 0:f782d9c66c49 46 Interactive shell login is not possible for security reasons.
dkato 0:f782d9c66c49 47 VCS commands are allowed.
dkato 0:f782d9c66c49 48 Last login: Tue May 15 23:10:12 2012 from 82.245.102.129
dkato 0:f782d9c66c49 49 You tried to execute:
dkato 0:f782d9c66c49 50 Sorry, you are not allowed to execute that command.
dkato 0:f782d9c66c49 51 Shared connection to git.sv.gnu.org closed.
dkato 0:f782d9c66c49 52
dkato 0:f782d9c66c49 53 then you could login; Savannah refuses to give you a shell - which is OK, as we
dkato 0:f782d9c66c49 54 are allowed to use SSH for Git only. Now, you should be able to do this:
dkato 0:f782d9c66c49 55 git clone your_login@git.sv.gnu.org:/srv/git/lwip.git
dkato 0:f782d9c66c49 56
dkato 0:f782d9c66c49 57 After which you can edit your local files with bug fixes or new features and
dkato 0:f782d9c66c49 58 commit them. Make sure you know what you are doing when using Git to make
dkato 0:f782d9c66c49 59 changes on the repository. If in doubt, ask on the lwip-members mailing list.
dkato 0:f782d9c66c49 60
dkato 0:f782d9c66c49 61 (If SSH asks about authenticity of the host, you can check the key
dkato 0:f782d9c66c49 62 fingerprint against https://savannah.nongnu.org/git/?group=lwip
dkato 0:f782d9c66c49 63
dkato 0:f782d9c66c49 64
dkato 0:f782d9c66c49 65 3 - Merging a development branch to master branch
dkato 0:f782d9c66c49 66 -------------------------------------------------
dkato 0:f782d9c66c49 67
dkato 0:f782d9c66c49 68 Merging is a straightforward process in Git. How to merge all changes in a
dkato 0:f782d9c66c49 69 development branch since our last merge from main:
dkato 0:f782d9c66c49 70
dkato 0:f782d9c66c49 71 Checkout the master branch:
dkato 0:f782d9c66c49 72 git checkout master
dkato 0:f782d9c66c49 73
dkato 0:f782d9c66c49 74 Merge the development branch to master:
dkato 0:f782d9c66c49 75 git merge your-development-branch
dkato 0:f782d9c66c49 76
dkato 0:f782d9c66c49 77 Resolve any conflict.
dkato 0:f782d9c66c49 78
dkato 0:f782d9c66c49 79 Commit the merge result.
dkato 0:f782d9c66c49 80 git commit -a
dkato 0:f782d9c66c49 81
dkato 0:f782d9c66c49 82 Push your commits:
dkato 0:f782d9c66c49 83 git push
dkato 0:f782d9c66c49 84
dkato 0:f782d9c66c49 85
dkato 0:f782d9c66c49 86 4 How to release lwIP
dkato 0:f782d9c66c49 87 ---------------------
dkato 0:f782d9c66c49 88
dkato 0:f782d9c66c49 89 First, tag the release using Git: (I use release number 1.4.1 throughout
dkato 0:f782d9c66c49 90 this example).
dkato 0:f782d9c66c49 91 git tag -a STABLE-1_4_1
dkato 0:f782d9c66c49 92
dkato 0:f782d9c66c49 93 Share the tag reference by pushing it to remote:
dkato 0:f782d9c66c49 94 git push origin STABLE-1_4_1
dkato 0:f782d9c66c49 95
dkato 0:f782d9c66c49 96 Prepare the release:
dkato 0:f782d9c66c49 97 cp -r lwip lwip-1.4.1
dkato 0:f782d9c66c49 98 rm -rf lwip-1.4.1/.git lwip-1.4.1/.gitattributes
dkato 0:f782d9c66c49 99
dkato 0:f782d9c66c49 100 Archive the current directory using tar, gzip'd, bzip2'd and zip'd.
dkato 0:f782d9c66c49 101 tar czvf lwip-1.4.1.tar.gz lwip-1.4.1
dkato 0:f782d9c66c49 102 tar cjvf lwip-1.4.1.tar.bz2 lwip-1.4.1
dkato 0:f782d9c66c49 103 zip -r lwip-1.4.1.zip lwip-1.4.1
dkato 0:f782d9c66c49 104
dkato 0:f782d9c66c49 105 Now, sign the archives with a detached GPG binary signature as follows:
dkato 0:f782d9c66c49 106 gpg -b lwip-1.4.1.tar.gz
dkato 0:f782d9c66c49 107 gpg -b lwip-1.4.1.tar.bz2
dkato 0:f782d9c66c49 108 gpg -b lwip-1.4.1.zip
dkato 0:f782d9c66c49 109
dkato 0:f782d9c66c49 110 Upload these files using anonymous FTP:
dkato 0:f782d9c66c49 111 ncftp ftp://savannah.gnu.org/incoming/savannah/lwip
dkato 0:f782d9c66c49 112 ncftp> mput *1.4.1.*
dkato 0:f782d9c66c49 113
dkato 0:f782d9c66c49 114 Additionally, you may post a news item on Savannah, like this:
dkato 0:f782d9c66c49 115
dkato 0:f782d9c66c49 116 A new 1.4.1 release is now available here:
dkato 0:f782d9c66c49 117 http://savannah.nongnu.org/files/?group=lwip&highlight=1.4.1
dkato 0:f782d9c66c49 118
dkato 0:f782d9c66c49 119 You will have to submit this via the user News interface, then approve
dkato 0:f782d9c66c49 120 this via the Administrator News interface.