summaryrefslogtreecommitdiff
path: root/doc/apt-changelog.1.xml
blob: f881dad8ac4e93641086bdcdf79f43913beb38dc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [

<!ENTITY % aptent SYSTEM "apt.ent">
%aptent;

<!ENTITY % aptverbatiment SYSTEM "apt-verbatim.ent">
%aptverbatiment;

]>

<refentry>

<refentryinfo>

   <author>
    <firstname>Martin</firstname>
    <surname>Pitt</surname>
    <contrib></contrib>
   </author>
   &apt-email;
   &apt-product;
   <!-- The last update date -->
   <date>09 November 2010</date>
 </refentryinfo>
 
 <refmeta>
   <refentrytitle>apt-changelog</refentrytitle>
   <manvolnum>1</manvolnum>
   <refmiscinfo class="manual">APT</refmiscinfo>
 </refmeta>
 
 <!-- Man page title -->
 <refnamediv>
    <refname>apt-changelog</refname>
    <refpurpose>APT package changelog retriever</refpurpose>
 </refnamediv>

 <!-- Arguments -->
 <refsynopsisdiv>
   <cmdsynopsis>
      <command>apt-changelog</command>
      <arg choice="plain"><replaceable>packagename</replaceable></arg>
      <group>
        <arg choice="plain"><replaceable>version</replaceable></arg>
        <arg choice="plain">candidate</arg>
      </group>
   </cmdsynopsis>
 </refsynopsisdiv>

 <refsect1><title>Description</title>
   <para>
   <command>apt-changelog</command> downloads a package changelog and displays
   it through <command>sensible-pager</command>. The server name and base
   directory is defined in the <literal>APT::Changelog::Server</literal>
   variable (e. g. <ulink>http://packages.debian.org/changelogs</ulink> for
   Debian or <ulink>http://changelogs.ubuntu.com/changelogs</ulink> for
   Ubuntu).
   </para>

   <para>
   By default it displays the changelog for the version that is installed.
   However, you can specify a different version as the second argument; if you 
   specify <constant>candidate</constant>, it will fetch the changelog for the
   latest available version of that package, i. e. the version which you would
   get with <command>apt-get install <parameter>packagename</parameter></command>.
   </para>
</refsect1>

<refsect1><title>See Also</title>
<para>
&apt-get;
</para>
</refsect1>

 &manbugs;

</refentry>