Difference between revisions of "Development of Open Source tools"
(→hugin) |
|||
(170 intermediate revisions by 8 users not shown) | |||
Line 1: | Line 1: | ||
+ | {| style="margin: 1em auto 1em 1em;background:#FFFF99;color:#FF0000;text-align:left;border: solid #FF3300;" | ||
+ | |-valign="top" | ||
+ | ! '''2011-Feb-09:''' | ||
+ | ! Libpano has migrated to a Mercurial Repository on SourceForge. If you find outdated references to Subversion, please update. | ||
+ | |-valign="top" | ||
+ | ! '''2010-Nov-22:''' | ||
+ | ! Hugin's tracker has moved from SourceForge to Launchpad, and so have the trackers for Enblend and Panotools. If you still find references to the SourceForge tracker in these pages, it may be outdated. Please fix if you can. Most pages have been fixed for Hugin's move from a Subversion to a Mercurial repository (2010-May-16) but if you find a reference to SVN, it may be outdated or it may be related to Panotools that has not moved. Please fix if you can. | ||
+ | |} | ||
+ | |||
== Panorama Related Open Source tools == | == Panorama Related Open Source tools == | ||
Line 18: | Line 27: | ||
If you don't have time, you are most likely a busy professional. You can donate money to [http://sourceforge.net/project/project_donations.php?group_id=77506 Hugin], [http://sourceforge.net/project/project_donations.php?group_id=123407 Enblend/Enfuse] on their project pages through Sourceforge. | If you don't have time, you are most likely a busy professional. You can donate money to [http://sourceforge.net/project/project_donations.php?group_id=77506 Hugin], [http://sourceforge.net/project/project_donations.php?group_id=123407 Enblend/Enfuse] on their project pages through Sourceforge. | ||
− | At the time of | + | At the time of updating this text (6-Mar-2011) the building process of Hugin is robust and there are more and more people mastering it on the different platform. The 2011.0 release cycle is well underway. Beyond that, a few exciting features such as a python scripting interface are in line for future releases. |
'''Don't be afraid of failures in the building process''' | '''Don't be afraid of failures in the building process''' | ||
− | * | + | * You may encounter errors when following the build processes linked below is high. Don't worry such errors will not compromise your computer. |
− | |||
* The failure of the building process is actually your success! Every time you report such a failure, with as much detail as possible to how it came about, you are contributing to the progress toward a stable release. | * The failure of the building process is actually your success! Every time you report such a failure, with as much detail as possible to how it came about, you are contributing to the progress toward a stable release. | ||
+ | * See also If you encounter errors, [[Fixing The Hugin Build]]. | ||
If you are fluent in other languages than English, you can help translate Hugin. There's a [[Hugin translation guide]] to help you get started or help when you run into translation problems. | If you are fluent in other languages than English, you can help translate Hugin. There's a [[Hugin translation guide]] to help you get started or help when you run into translation problems. | ||
− | == Hugin | + | == Processes == |
+ | |||
+ | The release process introduced in 2009 has decoupled the development processes from the release process, avoiding artificial slow downs (trunk freezes). | ||
+ | |||
+ | Hugin uses an asynchronous development process based on Mercurial, which means that: | ||
+ | * the '''default branch''' never freezes, and committers can continuously add improvements to it. | ||
+ | * anybody can branch out development codelines on their local copy of the repository, and even publish that repository. | ||
+ | * usually developers will branch out to implement major changes or changes that will not be completed very soon; and builders will branch out to clean up releases; without disrupting the continuous flow of contributions. | ||
+ | * unlike in the previous Subversion repository, branches are no longer stored in different folders. Give them a meaningful name to distinguish release branches (version number) from development branches (feature being implemented / worked on). | ||
+ | * developers have write access to the official repository on Sourceforge and can push changes and branches to it. The project is very liberal in giving such write access - if you have something to contribute, mention it on hugin-ptx and chances are one of the admins will give you the necessary write rights. | ||
+ | * once a months, developers are polled as to whether it is worth issuing a release. if there is enough support and one person volunteers as release manager, that person branches out a release codeline from the default codeline. That release codeline is equivalent to a trunk freeze in traditional synchronous development. only bug fixes and translations should go into that codeline. Tarballs are to be released from release codelines only. | ||
+ | |||
+ | === Development === | ||
+ | |||
+ | * If you are working on something big that requires multiple changes to complete, you're encouraged to start your own branch: | ||
+ | <pre> | ||
+ | hg pull | ||
+ | hg branch <YOUR_UNIQUE_BRANCH_NAME> | ||
+ | </pre> | ||
+ | * If you are working on incremental improvements to the default branch, feel free to push them any time. '''There is no trunk freeze'''. | ||
+ | * You're encouraged to continue with your usual pace of bug fixing and development. | ||
+ | * To do things perfectly: commit all your changes to the default branch; and apply those that are bug fixes also to the current release codeline if the project is in the midst of a release cycle. | ||
+ | * The new thing about Mercurial (coming from Subversion): commit is to your local repository only. To avoid multiple heads, pull/update before committing; and remember to push your change from time to time so that others can test them / benefit from them / add value to them. | ||
+ | <pre> | ||
+ | hg pull | ||
+ | hg up | ||
+ | hg ci | ||
+ | hg push | ||
+ | </pre> | ||
+ | * If you forget about it and commit only to one codeline, do not worry. The release manager takes responsibility to sync between the default branch and the release branch. | ||
+ | * Try not to add new features, particularly new strings, to the release codeline later in the release cycle. | ||
+ | |||
+ | === Translation === | ||
− | Clearing the | + | * Generally same as development. For specifics see the [[Hugin_translation_guide|translation guide]]. |
+ | |||
+ | === Debugging === | ||
+ | |||
+ | Working through [[Hugin Trackers]]. | ||
+ | |||
+ | Clearing the tickets in the tracker is an iterative process critical to the release cycle. Feedback from tester is essential for this process. Please take the time to check if the older reports apply to a current snapshot and add new findings to the ticket. | ||
We'll be releasing frequent snapshots until a release candidate emerges. This is an iterative process: | We'll be releasing frequent snapshots until a release candidate emerges. This is an iterative process: | ||
− | # '''Volunteers''' check the bugs listed in the [https:// | + | # '''Volunteers''' check the release-critical bugs listed in the [https://bugs.launchpad.net/hugin bug tracker] against the most recent snapshot. The most recent snapshot for is usually posted on the Hugin-PTX mailing list. |
#* Install the latest snapshot. | #* Install the latest snapshot. | ||
#* Try to reproduce the bug on your system. | #* Try to reproduce the bug on your system. | ||
− | #* If you find that the bug no longer occurs, chances are that it has been fixed. Close it (assuming you have the required access), or simply leave a note that it has been fixed (together with the | + | #* If you find that the bug no longer occurs, chances are that it has been fixed. Close it (assuming you have the required access), or simply leave a note that it has been fixed (together with the exact version number and the system used for testing). |
− | #* If you reproduce the bug, leave a note to confirm that it is still actual. Note the | + | #* If you reproduce the bug, leave a note to confirm that it is still actual. Note the SHA1 ID and the system used for testing. Post detailed instructions how to reproduce the crash. Provide a test case if you can. |
− | + | #* Add any comments you have to the ticket in the bug tracker. Let the community know you have tested. The tracker is like a mailing list or forum thread, don't be afraid to post. | |
− | + | #* If you don't want to open an account with Launchpad, post your observations on the hugin-ptx mailing list. | |
− | #* Add any comments you have to the ticket in the bug tracker. Let the community know you have tested. The | ||
− | #* If you don't want to open an account with | ||
# The '''developers''' fix the bugs identified in the tracker. | # The '''developers''' fix the bugs identified in the tracker. | ||
# The '''builders''' build new snapshots including the fixes. | # The '''builders''' build new snapshots including the fixes. | ||
− | + | === Development Codelines === | |
− | * | + | |
− | * | + | It is recommended to work separately on major changes and integrate them in the main codeline when they are ready. The currently open development branches are listed in the repository along the release branches. |
− | * | + | |
+ | <pre> | ||
+ | hg pull | ||
+ | hg branches | ||
+ | </pre> | ||
+ | |||
+ | If you want to work on a major new feature, open yourself a branch. | ||
+ | |||
+ | <pre> | ||
+ | hg branch <NEW_UNIQUE_BRANCH_NAME> | ||
+ | </pre> | ||
+ | |||
+ | |||
+ | If you want to publish that branch on Sourceforge, ask for write right and push your changes to Sourceforge. | ||
+ | |||
+ | <pre> | ||
+ | hg push | ||
+ | </pre> | ||
+ | |||
+ | The branch owners are strongly encouraged to regularly sync their branch with default, i.e. merge the changes that have occurred since the last sync (or branching) into their branch. | ||
+ | |||
+ | <pre> | ||
+ | hg pull | ||
+ | hg up -C <YOUR_BRANCH> | ||
+ | hg merge default | ||
+ | hg ci -m "merged from default" | ||
+ | hg push | ||
+ | </pre> | ||
+ | |||
+ | If an unresolved conflict arises, see below the [[#Merging|Merging]] section. | ||
+ | |||
+ | When development is complete or has reached a milestone, it may be integrated into default. Before integrating into default it is recommended to: | ||
+ | * Merge all of default's changes since the last sync into the branch. | ||
+ | * Test that the branch builds on the major supported platforms. | ||
+ | * Test that the branch does not break existing functionality (unless the break is intended, e.g. when a new functionality replaces an existing one). | ||
+ | |||
+ | When the development branch has fulfilled its purpose; is superseded or has been abandoned, close it. | ||
+ | |||
+ | <pre> | ||
+ | hg up -C <OBSOLETE_BRANCH> | ||
+ | hg commit --close-branch -m 'close badbranch, this approach never worked' | ||
+ | hg up -C default # switch back to "good" branch | ||
+ | </pre> | ||
+ | |||
+ | === Merging === | ||
+ | |||
+ | Most of the time Mercurial is quite good at merging different codelines. However sometimes there are conflicting version and even Mercurial does not know what to do. It will prompt for you to solve the conflicts. | ||
+ | |||
+ | The preferred tool to solve conflicts is [KDiff3 http://mercurial.selenic.com/wiki/KDiff3]. According to Mercurial's wiki it is 'the "best" merge tools' and included with the Windows installer of TortoiseHg. [http://kdiff3.sourceforge.net/doc/kdiff3_en.pdf Handbook]. On Ubuntu install it with `sudo apt-get install kdiff3`. To work comfortably with KDiff3, add the following lines to ~/.hgrc: | ||
+ | <pre> | ||
+ | [extensions] | ||
+ | hgext.extdiff = | ||
+ | |||
+ | [extdiff] | ||
+ | cmd.kdiff3 = | ||
+ | |||
+ | [merge-tools] | ||
+ | kdiff3.args = $base $local $other -o $output | ||
+ | </pre> | ||
+ | |||
+ | First close the codeline to be merged with a last commit. Then switch to the default branch and start the merge. | ||
+ | |||
+ | <pre> | ||
+ | hg up -C feature-x | ||
+ | hg ci -m 'Closed branch feature-x' --close-branch | ||
+ | hg up -C default | ||
+ | hg merge feature-x | ||
+ | </pre> | ||
+ | |||
+ | During the merge operation, Mercurial will trigger KDiff3 automatically in case of an unresolved conflict. Kdiff3 will show three versions side by side in the top half of the window: | ||
+ | * in the middle is the current one | ||
+ | * on the right is the new one | ||
+ | * on the left is the base (common ancestor? not sure?) | ||
+ | * In the bottom half of the window is the resulting merge, with conflicts highlighted. | ||
+ | * Using the buttons bar: | ||
+ | ** Use the symbol with the three arrows up/down to jump to the previous/next unsolved conflict. | ||
+ | ** When a <Merge Conflict> area is highlighted in the bottom pane, hit the A/B/C buttons to select which version(s) to use/merge in. | ||
+ | * Once all conflicts are solved, save and quit. Mercurial will continue the merge operation. | ||
+ | |||
+ | Once the merge operation is finished, commit and push. | ||
+ | |||
+ | <pre> | ||
+ | hg ci -m 'Merged branch feature-x' | ||
+ | hg push | ||
+ | </pre> | ||
+ | |||
+ | === Maturity Criteria === | ||
+ | |||
+ | A development codeline - whether under revision control or presented as a patch - is considered mature when: | ||
+ | * '''a''': the functionality it is intended to implement works on the developer's machine ("works for me" condition) | ||
+ | * '''b''': it has been tested to build on the major supported platforms ("does not leave them behind" condition) by at least one contributor for each: Windows, OSX, Linux | ||
+ | * '''c''': it does not unintentionally break existing functionality ("no regression" condition) | ||
+ | |||
+ | When a development codeline reaches maturity, it enters the integration queue. | ||
+ | |||
+ | === Integration Queue === | ||
+ | |||
+ | The integration queue is the ordered list of new features / development codelines waiting to be integrated in trunk. The prioritization is a collective decision by consensus of the developers. Silence = consent. The discussion, and the latest version of the list, are on the [http://groups.google.com/group/hugin-ptx mailing list]. | ||
+ | |||
+ | The integration queue is not set in stone: a change in the maturity status of a feature in waiting is good reason to review/change the ordered list. In any case it is reviewed after every release branching. | ||
+ | |||
+ | === Release === | ||
+ | |||
+ | Once a month the developers are polled if there is reason to issue a release. If there is enough support for releasing, one developer takes on the role of release manager and undertakes the following steps: | ||
+ | |||
+ | The conditions to declare a release final are: | ||
+ | * the code builds on the major supported platforms (Ubuntu, Fedora, OSX, Windows) | ||
+ | * there is no (known) regression, unless intentional. This means: what worked with the previous release should work with the current one. | ||
+ | |||
+ | ==== Release Plan ==== | ||
+ | |||
+ | Planning the release helps contributors pace and schedule their contributions. On Launchpad there is a simple and adequate tool for planning and communicating releases. | ||
+ | |||
+ | ===== Register a New Hugin Releases Series in Launchpad ===== | ||
+ | |||
+ | When starting a new release cycle, register first a new Releases Series in Launchpad. | ||
+ | * Prerequisites: must be logged in to Launchpad and be a member of the Hugin-Devs team. | ||
+ | * Point your web browser to: https://launchpad.net/hugin/+addseries | ||
+ | * Enter the Version in the Release Name field: V_MAJOR.V_MINOR | ||
+ | * As Summary enter a bullet points list of the most relevant new features that will be introduced by the release. | ||
+ | * Hit Register Release Series. | ||
+ | * On the next page edit the Release Manager. | ||
+ | |||
+ | ===== Edit Status of Previous Series ===== | ||
+ | |||
+ | As a policy: | ||
+ | * Only the default branch, the latest release, and the active development branches are in active development. | ||
+ | * Only the previous two releases are supported. | ||
+ | * Older releases are obsolete. | ||
+ | |||
+ | To change the status as a consequence of the new release cycle, point your browser to https://launchpad.net/hugin/<V_MAJOR.V_MINOR>/+edit, e.g. https://launchpad.net/hugin/2010.4/+edit for the relevant series. | ||
+ | * Change the status of the previous release from Active Development to Supported. | ||
+ | * Change the status of the oldest supported release to Obsolete. | ||
+ | |||
+ | ===== Register Milestones for the release ===== | ||
+ | |||
+ | Planning milestones in advance and registering them with targeted dates will make the process more predictable and help builders plan for the binaries releases. | ||
+ | |||
+ | As a rule of thumb plan for two betas spaced by 2 weeks; for one release candidate two weeks after the last planned beta; and for the first RC to be declared final two weeks after release. Adapt to the circumstances. Things will change during the cycle and you can also add extra betas and rcs. Toward the end of the cycle, spacing can be one week. | ||
+ | |||
+ | * Point your browser to https://launchpad.net/hugin/<V_MAJOR.V_MINOR>/+addmilestone of the new releases series, e.g. https://launchpad.net/hugin/2011.0/+addmilestone | ||
+ | * Enter a name following these conventions: | ||
+ | ** Betas: <V_MAJOR>.<V_MINOR>beta<INCREMENT> with INCREMENT starting from 1, "beta" in small caps and no spaces or underscores, no leading zeros. Example 2011.0beta1 | ||
+ | ** Release Candidates: <V_MAJOR>.<V_MINOR>rc<INCREMENT> with INCREMENT starting from 1, "rc" in small caps and no spaces or underscores, no leading zeros. Example 2010.4rc2 | ||
+ | ** Final Release: <V_MAJOR>.<V_MINOR>.<V_PATCH>, no leading zeros. Example: 2009.2.0 | ||
+ | * No need to enter a Code name. | ||
+ | * Enter the date targeted for the tarball release. | ||
+ | * No need to enter a Summary. | ||
+ | * Hit Register Milestone. | ||
+ | |||
+ | |||
+ | ==== Release Notes ==== | ||
+ | |||
+ | The Release Notes are an important document accompanying the release. Although it is just a list of new features, it gets distributed widely. Most readers are unlikely to have used Hugin before. When drafting them, think that the target audience is somebody who has an idea of what a panorama stitcher might be, has never heard of Hugin, but is interested in discovering cool new software. | ||
+ | |||
+ | Start drafting them early in the process to allow for translators to translate the Release Notes on the website. Moreover, you will send them as simple text with each released tarball. | ||
+ | |||
+ | '''Important: store the release notes in the repository, as a text file inside doc/releases/'''. Use those texts as inspiration example. | ||
+ | |||
+ | ===== Set Up ===== | ||
+ | |||
+ | Set yourself up to edit the release notes on the website. You will need write access to the SourceForge project. | ||
+ | |||
+ | <pre> | ||
+ | hg clone ssh://${USER}@hg.code.sf.net/p/hugin/hugin-web hugin-web | ||
+ | </pre> | ||
+ | |||
+ | ===== The Editing Cycle ===== | ||
+ | <pre> | ||
+ | cd hugin-web | ||
+ | hg pull | ||
+ | hg up | ||
+ | mkdir releases/2014.0 | ||
+ | nano releases/2014.0/en.shtml | ||
+ | hg add releases/2014.0 | ||
+ | hg ci -m "skeleton|draft|updated|final release notes" | ||
+ | hg push | ||
+ | </pre> | ||
+ | |||
+ | The website updates automatically about every hour. Wait enough time and point your web browser to http://hugin.sourceforge.net/releases/2010.4/ to verify the result of your edits. | ||
+ | |||
+ | ===== Release Notes for the First Beta Release in a New Release Cycle ===== | ||
+ | |||
+ | Before posting the beta1 of the release cycle, you want to have at least a working draft of the Release Notes. Edit them directly on the website. List the relevant new features. Use the release notes from past releases as a template. Copy them in text form for the email announcing the beta1 release. Don't link them from the homepage. Translators will want to start working on the text as soon as possible. Try to finish it early in the process. Add a comment at the beginning of the text to detail its current status. Not all translators follow the Changelog of the website and so are not aware if you committed the document as skeleton / draft / update / final. | ||
+ | |||
+ | ===== Release Notes for Follow Up Releases in the Same Release Cycle ===== | ||
+ | |||
+ | It is important to show the changes relative to the previous tarball, however only in the email announcing the new tarball. The HTML page on the website will most likely stay untouched (unless an important new feature has been added so late in the cycle). Add a section "Changes since previous beta release" (or "Changes since previous release candidate" if we're already at the RC stage) to the text mail you sent announcing the beta1 release. Copy and edit the relevant Changelog entries in there. | ||
+ | |||
+ | ==== Branching Out For Release ==== | ||
+ | |||
+ | 1. [[Hugin_translation_guide#Developer_info|Identify]] and add the new strings for translation. | ||
+ | |||
+ | Before running the script, make sure you have wxrc installed. On older Ubuntu, run <code>sudo apt-get install wxrc</code>. On Ubuntu 10.4LTS it is <code>sudo apt-get install wx-common</code>. | ||
+ | |||
+ | <pre> | ||
+ | hg pull | ||
+ | hg up | ||
+ | cd src/translations | ||
+ | ./extract-messages.sh | ||
+ | hg diff | ||
+ | hg ci -m "Add new and update existing strings for translation" | ||
+ | hg push | ||
+ | </pre> | ||
+ | |||
+ | 2. Update the Changes.txt file | ||
+ | |||
+ | 3. Identify the last time a release branch was branched from the default branch. This is usually tagged with a beta1 tag, so just use `hg view` and note down the revision number associated with the last beta1 tag. Extract the relevant changelog information for the release notes and save them in a file for later use: | ||
+ | <pre> | ||
+ | hg log -r <REV#>: -b default --style Changelog.style > ../temp_change_log.txt | ||
+ | </pre> | ||
+ | |||
+ | 4. Branch out a new release-codeline (replace 2010.4 below with the appropriate version number. 2010 stands for the current year and 4 stands for the next even number in sequence, starting with 0 if the year has changed and this is the first release of the year). | ||
+ | |||
+ | <pre> | ||
+ | hg branch 2010.4 | ||
+ | </pre> | ||
+ | |||
+ | 5. Bump up the version number: | ||
+ | |||
+ | <pre> | ||
+ | nano ./CMakeLists.txt | ||
+ | nano ./mac/Version.xcconfig | ||
+ | hg ci -m "bumping version number" | ||
+ | </pre> | ||
+ | |||
+ | In the top level ./CMakeLists.txt edit the lines | ||
+ | <pre> | ||
+ | # version | ||
+ | set(V_MAJOR 2010) | ||
+ | set(V_MINOR 4) | ||
+ | set(V_PATCH 0) | ||
+ | </pre> | ||
+ | |||
+ | In mac/Version.xcconfig edit the lines | ||
+ | <pre> | ||
+ | HUGIN_VERSION_MAJOR = 2010 | ||
+ | HUGIN_VERSION_MINOR = 4 | ||
+ | HUGIN_VERSION_PATCH = 0 | ||
+ | </pre> | ||
+ | |||
+ | 6. Update the @api-min and @api-max setting of the Python scripts in src/hugin_script_interface/plugins. For this it needs to check if they work with the current API or if there was an incompatible API change. In the latter case the scripts should updated or removed from the release. | ||
+ | |||
+ | This is not required for the scripts in src/hugin_script_interface/plugins-dev. These files contains only the rough framework for script developer. | ||
+ | |||
+ | <strike> | ||
+ | 7. Set the red splash screen to indicate that the artwork embellishing the release has not been selected yet (only to be done, if there is artwork selected for the release). | ||
+ | <pre> | ||
+ | hg revert -r 5008 src/hugin1/hugin/xrc/data/splash.png | ||
+ | hg ci -m "red splash screen to indicate release cycle with no artwork selected yet" | ||
+ | </pre> | ||
+ | </strike> (April 2015: currently not needed) | ||
+ | |||
+ | 8. Switch back to the default branch and bump up to the next odd version number, e.g. 2010.5 in this example. | ||
+ | |||
+ | <pre> | ||
+ | hg up default | ||
+ | nano ./CMakeLists.txt | ||
+ | nano ./mac/Version.xcconfig | ||
+ | hg ci -m "bumping version number" | ||
+ | </pre> | ||
+ | |||
+ | Edit the same lines as above in the top level ./CMakeLists.txt file and in ./mac/Version.xconfig | ||
+ | |||
+ | The same applies to the @api-min and @api-max settings in the scripts. | ||
+ | |||
+ | 9. Verify that the branches are ok and push them to the official repository. Since we intentionally create a new remote branch, we use the -f switch in the push command. | ||
+ | <pre> | ||
+ | hg view | ||
+ | hg push -f | ||
+ | </pre> | ||
+ | |||
+ | ==== Keeping the Release Branch in Sync with Default ==== | ||
+ | |||
+ | Committers have no obligation to help maintaining the release branch. In fact, it is best if they keep working in default on both code and translations. As a release manager, you want to stay on top of the changes in default and synchronize them into your branch prior to release if relevant. | ||
+ | |||
+ | The Hgk Mercurial extensions will help you with this. Edit your ~/.hgrc file to activate it. In [extensions] section add: | ||
+ | |||
+ | <pre> | ||
+ | hgext.hgk = | ||
+ | </pre> | ||
+ | |||
+ | If `hg view` does not work / returns an error, you may be missing a dependency. In Ubuntu type `sudo apt-get install tk8.5`. | ||
+ | |||
+ | In Hgk the changesets are displayed chronologically per branch with the newest one on top. Branches are indicated visually by a tree on the left. Tags have a yellow background and te top of branches are indicated by a box with green background and the name of the branch, except the default branch. Tags are displayed on yellow background. | ||
+ | |||
+ | ===== Syncing Code from Default to Release Branch ===== | ||
+ | |||
+ | This is for code only. For translations, see below. | ||
+ | |||
+ | * Make sure your repo is up to date and get an overview of the two branches with Hgk: | ||
+ | *:<pre>hg pull && hg up <RELEASE_BRANCH> && hg view default && hg view <RELEASE_BRANCH> &</pre> | ||
+ | * Find the first changeset on the default branch after the last time you synchronized and work yourself up to the present. | ||
+ | * Select one changeset at a time. You will see details of the change set in the lower part of the window. | ||
+ | * In the lower left panel, read the changeset log and its revision number. | ||
+ | * Decide if you want to apply it to the Release branch (i.e. if it is a bug fix) | ||
+ | * If you decided that the changeset should apply to the Release branch, check if it has not been applied already by the developer. | ||
+ | * If it has not been applied, apply it, using the <REVISION_NUMBER>: | ||
+ | *:<pre>hg graft --log --rev <REVISION_NUMBER></pre> | ||
+ | * If you deem this to have been a major change, go through a build/test cycle | ||
+ | * Repeat until all new changes have been applied | ||
+ | * Go through a build/test cycle | ||
+ | * Push your changes to the public repository | ||
+ | *:<pre>hg push</pre> | ||
+ | |||
+ | ===== Syncing Code from the Release Branch to Default ===== | ||
+ | |||
+ | This is for code only. For translations, see below. | ||
+ | |||
+ | The procedure is the same, just make sure you're working in default: | ||
+ | <pre> | ||
+ | hg pull && hg up default && hg <RELEASE_BRANCH> && hg view default & | ||
+ | hg export --git <REVISION_NUMBER> | hg import - | ||
+ | ... | ||
+ | hg push | ||
+ | </pre> | ||
+ | |||
+ | ===== Updating Translations ===== | ||
+ | |||
+ | Translations must always be imported using `msgmerge`. | ||
+ | |||
+ | * copy the file with the new contributed translation to src/translations/<LANG>.contributed.po | ||
+ | * check how many strings will be added/removed | ||
+ | * merge the new translation with the existing translation into a new file src/translations/<LANG>.merged.po | ||
+ | * examine the old and the new po files with msgfmt. | ||
+ | * if the statistics look good, overwrite the old file with the new file, commit, push, and ask native language speakers to check. | ||
+ | * repeat separately for each affected branch. | ||
+ | |||
+ | <pre> | ||
+ | hg pull | ||
+ | hg up -c 2010.4 | ||
+ | cp ~/Downloads/${UPLANG}.po ~/src/hugin.hg/src/translations/${UPLANG}.contributed.po | ||
+ | cd ~/src/hugin.hg/src/translations/ | ||
+ | ./diff_po.pl ${UPLANG}.po ${UPLANG}.contributed.po | ||
+ | msgmerge -o ${UPLANG}.merged.po ${UPLANG}.contributed.po ${UPLANG}.po | ||
+ | msgfmt -c --statistics ${UPLANG}.merged.po | ||
+ | msgfmt -c --statistics ${UPLANG}.po | ||
+ | mv ${UPLANG}.merged.po ${UPLANG}.po | ||
+ | rm ${UPLANG}.contributed.po | ||
+ | hg ci -m "Updated ${UPLANG} translation (${TRANSLATOR})" | ||
+ | hg push | ||
+ | </pre> | ||
+ | |||
+ | To check the status of the translations you could do something like: | ||
+ | <pre> | ||
+ | for i in *.po; do echo $i; msgfmt -c -v $i; done | ||
+ | </pre> | ||
+ | This will give you something like: | ||
+ | <pre> | ||
+ | <snip> | ||
+ | bg.po | ||
+ | 509 translated messages, 505 fuzzy translations, 369 untranslated messages. | ||
+ | ca_ES.po | ||
+ | 300 translated messages, 576 fuzzy translations, 507 untranslated messages. | ||
+ | </snip></pre> | ||
+ | |||
+ | ==== Release ==== | ||
+ | |||
+ | 1. Start with a clean checkout. | ||
+ | <pre> | ||
+ | hg clone http://hg.code.sf.net/p/hugin/hugin hugin.hg | ||
+ | </pre> | ||
+ | |||
+ | 2. Switch to the branch you are going to release (example 2013.0 release; and when you don't know do a "hg branches") | ||
+ | <pre> | ||
+ | cd hugin.hg | ||
+ | hg update -C 2013.0 | ||
+ | </pre> | ||
+ | |||
+ | 3. Update the Changelog (make sure LC_ALL is set to UTF-8 when doing this). In Ubuntu you may have to do something like `export LANG="en_CA.UTF-8" && export LC_ALL="en_CA.UTF-8"` | ||
+ | |||
+ | 4. commit the Changelog | ||
+ | |||
+ | <pre> | ||
+ | cd .. | ||
+ | mkdir hugin.hg-build | ||
+ | cd hugin.hg-build | ||
+ | cmake -DUPDATE_CHANGELOG=1 ../hugin.hg | ||
+ | cd ../hugin.hg | ||
+ | hg ci -m "Updated ChangeLog" | ||
+ | </pre> | ||
+ | |||
+ | 5. Update the appdata files in platforms/linux/appdata. Add a line with the date and release number like | ||
+ | |||
+ | <release date="2020-12-12" version="2020.0.0" /> | ||
+ | |||
+ | in the <tt><releases></tt> block to <tt>calibrate_lens_gui.appdata.xml</tt>, <tt>hugin.appdata.xml</tt> and <tt>PTBatcherGUI.appdata.xml</tt>. | ||
+ | |||
+ | 6. tag the release (list the tags first to see how releases are named and ensure consistency. | ||
+ | * Betas: <V_MAJOR>.<V_MINOR>beta<INCREMENT> with INCREMENT starting from 1, "beta" in small caps and no spaces or underscores, no leading zeros. Example 2011.0beta1 | ||
+ | * Release Candidates: <V_MAJOR>.<V_MINOR>rc<INCREMENT> with INCREMENT starting from 1, "rc" in small caps and no spaces or underscores, no leading zeros. Example 2010.4rc2 | ||
+ | * Final Release: <V_MAJOR>.<V_MINOR>.<V_PATCH>, no leading zeros. Example: 2009.2.0 | ||
+ | |||
+ | To fix/clean up tags: | ||
+ | * remove a tag with `hg tag --remove <TAG_NAME>` | ||
+ | * add a tag by going to a specific revision and tagging it: `hg up -q -r <REV> && hg tag <TAGNAME>` | ||
+ | * if a tag exists already and you want to move it, just use `hg tag -f <TAGNAME>` at the new revision to be tagged | ||
+ | |||
+ | 7. note down the revision/hash for the release | ||
+ | |||
+ | <pre> | ||
+ | hg tags | ||
+ | hg tag <RELEASE> | ||
+ | hg log -l 2 | ||
+ | hg push | ||
+ | </pre> | ||
+ | |||
+ | 7. Create tarball | ||
+ | |||
+ | <pre> | ||
+ | cd .. | ||
+ | mkdir hugin-tarball | ||
+ | cd hugin-tarball | ||
+ | cmake ../hugin.hg -DENABLE_LAPACK=YES -DCPACK_BINARY_DEB:BOOL=OFF -DCPACK_BINARY_NSIS:BOOL=OFF \ | ||
+ | -DCPACK_BINARY_RPM:BOOL=OFF -DCPACK_BINARY_STGZ:BOOL=OFF -DCPACK_BINARY_TBZ2:BOOL=OFF \ | ||
+ | -DCPACK_BINARY_TGZ:BOOL=ON -DCPACK_BINARY_TZ:BOOL=OFF | ||
+ | make package_source | ||
+ | </pre> | ||
+ | |||
+ | 8. Build an rpm or deb (depending on your distro) from the tarball as a sanity check. Test what you can test. | ||
+ | |||
+ | <pre> | ||
+ | tar xvfj hugin-2010.4.0.tar.bz2 | ||
+ | mkdir hugin-tarball-build | ||
+ | cd hugin-tarball-build | ||
+ | cmake ../hugin-2010.4.0 -DENABLE_LAPACK=YES -DCPACK_BINARY_DEB:BOOL=ON -DCPACK_BINARY_NSIS:BOOL=OFF \ | ||
+ | -DCPACK_BINARY_RPM:BOOL=OFF -DCPACK_BINARY_STGZ:BOOL=OFF -DCPACK_BINARY_TBZ2:BOOL=OFF \ | ||
+ | -DCPACK_BINARY_TGZ:BOOL=OFF -DCPACK_BINARY_TZ:BOOL=OFF \ | ||
+ | -DBUILD_HSI:BOOL=ON -DSWIG_EXECUTABLE=/usr/bin/swig2.0 | ||
+ | make package | ||
+ | sudo dpkg -i hugin-2010.4.0-Linux.deb | ||
+ | </pre> | ||
+ | 9. Rename the tarball. For snapsnots, append _snapshotYYMMDD (replace YYMMDD with Year/Month/Day). For betas, append _betaX with X being an incremental number starting with 1. For release candidates, append _rcX with X being an incremental number starting with 1. Eventually the last candidate will be made final (by removing the appendix) after a few more tests prove that no further candidate is needed. | ||
+ | |||
+ | <pre> | ||
+ | cd .. | ||
+ | mv hugin-2010.4.0.tar.bz2 hugin-2010.4.0_beta1.tar.bz2 | ||
+ | </pre> | ||
+ | |||
+ | |||
+ | 10. Determine the tarball's checksum for the announcement notice | ||
+ | <pre> | ||
+ | sha1sum hugin-2010.4.0_beta1.tar.bz2 | ||
+ | </pre> | ||
+ | |||
+ | 11. Upload the tarball to SourceForge. | ||
+ | |||
+ | * Must to be a 'Release tech'. | ||
+ | * Preferred: with rsync (best with SSH Key set up, else need to enter password): | ||
+ | <pre> | ||
+ | rsync --partial --progress -e ssh hugin-2010.4.0beta2.tar.bz2 yuv,hugin@frs.sourceforge.net:/home/frs/project/h/hu/hugin/hugin/hugin-2010.4_beta/ | ||
+ | </pre> | ||
+ | * Web based alternative (not reliable, '''outdated instructions''' may not work since SourceForge has made major changes in February 2010) | ||
+ | ** log on to the SF [https://sourceforge.net/project/admin/explorer.php?group_id=77506 file manager] | ||
+ | ** left-click to navigate to the appropriate subfolder (e.g. hugin -> hugin-2009.2) | ||
+ | ** click on the icon next to the appropriate subfolder and in the context menu select "Uploads here" (or "New folder") if you need a new folder. | ||
+ | ** click on "upload file" | ||
+ | ** browse to the local file and let the upload begin. | ||
+ | ** prepare a release notes text file (e.g. "hugin-2009.2.0.release_notes.txt") and upload it as well, to the same subfolder | ||
+ | ** left-click on the release notes text file and click the checkbox "Release Note" | ||
+ | ** left-click on the released file. If you want it to be the default download for a specific platform, click the appropriate checkbox | ||
+ | ** in the "Release Notes" dropdown list, select the appropriate ones for this file | ||
+ | ** note the SHA1 sum calculated by SF. Compare it with the one determined in step 8. If it is different, delete the uploaded file and try again. | ||
+ | |||
+ | 12. Upload the tarball to Launchpad. | ||
+ | |||
+ | * Must be a member of the Hugin Developers Team on Launchpad. | ||
+ | * Strongly recommended: a GPG Key set up on Launchpad. | ||
+ | * Must have a pre-registered Series (see Release Plan above). | ||
+ | * Sign the tarball (if you have a GPG Key) | ||
+ | <pre> | ||
+ | gpg -u ${GPGKEY} --armor --sign --detach-sig hugin-2011.0.0.tar.bz2 | ||
+ | </pre> | ||
+ | * Point your browser to https://launchpad.net/hugin/<SERIES>/+addrelease, e.g. https://launchpad.net/hugin/2011.0/+addrelease | ||
+ | * Select the milestone against which you are uploading in the drop down menu, or if there was no milestone yet create one on the fly | ||
+ | * Set the release date | ||
+ | * Copy the Release Notes and ChangeLog into the fields | ||
+ | * Hit "Register the release" | ||
+ | * Hit "Add download file" (max file size is 200MB) | ||
+ | * Enter short Description: Hugin 2010.0.0 release tarball | ||
+ | * Browse to the .tar.bz2 file | ||
+ | * Browse to the .tar.bz2.asc signature | ||
+ | * Set Content Type: code release tarball | ||
+ | * Hit "Upload" | ||
− | + | 13. Draft the release announcement. | |
− | * a | + | * Extract the relevant ChangeLog section since the last release (look up the last release by tag or by revision number in `hg view`, then issue a command `hg log -r <REV_OF_PREV_RELEASE>: -b default --follow --style=changelog > relchange.txt |
− | * | + | * Use the Mercurial Tag noted earlier. |
+ | * Use the SHA1SUM noted earlier. | ||
− | + | 14. Mail the announcement to hugin-ptx. | |
− | + | 15. Clear the bug tracker. Go over the reports identified as [https://bugs.launchpad.net/hugin/+bugs?field.searchtext=&orderby=-importance&field.status%3Alist=FIXCOMMITTED&assignee_option=any&field.assignee=&field.bug_reporter=&field.bug_supervisor=&field.bug_commenter=&field.subscriber=&field.tag=&field.tags_combinator=ANY&field.has_cve.used=&field.omit_dupes.used=&field.affects_me.used=&field.has_patch.used=&field.has_branches.used=&field.has_branches=on&field.has_no_branches.used=&field.has_no_branches=on&field.has_blueprints.used=&field.has_blueprints=on&field.has_no_blueprints.used=&field.has_no_blueprints=on&search=Search fix committed] and change their status to '''fix released'''. | |
− | + | 16. Wait for feedback and fixes. Volunteers may fix critical bugs. Test that the codeline builds on the major supported platforms. Test that no major functionality is broken. Repeats steps 1-13 as often as necessary. | |
− | + | 17. Once the codeline is final, port relevant "polish" commits that have not been ported yet to default. | |
− | |||
− | + | 18. Later on if patches are required, apply them to the branch. Bump up V_PATCH in ./CMakeLists.txt and HUGIN_VERSION_PATCH in ./mac/Version.xcconfig, tag, and release. | |
− | |||
− | |||
− | ==== | + | ==== Declare a Release Final ==== |
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | * No tarball is to be released as final without being a release candidate (RC) first. If fixes are committed to the release codeline after the last RC, you have two options: either declare the current RC final and the issue a known issue; or release a new RC and wait again for it to be deemed of final quality. Make the decision by consensus on the mailing list. | |
− | * ''' | + | * Once you've decided that the current release candidate is final, polish the release notes in '''/doc/releases/''' and on the website in '''/releases/''' (this should be a process along with the polishing of the release itself). This will be mostly just text shuffling as information important during the release cycle such as calls for translation is pushed down in the document in favor of information that is more important for daily use. |
− | |||
− | + | ===== Mercurial Repository ===== | |
− | + | * identify the revision number that was tagged as the last RC (the number before the semicolon in the list of tags produced by the first command below) and tag it with the final version number: | |
+ | <pre> | ||
+ | hg tags | ||
+ | hg tag -r 5243 2011.0.0 | ||
+ | hg push | ||
+ | </pre> | ||
+ | * commit the release notes into doc/releases/ if you have not done so yet. | ||
− | + | ===== SourceForge ===== | |
− | |||
− | + | The following procedure can be done on the web or more conveniently in a shell. | |
− | |||
− | + | Web interface: | |
− | * | + | * Log on to SourceForge's [https://sourceforge.net/projects/hugin/files/ web interface]. |
− | * | + | * In the download folder for the current release cycle, delete all betas and rc except the last one (hit the hash sign button if on the web interface) |
− | ** | + | * Rename the last RC files, e.g. '''hugin-2010.4.0.tar.bz2''' |
+ | * Rename the folder for the current release cycle to a final folder name | ||
+ | Shell: | ||
+ | <pre> | ||
+ | ssh -t USER,PROJECT@shell.sourceforge.net create | ||
+ | cd /home/frs/project/h/hu/hugin/hugin | ||
+ | mv hugin-2011.0_beta hugin-2011.0 | ||
+ | cd hugin-2011.0 | ||
+ | mv hugin-2011.0.0_rc2.tar.bz2 hugin-2011.0.0.tar.bz2 | ||
+ | rm *beta* | ||
+ | rm *rc* # beware of this command, it may also delete some rc binaries you don't want to delete | ||
+ | exit | ||
+ | </pre> | ||
− | + | Rename a text document with the release notes README and upload it | |
+ | <pre> | ||
+ | cd doc/releases/ | ||
+ | cp hugin-2011.0.0.txt README | ||
+ | rsync -e ssh README yuv,hugin@frs.sourceforge.net:/home/frs/project/h/hu/hugin/hugin/hugin-2011.0/ | ||
+ | rm README | ||
+ | </pre> | ||
− | + | Must be done on the web interface: | |
+ | * Hit the circle symbol with the i on the line listing the download to show details | ||
+ | * for the README file, tick the Exclude Stats box | ||
+ | * for the tarball tick the Default Download boxes for all systems except Windows and Mac | ||
+ | * for Windows or Mac binaries, tick the appropriate Default Download box. (Issue: no discrimination of 32/64 bits -> use the 32 bits) | ||
+ | * Paste the announcement into the SourceForge news system. You need to be a 'News Editor' to do this. Log on to https://sourceforge.net/news/submit.php?group_id=77506 and paste the announcement. Note: we have not been using SF's news for at least a year. | ||
− | == | + | ===== Launchpad ===== |
− | If you | + | * If you have not kept a copy of the last release candidate and its signature that were uploaded to Launchpad on release of the last release candidate: |
+ | ** Point your browser to the last release candidate on Launchpad, e.g. https://launchpad.net/hugin/+milestone/2011.0rc1 | ||
+ | ** Download the last release candidate e.g. http://launchpad.net/hugin/2011.0/2011.0rc1/+download/hugin-2011.0.0_rc1.tar.bz2 | ||
+ | ** Download the last signature e.g. http://launchpad.net/hugin/2011.0/2011.0rc1/+download/hugin-2011.0.0_rc1.tar.bz2.asc | ||
+ | * Point your browser to https://launchpad.net/hugin/<SERIES>/+addrelease, e.g. https://launchpad.net/hugin/2011.0/+addrelease | ||
+ | * Select the milestone against which you are uploading in the drop down menu, or if there was no milestone yet create one on the fly | ||
+ | * Set the release date | ||
+ | * Copy the Release Notes and ChangeLog into the fields | ||
+ | * Hit "Register the release" | ||
+ | * Hit "Add download file" (max file size is 200MB) | ||
+ | * Enter short Description: Hugin 2011.0.0 release tarball | ||
+ | * Browse to the .tar.bz2 file | ||
+ | * Browse to the .tar.bz2.asc signature | ||
+ | * Set Content Type: code release tarball | ||
+ | * Hit "Upload" | ||
− | + | ===== Public Announcement ===== | |
− | + | * update Hugin homepage with link to the new release notes | |
− | + | * mail the announcement to [http://groups.google.com/group/hugin-ptx Hugin-PTX] (subscription required). | |
− | + | * mail the announcement to [http://lists.freedesktop.org/mailman/listinfo/create CREATE] (subscription required). | |
− | |||
− | === | + | === Testing === |
− | + | * There is only so much testing that can be done with our limited resources. | |
+ | * Final releases are expected to build and work on the major supported platforms, however it is possible that a bug slips in due to lack of resources / systematic testing | ||
+ | * We may issue patch releases in case of security issues or other major issues reported after final release. | ||
− | === | + | === Distribution === |
− | + | * The Hugin project releases source code that is tested to build on the main supported platforms: Fedora, Ubuntu, Windows, OSX. It works on the developers machines. YMMV. | |
− | + | * Building and distributing binaries is left to the users communities. Once there are binaries of appropriate quality level for platforms that do not have a package manager (Windows and OSX) we add them as a courtesy to the SourceForge download archive - as usual "WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE." See the GNU General Public License for more details. | |
− | |||
− | |||
− | |||
− | |||
− | == | + | == Download Test Build == |
− | + | Users publish test builds in different places of their choosing. Refer to hugin-ptx for the latest information. | |
− | + | * Ubuntu: when there are changes in the repository and when the latest revision builds, an automated nightly is produced every 24 hours for the Hugin PPA. Add it to your system with: | |
+ | <pre> | ||
+ | sudo add-apt-repository ppa:hugin/hugin-builds | ||
+ | sudo add-apt-repository ppa:hugin/nightly | ||
+ | sudo apt-get update | ||
+ | sudo apt-get install hugin enblend | ||
+ | </pre> | ||
− | + | * OSX: from time to time bleeding edge bundles are updated on Harry van der Wolf's [http://panorama.dyndns.org/index.php?lang=EN&subject=Hugin&texttag=Hugin site]. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | == Build your Own Test Builds == | |
− | + | If you are ready to go through the building process, here are the instructions. | |
− | {| style="margin: 1em auto 1em 1em;background:# | + | {| style="margin: 1em auto 1em 1em;background:#FFFF99;color:#FF0000;text-align:left;border: solid #FF3300;" |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|-valign="top" | |-valign="top" | ||
+ | ! '''IMPORTANT:''' | ||
+ | ! These builds are for your computer. If you decide to share them with others, be aware that you are subject to the GPL, and that the general public may need guidance regarding what you distribute. Read the information in the packaging and distribution section [[Development_of_Open_Source_tools#Packaging_and_Distribution | below]]. If you are unsure, ask on the hugin-ptx mailing list for advice before posting a file for download. | ||
|} | |} | ||
− | + | === Goal === | |
+ | |||
+ | An infrastructure for on-demand build and distribution of usable test-binaries for the most popular platforms. Ideally on demand, and synchronized with the project's major milestones and releases. But also builds for personal use. | ||
+ | |||
+ | === Process === | ||
− | + | # The build process for Hugin and related tools is documented for each of the supported platform. | |
+ | # Users reproduce the documented process and report success or failure. | ||
+ | # Experienced users and/or developers follow up on the reports and keep the documentation current. | ||
+ | # Power users script and automate the building process. | ||
+ | # Users with packaging skills package the builds for distribution (installers). | ||
+ | # The produced binaries/installers will be made available via the package distribution tools of well managed O/S; and/or on the web. | ||
− | + | === Specific revisions === | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | [[ | + | When building from the repository, some revisions may be broken. This process is meant to build the latest revision so that if the latest revision has bugs these can be identified, reported and corrected. However sometimes these bugs can be more critical than other times. If you need a more or less working version of Hugin, try applying the process to an earlier revision or to a released branch. To stay on top of all changes, consult the revision logs and the discussions on the hugin-ptx mailing list. |
+ | * [http://hugin.hg.sourceforge.net/hgweb/hugin/hugin/log/ Hugin revision log] | ||
+ | * [http://panotools.hg.sourceforge.net/hgweb/panotools/libpano/log Libpano revision log] | ||
+ | * [http://enblend.hg.sourceforge.net/hgweb/enblend/enblend/log Enblend revision log] | ||
=== Supported Platforms === | === Supported Platforms === | ||
− | * If you don't find your preferred platform listed below '''and''' you are willing to contribute your time and skills to build | + | * If you don't find your preferred platform listed below '''and''' you are willing to contribute your time and skills to build Hugin on it, feel free to add it to the table. We will accommodate any well supported platform in the regular release process. |
− | + | * '''Redundancy is good'''. If you have access to one of the listed platforms, please try to run the documented process below and report success to hugin-ptx. | |
− | * '''Redundancy is good'''. If you have access to one of the listed platforms, please try to run the documented process below and report success to hugin-ptx | ||
{| style="margin: 1em auto 1em 1em;background:#FFFFDD;text-align:left;border-top: thin dotted #333333;" | {| style="margin: 1em auto 1em 1em;background:#FFFFDD;text-align:left;border-top: thin dotted #333333;" | ||
|-valign="top" | |-valign="top" | ||
− | ! width=" | + | ! width="90" | |
Platform | Platform | ||
− | ! width=" | + | ! width="130" | |
Supported Versions | Supported Versions | ||
− | ! width=" | + | ! width="60" | |
Status | Status | ||
− | ! width=" | + | ! width="220" | |
Process | Process | ||
− | ! width=" | + | ! width="400" | |
− | |||
− | |||
Credits | Credits | ||
− | |||
− | |||
|-valign="top" | |-valign="top" | ||
! style="border-top: thin dotted #333333;" | | ! style="border-top: thin dotted #333333;" | | ||
− | + | Ubuntu | |
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
− | 32bit/64bit<br> | + | 32bit/64bit<br>10.04 10.10 11.04 (oder releases may work but are no longer supported). |
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
tbd | tbd | ||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
[[Hugin Compiling Ubuntu | OK]] | [[Hugin Compiling Ubuntu | OK]] | ||
− | |||
− | |||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
* Sébastien Perez-Duarte | * Sébastien Perez-Duarte | ||
* Yuval Levy | * Yuval Levy | ||
* Régis B. | * Régis B. | ||
+ | * Kornel Benko | ||
+ | |||
+ | |-valign="top" | ||
+ | ! style="border-top: thin dotted #333333;" | | ||
+ | Debian | ||
+ | | style="border-top: thin dotted #333333;" colspan="3" | | ||
+ | The Hugin Packagers Team for Debian can be reached at '''hugin at packages.debian.org'''. Liaise with them if there are issues with the binaries in Debian (and downstream distributions like Ubuntu) and on backports.org. | ||
+ | |||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
+ | * Cyril Brulebois | ||
+ | * Andreas Metzler | ||
+ | * Sebastian Harl (enblend) | ||
|-valign="top" | |-valign="top" | ||
Line 258: | Line 776: | ||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
[[Hugin Compiling Fedora | tbd]] | [[Hugin Compiling Fedora | tbd]] | ||
− | |||
− | |||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
* Bruno Postle | * Bruno Postle | ||
− | |||
|-valign="top" | |-valign="top" | ||
Line 268: | Line 783: | ||
OSX | OSX | ||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
− | IntelMac/PowerPC<br>10. | + | IntelMac/PowerPC<br>10.4 10.5 10.6 |
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
tbd | tbd | ||
Line 274: | Line 789: | ||
* [[Hugin Compiling OSX | "roll your own" draft]] | * [[Hugin Compiling OSX | "roll your own" draft]] | ||
* [[Build_a_MacOSX_Universal_Hugin_bundle_with_Xcode | universal bundle for distribution draft]] | * [[Build_a_MacOSX_Universal_Hugin_bundle_with_Xcode | universal bundle for distribution draft]] | ||
− | |||
− | |||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
* Ippei Ukai | * Ippei Ukai | ||
Line 285: | Line 798: | ||
* Roger Howard | * Roger Howard | ||
* Harry van der Wolf | * Harry van der Wolf | ||
− | + | * Charlie Reiman | |
|-valign="top" | |-valign="top" | ||
Line 291: | Line 804: | ||
Windows | Windows | ||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
− | 32bit<br>XP | + | 32bit/64bit<br>XP/Vista<br>(64bit officially supported only after 0.8.0) |
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
tbd | tbd | ||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
− | *[[Build Hugin for Windows with SDK | OK, SDK based]] | + | *[[Build Hugin for Windows with SDK | OK, SDK based]] 32bit only. |
*[[Hugin Compiling Windows | draft, from scratch]] | *[[Hugin Compiling Windows | draft, from scratch]] | ||
− | | | + | *[[Hugin_SDK_(MSVC_2008) | build the SDK for MSVC 2008]] 32bit & 64bit |
− | + | *[[Hugin_SDK_(MSVC_2008)_Patches | SDK 64bit patches]] | |
+ | *[[Hugin_SDK_(MSVC_2010) | build the SDK for MSVC 2010]] 32bit & 64bit | ||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
* Tom Sharpless | * Tom Sharpless | ||
Line 306: | Line 820: | ||
* Yuval Levy | * Yuval Levy | ||
* Guido Kohlmeyer | * Guido Kohlmeyer | ||
− | + | * Ad Huikeshoven (build automation) | |
− | + | * Ryan Sleevi (64 bit) | |
+ | * Thomas Modes | ||
|-valign="top" | |-valign="top" | ||
! style="border-top: thin dotted #333333;" | | ! style="border-top: thin dotted #333333;" | | ||
Line 317: | Line 832: | ||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
[[Hugin Compiling OpenSuse | tbd]] | [[Hugin Compiling OpenSuse | tbd]] | ||
− | |||
− | |||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
* Kornel Benko (10.3) | * Kornel Benko (10.3) | ||
* Peter Suetterlin (10.2) | * Peter Suetterlin (10.2) | ||
* Stephan Hegel (10.3 x86_64) | * Stephan Hegel (10.3 x86_64) | ||
− | |||
|-valign="top" | |-valign="top" | ||
Line 333: | Line 845: | ||
n/a | n/a | ||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
− | + | [[Hugin Compiling FreeBSD | OK]] | |
− | | | ||
− | |||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
* Vasil Dimov (6.2/i386) | * Vasil Dimov (6.2/i386) | ||
* Vasil Dimov (7.0/amd64) | * Vasil Dimov (7.0/amd64) | ||
− | |||
|-valign="top" | |-valign="top" | ||
Line 349: | Line 858: | ||
tbd | tbd | ||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
− | [[Hugin_Compiling_Gentoo | | + | [[Hugin_Compiling_Gentoo | OK]] |
− | |||
− | |||
| style="border-top: thin dotted #333333;" | | | style="border-top: thin dotted #333333;" | | ||
* Thomas Pani | * Thomas Pani | ||
− | |||
|-valign="top" | |-valign="top" | ||
! style="border-top: thin dotted #333333;" | | ! style="border-top: thin dotted #333333;" | | ||
all platforms | all platforms | ||
− | ! style="border-top: thin dotted #333333;" colspan=" | + | ! style="border-top: thin dotted #333333;" colspan="4" | |
a big thank you to '''Pablo d'Angelo''' for supporting all of those building efforts. | a big thank you to '''Pablo d'Angelo''' for supporting all of those building efforts. | ||
|-valign="top" | |-valign="top" | ||
Line 383: | Line 889: | ||
* outdated: worked in the past but needs an update | * outdated: worked in the past but needs an update | ||
* obsolete: nobody has the time to update | * obsolete: nobody has the time to update | ||
+ | |||
+ | === Dependencies === | ||
+ | |||
+ | Hugin is work in progress and dependencies can be added any time. If your build does not work, see [[Fixing The Hugin Build]]. | ||
+ | |||
+ | Hugin depends on the following packages. The list may be incomplete, and there may be some platform-specific dependencies. Details for specific platforms are in the platform documents linked above. | ||
+ | |||
+ | ==== Build-Time Dependencies ==== | ||
+ | |||
+ | Users compiling Hugin (version 2016.1 and later) from source will need: | ||
+ | * A C++ compiler which supports OpenMP and C++11 | ||
+ | ** [http://openmp.org/ OpenMP] support is not required. But when compiling without OpenMP nona and cpfind (and some other algorithm) are running only with one thread, which is slower. | ||
+ | |||
+ | * The '''[http://www.wxwidgets.org/ wxWidgets GUI toolkit]''' version >=2.7.0. the 3.x series is supported. | ||
+ | * '''std::filesystem''' from C++17 or '''[http://www.boost.org/doc/libs/1_47_0/libs/filesystem/index.html boost::filesystem]''' (Boost >= 1.47) | ||
+ | * '''[http://www.zlib.net/ libzlib]''' the zlib compression library. | ||
+ | * '''[http://www.libtiff.org/ libtiff]''' the TIFF library with LZW support. | ||
+ | * '''[http://panotools.sourceforge.net/ libpano13]''' version >=2.9.19 | ||
+ | * '''[http://libjpeg.sourceforge.net/ libjpg]''' the JPEG library | ||
+ | * '''[http://www.libpng.org/pub/png/libpng.html libpng]''' the PNG library | ||
+ | * '''[http://www.openexr.com/ libopenexr]''' the OpenEXR library | ||
+ | * '''[http://ukoethe.github.io/vigra/ vigra]''' the VIGRA Computer Vision Library >=1.9 | ||
+ | * '''[http://www.exiv2.org/ Exiv2]''' Image metadata library | ||
+ | * '''[http://glew.sourceforge.net/ GLEW]''' the OpenGL Extension Wrangler Library or '''[https://github.com/anholt/libepoxy libepoxy]''' library for handling OpenGL function pointer management (since 2023.0, see file INSTALL_cmake for more details) | ||
+ | * '''[http://www.gnu.org/software/gettext/ gettext]''' | ||
+ | * optionally, '''[http://www.fftw.org/ libfftw3]''' | ||
+ | * On Unix/Linux you need also | ||
+ | ** '''[http://www.opengl.org/resources/libraries/glx/ libGLU]''' the OpenGL utility library | ||
+ | ** '''[http://cgit.freedesktop.org/xorg/lib/libXi/ libxi]''' | ||
+ | ** '''[http://cgit.freedesktop.org/xorg/lib/libXmu libxmu]''' | ||
+ | * On Windows you need also | ||
+ | ** '''[http://www.microsoft.com/downloads/en/details.aspx?familyid=00535334-c8a6-452f-9aa0-d597d16580cc HTML Help Workshop]''' for generating compiled HTML help file | ||
+ | ** optional '''[http://wixtoolset.org/ WiX toolset]''' to create the installer | ||
+ | * On MacOS you need also | ||
+ | ** '''[http://freeglut.sourceforge.net/ freeglut]''' or '''[http://www.opengl.org/resources/libraries/glut/ glut]''', the OpenGL utility toolkit | ||
+ | |||
+ | * for the optional Python Scripting Interface (currently functional and tested only on Linux and Windows) | ||
+ | ** '''[http://www.python.org/ Python]''' version >=2.6 | ||
+ | ** '''[http://swig.sourceforge.net/ SWIG]''' >=2.0 - If Python >=3.2, SWIG must be >=2.0.4 | ||
+ | * Hugin can be compiled with gcc, as well as with MSVC. | ||
+ | * The build process requires '''[http://www.cmake.org/ CMake'''] version >=3.1 | ||
+ | |||
+ | ==== Run-Time Dependencies ==== | ||
+ | |||
+ | At runtime | ||
+ | * '''[http://enblend.sourceforge.net/ enblend]''' >= 3.2 is required. | ||
+ | * '''[http://www.sno.phy.queensu.ca/~phil/exiftool/ Exiftool]''' >=9.09 is required. | ||
+ | * Starting with Hugin 2010.3 and newer, Hugin ships with its own control points generator cpfind. Prior to 2010.3 another optional but recommended runtime dependency was a control points generator. | ||
+ | * Optionally '''[http://pypi.python.org/pypi/argparse/1.2.1 Python argparse]''' command-line parsing library for the Python scripts. | ||
== Packaging and Distribution == | == Packaging and Distribution == | ||
Line 407: | Line 962: | ||
== Feedback == | == Feedback == | ||
− | When running through the building process documented above chances are that something goes wrong. While it is disappointing when the process ends in a flurry of cryptic error messages it is not harmful. This is the nature of software development and you are now part of it. There is | + | When running through the building process documented above chances are that something goes wrong. While it is disappointing when the process ends in a flurry of cryptic error messages it is not harmful. This is the nature of software development and you are now part of it. There is a lot of value in your experience and you can help improve the process and get closer to the hoped for software package. Don't be ashamed that it did not work. This happens even to the most expert coders. Give the developers feedback on the hugin-ptx mailing list. Only with your feedback they can know that something goes wrong, and a well crafted feedback is the most important step to help identify what went wrong and devise a solution. Be a part of the solution, not a part of the problem! |
To give good feedback, note down carefully all of this information while you are going through the instructions. | To give good feedback, note down carefully all of this information while you are going through the instructions. | ||
− | # | + | # Details about your computer. CPU, operating system, other particularities |
− | # | + | # The revision number of the code checked out with Mercurial (`hg sum`). If you don't find a revision number, the date and time when you checked out the code. |
− | # | + | # The last step / command you entered into the command line. |
− | # | + | # A copy of the last few lines displayed, from where you think the error messages started. Don't worry if you copy a couple of lines too many, it is better to give more lines than less lines. |
Even the standard feedback is good feedback. For those wishing to dig deeper, you can try | Even the standard feedback is good feedback. For those wishing to dig deeper, you can try | ||
* to use "make VERBOSE=1" when building hugin. | * to use "make VERBOSE=1" when building hugin. | ||
* to do a debug build "cmake -DCMAKE_BUILD_TYPE=DEBUG" and use oprofile for profiling. | * to do a debug build "cmake -DCMAKE_BUILD_TYPE=DEBUG" and use oprofile for profiling. | ||
+ | |||
+ | [[Category:Community:Project]] [[Category:Software:Hugin]] |
Latest revision as of 17:23, 30 March 2023
2011-Feb-09: | Libpano has migrated to a Mercurial Repository on SourceForge. If you find outdated references to Subversion, please update. |
---|---|
2010-Nov-22: | Hugin's tracker has moved from SourceForge to Launchpad, and so have the trackers for Enblend and Panotools. If you still find references to the SourceForge tracker in these pages, it may be outdated. Please fix if you can. Most pages have been fixed for Hugin's move from a Subversion to a Mercurial repository (2010-May-16) but if you find a reference to SVN, it may be outdated or it may be related to Panotools that has not moved. Please fix if you can. |
Panorama Related Open Source tools
Contribution
Why contribute?
The above tools are free for you (and every other user), because volunteers have contributed their skills and time. They provide immense value to the whole community. They provide value to you, don't they? If they do, please consider contributing something back.
How to contribute?
Join the hugin-ptx mailing list to find out what is going on at the moment and how you can help.
If you don't have time, you are most likely a busy professional. You can donate money to Hugin, Enblend/Enfuse on their project pages through Sourceforge.
At the time of updating this text (6-Mar-2011) the building process of Hugin is robust and there are more and more people mastering it on the different platform. The 2011.0 release cycle is well underway. Beyond that, a few exciting features such as a python scripting interface are in line for future releases.
Don't be afraid of failures in the building process
- You may encounter errors when following the build processes linked below is high. Don't worry such errors will not compromise your computer.
- The failure of the building process is actually your success! Every time you report such a failure, with as much detail as possible to how it came about, you are contributing to the progress toward a stable release.
- See also If you encounter errors, Fixing The Hugin Build.
If you are fluent in other languages than English, you can help translate Hugin. There's a Hugin translation guide to help you get started or help when you run into translation problems.
Processes
The release process introduced in 2009 has decoupled the development processes from the release process, avoiding artificial slow downs (trunk freezes).
Hugin uses an asynchronous development process based on Mercurial, which means that:
- the default branch never freezes, and committers can continuously add improvements to it.
- anybody can branch out development codelines on their local copy of the repository, and even publish that repository.
- usually developers will branch out to implement major changes or changes that will not be completed very soon; and builders will branch out to clean up releases; without disrupting the continuous flow of contributions.
- unlike in the previous Subversion repository, branches are no longer stored in different folders. Give them a meaningful name to distinguish release branches (version number) from development branches (feature being implemented / worked on).
- developers have write access to the official repository on Sourceforge and can push changes and branches to it. The project is very liberal in giving such write access - if you have something to contribute, mention it on hugin-ptx and chances are one of the admins will give you the necessary write rights.
- once a months, developers are polled as to whether it is worth issuing a release. if there is enough support and one person volunteers as release manager, that person branches out a release codeline from the default codeline. That release codeline is equivalent to a trunk freeze in traditional synchronous development. only bug fixes and translations should go into that codeline. Tarballs are to be released from release codelines only.
Development
- If you are working on something big that requires multiple changes to complete, you're encouraged to start your own branch:
hg pull hg branch <YOUR_UNIQUE_BRANCH_NAME>
- If you are working on incremental improvements to the default branch, feel free to push them any time. There is no trunk freeze.
- You're encouraged to continue with your usual pace of bug fixing and development.
- To do things perfectly: commit all your changes to the default branch; and apply those that are bug fixes also to the current release codeline if the project is in the midst of a release cycle.
- The new thing about Mercurial (coming from Subversion): commit is to your local repository only. To avoid multiple heads, pull/update before committing; and remember to push your change from time to time so that others can test them / benefit from them / add value to them.
hg pull hg up hg ci hg push
- If you forget about it and commit only to one codeline, do not worry. The release manager takes responsibility to sync between the default branch and the release branch.
- Try not to add new features, particularly new strings, to the release codeline later in the release cycle.
Translation
- Generally same as development. For specifics see the translation guide.
Debugging
Working through Hugin Trackers.
Clearing the tickets in the tracker is an iterative process critical to the release cycle. Feedback from tester is essential for this process. Please take the time to check if the older reports apply to a current snapshot and add new findings to the ticket.
We'll be releasing frequent snapshots until a release candidate emerges. This is an iterative process:
- Volunteers check the release-critical bugs listed in the bug tracker against the most recent snapshot. The most recent snapshot for is usually posted on the Hugin-PTX mailing list.
- Install the latest snapshot.
- Try to reproduce the bug on your system.
- If you find that the bug no longer occurs, chances are that it has been fixed. Close it (assuming you have the required access), or simply leave a note that it has been fixed (together with the exact version number and the system used for testing).
- If you reproduce the bug, leave a note to confirm that it is still actual. Note the SHA1 ID and the system used for testing. Post detailed instructions how to reproduce the crash. Provide a test case if you can.
- Add any comments you have to the ticket in the bug tracker. Let the community know you have tested. The tracker is like a mailing list or forum thread, don't be afraid to post.
- If you don't want to open an account with Launchpad, post your observations on the hugin-ptx mailing list.
- The developers fix the bugs identified in the tracker.
- The builders build new snapshots including the fixes.
Development Codelines
It is recommended to work separately on major changes and integrate them in the main codeline when they are ready. The currently open development branches are listed in the repository along the release branches.
hg pull hg branches
If you want to work on a major new feature, open yourself a branch.
hg branch <NEW_UNIQUE_BRANCH_NAME>
If you want to publish that branch on Sourceforge, ask for write right and push your changes to Sourceforge.
hg push
The branch owners are strongly encouraged to regularly sync their branch with default, i.e. merge the changes that have occurred since the last sync (or branching) into their branch.
hg pull hg up -C <YOUR_BRANCH> hg merge default hg ci -m "merged from default" hg push
If an unresolved conflict arises, see below the Merging section.
When development is complete or has reached a milestone, it may be integrated into default. Before integrating into default it is recommended to:
- Merge all of default's changes since the last sync into the branch.
- Test that the branch builds on the major supported platforms.
- Test that the branch does not break existing functionality (unless the break is intended, e.g. when a new functionality replaces an existing one).
When the development branch has fulfilled its purpose; is superseded or has been abandoned, close it.
hg up -C <OBSOLETE_BRANCH> hg commit --close-branch -m 'close badbranch, this approach never worked' hg up -C default # switch back to "good" branch
Merging
Most of the time Mercurial is quite good at merging different codelines. However sometimes there are conflicting version and even Mercurial does not know what to do. It will prompt for you to solve the conflicts.
The preferred tool to solve conflicts is [KDiff3 http://mercurial.selenic.com/wiki/KDiff3]. According to Mercurial's wiki it is 'the "best" merge tools' and included with the Windows installer of TortoiseHg. Handbook. On Ubuntu install it with `sudo apt-get install kdiff3`. To work comfortably with KDiff3, add the following lines to ~/.hgrc:
[extensions] hgext.extdiff = [extdiff] cmd.kdiff3 = [merge-tools] kdiff3.args = $base $local $other -o $output
First close the codeline to be merged with a last commit. Then switch to the default branch and start the merge.
hg up -C feature-x hg ci -m 'Closed branch feature-x' --close-branch hg up -C default hg merge feature-x
During the merge operation, Mercurial will trigger KDiff3 automatically in case of an unresolved conflict. Kdiff3 will show three versions side by side in the top half of the window:
- in the middle is the current one
- on the right is the new one
- on the left is the base (common ancestor? not sure?)
- In the bottom half of the window is the resulting merge, with conflicts highlighted.
- Using the buttons bar:
- Use the symbol with the three arrows up/down to jump to the previous/next unsolved conflict.
- When a <Merge Conflict> area is highlighted in the bottom pane, hit the A/B/C buttons to select which version(s) to use/merge in.
- Once all conflicts are solved, save and quit. Mercurial will continue the merge operation.
Once the merge operation is finished, commit and push.
hg ci -m 'Merged branch feature-x' hg push
Maturity Criteria
A development codeline - whether under revision control or presented as a patch - is considered mature when:
- a: the functionality it is intended to implement works on the developer's machine ("works for me" condition)
- b: it has been tested to build on the major supported platforms ("does not leave them behind" condition) by at least one contributor for each: Windows, OSX, Linux
- c: it does not unintentionally break existing functionality ("no regression" condition)
When a development codeline reaches maturity, it enters the integration queue.
Integration Queue
The integration queue is the ordered list of new features / development codelines waiting to be integrated in trunk. The prioritization is a collective decision by consensus of the developers. Silence = consent. The discussion, and the latest version of the list, are on the mailing list.
The integration queue is not set in stone: a change in the maturity status of a feature in waiting is good reason to review/change the ordered list. In any case it is reviewed after every release branching.
Release
Once a month the developers are polled if there is reason to issue a release. If there is enough support for releasing, one developer takes on the role of release manager and undertakes the following steps:
The conditions to declare a release final are:
- the code builds on the major supported platforms (Ubuntu, Fedora, OSX, Windows)
- there is no (known) regression, unless intentional. This means: what worked with the previous release should work with the current one.
Release Plan
Planning the release helps contributors pace and schedule their contributions. On Launchpad there is a simple and adequate tool for planning and communicating releases.
Register a New Hugin Releases Series in Launchpad
When starting a new release cycle, register first a new Releases Series in Launchpad.
- Prerequisites: must be logged in to Launchpad and be a member of the Hugin-Devs team.
- Point your web browser to: https://launchpad.net/hugin/+addseries
- Enter the Version in the Release Name field: V_MAJOR.V_MINOR
- As Summary enter a bullet points list of the most relevant new features that will be introduced by the release.
- Hit Register Release Series.
- On the next page edit the Release Manager.
Edit Status of Previous Series
As a policy:
- Only the default branch, the latest release, and the active development branches are in active development.
- Only the previous two releases are supported.
- Older releases are obsolete.
To change the status as a consequence of the new release cycle, point your browser to https://launchpad.net/hugin/<V_MAJOR.V_MINOR>/+edit, e.g. https://launchpad.net/hugin/2010.4/+edit for the relevant series.
- Change the status of the previous release from Active Development to Supported.
- Change the status of the oldest supported release to Obsolete.
Register Milestones for the release
Planning milestones in advance and registering them with targeted dates will make the process more predictable and help builders plan for the binaries releases.
As a rule of thumb plan for two betas spaced by 2 weeks; for one release candidate two weeks after the last planned beta; and for the first RC to be declared final two weeks after release. Adapt to the circumstances. Things will change during the cycle and you can also add extra betas and rcs. Toward the end of the cycle, spacing can be one week.
- Point your browser to https://launchpad.net/hugin/<V_MAJOR.V_MINOR>/+addmilestone of the new releases series, e.g. https://launchpad.net/hugin/2011.0/+addmilestone
- Enter a name following these conventions:
- Betas: <V_MAJOR>.<V_MINOR>beta<INCREMENT> with INCREMENT starting from 1, "beta" in small caps and no spaces or underscores, no leading zeros. Example 2011.0beta1
- Release Candidates: <V_MAJOR>.<V_MINOR>rc<INCREMENT> with INCREMENT starting from 1, "rc" in small caps and no spaces or underscores, no leading zeros. Example 2010.4rc2
- Final Release: <V_MAJOR>.<V_MINOR>.<V_PATCH>, no leading zeros. Example: 2009.2.0
- No need to enter a Code name.
- Enter the date targeted for the tarball release.
- No need to enter a Summary.
- Hit Register Milestone.
Release Notes
The Release Notes are an important document accompanying the release. Although it is just a list of new features, it gets distributed widely. Most readers are unlikely to have used Hugin before. When drafting them, think that the target audience is somebody who has an idea of what a panorama stitcher might be, has never heard of Hugin, but is interested in discovering cool new software.
Start drafting them early in the process to allow for translators to translate the Release Notes on the website. Moreover, you will send them as simple text with each released tarball.
Important: store the release notes in the repository, as a text file inside doc/releases/. Use those texts as inspiration example.
Set Up
Set yourself up to edit the release notes on the website. You will need write access to the SourceForge project.
hg clone ssh://${USER}@hg.code.sf.net/p/hugin/hugin-web hugin-web
The Editing Cycle
cd hugin-web hg pull hg up mkdir releases/2014.0 nano releases/2014.0/en.shtml hg add releases/2014.0 hg ci -m "skeleton|draft|updated|final release notes" hg push
The website updates automatically about every hour. Wait enough time and point your web browser to http://hugin.sourceforge.net/releases/2010.4/ to verify the result of your edits.
Release Notes for the First Beta Release in a New Release Cycle
Before posting the beta1 of the release cycle, you want to have at least a working draft of the Release Notes. Edit them directly on the website. List the relevant new features. Use the release notes from past releases as a template. Copy them in text form for the email announcing the beta1 release. Don't link them from the homepage. Translators will want to start working on the text as soon as possible. Try to finish it early in the process. Add a comment at the beginning of the text to detail its current status. Not all translators follow the Changelog of the website and so are not aware if you committed the document as skeleton / draft / update / final.
Release Notes for Follow Up Releases in the Same Release Cycle
It is important to show the changes relative to the previous tarball, however only in the email announcing the new tarball. The HTML page on the website will most likely stay untouched (unless an important new feature has been added so late in the cycle). Add a section "Changes since previous beta release" (or "Changes since previous release candidate" if we're already at the RC stage) to the text mail you sent announcing the beta1 release. Copy and edit the relevant Changelog entries in there.
Branching Out For Release
1. Identify and add the new strings for translation.
Before running the script, make sure you have wxrc installed. On older Ubuntu, run sudo apt-get install wxrc
. On Ubuntu 10.4LTS it is sudo apt-get install wx-common
.
hg pull hg up cd src/translations ./extract-messages.sh hg diff hg ci -m "Add new and update existing strings for translation" hg push
2. Update the Changes.txt file
3. Identify the last time a release branch was branched from the default branch. This is usually tagged with a beta1 tag, so just use `hg view` and note down the revision number associated with the last beta1 tag. Extract the relevant changelog information for the release notes and save them in a file for later use:
hg log -r <REV#>: -b default --style Changelog.style > ../temp_change_log.txt
4. Branch out a new release-codeline (replace 2010.4 below with the appropriate version number. 2010 stands for the current year and 4 stands for the next even number in sequence, starting with 0 if the year has changed and this is the first release of the year).
hg branch 2010.4
5. Bump up the version number:
nano ./CMakeLists.txt nano ./mac/Version.xcconfig hg ci -m "bumping version number"
In the top level ./CMakeLists.txt edit the lines
# version set(V_MAJOR 2010) set(V_MINOR 4) set(V_PATCH 0)
In mac/Version.xcconfig edit the lines
HUGIN_VERSION_MAJOR = 2010 HUGIN_VERSION_MINOR = 4 HUGIN_VERSION_PATCH = 0
6. Update the @api-min and @api-max setting of the Python scripts in src/hugin_script_interface/plugins. For this it needs to check if they work with the current API or if there was an incompatible API change. In the latter case the scripts should updated or removed from the release.
This is not required for the scripts in src/hugin_script_interface/plugins-dev. These files contains only the rough framework for script developer.
7. Set the red splash screen to indicate that the artwork embellishing the release has not been selected yet (only to be done, if there is artwork selected for the release).
hg revert -r 5008 src/hugin1/hugin/xrc/data/splash.png hg ci -m "red splash screen to indicate release cycle with no artwork selected yet"
(April 2015: currently not needed)
8. Switch back to the default branch and bump up to the next odd version number, e.g. 2010.5 in this example.
hg up default nano ./CMakeLists.txt nano ./mac/Version.xcconfig hg ci -m "bumping version number"
Edit the same lines as above in the top level ./CMakeLists.txt file and in ./mac/Version.xconfig
The same applies to the @api-min and @api-max settings in the scripts.
9. Verify that the branches are ok and push them to the official repository. Since we intentionally create a new remote branch, we use the -f switch in the push command.
hg view hg push -f
Keeping the Release Branch in Sync with Default
Committers have no obligation to help maintaining the release branch. In fact, it is best if they keep working in default on both code and translations. As a release manager, you want to stay on top of the changes in default and synchronize them into your branch prior to release if relevant.
The Hgk Mercurial extensions will help you with this. Edit your ~/.hgrc file to activate it. In [extensions] section add:
hgext.hgk =
If `hg view` does not work / returns an error, you may be missing a dependency. In Ubuntu type `sudo apt-get install tk8.5`.
In Hgk the changesets are displayed chronologically per branch with the newest one on top. Branches are indicated visually by a tree on the left. Tags have a yellow background and te top of branches are indicated by a box with green background and the name of the branch, except the default branch. Tags are displayed on yellow background.
Syncing Code from Default to Release Branch
This is for code only. For translations, see below.
- Make sure your repo is up to date and get an overview of the two branches with Hgk:
hg pull && hg up <RELEASE_BRANCH> && hg view default && hg view <RELEASE_BRANCH> &
- Find the first changeset on the default branch after the last time you synchronized and work yourself up to the present.
- Select one changeset at a time. You will see details of the change set in the lower part of the window.
- In the lower left panel, read the changeset log and its revision number.
- Decide if you want to apply it to the Release branch (i.e. if it is a bug fix)
- If you decided that the changeset should apply to the Release branch, check if it has not been applied already by the developer.
- If it has not been applied, apply it, using the <REVISION_NUMBER>:
hg graft --log --rev <REVISION_NUMBER>
- If you deem this to have been a major change, go through a build/test cycle
- Repeat until all new changes have been applied
- Go through a build/test cycle
- Push your changes to the public repository
hg push
Syncing Code from the Release Branch to Default
This is for code only. For translations, see below.
The procedure is the same, just make sure you're working in default:
hg pull && hg up default && hg <RELEASE_BRANCH> && hg view default & hg export --git <REVISION_NUMBER> | hg import - ... hg push
Updating Translations
Translations must always be imported using `msgmerge`.
- copy the file with the new contributed translation to src/translations/<LANG>.contributed.po
- check how many strings will be added/removed
- merge the new translation with the existing translation into a new file src/translations/<LANG>.merged.po
- examine the old and the new po files with msgfmt.
- if the statistics look good, overwrite the old file with the new file, commit, push, and ask native language speakers to check.
- repeat separately for each affected branch.
hg pull hg up -c 2010.4 cp ~/Downloads/${UPLANG}.po ~/src/hugin.hg/src/translations/${UPLANG}.contributed.po cd ~/src/hugin.hg/src/translations/ ./diff_po.pl ${UPLANG}.po ${UPLANG}.contributed.po msgmerge -o ${UPLANG}.merged.po ${UPLANG}.contributed.po ${UPLANG}.po msgfmt -c --statistics ${UPLANG}.merged.po msgfmt -c --statistics ${UPLANG}.po mv ${UPLANG}.merged.po ${UPLANG}.po rm ${UPLANG}.contributed.po hg ci -m "Updated ${UPLANG} translation (${TRANSLATOR})" hg push
To check the status of the translations you could do something like:
for i in *.po; do echo $i; msgfmt -c -v $i; done
This will give you something like:
<snip> bg.po 509 translated messages, 505 fuzzy translations, 369 untranslated messages. ca_ES.po 300 translated messages, 576 fuzzy translations, 507 untranslated messages. </snip>
Release
1. Start with a clean checkout.
hg clone http://hg.code.sf.net/p/hugin/hugin hugin.hg
2. Switch to the branch you are going to release (example 2013.0 release; and when you don't know do a "hg branches")
cd hugin.hg hg update -C 2013.0
3. Update the Changelog (make sure LC_ALL is set to UTF-8 when doing this). In Ubuntu you may have to do something like `export LANG="en_CA.UTF-8" && export LC_ALL="en_CA.UTF-8"`
4. commit the Changelog
cd .. mkdir hugin.hg-build cd hugin.hg-build cmake -DUPDATE_CHANGELOG=1 ../hugin.hg cd ../hugin.hg hg ci -m "Updated ChangeLog"
5. Update the appdata files in platforms/linux/appdata. Add a line with the date and release number like
<release date="2020-12-12" version="2020.0.0" />
in the <releases> block to calibrate_lens_gui.appdata.xml, hugin.appdata.xml and PTBatcherGUI.appdata.xml.
6. tag the release (list the tags first to see how releases are named and ensure consistency.
- Betas: <V_MAJOR>.<V_MINOR>beta<INCREMENT> with INCREMENT starting from 1, "beta" in small caps and no spaces or underscores, no leading zeros. Example 2011.0beta1
- Release Candidates: <V_MAJOR>.<V_MINOR>rc<INCREMENT> with INCREMENT starting from 1, "rc" in small caps and no spaces or underscores, no leading zeros. Example 2010.4rc2
- Final Release: <V_MAJOR>.<V_MINOR>.<V_PATCH>, no leading zeros. Example: 2009.2.0
To fix/clean up tags:
- remove a tag with `hg tag --remove <TAG_NAME>`
- add a tag by going to a specific revision and tagging it: `hg up -q -r <REV> && hg tag <TAGNAME>`
- if a tag exists already and you want to move it, just use `hg tag -f <TAGNAME>` at the new revision to be tagged
7. note down the revision/hash for the release
hg tags hg tag <RELEASE> hg log -l 2 hg push
7. Create tarball
cd .. mkdir hugin-tarball cd hugin-tarball cmake ../hugin.hg -DENABLE_LAPACK=YES -DCPACK_BINARY_DEB:BOOL=OFF -DCPACK_BINARY_NSIS:BOOL=OFF \ -DCPACK_BINARY_RPM:BOOL=OFF -DCPACK_BINARY_STGZ:BOOL=OFF -DCPACK_BINARY_TBZ2:BOOL=OFF \ -DCPACK_BINARY_TGZ:BOOL=ON -DCPACK_BINARY_TZ:BOOL=OFF make package_source
8. Build an rpm or deb (depending on your distro) from the tarball as a sanity check. Test what you can test.
tar xvfj hugin-2010.4.0.tar.bz2 mkdir hugin-tarball-build cd hugin-tarball-build cmake ../hugin-2010.4.0 -DENABLE_LAPACK=YES -DCPACK_BINARY_DEB:BOOL=ON -DCPACK_BINARY_NSIS:BOOL=OFF \ -DCPACK_BINARY_RPM:BOOL=OFF -DCPACK_BINARY_STGZ:BOOL=OFF -DCPACK_BINARY_TBZ2:BOOL=OFF \ -DCPACK_BINARY_TGZ:BOOL=OFF -DCPACK_BINARY_TZ:BOOL=OFF \ -DBUILD_HSI:BOOL=ON -DSWIG_EXECUTABLE=/usr/bin/swig2.0 make package sudo dpkg -i hugin-2010.4.0-Linux.deb
9. Rename the tarball. For snapsnots, append _snapshotYYMMDD (replace YYMMDD with Year/Month/Day). For betas, append _betaX with X being an incremental number starting with 1. For release candidates, append _rcX with X being an incremental number starting with 1. Eventually the last candidate will be made final (by removing the appendix) after a few more tests prove that no further candidate is needed.
cd .. mv hugin-2010.4.0.tar.bz2 hugin-2010.4.0_beta1.tar.bz2
10. Determine the tarball's checksum for the announcement notice
sha1sum hugin-2010.4.0_beta1.tar.bz2
11. Upload the tarball to SourceForge.
- Must to be a 'Release tech'.
- Preferred: with rsync (best with SSH Key set up, else need to enter password):
rsync --partial --progress -e ssh hugin-2010.4.0beta2.tar.bz2 yuv,hugin@frs.sourceforge.net:/home/frs/project/h/hu/hugin/hugin/hugin-2010.4_beta/
- Web based alternative (not reliable, outdated instructions may not work since SourceForge has made major changes in February 2010)
- log on to the SF file manager
- left-click to navigate to the appropriate subfolder (e.g. hugin -> hugin-2009.2)
- click on the icon next to the appropriate subfolder and in the context menu select "Uploads here" (or "New folder") if you need a new folder.
- click on "upload file"
- browse to the local file and let the upload begin.
- prepare a release notes text file (e.g. "hugin-2009.2.0.release_notes.txt") and upload it as well, to the same subfolder
- left-click on the release notes text file and click the checkbox "Release Note"
- left-click on the released file. If you want it to be the default download for a specific platform, click the appropriate checkbox
- in the "Release Notes" dropdown list, select the appropriate ones for this file
- note the SHA1 sum calculated by SF. Compare it with the one determined in step 8. If it is different, delete the uploaded file and try again.
12. Upload the tarball to Launchpad.
- Must be a member of the Hugin Developers Team on Launchpad.
- Strongly recommended: a GPG Key set up on Launchpad.
- Must have a pre-registered Series (see Release Plan above).
- Sign the tarball (if you have a GPG Key)
gpg -u ${GPGKEY} --armor --sign --detach-sig hugin-2011.0.0.tar.bz2
- Point your browser to https://launchpad.net/hugin/<SERIES>/+addrelease, e.g. https://launchpad.net/hugin/2011.0/+addrelease
- Select the milestone against which you are uploading in the drop down menu, or if there was no milestone yet create one on the fly
- Set the release date
- Copy the Release Notes and ChangeLog into the fields
- Hit "Register the release"
- Hit "Add download file" (max file size is 200MB)
- Enter short Description: Hugin 2010.0.0 release tarball
- Browse to the .tar.bz2 file
- Browse to the .tar.bz2.asc signature
- Set Content Type: code release tarball
- Hit "Upload"
13. Draft the release announcement.
- Extract the relevant ChangeLog section since the last release (look up the last release by tag or by revision number in `hg view`, then issue a command `hg log -r <REV_OF_PREV_RELEASE>: -b default --follow --style=changelog > relchange.txt
- Use the Mercurial Tag noted earlier.
- Use the SHA1SUM noted earlier.
14. Mail the announcement to hugin-ptx.
15. Clear the bug tracker. Go over the reports identified as fix committed and change their status to fix released.
16. Wait for feedback and fixes. Volunteers may fix critical bugs. Test that the codeline builds on the major supported platforms. Test that no major functionality is broken. Repeats steps 1-13 as often as necessary.
17. Once the codeline is final, port relevant "polish" commits that have not been ported yet to default.
18. Later on if patches are required, apply them to the branch. Bump up V_PATCH in ./CMakeLists.txt and HUGIN_VERSION_PATCH in ./mac/Version.xcconfig, tag, and release.
Declare a Release Final
- No tarball is to be released as final without being a release candidate (RC) first. If fixes are committed to the release codeline after the last RC, you have two options: either declare the current RC final and the issue a known issue; or release a new RC and wait again for it to be deemed of final quality. Make the decision by consensus on the mailing list.
- Once you've decided that the current release candidate is final, polish the release notes in /doc/releases/ and on the website in /releases/ (this should be a process along with the polishing of the release itself). This will be mostly just text shuffling as information important during the release cycle such as calls for translation is pushed down in the document in favor of information that is more important for daily use.
Mercurial Repository
- identify the revision number that was tagged as the last RC (the number before the semicolon in the list of tags produced by the first command below) and tag it with the final version number:
hg tags hg tag -r 5243 2011.0.0 hg push
- commit the release notes into doc/releases/ if you have not done so yet.
SourceForge
The following procedure can be done on the web or more conveniently in a shell.
Web interface:
- Log on to SourceForge's web interface.
- In the download folder for the current release cycle, delete all betas and rc except the last one (hit the hash sign button if on the web interface)
- Rename the last RC files, e.g. hugin-2010.4.0.tar.bz2
- Rename the folder for the current release cycle to a final folder name
Shell:
ssh -t USER,PROJECT@shell.sourceforge.net create cd /home/frs/project/h/hu/hugin/hugin mv hugin-2011.0_beta hugin-2011.0 cd hugin-2011.0 mv hugin-2011.0.0_rc2.tar.bz2 hugin-2011.0.0.tar.bz2 rm *beta* rm *rc* # beware of this command, it may also delete some rc binaries you don't want to delete exit
Rename a text document with the release notes README and upload it
cd doc/releases/ cp hugin-2011.0.0.txt README rsync -e ssh README yuv,hugin@frs.sourceforge.net:/home/frs/project/h/hu/hugin/hugin/hugin-2011.0/ rm README
Must be done on the web interface:
- Hit the circle symbol with the i on the line listing the download to show details
- for the README file, tick the Exclude Stats box
- for the tarball tick the Default Download boxes for all systems except Windows and Mac
- for Windows or Mac binaries, tick the appropriate Default Download box. (Issue: no discrimination of 32/64 bits -> use the 32 bits)
- Paste the announcement into the SourceForge news system. You need to be a 'News Editor' to do this. Log on to https://sourceforge.net/news/submit.php?group_id=77506 and paste the announcement. Note: we have not been using SF's news for at least a year.
Launchpad
- If you have not kept a copy of the last release candidate and its signature that were uploaded to Launchpad on release of the last release candidate:
- Point your browser to the last release candidate on Launchpad, e.g. https://launchpad.net/hugin/+milestone/2011.0rc1
- Download the last release candidate e.g. http://launchpad.net/hugin/2011.0/2011.0rc1/+download/hugin-2011.0.0_rc1.tar.bz2
- Download the last signature e.g. http://launchpad.net/hugin/2011.0/2011.0rc1/+download/hugin-2011.0.0_rc1.tar.bz2.asc
- Point your browser to https://launchpad.net/hugin/<SERIES>/+addrelease, e.g. https://launchpad.net/hugin/2011.0/+addrelease
- Select the milestone against which you are uploading in the drop down menu, or if there was no milestone yet create one on the fly
- Set the release date
- Copy the Release Notes and ChangeLog into the fields
- Hit "Register the release"
- Hit "Add download file" (max file size is 200MB)
- Enter short Description: Hugin 2011.0.0 release tarball
- Browse to the .tar.bz2 file
- Browse to the .tar.bz2.asc signature
- Set Content Type: code release tarball
- Hit "Upload"
Public Announcement
- update Hugin homepage with link to the new release notes
- mail the announcement to Hugin-PTX (subscription required).
- mail the announcement to CREATE (subscription required).
Testing
- There is only so much testing that can be done with our limited resources.
- Final releases are expected to build and work on the major supported platforms, however it is possible that a bug slips in due to lack of resources / systematic testing
- We may issue patch releases in case of security issues or other major issues reported after final release.
Distribution
- The Hugin project releases source code that is tested to build on the main supported platforms: Fedora, Ubuntu, Windows, OSX. It works on the developers machines. YMMV.
- Building and distributing binaries is left to the users communities. Once there are binaries of appropriate quality level for platforms that do not have a package manager (Windows and OSX) we add them as a courtesy to the SourceForge download archive - as usual "WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE." See the GNU General Public License for more details.
Download Test Build
Users publish test builds in different places of their choosing. Refer to hugin-ptx for the latest information.
- Ubuntu: when there are changes in the repository and when the latest revision builds, an automated nightly is produced every 24 hours for the Hugin PPA. Add it to your system with:
sudo add-apt-repository ppa:hugin/hugin-builds sudo add-apt-repository ppa:hugin/nightly sudo apt-get update sudo apt-get install hugin enblend
- OSX: from time to time bleeding edge bundles are updated on Harry van der Wolf's site.
Build your Own Test Builds
If you are ready to go through the building process, here are the instructions.
IMPORTANT: | These builds are for your computer. If you decide to share them with others, be aware that you are subject to the GPL, and that the general public may need guidance regarding what you distribute. Read the information in the packaging and distribution section below. If you are unsure, ask on the hugin-ptx mailing list for advice before posting a file for download. |
---|
Goal
An infrastructure for on-demand build and distribution of usable test-binaries for the most popular platforms. Ideally on demand, and synchronized with the project's major milestones and releases. But also builds for personal use.
Process
- The build process for Hugin and related tools is documented for each of the supported platform.
- Users reproduce the documented process and report success or failure.
- Experienced users and/or developers follow up on the reports and keep the documentation current.
- Power users script and automate the building process.
- Users with packaging skills package the builds for distribution (installers).
- The produced binaries/installers will be made available via the package distribution tools of well managed O/S; and/or on the web.
Specific revisions
When building from the repository, some revisions may be broken. This process is meant to build the latest revision so that if the latest revision has bugs these can be identified, reported and corrected. However sometimes these bugs can be more critical than other times. If you need a more or less working version of Hugin, try applying the process to an earlier revision or to a released branch. To stay on top of all changes, consult the revision logs and the discussions on the hugin-ptx mailing list.
Supported Platforms
- If you don't find your preferred platform listed below and you are willing to contribute your time and skills to build Hugin on it, feel free to add it to the table. We will accommodate any well supported platform in the regular release process.
- Redundancy is good. If you have access to one of the listed platforms, please try to run the documented process below and report success to hugin-ptx.
Platform |
Supported Versions |
Status |
Process |
Credits |
---|---|---|---|---|
Ubuntu |
32bit/64bit |
tbd |
| |
Debian |
The Hugin Packagers Team for Debian can be reached at hugin at packages.debian.org. Liaise with them if there are issues with the binaries in Debian (and downstream distributions like Ubuntu) and on backports.org. |
| ||
Fedora |
32bit/64bit/ppc/ppc64 |
tbd |
| |
OSX |
IntelMac/PowerPC |
tbd |
| |
Windows |
32bit/64bit |
tbd |
|
|
OpenSuse |
32bit/64bit |
tbd |
| |
FreeBSD |
32bit/64bit |
n/a |
| |
Gentoo Linux |
32bit |
tbd |
| |
all platforms |
a big thank you to Pablo d'Angelo for supporting all of those building efforts. |
Stati
Build Chain
- tbd: looking for responsible
- OK: mostly automated build process ready on request
- unavailable: temporarily unavailable (e.g. responsible on holiday)
- HW-broken: the hardware is temporarily unavailable
- SW-broken: temporarily dysfunctional, working on a fix
- broken: nobody is working on a fix
- unsupported: has been dropped for lack of support
Process
- tbd: status unknown
- auto: work as documented and has been automated to a reasonable extent
- OK: works as documented, could use automation / scripting
- draft: documented, needs validation / testing / cleaning
- incomplete: parts are missing (e.g. enblend, libpano)
- outdated: worked in the past but needs an update
- obsolete: nobody has the time to update
Dependencies
Hugin is work in progress and dependencies can be added any time. If your build does not work, see Fixing The Hugin Build.
Hugin depends on the following packages. The list may be incomplete, and there may be some platform-specific dependencies. Details for specific platforms are in the platform documents linked above.
Build-Time Dependencies
Users compiling Hugin (version 2016.1 and later) from source will need:
- A C++ compiler which supports OpenMP and C++11
- OpenMP support is not required. But when compiling without OpenMP nona and cpfind (and some other algorithm) are running only with one thread, which is slower.
- The wxWidgets GUI toolkit version >=2.7.0. the 3.x series is supported.
- std::filesystem from C++17 or boost::filesystem (Boost >= 1.47)
- libzlib the zlib compression library.
- libtiff the TIFF library with LZW support.
- libpano13 version >=2.9.19
- libjpg the JPEG library
- libpng the PNG library
- libopenexr the OpenEXR library
- vigra the VIGRA Computer Vision Library >=1.9
- Exiv2 Image metadata library
- GLEW the OpenGL Extension Wrangler Library or libepoxy library for handling OpenGL function pointer management (since 2023.0, see file INSTALL_cmake for more details)
- gettext
- optionally, libfftw3
- On Unix/Linux you need also
- On Windows you need also
- HTML Help Workshop for generating compiled HTML help file
- optional WiX toolset to create the installer
- On MacOS you need also
- for the optional Python Scripting Interface (currently functional and tested only on Linux and Windows)
- Hugin can be compiled with gcc, as well as with MSVC.
- The build process requires CMake version >=3.1
Run-Time Dependencies
At runtime
- enblend >= 3.2 is required.
- Exiftool >=9.09 is required.
- Starting with Hugin 2010.3 and newer, Hugin ships with its own control points generator cpfind. Prior to 2010.3 another optional but recommended runtime dependency was a control points generator.
- Optionally Python argparse command-line parsing library for the Python scripts.
Packaging and Distribution
Instructions for packaging binaries for distribution will follow. Some important points:
Snapshots
- comply with the GPL
- join a text of the GPL in the distribution
- give access to the source code
- credit the authors
- label clearly the snapshot as such, with a reference to the build date and/or the SVN revision number
- edit the text / readme files that come with the snapshot
- indicate clearly that it is unstable, experimental software
- indicate where to find the latest version
- indicate that the advertised features might or might not work
Release
- comply with the GPL
- join a text of the GPL in the distribution
- give access to the source code
- credit the authors
Feedback
When running through the building process documented above chances are that something goes wrong. While it is disappointing when the process ends in a flurry of cryptic error messages it is not harmful. This is the nature of software development and you are now part of it. There is a lot of value in your experience and you can help improve the process and get closer to the hoped for software package. Don't be ashamed that it did not work. This happens even to the most expert coders. Give the developers feedback on the hugin-ptx mailing list. Only with your feedback they can know that something goes wrong, and a well crafted feedback is the most important step to help identify what went wrong and devise a solution. Be a part of the solution, not a part of the problem!
To give good feedback, note down carefully all of this information while you are going through the instructions.
- Details about your computer. CPU, operating system, other particularities
- The revision number of the code checked out with Mercurial (`hg sum`). If you don't find a revision number, the date and time when you checked out the code.
- The last step / command you entered into the command line.
- A copy of the last few lines displayed, from where you think the error messages started. Don't worry if you copy a couple of lines too many, it is better to give more lines than less lines.
Even the standard feedback is good feedback. For those wishing to dig deeper, you can try
- to use "make VERBOSE=1" when building hugin.
- to do a debug build "cmake -DCMAKE_BUILD_TYPE=DEBUG" and use oprofile for profiling.