How to make a gnulib stable snapshot

home | public key | projects | debian packages | apt source | webtools | ssl

gnuit | gnulib | surfraw | id3fs | XML::PFIF | mp3lint | mp3-archive-tools | libmp3-archive-perl

Branches

Procedure

1. if you don't already have a repository:
   • clone the gnulib repo:

              $ git clone git://git.savannah.gnu.org/gnulib.git
     	 $ git branch -m master upstream
            

   • then either import the existing stable repo:

              $ git remote add erislabs git://erislabs.net/gnulib.git
     	 $ git fetch erislabs
     	 $ git branch stable erislabs/stable
            

   • or, if that isn't possible, start from scratch:

              $ git branch stable upstream
            

2. update upstream branch:

            $ git checkout upstream
            $ git pull
        

3. tag the current upstream HEAD for later use:

            $ git tag snapshot-start upstream
        

4. run the test suite:

            $ git checkout upstream
            $ ./gnulib-tool --create-megatestdir --with-tests  --dir=t 2>&1 | tee create.out
            $ cd t
            $ ./do-autobuild 2>&1 | tee ../build.out
            $ cd ..
        

5. find failing tests with:

            $ grep -L rc=0 t/logs/*
        

6. report any issues to bug-gnulib@gnu.org
7. merge the current upstream version into the stable branch:

            $ git checkout stable
            $ git merge upstream
        

8. resolve conflicts

            $ git checkout upstream <all conflicting paths except NEWS.stable>
            $ git commit -a
        

9. wait a week or so
10. update upstream branch:

             $ git checkout upstream
             $ git pull
         

11. create list of commits to review:

             $ git log --oneline --reverse --topo-order snapshot-start..upstream > ../stable.log
         

12. return to the stable branch

             $ git checkout stable
         

13. prepare NEWS.stable for new release:
    • add new header
    • add __NEXTCOMMITMARKER__ tag where you want commits to be logged
14. for each commit in ../stable.log:
    • review each commit in ../stable.log:

               $ git show commitid
      	 

    • if you want to cherry-pick that commit:

               $ stable-cherry-pick commitid
      	 

      (stable-cherry-pick source)
    • if the cherry-pick fails:
      • resolve the conflict and commit, making a note of the new commitid
      • fill in the new commitid in NEWS.stable, then commit
15. remove __NEXTCOMMIT__ marker from NEWS.stable, commit
16. test (see above). If testsuite fails, check whether bug exists in upstream branch, report to bug-gnulib@gnu.org.
17. remove the temporary snapshot-start tag

              $ git tag -d snapshot-start
         

18. tag the new release

              $ git tag stable/yymmdd
         

19. create and upload tarball:

              $ git archive --format=tar --prefix=gnulib-yymmdd-stable/ stable/yymmdd | gzip -9 > ../gnulib-yymmdd-stable.tar.gz
         

20. push changes to stable git repository
21. mail announcement to bug-gnulib@gnu.org