NAME

       amo-changelog - fetch Version History of an addon

SYNOPSIS

       amo-changelog [options] extension

DESCRIPTION

       amo-changelog  fetches  the Version History of an addon from the Mozilla Extensions website.  It is meant
       to offer an easy way to include upstream changelogs in Debian packages of mozilla extensions  -  in  many
       cases, this is not contained in the upstream source code repository, but is available on said website.

       The  extension argument is its short name, as used by the website. For example, the homepage for "Adblock
       Plus"  is  https://addons.mozilla.org/en-US/firefox/addon/adblock-plus/,  so  the  short  name  would  be
       "adblock-plus".

       Here is an example for debian/rules:

       # if using debhelper
       override_dh_installchangelogs:
            dh_installchangelogs debian/upstream/changelog.html debian/upstream/changelog

       .PHONY: get-orig-changelog
       get-orig-changelog:
            amo-changelog -p rst adblock-plus

       Using  this  approach, one would save the output files debian/upstream/{changelog.html,changelog} as part
       of the Debian packaging.  When  updating  the  package  with  a  new  upstream  release,  one  would  run
       `debian/rules get-orig-changelog`

OPTIONS

       -h, --help
              Display a brief help message.

       -f, --html-file
              File to write to. Default: debian/upstream/changelog.html

       -p, --plain-format
              Generate  a human-readable form of the changelog in the file without the .html extension, using an
              external program.  Possible  options  are  text  (uses  lynx(1)),  markdown  (pandoc(1)),  or  rst
              (pandoc(1)). Default: none.

AUTHOR

       Jakub Wilk <jwilk@debian.org> and Ximin Luo <infinity0@pwned.gg>

amo-changelog                                     December 2014                                 AMO-CHANGELOG(1)