]> git.saurik.com Git - apt.git/blame - doc/apt-sortpkgs.1.xml
* Replace SGML manpages with XML man pages from richard...
[apt.git] / doc / apt-sortpkgs.1.xml
CommitLineData
24f6490f
AL
1<?xml version="1.0" encoding="utf-8" standalone="no"?>
2<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4
5<!ENTITY % aptent SYSTEM "apt.ent">
6%aptent;
7
8]>
9
10<refentry>
11 &apt-docinfo;
12
13 <refmeta>
14 <refentrytitle>apt-sortpkgs</refentrytitle>
15 <manvolnum>1</manvolnum>
16 </refmeta>
17
18 <!-- Man page title -->
19 <refnamediv>
20 <refname>apt-sortpkgs</refname>
21 <refpurpose>Utility to sort package index files</refpurpose>
22 </refnamediv>
23
24 <!-- Arguments -->
25 <refsynopsisdiv>
26 <cmdsynopsis>
27 <command>apt-sortpkgs</command>
28 <arg><option>-hvs</option></arg>
29 <arg><option>-o=<replaceable>config string</replaceable></option></arg>
30 <arg><option>-c=<replaceable>file</replaceable></option></arg>
31 <arg choice="plain" rep="repeat"><replaceable>file</replaceable></arg>
32 </cmdsynopsis>
33 </refsynopsisdiv>
34
35 <refsect1><title>Description</title>
36 <para><command>apt-sortpkgs</command> will take an index file (Source index or Package
37 index) and sort the records so that they are ordered by the package name.
38 It will also sort the internal fields of each record according to the
39 internal sorting rules.</para>
40
41 <para>
42 All output is sent to stdout, the input must be a seekable file.</para>
43 </refsect1>
44
45 <refsect1><title>options</title>
46 &apt-cmdblurb;
47
48 <variablelist>
49 <varlistentry><term><option>-s</option></term><term><option>--source</option></term>
50 <listitem><para>
51 Use Source index field ordering.
52 Configuration Item: <literal>APT::SortPkgs::Source</literal>.</para></listitem>
53 </varlistentry>
54
55 &apt-commonoptions;
56
57 </variablelist>
58 </refsect1>
59
60 <refsect1><title>See Also</title>
61 <para>&apt-conf;</para>
62 </refsect1>
63
64 <refsect1><title>Diagnostics</title>
65 <para><command>apt-sortpkgs</command> returns zero on normal operation, decimal 100 on error.</para>
66 </refsect1>
67
68 &manbugs;
69 &manauthor;
70
71</refentry>