Provided by: ubuntu-dev-tools_0.158_all bug

NAME
       requestsync - helper to file sync requests for Ubuntu


SYNOPSIS
       requestsync  [-d  distro]  [-nse]  [-k  keyid] <source package> [target
       release] [base version]
       requestsync  --lp  [-nse]  <source  package>  <target  release>   [base
       version]
       requestsync -h


DESCRIPTION
       requestsync  looks  at  the  versions of <source package> in Debian and
       Ubuntu and prompts for an explanation of why  the  Ubuntu  changes  (if
       there  are  any)  should  be  dropped.   The  changelog  entry  is then
       downloaded from packages.debian.org, and the sync request bug is  filed
       in  launchpad.   Alternatively,  the  sync  request  can  be  filed  by
       GPG-signed email (option --email).

       requestsync checks if you have the permissions to request the sync from
       the  archive  administrators  directly  by  checking if you have upload
       permissions  for  that  package  through  package  set  permissions  or
       component permissions. If you don't have upload permissions, the script
       will subscribe the necessary team  with  approval  rights  to  the  bug
       report for you.

       This  check  is  only performed if requestsync is allowed to use the LP
       API (not email submission). In the other  case  requestsync  relies  on
       that  you  answer  the  question  about  upload permissions honestly to
       determine if a team with approval rights is to  be  subscribed  to  the
       bug.

       If  you  have  permission  to upload the package directly, then you may
       prefer to use  syncpackage  instead  to  copy  the  package  using  the
       Launchpad  API. At some future point, requestsync will be changed to do
       this automatically.

       requestsync uses launchpadlib authentication to file its requests.


OPTIONS
       Listed below are the command line options for requestsync:

       -h     Display a help message and exit.

       -d     Specifies which Debian distribution a package should  be  synced
              from.  Default is unstable.

       -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.

       -k <keyid>
              Specifies  your  GPG key.  This is only used if the sync request
              is mailed to Launchpad.

       --email
              Use GPG-signed email to file the bug, rather than launchpadlib.

       -s     Specifies that you require sponsorship.  You need this option if
              you  don't  have  upload  permissions  for  that  package.  This
              disables the upload permissions check described above.

       -C     Allow  changelog  to  be  manually  filled  in   when   missing.
              requestsync  gets  Debian  changelogs  from packages.debian.org,
              which isn't in sync with the Debian archive.  To request a  sync
              before the changelog is available, pass this option, and provide
              the changelog entries yourself.

       -e     Use  this  flag  after  FeatureFreeze  for  non-bug  fix  syncs.
              requestsync   will  subscribe  ubuntu-release  team  instead  of
              sponsorship team.

       -l INSTANCE, --lpinstance=INSTANCE
              Use  the  specified  instance  of  Launchpad  (e.g.  "staging"),
              instead of the default of "production".

       --no-conf
              Do  not  read  any  configuration  files,  or configuration from
              environment variables.

       <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)   cannot   be
              automatically determined.  Specify this option in this case.


ENVIRONMENT
       requestsync  uses  the  following variables which should be set in your
       shell's configuration by adding export VARIABLE= lines, where  VARIABLE
       is one of the following:

       UBUMAIL, DEBEMAIL
              Specifies which email should be used when sending to Launchpad.

       All  of  the  CONFIGURATION  VARIABLES  below  are  also  supported  as
       environment variables.  Variables in the environment take precedence to
       those in configuration files.


CONFIGURATION VARIABLES
       REQUESTSYNC_SMTP_SERVER
              Set  which SMTP server to use when sending mail.  If unspecified
              this  defaults  to  launchpad's  SMTP  servers   (the   eventual
              destination).

       REQUESTSYNC_SMTP_PORT
              Sets which port of the SMTP server to use. Default is 25.

       REQUESTSYNC_SMTP_USER and REQUESTSYNC_SMTP_PASS
              Sets the username and password to use when authenticating to the
              SMTP server.

       REQUESTSYNC_USE_LPAPI
              Setting this to no is equivalent to running with --email.

       REQUESTSYNC_LPINSTANCE, UBUNTUTOOLS_LPINSTANCE
              The default value for --lpinstance.

       REQUESTSYNC_KEYID, UBUNTUTOOLS_KEYID
              The default value for -k.


SEE ALSO
       rmadison(1), syncpackage(1), ubuntu-dev-tools(5)


AUTHOR
       requestsync and this manual page were written by the Ubuntu MOTU Team.

       Both are released under the GNU General Public License, version 2.