=head1 NAME
-dh_builddeb - build debian binary packages
+dh_builddeb - build Debian binary packages
=cut
=head1 DESCRIPTION
-dh_builddeb simply calls L<dpkg-deb(1)> to build a debian package or
+B<dh_builddeb> simply calls L<dpkg-deb(1)> to build a Debian package or
packages.
=head1 OPTIONS
=item B<--destdir=>I<directory>
-Use this if you want the generated .deb files to be put in a directory
-other than the default of ".."
+Use this if you want the generated F<.deb> files to be put in a directory
+other than the default of "F<..>".
=item B<--filename=>I<name>
Use this if you want to force the generated .deb file to have a particular
file name. Does not work well if more than one .deb is generated!
-=item B<-u>I<params>
-
=item B<--> I<params>
Pass I<params> to L<dpkg-deb(1)> when it is used to build the
package.
+=item B<-u>I<params>
+
+This is another way to pass I<params> to L<dpkg-deb(1)>.
+It is deprecated; use B<--> instead.
+
=back
=cut