/[ddp]/manuals/trunk/maint-guide/maint-guide.en.dbk

Diff of /manuals/trunk/maint-guide/maint-guide.en.dbk

Parent Directory | Revision Log | View Patch Patch

-revision 8621 by osamu,
Sun Apr  3 16:16:49 2011 UTC
+revision 8623 by osamu,
Sun Apr  3 16:26:56 2011 UTC
 Line 539 
 least some of the documentation before a
  When you receive a bug report (yes, actual bug reports!), you will know that it
  is time for you to dig into the <ulink url="http://www.debian.org/Bugs/">Debian
  Bug Tracking System</ulink> and read the documentation there, to be able to
- deal with the reports efficiently.  I highly recommend reading the <ulink url="http://www.debian.org/doc/manuals/developers-reference/pkgs.html#bug-handling">Developer's
+ deal with the reports efficiently.  I highly recommend reading the <ulink url="&bughandling;">Debian Developer's
  Reference, 5.8.  'Handling bugs'</ulink>.
  </para>
  <para>
 Line 2800 
 $ echo 7 &gt; debian/compat
  <para>
  One of the most annoying things about software is when you spend a great deal
  of time and effort customizing a program, only to have an upgrade stomp all
- over your changes.  Debian solves this problem by marking configuration files
+ over your changes.  Debian solves this problem by marking such configuration files as conffiles.
- so that when you upgrade a package, you'll be prompted whether you want to keep
+ <footnote><para>See <citerefentry> <refentrytitle>dpkg</refentrytitle>
- your old configuration or not.
+ <manvolnum>1</manvolnum> </citerefentry> and
+ <ulink url="http://www.debian.org/doc/debian-policy/ap-pkg-controlfields.html#s-pkg-f-Conffiles">Debian Policy Manual 'D.2.5 Conffiles'</ulink>.
+ </para></footnote>
+ When you upgrade a package, you'll be prompted whether you want to keep
+ your old configuration files or not.
  </para>
  <para>
  Since <systemitem role="package">debhelper</systemitem> V3, <citerefentry>
-Line 2912 
 directories created first.  See <xref li
+Line 2916 
 directories created first.  See <xref li
  </para>
  <para>
  It is best to first try to run the installation first and only use this if you
- run into trouble.  There is no preceding slash on the directory names.
+ run into trouble.  There is no preceding slash on the directory names listed in
+ the <filename>dirs</filename> file.
  </para>
  </section>
  <section id="doc-base"><title><filename><replaceable>package</replaceable>.doc-base</filename> file</title>
-Line 3627 
 create and sign the upload <filename>.ch
+Line 3632 
 create and sign the upload <filename>.ch
  <para>
  The only input that will be required of you is your GPG secret pass phrase,
  twice.
+ <footnote><para>
+ This GPG key must be signed by the Debian developer to get connected to the web
+ of trust.  This enables your uploaded packages to be accepted to the Debian
+ archives.  See
+ <ulink url="http://wiki.debian.org/Keysigning ">Debian Wiki on Keysigning</ulink>.
+ </para></footnote>
  </para>
  <para>
  After all this is done, you will see the following files in the directory above
-Line 3803 
 packages in the <literal>Build-Depends</
+Line 3814 
 packages in the <literal>Build-Depends</
  <section id="option-sa"><title>Including <filename>orig.tar.gz</filename> for upload</title>
  <para>
  When you first upload the package to the archive, you need to include the
- original <filename>orig.tar.gz</filename> source.  If the last changelog entry
+ original <filename>orig.tar.gz</filename> source, too.  If the Debian revision
- is not the first one for the given upstream version, you must provide
+ number of such package is neither <literal>1</literal> nor
- <command>dpkg-buildpackage</command> command with the <literal>-sa</literal>
+ <literal>0</literal>, you must provide <command>dpkg-buildpackage</command>
- option.  On the other hand, the <literal>-sd</literal> option will force to
+ command with the <literal>-sa</literal> option.  On the other hand, the
- exclude the original <filename>orig.tar.gz</filename> source.
+ <literal>-sd</literal> option will force to exclude the original
+ <filename>orig.tar.gz</filename> source.
  </para>
  </section>
  <section id="debuild"><title><command>debuild</command> command</title>
-Line 3864 
 documentation.  </para> </footnote> This
+Line 3876 
 documentation.  </para> </footnote> This
  under the <literal>sid</literal> auto-builder for different architectures and
  avoids the severity serious FTBFS (Fails To Build From Source) bug which is
  always in the RC (release critical) category.  See <ulink url="&buildd-home;">&buildd-home;</ulink> for more on the Debian
- package auto-builder.
+ package <systemitem role="package">auto-builder</systemitem>.
  </para>
  <para>
  Let's customize the <systemitem role="package">pbuilder</systemitem> package by
-Line 4295 
 old <literal>1.0</literal> source format
+Line 4307 
 old <literal>1.0</literal> source format
  $ interdiff -z <replaceable>old-package</replaceable>.diff.gz <replaceable>new-package</replaceable>.diff.gz
  </screen>
  </section>
+ <section id="tardiff"><title><command>tar</command> command with <literal>--diff</literal> option</title>
+ <para>
+ You can compare two <filename>tar.gz</filename> files with the <citerefentry>
+ <refentrytitle>tar</refentrytitle> <manvolnum>1</manvolnum>
+ </citerefentry> command with <literal>--diff</literal> option.  This is useful for verifying that no inadvertent
+ changes were made to the source by the maintainer when updating packages in the
+ new <literal>3.0</literal> source format.
+ </para>
+ <screen>
+ $ tar --diff -z <replaceable>old-package</replaceable>.debian.tar.gz <replaceable>new-package</replaceable>.debian.tar.gz
+ </screen>
+ </section>
  <section id="mc"><title><command>mc</command> command</title>
  <para>
  Many of these file inspection operations can be made into an intuitive process
-Line 4346 
 these options means.
+Line 4370 
 these options means.
  The <literal>$default_host</literal> option determines which of the upload
  queues will be used by default.  <literal>anonymous-ftp-master</literal> is the
  primary one, but it's possible that you will want to use another one.
+ <footnote><para>See <ulink url="&uploading;">Debian Developer's Reference 5.6. 'Uploading a package'</ulink>.</para></footnote>
  </para>
  <para>
  While connected to the Internet, you can upload your package by the following:
-Line 4386 
 Z4jxNrgh7Bc=
+Line 4411 
 Z4jxNrgh7Bc=
  -----END PGP SIGNATURE-----
  </screen>
  <para>
- See <ulink url="http://mentors.debian.net/cgi-bin/welcome">mentors.debian.net</ulink> for
+ See <ulink url="&mentorsdebiannet;">mentors.debian.net</ulink> for
  publically accessible upload area for non-DD.
  </para>
  <para>
-Line 4582 
 Update the Debian <filename>changelog</f
+Line 4607 
 Update the Debian <filename>changelog</f
  <itemizedlist>
  <listitem>
  <para>
- Add an entry with New upstream release.
+ Add an entry with "<literal>New upstream release</literal>".
  </para>
  </listitem>
  <listitem>
  <para>
  Describe concisely the changes <emphasis>in the new upstream release</emphasis>
- that fix reported bugs and close those bugs.
+ that fix reported bugs and close those bugs by adding "<literal>Closes: #<replaceable>bug_number</replaceable></literal>".
  </para>
  </listitem>
  <listitem>
  <para>
  Describe concisely the changes <emphasis>to the new upstream release</emphasis>
- by the maintainer that fix reported bugs and close those bugs.
+ by the maintainer that fix reported bugs and close those bugs by adding "<literal>Closes: #<replaceable>bug_number</replaceable></literal>".
  </para>
  </listitem>
  </itemizedlist>

 Legend:



Removed from v.8621
 


changed lines


 
Added in v.8623
 Legend:



Removed from v.8621
 


changed lines


 
Added in v.8623
-Removed from v.8621
+Added in v.8623

	ViewVC Help
Powered by ViewVC 1.1.5