chiark / gitweb /
Fix several typesetting errors and typos noticed by Sandro Tosi,
[developers-reference.git] / beyond-pkging.dbk
index 0d27668977c723d4f15da1cf50964b05fa1f119b..77a973947cfcc112422e07f2a00f22e2337108fc 100644 (file)
@@ -124,8 +124,8 @@ many problems as possible.  They are announced on
 &email-debian-devel-announce; and the announcement explains
 which area will be the focus of the party: usually they focus on release
 critical bugs but it may happen that they decide to help finish a major upgrade
-(like a new perl version which requires recompilation of all the binary
-modules).
+(like a new <command>perl</command> version which requires recompilation of all
+the binary modules).
 </para>
 <para>
 The rules for non-maintainer uploads differ during the parties because the
@@ -190,11 +190,11 @@ There is a simple system (the MIA database) in which information about
 maintainers who are deemed Missing In Action is recorded.  When a member of the
 QA group contacts an inactive maintainer or finds more information about one,
 this is recorded in the MIA database.  This system is available in
-/org/qa.debian.org/mia on the host qa.debian.org, and can be queried with a
-tool known as <command>mia-query</command>.  Use <command>mia-query --help</command>
-to see how to query the database.  If you find that no information has been
-recorded about an inactive maintainer yet, or that you can add more
-information, you should generally proceed as follows.
+<filename>/org/qa.debian.org/mia</filename> on the host <literal>qa.debian.org
+</literal>, and can be queried with the <command>mia-query</command> tool.
+Use <command>mia-query --help</command> to see how to query the database.
+If you find that no information has been recorded about an inactive maintainer yet,
+or that you can add more information, you should generally proceed as follows.
 </para>
 <para>
 The first step is to politely contact the maintainer, and wait a reasonable
@@ -211,11 +211,12 @@ maintainer in question as possible.  This includes:
 <itemizedlist>
 <listitem>
 <para>
-The echelon information available through the <ulink
+The <literal>echelon</literal> information available through the <ulink
 url="&url-debian-db;">developers' LDAP database</ulink>, which indicates
 when the developer last posted to a Debian mailing list.  (This includes
-uploads via debian-*-changes lists.) Also, remember to check whether the
-maintainer is marked as on vacation in the database.
+mails about uploads distributed via the &email-debian-devel-changes; list.)
+Also, remember to check whether the maintainer is marked as on vacation in
+the database.
 </para>
 </listitem>
 <listitem>
@@ -237,11 +238,11 @@ groups.
 </itemizedlist>
 <para>
 A bit of a problem are packages which were sponsored — the maintainer is not
-an official Debian developer.  The echelon information is not available for
-sponsored people, for example, so you need to find and contact the Debian
-developer who has actually uploaded the package.  Given that they signed the
-package, they're responsible for the upload anyhow, and are likely to know what
-happened to the person they sponsored.
+an official Debian developer.  The <literal>echelon</literal> information is not
+available for sponsored people, for example, so you need to find and contact the
+Debian developer who has actually uploaded the package.  Given that they signed
+the package, they're responsible for the upload anyhow, and are likely to know
+what happened to the person they sponsored.
 </para>
 <para>
 It is also allowed to post a query to &email-debian-devel;,
@@ -272,9 +273,9 @@ someone with more time.
 </para>
 <para>
 If you are interested in working in the MIA team, please have a look at the
-README file in /org/qa.debian.org/mia on qa.debian.org where the technical
-details and the MIA procedures are documented and contact
-&email-mia;.
+README file in <filename>/org/qa.debian.org/mia</filename> on <literal>
+qa.debian.org</literal> where the technical details and the MIA procedures are
+documented and contact &email-mia;.
 </para>
 </section>