SyncRequestProcess

Differences between revisions 12 and 15 (spanning 3 versions)
Revision 12 as of 2007-09-15 17:07:42
Size: 3880
Editor: cpe-76-87-163-235
Comment: use correct name for package containing /usr/bin/requestsync
Revision 15 as of 2007-11-02 21:18:09
Size: 4997
Editor: host203-61-dynamic
Comment: expanded the requestsync script paragraph (mainly from the man page)
Deletions are marked like this. Additions are marked like this.
Line 33: Line 33:
 * Martin Pitt has written a script to file sync requests which is available in the ubuntu-dev-tools package. == requestsync ==
Line 35: Line 35:
Please note that if you are not in ~ubuntu-dev, you will need to change (in /usr/bin/requestsync): Martin Pitt and Steve Kowalik have written '''requestsync''', a script to file sync requests which is available in the [https://launchpad.net/ubuntu/+source/ubuntu-dev-tools ubuntu-dev-tools] package.
Line 37: Line 37:
{{{report += ''' affects ubuntu/%s subscribe ubuntu-archive}}} '''requestsync''' looks at the versions of the source package in Debian and Ubuntu, prompts for an explanation of why the Ubuntu changes (if there are any) should be dropped, downloads the changelog entry from packages.debian.org, and then prompts for your GPG passphrase so it can sign the mail and send it off, which files a sync request in the form of a bug report in Launchpad.
Line 39: Line 39:
to The syntax to call the script is:
Line 41: Line 41:
{{{report += ''' affects ubuntu/%s subscribe ubuntu-universe-sponsors}}} {{{ requestsync [-n|-s] <source package> <target release> [base version] }}}
Line 43: Line 43:
as you need a sponsor for sync requests, else the archive admins will not process the request. Where:
Line 45: Line 45:
If you are in gutsy, and not in ~ubuntu-dev, you will need to use the '-s' option when running requestsync. -n
Line 47: Line 47:
 * The list of outstanding archive administration requests can be found here: https://launchpad.net/~ubuntu-archive/+subscribedbugs Specifies that the package is a new package, and requestsync should not attempt to look it up in Ubuntu since it will not exist.

-s

Specifies that you require sponsorship. You need this option if you are not a member of ubuntu-dev for universe or multiverse, or ubuntu-core-dev for main or restricted.

<source package>

This is the source package that you would like to be synced from Debian.

<target release>

This is the release that you would like the source package to be synced into. This should always be the latest development release of Ubuntu.

[base version]

In some cases, the base version (where the Ubuntu package started differing from the Debian package) can not be automatically determined. Specify this option in this case.


== sync bug list ==

Before submitting a sync request, please check that a similar request has not been filed already. You can see all bugs to which the archive-admins have been subscribed [https://bugs.launchpad.net/~ubuntu-archive/+bugs here].

----
CategoryProcess

Before requesting a sync

Syncs (like uploads) cannot be reversed or undone. ALWAYS thoroughly check a package before asking for a sync. In particular, if there are Ubuntu changes in the current package, you must ensure the Ubuntu changes have been merged or are no longer relevant.

After UpstreamVersionFreeze, syncs of a newer upstream version require a [:UbuntuDevelopment#Freezes:freeze exception].

You should always sync a package rather than upload the unmodified source by hand, as it is safer and more accurate. If you know you will upload modified source immediately, modify the package and make an -<n>ubuntu<n> upload rather than requesting a sync. However, be sure to always use the exact same .orig.tar.gz as Debian (or whomever).

After DebianImportFreeze, it's a good idea to review the Debian changes to make sure that the fixes will improve Ubuntu: some changes (maintainer change, new uploader, NMU acknowledgement with no additional fixes, etc.) may be better left for the next cycle.

Packages can be synced from any Debian-format package archive, i.e. something with a Sources file.

Content of a sync request

When requesting a 'sync', please include the following information:

  • Source package name
  • Source package version number to sync
  • Where to sync from (e.g. 'Debian sid main', 'Debian experimental non-free')
  • If there are Ubuntu changes apart from debian/changelog or if UpstreamVersionFreeze is in effect:

    • A copy of the entries from debian/changelog corresponding to the changes relative to the current version in Ubuntu
  • If there are Ubuntu changes:
    • a description of each of the Ubuntu changes (a bullet point list is fine, but copies of debian/changelog aren't)
    • a brief explanation of why each one may be dropped (e.g., it's been merged into Debian, is no longer appropriate, etc.)
    • an explicit confirmation that the Ubuntu changes should be overridden

Submitting your request

To request a sync, [https://launchpad.net/ubuntu/+filebug file a bug in Launchpad] with the above information. Once the bug is complete and correct, if you are not an Ubuntu developer, subscribe (NOT assign) ubuntu-main-sponsors for packages in Main/Restricted and ubuntu-universe-sponsors for packages in Universe/Multiverse. They will review the request and subscribe ubuntu-archive. Ubuntu developers should subscribe (NOT assign) the ubuntu-archive team to the bug directly. This team will process the request and close the bug when it is complete. Please only subscribe ubuntu-archive to a bug once you have a clear action for the archive team to perform. Do not ask ubuntu-archive to help you decide what to do.

Do not change the Status of the bug as package sponsors and the archive administrators use this field. Do track the status of the sync. You will be notified via bug mail when the package has been published. Once you see (in Launchpad) that the updated packaged has been successfully built, if the archive admin has not, then you may mark the bug Status as 'Fix Released' (primarily for Universe/Multiverse).

requestsync

Martin Pitt and Steve Kowalik have written requestsync, a script to file sync requests which is available in the [https://launchpad.net/ubuntu/+source/ubuntu-dev-tools ubuntu-dev-tools] package.

requestsync looks at the versions of the source package in Debian and Ubuntu, prompts for an explanation of why the Ubuntu changes (if there are any) should be dropped, downloads the changelog entry from packages.debian.org, and then prompts for your GPG passphrase so it can sign the mail and send it off, which files a sync request in the form of a bug report in Launchpad.

The syntax to call the script is:

 requestsync [-n|-s] <source package> <target release> [base version] 

Where:

-n

Specifies that the package is a new package, and requestsync should not attempt to look it up in Ubuntu since it will not exist.

-s

Specifies that you require sponsorship. You need this option if you are not a member of ubuntu-dev for universe or multiverse, or ubuntu-core-dev for main or restricted.

<source package>

This is the source package that you would like to be synced from Debian.

<target release>

This is the release that you would like the source package to be synced into. This should always be the latest development release of Ubuntu.

[base version]

In some cases, the base version (where the Ubuntu package started differing from the Debian package) can not be automatically determined. Specify this option in this case.

sync bug list

Before submitting a sync request, please check that a similar request has not been filed already. You can see all bugs to which the archive-admins have been subscribed [https://bugs.launchpad.net/~ubuntu-archive/+bugs here].


CategoryProcess

SyncRequestProcess (last edited 2012-01-23 12:20:22 by mitya57)