Difference between revisions of "Making a release"
(remove →Making a release in SourceForge) |
|||
(21 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
[[Fabriquer une version|En français]] |
|||
{{TOCD}} |
{{TOCD}} |
||
{{Github-migration-check}} |
|||
Here are some simple steps to making a release, read the [[release policy]] for more information as to when a release should be made. Basically, we have four main stages, "building the package", "testing", "uploading to SourceForge" and "tagging |
Here are some simple steps to making a release, read the [[release policy]] for more information as to when a release should be made. Basically, we have four main stages, "building the package", "testing", "uploading to SourceForge" and "tagging in git". |
||
==Retrieving the version from SVN== |
|||
Get the latest SVN, or the revision (or date) which you'd like to release. For example to get the version of <code>apertium-oc-ca</code> on the 10th June, 2007, use: |
|||
⚫ | |||
$ svn co -r '{2007-06-10}' https://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium-oc-ca |
|||
⚫ | |||
==Editing the build files== |
==Editing the build files== |
||
Line 13: | Line 10: | ||
First update the build files to reflect the new version. |
First update the build files to reflect the new version. |
||
Edit Makefile.am |
Edit Makefile.am and delete any lines like |
||
<pre> |
<pre> |
||
RELEASE=0.9 |
|||
VERSION=0.9.7 |
|||
</pre> |
</pre> |
||
(Makefile.am shouldn't have any version info.) |
|||
Edit configure.ac: |
Edit configure.ac: |
||
<pre> |
<pre> |
||
-AC_INIT([ |
-AC_INIT([Apertium Foolish-Barman], [0.9.7], [maintainer@domain.org], [apertium-foo-bar], [http://wiki.apertium.org/wiki/Apertium-foo-bar]) |
||
+AC_INIT([Apertium Foolish-Barman], [1.0.0], [maintainer@domain.org], [apertium-foo-bar], [http://wiki.apertium.org/wiki/Apertium-foo-bar]) |
|||
-AM_INIT_AUTOMAKE([apertium-oc-ca], [1.0.2], no-define) |
|||
+AC_INIT([apertium-oc-ca], [1.0.3], [<maintainer email>]) |
|||
+AM_INIT_AUTOMAKE([apertium-oc-ca], [1.0.3], no-define) |
|||
</pre> |
</pre> |
||
==Building the package== |
==Building the package== |
||
Run autogen.sh: |
|||
<pre> |
<pre> |
||
$ ./autogen.sh |
$ ./autogen.sh |
||
$ make dist |
$ make dist |
||
</pre> |
</pre> |
||
You should now have a file in the source directory called <code>apertium-foo-bar-1.0.0.tar.gz</code>. |
|||
If you have a GPG key, you can sign the release with |
|||
⚫ | |||
$ gpg --detach-sign --armor apertium-foo-bar-1.0.0.tar.gz |
|||
⚫ | |||
This will give you the file <code>apertium-foo-bar-1.0.0.tar.gz.asc</code> that you should upload along with <code>apertium-foo-bar-1.0.0.tar.gz</code>. |
|||
==Testing== |
==Testing== |
||
Line 49: | Line 52: | ||
</pre> |
</pre> |
||
If you get any errors, go back, fix them in |
If you get any errors, go back, fix them in git, push and start again. |
||
==Installing the pair on apertium.org== |
|||
Example contents of ChangeLog: |
|||
1. First update the apy server: |
|||
Assuming the tarballs apertium-foo-0.9.0.tar.gz and apertium-foo-bar-0.9.0.tar.gz are in your current dir, do |
|||
<pre> |
<pre> |
||
scp apertium-foo-0.9.0.tar.gz apertium-foo-bar-0.9.0.tar.gz apertium@oqaa.projectjj.com:~/tarballs/ |
|||
Wed 20 Jun 2007 08:45:42 BST |
|||
ssh apertium@oqaa.projectjj.com |
|||
cd tarballs |
|||
* New release version 1.0.3 |
|||
./install-tarball.sh apertium-foo-0.9.0.tar.gz |
|||
* Updated Makefile.am to fix 'make install' problem. See |
|||
./install-tarball.sh apertium-foo-bar-0.9.0.tar.gz |
|||
bug #3 in Bugzilla. |
|||
systemctl --user restart apy |
|||
</pre> |
</pre> |
||
2. Possibly update the html-tools server: |
|||
==Making a release in SourceForge== |
|||
If the tarball installed new modes that weren't on apertium.org before (weren't in http://apy.projectjj.com/listPairs before), you'll have to (get spectie to) ssh to the machine running the apertium.org web page as well and <code>make clean && make -j8</code> there. |
|||
For this step, you'll need to be an admin on SourceForge. First thing is to log into SourceForge and go to the Apertium [http://www.sourceforge.net/projects/apertium project page]. Go to the "Project admin" tab, and scroll down to "Feature settings" and click. You should see "File release system", click on "Manage" on the right hand side. |
|||
==Tagging the release you just made in git== |
|||
From the list, click on "Add release" next to the module you want to release. In the "name" field, type the version, and click on "Create this release". On the next page, if you have release notes, or a changelog, you can upload these. |
|||
Now you need to upload the file to SourceForge so you are able to choose it from the list in "Step 2". You can upload the file using WebDAV, see the instructions below: |
|||
⚫ | |||
''Note: The part /f/ft/ftyers should be replaced by /<first letter of your username>/<first two letters of your username>/<your username>'' |
|||
<pre> |
<pre> |
||
$ git tag -s -m "v1.0.0 released" v1.0.0 HEAD |
|||
$ cadaver https://frs.sourceforge.net/f/ft/ftyers/uploads |
|||
$ git push --tags |
|||
WARNING: Untrusted server certificate presented for `*.sourceforge.net': |
|||
Issued to: SourceForge.net, SourceForge, Inc., Mountain View, California, US |
|||
Issued by: Equifax Secure Certificate Authority, Equifax, US |
|||
Certificate is valid from Fri, 29 Feb 2008 21:02:37 GMT to Thu, 30 Apr 2009 20:02:37 GMT |
|||
Do you wish to accept the certificate? (y/n) yes |
|||
Authentication required for SourceForge.net File Release System on server `frs.sourceforge.net': |
|||
Username: ftyers |
|||
Password: |
|||
dav:/f/ft/ftyers/uploads/> |
|||
dav:/f/ft/ftyers/uploads/> ls |
|||
Listing collection `/f/ft/ftyers/uploads/': collection is empty. |
|||
dav:/f/ft/ftyers/uploads/> put apertium-es-pt-1.0.3.tar.gz |
|||
Uploading apertium-es-pt-1.0.3.tar.gz to `/f/ft/ftyers/uploads/apertium-es-pt-1.0.3.tar.gz': |
|||
Progress: [=============================>] 100.0% of 636855 bytes succeeded. |
|||
dav:/f/ft/ftyers/uploads/> exit |
|||
Connection to `frs.sourceforge.net' closed. |
|||
</pre> |
</pre> |
||
The above will tag the current commit; you can change HEAD for some commit hash or branch if you want to tag that instead. |
|||
So, once this is done, go to "Step 2" and check the box of the file you have just uploaded (in this case <code>apertium-es-pt-1.0.3.tar.gz</code>) then click "Add files/refresh view". You've now made the release, the only thing remaining is to go to "Step 3" and change the Processor to "Platform-independent", and the File type to "Source .gz". Click on "Update/Refresh" and thats it! |
|||
== |
==Making a release on github== |
||
After tagging, you can |
|||
⚫ | |||
* go to https://github.com/apertium/apertium-foo-bar/releases/ |
|||
* and pick your tag |
|||
* and click "Edit release", |
|||
* and upload your tarball (and signature, if you did that) |
|||
If there is already a module in the <code>/tags/</code> directory for the module you are packaging, then skip the next step, if not you'll need to do: |
|||
<pre> |
|||
$ svn mkdir https://apertium.svn.sourceforge.net/svnroot/apertium/tags/apertium-oc-ca |
|||
</pre> |
|||
==Related pages== |
|||
Now to tag the release, do: |
|||
* [[Packaging]] (Debian etc.) |
|||
* [[Release policy]] |
|||
<pre> |
|||
$ svn copy https://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium-oc-ca \ |
|||
https://apertium.svn.sourceforge.net/svnroot/apertium/tags/apertium-oc-ca/release-1.0.3 -m "Tagging release" |
|||
$ svn commit |
|||
</pre> |
|||
[[Category:Documentation]] |
[[Category:Documentation]] |
||
[[Category:Documentation in English]] |
Latest revision as of 09:59, 26 April 2021
This page is out of date as a result of the migration to GitHub. Please update this page with new documentation and remove this warning. If you are unsure how to proceed, please contact the GitHub migration team.
Here are some simple steps to making a release, read the release policy for more information as to when a release should be made. Basically, we have four main stages, "building the package", "testing", "uploading to SourceForge" and "tagging in git".
Editing the build files[edit]
First update the build files to reflect the new version.
Edit Makefile.am and delete any lines like
RELEASE=0.9 VERSION=0.9.7
(Makefile.am shouldn't have any version info.)
Edit configure.ac:
-AC_INIT([Apertium Foolish-Barman], [0.9.7], [maintainer@domain.org], [apertium-foo-bar], [http://wiki.apertium.org/wiki/Apertium-foo-bar]) +AC_INIT([Apertium Foolish-Barman], [1.0.0], [maintainer@domain.org], [apertium-foo-bar], [http://wiki.apertium.org/wiki/Apertium-foo-bar])
Building the package[edit]
$ ./autogen.sh $ make dist
You should now have a file in the source directory called apertium-foo-bar-1.0.0.tar.gz
.
If you have a GPG key, you can sign the release with
$ gpg --detach-sign --armor apertium-foo-bar-1.0.0.tar.gz
This will give you the file apertium-foo-bar-1.0.0.tar.gz.asc
that you should upload along with apertium-foo-bar-1.0.0.tar.gz
.
Testing[edit]
Copy the file somewhere temporary, extract it, and test it.
$ mkdir /tmp/test $ ./configure --prefix=/tmp/test $ make $ make install
If you get any errors, go back, fix them in git, push and start again.
Installing the pair on apertium.org[edit]
1. First update the apy server:
Assuming the tarballs apertium-foo-0.9.0.tar.gz and apertium-foo-bar-0.9.0.tar.gz are in your current dir, do
scp apertium-foo-0.9.0.tar.gz apertium-foo-bar-0.9.0.tar.gz apertium@oqaa.projectjj.com:~/tarballs/ ssh apertium@oqaa.projectjj.com cd tarballs ./install-tarball.sh apertium-foo-0.9.0.tar.gz ./install-tarball.sh apertium-foo-bar-0.9.0.tar.gz systemctl --user restart apy
2. Possibly update the html-tools server:
If the tarball installed new modes that weren't on apertium.org before (weren't in http://apy.projectjj.com/listPairs before), you'll have to (get spectie to) ssh to the machine running the apertium.org web page as well and make clean && make -j8
there.
Tagging the release you just made in git[edit]
In git, tagging a release is done using the git tag
command, see git help tag
.
$ git tag -s -m "v1.0.0 released" v1.0.0 HEAD $ git push --tags
The above will tag the current commit; you can change HEAD for some commit hash or branch if you want to tag that instead.
Making a release on github[edit]
After tagging, you can
- go to https://github.com/apertium/apertium-foo-bar/releases/
- and pick your tag
- and click "Edit release",
- and upload your tarball (and signature, if you did that)
Related pages[edit]
- Packaging (Debian etc.)
- Release policy