summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorXimin Luo <infinity0@pwned.gg>2014-09-30 01:59:25 +0100
committerXimin Luo <infinity0@pwned.gg>2014-12-17 10:29:11 +0100
commit003eca75448abf77413b93b3c8c3cf56f48cee34 (patch)
tree88cbbb18617fefeac7c4b77c1eb1817f28e820c6 /man
parentbc9f279909ac9c7e47f2b4599630565fe03230ec (diff)
amo-changelog: parse into human-readable form and save to debian/upstream/changelog{,.html}
Diffstat (limited to 'man')
-rw-r--r--man/amo-changelog.116
1 files changed, 12 insertions, 4 deletions
diff --git a/man/amo-changelog.1 b/man/amo-changelog.1
index 197ff17..09ab68e 100644
--- a/man/amo-changelog.1
+++ b/man/amo-changelog.1
@@ -12,7 +12,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.TH XPI-REPACK "1" "April 2014" "amo-changelog" "mozilla-devscripts suite"
+.TH AMO-CHANGELOG "1" "December 2014" "amo-changelog" "mozilla-devscripts suite"
.SH NAME
amo-changelog \- fetch Version History of an addon
.SH SYNOPSIS
@@ -37,20 +37,28 @@ Here is an example for debian/rules:
.br
override_dh_installchangelogs:
.br
- dh_installchangelogs debian/changelog.upstream
+ dh_installchangelogs debian/upstream/changelog.html debian/upstream/changelog
\[char46]PHONY: get-orig-changelog
.br
get-orig-changelog:
.br
- amo-changelog adblock-plus > debian/changelog.upstream
+ amo-changelog -p rst adblock-plus
-Using this approach, one would save the output file (debian/changelog.upstream)
+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`
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Display a brief help message.
+.TP
+\fB\-f\fR, \fB\-\-html\-file\fR
+File to write to. Default: debian/upstream/changelog.html
+.TP
+\fB\-p\fR, \fB\-\-plain\-format\fR
+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.
.SH AUTHOR
Jakub Wilk <jwilk@debian.org> and Ximin Luo <infinity0@pwned.gg>