Re: Updated maint-guide contents, question on style
Chapter 8, which took about five minutes. Just one comment: in the
signed .command file in 8.1, "Version: 2.6.3ia" means it was signed
with a piece of mid-nineties non-free software, not GPG...
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
--- maint-guide.en.dbk.pristine 2011-04-17 14:35:41.052916002 +0100
+++ maint-guide.en.dbk 2011-04-27 21:03:32.653258856 +0100
@@ -4491,10 +4491,10 @@
you can upload the package to the Debian archive.
<footnote><para>
There are publicly accessible archives such as <ulink url="&mentors-dn;"/>
-which work almost the same way as Debian archive and provide upload area for
-the non-DD. You can set up an equivalent archive by yourself using tools
-listed at <ulink url="&deb-archive;"/>. So this section is useful for the
-non-DD, too.
+which work almost the same way as the Debian archive and provide an upload area for
+non-DDs. You can set up an equivalent archive by yourself using the tools
+listed at <ulink url="&deb-archive;"/>. So this section is useful for
+non-DDs, too.
</para></footnote>
You can do this manually, but it's easier to use the existing
automated tools, like <citerefentry> <refentrytitle>dupload</refentrytitle>
@@ -4502,10 +4502,10 @@
<refentrytitle>dput</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
We'll describe how it's done with <command>dupload</command>. <footnote><para>
The <systemitem role="package">dput</systemitem> package seems to come with
-more features and becoming more popular than the <systemitem role="package">dupload</systemitem> package. It uses the
-<filename>/etc/dput</filename> file for the global configuration and the
-<filename>~/.dput.cf</filename> file for the per-user one. It supports Ubuntu
-related services out-of-box, too. </para> </footnote>
+more features and to be becoming more popular than the <systemitem role="package">dupload</systemitem> package. It uses the
+file <filename>/etc/dput</filename> for its global configuration and the
+file <filename>~/.dput.cf</filename> for per-user configuration. It supports
+Ubuntu-related services out-of-the-box, too. </para> </footnote>
</para>
<para>
First you have to set up <command>dupload</command>'s config file. You can
@@ -4525,14 +4525,14 @@
<footnote><para>See <ulink url="&devref-upload;">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:
+While connected to the Internet, you can upload your package as follows:
</para>
<screen>
$ dupload gentoo_0.9.12-1_i386.changes
</screen>
<para>
-<command>dupload</command> checks that the MD5/SHA1/SHA256 checksums of the
-files match those from the <filename>.changes</filename> file. If they do not
+<command>dupload</command> checks that the SHA1/SHA256 file checksums
+match those listed in the <filename>.changes</filename> file. If they do not
match, it will warn you to rebuild it as described in <xref linkend="completebuild"/> so it can be properly uploaded.
</para>
<!--
@@ -4542,9 +4542,10 @@
-->
<para>
If you encounter an upload problem at <ulink url="&uploadqueue;"/>, you can fix this
-by manually uploading GPG signed <filename>*.commands</filename> file to there
-with <command>ftp</command>. <footnote><para> See <ulink url="&uploadqueue-readme;"/>. Alternatively, you may
-use <command>dcut</command> command from the <systemitem role="package">dput</systemitem> package. </para> </footnote> For example, use
+by manually uploading a GPG-signed <filename>*.commands</filename> file to there
+with <command>ftp</command>. <footnote><para> See <ulink url="&uploadqueue-readme;"/>. Alternatively, you can
+use the <command>dcut</command> command from the <systemitem
+role="package">dput</systemitem> package. </para> </footnote> For example, using
<filename>hello.commands</filename>:
</para>
<screen>
@@ -4570,7 +4571,7 @@
which includes all changes from the last upload.
</para>
<para>
-This can be done by specifying <literal>-v</literal> option to the package
+This can be done by specifying the <literal>-v</literal> option to the package
building programs such as <command>dpkg-buildpackage</command>,
<command>debuild</command>, <command>pdebuild</command>, etc.
</para>
Reply to: