unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-5.0)
Page:
Section:
Apropos / Subsearch:
optional field

dpkg-parsechangelog(1)          dpkg utilities          dpkg-parsechangelog(1)



NAME
       dpkg-parsechangelog - parse Debian changelog files

SYNOPSIS
       dpkg-parsechangelog [options]

DESCRIPTION
       dpkg-parsechangelog  reads  and  parses  the  changelog  of an unpacked
       Debian source tree and outputs the information in it to standard output
       in a machine-readable form.

OPTIONS
       -lchangelogfile
              Specifies  the  change  log  file  to read information from. The
              default is debian/changelog.

       -Fchangelogformat
              Specifies the format of the changelog. By default the format  is
              read  from  a  special  line near the bottom of the changelog or
              failing that defaults to the debian standard format.

       -Llibdir
              Specify an additional directory to search  for  parser  scripts.
              This  directory is searched before the default directories which
              are     currently     /usr/local/lib/dpkg/parsechangelog     and
              /usr/lib/dpkg/parsechangelog.

       -h, --help
              Show the usage message and exit.

       --version
              Show the version and exit.

   Parser Options
       The  following  options  can  be  used  to  influence the output of the
       changelog parser, e.g. the range of entries or the format of  the  out-
       put.  They  need  to be supported by the parser script in question. See
       also CAVEATS.

       --format outputformat
              Set the output format. Currently supported values are  dpkg  and
              rfc822.   dpkg  is  the  classic output format (from before this
              option existed) and the default. It consists of one paragraph in
              Debian  control  format  (see  deb-control(5)). If more than one
              entry is requested, then most fields are taken from  the  latest
              entry, except otherwise stated:

              Source: <pkg name>

              Version: <version>

              Distribution: <target distribution>

              Urgency: <urgency>
                     The highest urgency of all included entries is used.

              Maintainer: <author>

              Date: <date>

              Closes: <bug number>
                     The Closes fields of all included entries are merged.

              Changes: <changelog entries>
                     The  text  of  all  changelog entries is concatenated. To
                     make this field a valid Debian control  format  multiline
                     field  empty  lines  are replaced with a single full stop
                     and all lines is intended by  one  space  character.  The
                     exact content depends on the changelog format.

              There might be additional user-defined fields present.

              The  rfc822  format  uses the same fields but outputs a separate
              paragraph for each changelog entry so that all metadata for each
              entry is preserved.

       --since, -s, -v version
              include all changes later than version.

       --until, -u version
              include all changes earlier than version.

       --from, -f version
              include all changes equal or later than version.

       --to, -t version
              include all changes up to or equal than version.

       --count, -c, -n number
              include  number  entries  from the top (or the tail if number is
              lower than 0).

       --offset, -o number
              change the starting point for --count, counted from the top  (or
              the tail if number is lower than 0).

       --all  include all changes.

CAVEATS
       All  Parser  Options  except for -v are only supported in dpkg, version
       1.14.16 and later. Third party parsers for changelog formats other than
       debian might not support all options.

FILES
       debian/changelog
              The changelog file, used to obtain version-dependent information
              about the source package, such as the urgency  and  distribution
              of  an  upload, the changes made since a particular release, and
              the source version number itself.

AUTHORS
       Copyright (C) 1995-1996 Ian Jackson
       Copyright (C) 2000 Wichert Akkerman
       Copyright (C) 2007, 2008 Frank Lichtenheld

       This is free software; see the GNU General Public Licence version 2  or
       later for copying conditions. There is NO WARRANTY.



Debian Project                    2008-01-13            dpkg-parsechangelog(1)