README.contrib: document that short lines are preferred. (#278267)

[developers-reference.git] / pkgs.dbk

diff --git a/pkgs.dbk b/pkgs.dbk
index 868157d0d4504da7b2975c883cb79a42d068f628..15cb2f00a91c4a4e68fed3a9234b0a285972abfe 100644 (file)
--- a/pkgs.dbk
+++ b/pkgs.dbk
@@ -373,7 +373,8 @@ and dsc-file) with anonymous ftp to <literal>&ftp-master-host;</literal> in
 the directory <ulink
 url="ftp://&ftp-master-host;&upload-queue;">&upload-queue;</ulink>.
 To get the files processed there, they need to be signed with a key in the
-debian keyring.
+Debian Developers keyring or the Debian Maintainers keyring
+(see <ulink url="&url-wiki-dm;"></ulink>).
 </para>
 <para>
 Please note that you should transfer the changes file last.  Otherwise, your
@@ -2095,7 +2096,9 @@ co-maintainers.
 Generally there is a primary maintainer and one or more co-maintainers.  The
 primary maintainer is the person whose name is listed in the
 <literal>Maintainer</literal> field of the <filename>debian/control</filename>
-file.  Co-maintainers are all the other maintainers.
+file.  Co-maintainers are all the other maintainers,
+usually listed in the <literal>Uploaders</literal> field of the
+<filename>debian/control</filename> file.
 </para>
 <para>
 In its most basic form, the process of adding a new co-maintainer is quite
@@ -2113,7 +2116,7 @@ such as <command>CVS</command> or <command>Subversion</command>.  Alioth (see
 <listitem>
 <para>
 Add the co-maintainer's correct maintainer name and address to the
-<literal>Uploaders</literal> field in the global part of the
+<literal>Uploaders</literal> field in the first paragraph of the
 <filename>debian/control</filename> file.
 </para>
 <screen>