doc/apt-changelog.1.xml

   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 <!ENTITY % aptverbatiment SYSTEM "apt-verbatim.ent">
   9 %aptverbatiment;
  10
  11 ]>
  12
  13 <refentry>
  14
  15 <refentryinfo>
  16
  17    <author>
  18     <firstname>Martin</firstname>
  19     <surname>Pitt</surname>
  20     <contrib></contrib>
  21    </author>
  22    &apt-email;
  23    &apt-product;
  24    <!-- The last update date -->
  25    <date>09 November 2010</date>
  26  </refentryinfo>
  27
  28  <refmeta>
  29    <refentrytitle>apt-changelog</refentrytitle>
  30    <manvolnum>1</manvolnum>
  31    <refmiscinfo class="manual">APT</refmiscinfo>
  32  </refmeta>
  33
  34  <!-- Man page title -->
  35  <refnamediv>
  36     <refname>apt-changelog</refname>
  37     <refpurpose>APT package changelog retriever</refpurpose>
  38  </refnamediv>
  39
  40  <!-- Arguments -->
  41  <refsynopsisdiv>
  42    <cmdsynopsis>
  43       <command>apt-changelog</command>
  44       <arg choice="plain"><replaceable>packagename</replaceable></arg>
  45       <group>
  46         <arg choice="plain"><replaceable>version</replaceable></arg>
  47         <arg choice="plain">candidate</arg>
  48       </group>
  49    </cmdsynopsis>
  50  </refsynopsisdiv>
  51
  52  <refsect1><title>Description</title>
  53    <para>
  54    <command>apt-changelog</command> downloads a package changelog and displays
  55    it through <command>sensible-pager</command>. The server name and base
  56    directory is defined in the <literal>APT::Changelog::Server</literal>
  57    variable (e. g. <ulink>http://packages.debian.org/changelogs</ulink> for
  58    Debian or <ulink>http://changelogs.ubuntu.com/changelogs</ulink> for
  59    Ubuntu).
  60    </para>
  61
  62    <para>
  63    By default it displays the changelog for the version that is installed.
  64    However, you can specify a different version as the second argument; if you
  65    specify <constant>candidate</constant>, it will fetch the changelog for the
  66    latest available version of that package, i. e. the version which you would
  67    get with <command>apt-get install <parameter>packagename</parameter></command>.
  68    </para>
  69 </refsect1>
  70
  71 <refsect1><title>See Also</title>
  72 <para>
  73 &apt-get;
  74 </para>
  75 </refsect1>
  76
  77  &manbugs;
  78
  79 </refentry>
  80