[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Request for Review: APT manpages



apt-sortpkgs.1.xml is short and simple, but still gets a patch:

[...]
>    <para><command>apt-sortpkgs</command> will take an index file (Source index or Package
>    index) and sort the records so that they are ordered by the package name.

Why capitalised "Source" and "Package"?  Shouldn't it either be the
ordinary lowercase noun "source" or the capitalised filename
"<filename>Sources</filename>"?  My patch has the former (and likewise
under the "--source" option).

[...]
>    <para>
>    All output is sent to stdout, the input must be a seekable file.</para>
>  </refsect1>

s/stdout,/standard output;/
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
--- old/apt-sortpkgs.1.xml	2012-05-21 10:41:17.000000000 +0100
+++ new/apt-sortpkgs.1.xml	2012-05-29 12:06:04.759718340 +0100
@@ -36,13 +36,13 @@
  &synopsis-command-apt-sortpkgs;
 
  <refsect1><title>Description</title>
-   <para><command>apt-sortpkgs</command> will take an index file (Source index or Package 
+   <para><command>apt-sortpkgs</command> will take an index file (source index or package 
    index) and sort the records so that they are ordered by the package name. 
    It will also sort the internal fields of each record according to the 
    internal sorting rules.</para>
 
    <para>
-   All output is sent to stdout, the input must be a seekable file.</para>
+   All output is sent to standard output; the input must be a seekable file.</para>
  </refsect1>
  
  <refsect1><title>options</title>
@@ -51,7 +51,7 @@
    <variablelist>
      <varlistentry><term><option>-s</option></term><term><option>--source</option></term>
      <listitem><para>
-     Use Source index field ordering.
+     Use source index field ordering.
      Configuration Item: <literal>APT::SortPkgs::Source</literal>.</para></listitem>
      </varlistentry>
    

Attachment: apt-sortpkgs.1.xml
Description: XML document


Reply to: