Packaging - Revision history

Sushain at 19:51, 26 April 2018

2018-04-26T19:51:10Z

Ilnar.salimzyan at 16:52, 17 April 2018

2018-04-17T16:52:11Z

Tino Didriksen: /* Raw Rundown */

2017-10-28T11:55:25Z

Raw Rundown

Tino Didriksen at 11:41, 28 October 2017

2017-10-28T11:41:10Z

Tino Didriksen at 14:18, 29 July 2016

2016-07-29T14:18:07Z

Tino Didriksen: /* Control Files in Subversion */

2016-07-29T14:17:03Z

Control Files in Subversion

Tino Didriksen: /* Release to Debian */

2016-07-29T14:15:46Z

Release to Debian

Tino Didriksen: /* Release to Debian */

2016-07-29T14:10:38Z

Release to Debian

Tino Didriksen: /* Release to Debian */

2016-07-29T13:57:49Z

Release to Debian

Tino Didriksen at 13:56, 29 July 2016

2016-07-29T13:56:52Z

@@ Line 1: / Line 1: @@
+{{Github-migration-check}}
 == New Language or Pair Package ==
 <pre>

@@ Line 216: / Line 216: @@
 </pre>
-== People, Lists ==
+== People, Logs/Lists ==
 * [[User:Tino_Didriksen|Tino Didriksen]] is the primary person to ask
 * Github mirror: https://github.com/TinoDidriksen/apertium-packaging
-* Nightly build results: https://lists.sourceforge.net/lists/listinfo/apertium-packaging ([https://sourceforge.net/p/apertium/mailman/apertium-packaging/ archives])
+* Nightly build results: https://apertium.projectjj.com/apt/logs/ https://lists.sourceforge.net/lists/listinfo/apertium-packaging ([https://sourceforge.net/p/apertium/mailman/apertium-packaging/ archives])

@@ Line 84: / Line 84: @@
 <pre># date -u
 Sat, Oct 28, 2017 10:45:36
+... check out the packages:
 # cd /tmp
@@ Line 89: / Line 91: @@
 # svn co https://svn.code.sf.net/p/apertium/svn/languages/apertium-srd
 # svn co https://svn.code.sf.net/p/apertium/svn/trunk/apertium-cat-srd
+... for each package, check that the versions are synced and later than previous release:
 # cd /tmp/apertium-cat
@@ Line 107: / Line 112: @@
 # cd /tmp
 # svn ci -m "Versions" apertium-cat apertium-srd apertium-cat-srd
+... check that each package can be built and make a usable tarball:
 # cd /tmp/apertium-cat
@@ Line 137: / Line 145: @@
 # ./configure --with-lang1=/tmp/apertium-cat/apertium-cat-2.3.1/ --with-lang2=/tmp/apertium-srd/apertium-srd-1.2.0/
 # make -j4
+... check that the translations don't crash:
 # echo "Hello world" | apertium -d . cat-srd
 # echo "Hello world" | apertium -d . srd-cat
+... update Debian Science repos and ensure control files are synced back to our svn:
 # cd ~/debian/apertium-cat
@@ Line 146: / Line 160: @@
 # cd ~/debian/apertium-cat-srd/
 # gbp pull && git pull --all
+... update control files with new releases and version dependencies:
 # cd /misc/branches/packaging
@@ Line 156: / Line 172: @@
 # ./rebuild-old.pl -r apertium-cat-srd
 # svn ci -m "Release cat, srd, cat-srd"
+... for each package, make a signed Debian source package, import it to git,
+... check that nothing odd was changed in the control files, then push it back to Debian:
 # cd /misc/branches/packaging
@@ Line 178: / Line 198: @@
 # git push --all && git push --tags
+... as a fresh login as the apertium user (so that systemd will work),
-# su - apertium
+... update APy installation and restart service:
 $ cd tarballs
@@ Line 187: / Line 208: @@
 $ systemctl --user restart apy
-... upload .tar.gz files to https://sourceforge.net/projects/apertium/files/ ...
+... upload .tar.gz files to https://sourceforge.net/projects/apertium/files/
 # date -u
 Sat Oct 28 11:25:16 UTC 2017
+... finally, send release report to apertium-stuff
 </pre>

@@ Line 77: / Line 77: @@
 git push --all
 git push origin upstream/3.4.2_r68453
+</pre>
+== Raw Rundown ==
+Example of flow of releasing apertium-cat 2.3.1, apertium-srd 1.2.0, and apertium-cat-srd 1.0.0:
+<pre># date -u
+Sat, Oct 28, 2017 10:45:36
+# cd /tmp
+# svn co https://svn.code.sf.net/p/apertium/svn/languages/apertium-cat
+# svn co https://svn.code.sf.net/p/apertium/svn/languages/apertium-srd
+# svn co https://svn.code.sf.net/p/apertium/svn/trunk/apertium-cat-srd
+# cd /tmp/apertium-cat
+# svn log -v | less
+# mcedit Makefile.am
+# mcedit configure.ac
+# cd /tmp/apertium-srd
+# svn log -v | less
+# mcedit Makefile.am
+# mcedit configure.ac
+# cd /tmp/apertium-cat-srd
+# svn log -v | less
+# mcedit Makefile.am
+# mcedit configure.ac
+# cd /tmp
+# svn ci -m "Versions" apertium-cat apertium-srd apertium-cat-srd
+# cd /tmp/apertium-cat
+# autoreconf -fvi
+# ./configure
+# make -j4
+# make dist
+# tar -zxvf apertium-cat-2.3.1.tar.gz
+# cd apertium-cat-2.3.1
+# ./configure
+# make -j4
+# cd /tmp/apertium-srd
+# autoreconf -fvi
+# ./configure
+# make -j4
+# make dist
+# tar -zxvf apertium-srd-1.2.0.tar.gz
+# cd apertium-srd-1.2.0
+# ./configure
+# make -j4
+# cd /tmp/apertium-cat-srd
+# autoreconf -fvi
+# ./configure --with-lang1=/tmp/apertium-cat/apertium-cat-2.3.1/ --with-lang2=/tmp/apertium-srd/apertium-srd-1.2.0/
+# make -j4
+# make dist
+# tar -zxvf apertium-cat-srd-1.0.0.tar.gz
+# cd apertium-cat-srd-1.0.0/
+# ./configure --with-lang1=/tmp/apertium-cat/apertium-cat-2.3.1/ --with-lang2=/tmp/apertium-srd/apertium-srd-1.2.0/
+# make -j4
+# echo "Hello world" | apertium -d . cat-srd
+# echo "Hello world" | apertium -d . srd-cat
+# cd ~/debian/apertium-cat
+# gbp pull && git pull --all
+# cd ~/debian/apertium-srd
+# gbp pull && git pull --all
+# cd ~/debian/apertium-cat-srd/
+# gbp pull && git pull --all
+# cd /misc/branches/packaging
+# mcedit languages/apertium-cat/changelog
+# mcedit languages/apertium-srd/changelog
+# mcedit trunk/apertium-cat-srd/changelog
+# mcedit trunk/apertium-cat-srd/control
+# ./rebuild-old.pl -r apertium-cat
+# ./rebuild-old.pl -r apertium-srd
+# ./rebuild-old.pl -r apertium-cat-srd
+# svn ci -m "Release cat, srd, cat-srd"
+# cd /misc/branches/packaging
+# ./single-dpkg.pl languages/apertium-cat --auto 0 -m 'Debian Science Team <debian-science-maintainers@lists.alioth.debian.org>' --rev 82994
+# cd ~/debian/apertium-cat
+# gbp import-dsc --pristine-tar --sign-tags /tmp/autopkg.*/*.dsc
+# git diff origin/master debian
+# git push --all && git push --tags
+# cd /misc/branches/packaging
+# ./single-dpkg.pl languages/apertium-srd --auto 0 -m 'Debian Science Team <debian-science-maintainers@lists.alioth.debian.org>' --rev 82994
+# cd ~/debian/apertium-srd
+# gbp import-dsc --pristine-tar --sign-tags /tmp/autopkg.*/*.dsc
+# git diff origin/master debian
+# git push --all && git push --tags
+# cd /misc/branches/packaging
+# ./single-dpkg.pl trunk/apertium-cat-srd --auto 0 -m 'Debian Science Team <debian-science-maintainers@lists.alioth.debian.org>' --rev 82995
+# cd ~/debian/apertium-cat-srd
+# gbp import-dsc --pristine-tar --sign-tags /tmp/autopkg.*/*.dsc
+# git diff origin/master debian
+# git push --all && git push --tags
+# su - apertium
+$ cd tarballs
+$ cp -av /tmp/apertium-*/*.tar.gz ./
+$ ./install-tarball.sh apertium-cat-2.3.1.tar.gz
+$ ./install-tarball.sh apertium-srd-1.2.0.tar.gz
+$ ./install-tarball.sh apertium-cat-srd-1.0.0.tar.gz
+$ systemctl --user restart apy
+... upload .tar.gz files to https://sourceforge.net/projects/apertium/files/ ...
+# date -u
+Sat Oct 28 11:25:16 UTC 2017
 </pre>

@@ Line 1: / Line 1: @@
-= New Language or Pair Package =
+== New Language or Pair Package ==
 <pre>
 svn co https://svn.code.sf.net/p/apertium/svn/branches/packaging
@@ Line 23: / Line 23: @@
 </pre>
-= Release to Debian =
+== Release to Debian ==
 * <code><nowiki>cd packaging</nowiki></code>
-== Prerequisites ==
+=== Prerequisites ===
 * A 4096 bit GnuPG key published to the various keyservers
 * An [https://alioth.debian.org/ Alioth login]
 * Access to the [http://debian-science.alioth.debian.org/debian-science-policy.html#idm45916844880768 Debian Science team]
-== Control Files in Subversion ==
+=== Control Files in Subversion ===
 Ensure control files correct, especially <code><nowiki>debian/copyright</nowiki></code> and <code><nowiki>debian/changelog</nowiki></code>. You will probably have to merge in the Debian git's control files as minor changes happen there. Everything else ought to be ok already, or it would have failed nightly build
@@ Line 57: / Line 57: @@
 Commit control files
-== Make and Sign Tarball ==
+=== Make and Sign Tarball ===
 Generate the signed Debian source package, from the revision above. The argument to -e must match the GnuPG key you're signing with:
 * <code><nowiki>./single-dpkg.pl trunk/apertium/ --auto 0 -m 'Debian Science Team <debian-science-maintainers@lists.alioth.debian.org>' -e 'Your Name <your@email.com>' --rev 68453</nowiki></code>
-== Import to Debian ==
+=== Import to Debian ===
 Import it to the Debian git repo.
@@ Line 79: / Line 79: @@
 </pre>
-= People, Lists =
+== People, Lists ==
 * [[User:Tino_Didriksen|Tino Didriksen]] is the primary person to ask
 * Github mirror: https://github.com/TinoDidriksen/apertium-packaging

@@ Line 32: / Line 32: @@
 == Control Files in Subversion ==
-Ensure control files correct, especially <code><nowiki>debian/copyright</nowiki></code> and <code><nowiki>debian/changelog</nowiki></code>. Everything else ought to be ok already, or it would have failed nightly build
+Ensure control files correct, especially <code><nowiki>debian/copyright</nowiki></code> and <code><nowiki>debian/changelog</nowiki></code>. You will probably have to merge in the Debian git's control files as minor changes happen there. Everything else ought to be ok already, or it would have failed nightly build
 Determine the svn revision that corresponds to the release and put this with the version in <code><nowiki>debian/changelog</nowiki></code>

@@ Line 24: / Line 24: @@
 = Release to Debian =
+* <code><nowiki>cd packaging</nowiki></code>
-<pre>
-cd packaging
+== Control Files in Subversion ==
-# 1) Ensure control files correct, especially debian/copyright and debian/changelog
-# Everything else ought to be ok already, or it would have failed nightly build
+Ensure control files correct, especially <code><nowiki>debian/copyright</nowiki></code> and <code><nowiki>debian/changelog</nowiki></code>. Everything else ought to be ok already, or it would have failed nightly build
-# 1.1) Determine the svn revision that corresponds to the release
+Determine the svn revision that corresponds to the release and put this with the version in <code><nowiki>debian/changelog</nowiki></code>
-# and put this with the version in debian/changelog
-# 1.1.1) If a tag was made, this is easy, e.g. for apertium 3.4.2:
+If a tag was made, this is easy, e.g. for apertium 3.4.2:
-svn log -q -l1 https://svn.code.sf.net/p/apertium/svn/tags/apertium/release-3.4.2/
+* <code><nowiki>svn log -q -l1 https://svn.code.sf.net/p/apertium/svn/tags/apertium/release-3.4.2/</nowiki></code> yields r68453
-# yields r68453
-# 1.1.2) Otherwise, look through to see what revision corresponds with the release:
+Otherwise, look through to see what revision corresponds with the release:
-svn log https://svn.code.sf.net/p/apertium/svn/trunk/apertium/ | less
+* <code><nowiki>svn log https://svn.code.sf.net/p/apertium/svn/trunk/apertium/ | less</nowiki></code>
-# 1.2) For the found revision, make sure the version in configure.ac (or similar) is correct:
+For the found revision, make sure the version in configure.ac (or similar) is correct:
-svn cat -r68453 https://svn.code.sf.net/p/apertium/svn/trunk/apertium/configure.ac | less
+* <code><nowiki>svn cat -r68453 https://svn.code.sf.net/p/apertium/svn/trunk/apertium/configure.ac | less</nowiki></code>
-# 1.3) Update debian/changelog with the found version and revision and sign+stamp it, e.g.:
+Update debian/changelog with the found version and revision and sign+stamp it, e.g.:
-apertium (3.4.2~r68453-1) unstable; urgency=low
+<pre>apertium (3.4.2~r68453-1) unstable; urgency=low
   * New upstream release.
- -- Tino Didriksen <tino@didriksen.cc>  Wed, 25 May 2016 11:27:01 +0200
+ -- Tino Didriksen <tino@didriksen.cc>  Wed, 25 May 2016 11:27:01 +0200</pre>
-# 1.4) Optionally, ensure exclude.txt has patterns of all files you don't want in the source tarball.
+Optionally, ensure exclude.txt has patterns of all files you don't want in the source tarball. For languages and pairs, this is usually all folders:
+* <code><nowiki>*/</nowiki></code>
-# For languages and pairs, this is usually all folders: */
-# 1.5) Commit control files
+Commit control files
+== Make and Sign Tarball ==
-# 2) Generate the signed Debian source package, from the revision above.
-# The argument to -e must match the GnuPG key you're signing with:
+Generate the signed Debian source package, from the revision above. The argument to -e must match the GnuPG key you're signing with:
-./single-dpkg.pl trunk/apertium/ --auto 0 \
+* <code><nowiki>./single-dpkg.pl trunk/apertium/ --auto 0 -m 'Debian Science Team <debian-science-maintainers@lists.alioth.debian.org>' -e 'Your Name <your@email.com>' --rev 68453</nowiki></code>
--m 'Debian Science Team <debian-science-maintainers@lists.alioth.debian.org>' \
--e 'Your Name <your@email.com>' \
---rev 68453
-# 3) Import it to the Debian git repo.
+== Import to Debian ==
+Import it to the Debian git repo.
-# 3.1) Clone or pull:
+Clone or pull:
-gbp clone ssh://your-alioth-login@git.debian.org/srv/git.debian.org/git/debian-science/packages/apertium.git
+<pre>gbp clone ssh://your-alioth-login@git.debian.org/srv/git.debian.org/git/debian-science/packages/apertium.git
-cd apertium
+cd apertium</pre>
-# Or, if you have it cloned already:
+Or, if you have it cloned already:
-cd apertium
+<pre>cd apertium
 gbp pull
-git pull --all
+git pull --all</pre>
-# 3.2) Import, push new branch data, push new upstream tag
+Import, push new branch data, push new upstream tag:
-gbp import-dsc --pristine-tar /tmp/autopkg.*/*.dsc
+<pre>gbp import-dsc --pristine-tar /tmp/autopkg.*/*.dsc
 git push --all
 git push origin upstream/3.4.2_r68453