<refentry id="svn-upgrade">
      <refentryinfo>
        <address>
          <email>blade@debian.org</email>
          </address>
        <address>
          &dhemail;
        </address>
        <author>
          <firstname>Eduard</firstname>
          <surname>Bloch</surname>
          <contrib>This manual page was written by Eduard Bloch in roff.
          </contrib>
        </author>
        <author>
          <firstname>Goneri</firstname>
          <surname>Le Bouder</surname>
          <contrib>Converted manpages to SGML.</contrib>
        </author>
        <author>
          &dhfirstname;
          &dhsurname;
          <contrib>Converted manpages to DocBook XML and current Debian maintainer
          </contrib>
        </author>
        <copyright>
          <year>2009</year>
          <holder>&dhusername;</holder>
        </copyright>
        &dhdate;
      </refentryinfo>
  <refmeta>
    <refentrytitle>&upgradepackage;</refentrytitle>

    &dhsection;
  </refmeta>
  <refnamediv>
    <refname>&upgradepackage;</refname>

    <refpurpose>upgrade source package from a new upstream revision</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>&upgradepackage; newsource [options]</command>

    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPTION</title>

    <para><command>&upgradepackage;</command> modifies a Debian package
    source located in a Subversion repository, upgrading it to a new
    upstream release. The repository filesystem tree must be in the format
    created by <command>svn-inject</command>.</para>

  </refsect1>
  <refsect1>
    <title>OPTIONS</title>

    <para><command>&upgradepackage;</command> accepts the following
    options on the command-line:</para>

    <variablelist>

      <varlistentry>
        <term>
            <option>-V STRING</option> |
            <option>--version STRING</option>
        </term>
        <listitem>
          <para>Forces a different upstream version string</para>
          <para>Default: Off.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
            <option>-c</option> |
            <option>--clean</option>
        </term>
        <listitem>
          <para>Runs <option>make clean</option> and removes
          the <filename>debian/</filename> directory in the
          new source.</para>
          <para>Default: Off.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
            <option>-P STRING</option> |
            <option>--packagename STRING</option>
        </term>
        <listitem>
          <para>Forces a different package name</para>
          <para>Default: Off.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
            <option>-v</option> |
            <option>--verbose</option>
        </term>
        <listitem>
          <para>More verbose program output</para>
          <para>Default: Off.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
            <option>-r</option> |
            <option>--replay-conflicting</option>
        </term>
        <listitem>
         <para>Extra cleanup run: replaces all conflicting files with
         upstream versions. Review of <command>svn status</command>
         output before doing that could make sense.</para>
          <para>Default: Off.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
            <option>-N</option> |
            <option>--noautodch</option>
        </term>
        <listitem>
          <para>Upgrade without making a new changelog entry.</para>
          <para>Default: Make the changelog entry.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
            <option>-u</option> |
            <option>--uscan</option>
        </term>
        <listitem>
          <para>Use <command>uscan</command> to download the new version.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
            <option>--noninteractive</option>
        </term>
        <listitem>
          <para>Turn off interactive mode.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
            <option>--ignoreerrors</option>
        </term>
        <listitem>
          <para>In noninteractive mode, ignore errors.</para>
        </listitem>
      </varlistentry>

       <varlistentry>
        <term>
            <option>--ignored-files-action STRING</option>
        </term>
        <listitem>
          <para>Make files that are ignored due to subversion ignore
          patterns to be 'import'ed or 'skip'ed.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
            <option>-e</option> |
            <option>--auto-epoch</option>
        </term>
        <listitem>
          <para>Automatically increase version epoch if the new
          upstream version is not greater than the current.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
            <option>--debclean</option>
        </term>
        <listitem>
          <para>Run <command>debclean</command> before merging the new upstream source.</para>
        </listitem>
      </varlistentry>

   <para>
    Tarballs must be compressed with <command>gzip</command> or <command>bzip2</command>.
    </para>

    </variablelist>

  </refsect1>

  <refsect1>
    <title>SEE ALSO</title>

    <variablelist>

      <varlistentry>
        <term>
          <citerefentry> <refentrytitle>/usr/share/doc/svn-buildpackage/</refentrytitle></citerefentry>

        </term>
        <listitem>
          <para>The svn-buildpackage HOWTO manual</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
          <citerefentry> <refentrytitle>svn</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>
        </term>
        <listitem>
          <para>Subversion command line client tool</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
          <citerefentry> <refentrytitle>svn-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>
        </term>
        <listitem>
          <para>build Debian packages from SVN repository</para>
        </listitem>
      </varlistentry>

    </variablelist>

  </refsect1>

</refentry>
