sane-project-backends/doc/releases.txt

82 wiersze
3.3 KiB
Plaintext
Czysty Zwykły widok Historia

2009-05-05
This text summarizes some points to pay attention to when a new release
of sane-backends is planned.
Timetable (approximate periods):
Day 0: Announcement of upcoming release on sane-devel including timetable
2004-11-07 19:40:52 +00:00
Day 14: Feature freeze (only bugfixes + documentation updates)
Day 28: Code freeze (only fixes for bugs that can destroy hardware, can cause
compilation problems or render a backend completely unusable, and
documentation updates are allowed)
2004-11-07 19:40:52 +00:00
Day 35: Release
Before the release:
2010-04-26 03:29:39 +00:00
* set :new :yes on any new backend .desc files
* Make sure that config.guess and config.sub are up-to-date (get them from
2008-02-10 20:32:40 +00:00
savannah.gnu.org/projects/config)
* configure.in: increase version number
* configure.in: remove 'git' from textual version number
2006-06-29 17:47:49 +00:00
* configure.in: set is_release=yes
2008-02-10 20:32:40 +00:00
* OPTIONAL: aclocal.m4: recreate by running aclocal
* OPTIONAL: include/sane/config.h.in: recreate (autoheader in root of checkout)
* DONT run automake, it will overwrite our custom ltmain.sh
* configure: recreate by running autoconf
* NEWS: update and enter date of release
* sane-backends.lsm: update
* ChangeLog: set release marker
2010-04-26 03:28:52 +00:00
* git commit -a
* tag git with release tag; e.g.: 'git tag -a RELEASE_1_0_15'
* probably DONT want to git push here, cause alioth will rebuild it's local
checkout needlessly
Making the release:
* make tar.gz, sane-backends-x.y.z.lsm, and .md5sum with "make sane-backends"
2004-11-07 19:40:52 +00:00
* unpack tar.gz in temporary directory
* make diff from last release by unpacking it also in temporary directory
and running e.g.
diff -uNr sane-backends-1.0.14 sane-backends-1.0.15 > sane-backends-1.0.14-1.0.15.diff
2004-11-07 19:40:52 +00:00
* check that the diff applies cleanly to the old version
* gzip the diff
2008-02-10 23:02:31 +00:00
* install devel headers required to build optional backends (1284,gphoto,etc)
2004-11-07 19:40:52 +00:00
* check that the new version .tar.gz can be compiled
* upload these files together with the .diff.gz to the FTP/HTTP servers
(at the moment: alioth.debian.org, ftp files are in
/srv/alioth.debian.org/chroot/ftproot/pub/sane/ )
2008-02-11 02:50:55 +00:00
Announcing the release:
* checkout the sane/website.git module and:
2008-02-11 02:50:55 +00:00
* copy sane-backends.html to sane-backends-"old-version".html
* update sane-supported-devices.html with link to above "old" file
2011-02-14 02:40:17 +00:00
* rebuild sane-backends.html and sane-mfgs.html (make -C doc html-pages)
* use man2html from http://hydra.nac.uci.edu/indiv/ehood/man2html.html
2011-02-14 02:40:17 +00:00
to rebuild html man pages (make -C doc html-man) (no other version works)
2008-02-11 02:50:55 +00:00
* add md5 sum to sane-md5sum.txt
* check and update platforms page (sane-support.html)
2010-04-26 03:29:39 +00:00
* add announcement to index.html
* git commit -a && git push
2010-04-26 03:29:39 +00:00
* check that website was updated automatically. if not, see:
/org/alioth.debian.org/chroot/home/groups/sane/bin/update-htdocs.sh
2011-02-14 02:40:17 +00:00
* rebuild descriptions.db (make -C doc descriptions.db)
* scp doc/descriptions.db to alioth:
2010-04-26 03:29:39 +00:00
/org/alioth.debian.org/chroot/home/groups/sane/search/release
* write announcements sane-devel, maybe others (e.g. freshmeat),
include the md5 hash
After the release:
2011-02-14 02:40:17 +00:00
* move ChangeLog to ChangeLog-"version"
* start a new ChangeLog
* add ChangeLog-"version" to EXTRA_DIST in Makefile.in
2010-04-26 03:48:14 +00:00
* configure.in: bump textual version & add 'git' suffix
* configure.in: bump V_REV
* configure.in: set is_release=no
2008-02-11 02:50:55 +00:00
* configure: regenerate with autoconf
* remove the ':new' tag from any new backends .desc files
2010-04-26 03:48:14 +00:00
* git add new files and commit
* git push --tags