WineHQ

Stable Rules: Difference between revisions

(Migrated from the old wiki)
 
(switch link to https)
(7 intermediate revisions by 2 users not shown)
Line 5: Line 5:
== Scope of this Page ==
== Scope of this Page ==
These rules are valid for:
These rules are valid for:
* Wine stable versions 1.8.x
* Wine stable versions 1.8.x, 2.0.x
* Stable maintainer: Michael Stefaniuc [[MailTo(mstefani AT SPAMFREE winehq DOT org)]]
* Stable maintainer: Michael Stefaniuc [[MailTo(mstefani AT SPAMFREE winehq DOT org)]]


== Acceptable Patches for Wine Stable ==
== Acceptable Patches for Wine Stable ==
Rules for patches going into Wine Stable:
Rules for patches going into Wine Stable:
* It must be first accepted in the Development version (in exceptional cases it can come via Staging).
* It must be first accepted in the Development version (in exceptional cases it can come via Staging).
* It must be tested (in 1-2 released Development or Staging versions).
* It must be tested (in 1-2 released Development or Staging versions).
* It should be small.
* It should be small.
* It must fix a real bug in a real application.
* It must fix a real bug in a real application.
* Stubs must get an application to run (not to just crash later) and need a longer testing period in the wild.
* Stubs must get an application to run (not to just crash later) and need a longer testing period in the wild.
* It must fix a build issue, especially on distributions using Wine Stable.
* It must fix a build issue, especially on distributions using Wine Stable.
* Translation updates are in scope too.
* Translation updates are in scope too.


== Submitting Patches for Wine Stable ==
== Submitting Patches for Wine Stable ==
To mark a patch for inclusion into Stable you can choose between the following methods:
To mark a patch for inclusion into Stable you can choose between the following methods:
* Set the [https://bugs.winehq.org/buglist.cgi?bug_status=RESOLVED&bug_status=CLOSED&known_name=1.8.x&list_id=273067&product=Wine&query_based_on=1.8.x&query_format=advanced&resolution=FIXED&target_milestone=1.8.x "Target Milestone" to 1.8.x] for a bug in bugzilla.
* Set the [https://bugs.winehq.org/buglist.cgi?bug_status=RESOLVED&bug_status=CLOSED&list_id=273067&product=Wine&query_format=advanced&resolution=FIXED&target_milestone=2.0.x "Target Milestone" to 2.0.x] for a bug in bugzilla.
* Or send the Stable maintainer an email with a list of commit IDs to cherry pick.
* Or send the Stable maintainer an email with a list of commit IDs to cherry pick.
* Add a comment ( /!\ Should we formalize a tag for that??) to the patch when submitting it to wine-patches.
* Add a comment ('''FIXME:''' Should we formalize a tag for that??) to the patch when submitting it to wine-patches.


== Accepted / Queued Patches ==
== Accepted / Queued Patches ==
A list of accepted and queued patches for Wine Stable can be found on https://github.com/mstefani/wine-stable
Here is the list of [https://static-winehq.193b.starter-ca-central-1.openshiftapps.com/stable/ accepted and queued patches] for Wine Stable.
 
Or in raw format in git on https://github.com/mstefani/wine-stable


Branches:
Branches:
;stable
;stable
: Accepted patches that will be in the next wine-1.8.x
: Accepted patches that will be in the next wine-2.0.x
;queue
;queue
: Queued patches for stable
: Queued patches for stable
: <!> This branch is always '''rebased''' on top of stable
: '''Warning:''' This branch is always '''rebased''' on top of stable


Additional information is kept with git notes in '''stable-notes'''. Github doesn't shows any notes so those need to be accessed via git:
Additional information is kept with git notes in '''stable-notes'''. Github doesn't shows any notes so those need to be accessed via git:

Revision as of 18:35, 18 October 2017

Wine Stable's mantra is to not break currently running applications.
Regressions are a priority to fix and new regressions should not be added.
Thus a patch that fixes ten applications but breaks one application is a bad patch for Stable.

Scope of this Page

These rules are valid for:

Acceptable Patches for Wine Stable

Rules for patches going into Wine Stable:

  • It must be first accepted in the Development version (in exceptional cases it can come via Staging).
  • It must be tested (in 1-2 released Development or Staging versions).
  • It should be small.
  • It must fix a real bug in a real application.
  • Stubs must get an application to run (not to just crash later) and need a longer testing period in the wild.
  • It must fix a build issue, especially on distributions using Wine Stable.
  • Translation updates are in scope too.

Submitting Patches for Wine Stable

To mark a patch for inclusion into Stable you can choose between the following methods:

  • Set the "Target Milestone" to 2.0.x for a bug in bugzilla.
  • Or send the Stable maintainer an email with a list of commit IDs to cherry pick.
  • Add a comment (FIXME: Should we formalize a tag for that??) to the patch when submitting it to wine-patches.

Accepted / Queued Patches

Here is the list of accepted and queued patches for Wine Stable.

Or in raw format in git on https://github.com/mstefani/wine-stable

Branches:

stable
Accepted patches that will be in the next wine-2.0.x
queue
Queued patches for stable
Warning: This branch is always rebased on top of stable

Additional information is kept with git notes in stable-notes. Github doesn't shows any notes so those need to be accessed via git:

git pull <stable-remote> refs/notes/stable-notes
export GIT_NOTES_REF=refs/notes/stable-notes
git log
git show
This page was last edited on 18 October 2017, at 18:35.