[SCM] bs1770gain/master: Added simple manual page using txt2man.

pere at users.alioth.debian.org pere at users.alioth.debian.org
Sun Dec 11 08:32:50 UTC 2016


The following commit has been merged in the master branch:
commit df41bd56670338918f49cbb2e777767a3413c5e9
Author: Petter Reinholdtsen <pere at hungry.com>
Date:   Sun Dec 11 08:26:22 2016 +0000

    Added simple manual page using txt2man.

diff --git a/debian/bs1770gain.manpages b/debian/bs1770gain.manpages
new file mode 100644
index 0000000..df3d59d
--- /dev/null
+++ b/debian/bs1770gain.manpages
@@ -0,0 +1 @@
+debian/bs1770gain.1
diff --git a/debian/bs1770gain.txtman b/debian/bs1770gain.txtman
new file mode 100644
index 0000000..773bf01
--- /dev/null
+++ b/debian/bs1770gain.txtman
@@ -0,0 +1,71 @@
+NAME
+  bs1770gain - lundness scanner and normalizer based on ITU-R BS.1770
+SYNOPSIS
+  bs1770gain [options] <file/dir> [<file/dir> ...]
+DESCRIPTION
+  BS1770GAIN is a loudness scanner compliant with ITU-R BS.1770 and
+  its flavors EBU R128, ATSC A/85, and ReplayGain 2.0. It helps
+  normalizing the loudness of audio and video files to the same level.
+
+  See bs1770gain --help for experimental options.  Command line
+  arguments can appear in any order.
+OPTIONS
+  -h,--help        print this message and exit
+  -i,--integrated  calculate integrated loudness
+  -s,--shorterm    calculate maximum shortterm loudness
+  -m,--momentary   claculate maximum momentary loudness
+  -r,--range       calculate loudness range
+  -p,--samplepeak  calculate maximum sample peak
+  -t,--truepeak    calculate maximum true peak
+
+  -b <timestamp>,--begin <timestamp>    begin decoding at timestamp (in microseconds, format: hh:mm:ss.mus)
+
+  -d <duration>,--duration <duration>   let decoding last duration (in microseconds, format: hh:mm:ss.mus)
+
+  -u <method>,--use <method>            base replay gain calculation on method (with respect to the -a/--apply and -o/--output options), methods: "integrated" (default), "shortterm", or "momentary" experimental methods: "momentary-mean" (same as "integrated"), "momentary-maximum" (same as "momentary"), "shortterm-mean", or "shortterm-maximum" (same as "shortterm")
+
+  -a               apply the EBU/ATSC/RG album gain to the output (in conjunction with the -o/--output option)
+  -o <folder>,--output <folder>          write RG tags or apply the EBU/ATSC/RG gain,
+                   respectively, and output to folder
+  -f <file>,--file <file>
+                   write analysis to file
+  -x,--extensions  enable following extensions/defaults:
+    1) rename files according to TITLE tag
+    2) read metadata from per-folder CSV file "folder.csv"
+    3) copy file "folder.jpg" from source to destination
+       folder
+    4) automatically add the TRACK and DISC tags
+    5) calculate maximum true peak
+    6) convert to stereo
+  -l,--list        print FFmpeg format/stream information
+  --ebu            calculate replay gain according to EBU R128 (-23.0 LUFS, default)
+  --atsc           calculate replay gain according to ATSC A/85 (-24.0 LUFS)
+  --replaygain     calculate replay gain according to ReplayGain 2.0 (-18.0 LUFS)
+  --track-tags     write track tags
+  --album-tags     write album tags
+  --unit <unit>    write tags with <unit>
+  --apply <q>      apply the EBU/ATSC/RG gain to the output (in conjunction with the -o/--output option), q=0.0 (album gain) ... 1.0 (track gain), default  0.0 (album gain)
+  --audio <index>  select audio index (corresponds to
+    [0:<index>] in FFmpeg listing, cf. -l/--list option)
+  --video <index>  select video index (corresponds to
+    [0:<index>] in FFmpeg listing, cf. -l/--list option)
+  --stereo         convert to stereo
+  --drc <float>    set AC3 dynamic range compression (DRC)
+  --extension <extension>  enable extension out of
+    "rename":  rename files according to TITLE tag
+    "csv":  read metadata from per-folder CSV file "folder.csv"
+    "jpg":  copy file "folder.jpg" from source to destination folder
+    "tags":  automatically add the TRACK and DISC tags
+  --format <format>  convert to format
+  --loglevel <level>  set loglevel,
+    level:  "quiet", "panic", "fatal", "error", "warning",
+    "info", "verbose", "debug"
+  --xml            print results in xml format
+  --time           print out duration of program invocation
+  --norm <float>   norm loudness to float.
+AUTHOR
+  The bs1770gain system is written Peter Belkner and others.  The
+  authors can be contacted via http://bs1770gain.sourceforge.net/ .
+
+  This manual page for bs1770gain was written by Petter Reinholdtsen
+  and is licensed using the same terms as the bs1770gain source.
diff --git a/debian/control b/debian/control
index 222896b..02d1b6c 100644
--- a/debian/control
+++ b/debian/control
@@ -8,6 +8,7 @@ Build-depends: debhelper (>> 9)
  , libsox-dev
  , libavformat-dev (>= 7:2.7.0)
  , sox
+ , txt2man
 Standards-Version: 3.9.8
 Homepage: http://bs1770gain.sourceforge.net/
 Vcs-Browser: https://anonscm.debian.org/gitweb/?p=pkg-multimedia/bs1770gain.git
diff --git a/debian/rules b/debian/rules
index ad88661..de2fe68 100755
--- a/debian/rules
+++ b/debian/rules
@@ -6,3 +6,10 @@
 override_dh_auto_test:
 	dh_auto_test
 	BS1770GAIN=`pwd`/bs1770gain/bs1770gain ./debian/tests/test-cmd-tool 
+
+# Generate and install manual page
+debian/bs1770gain.1: debian/bs1770gain.txtman
+	txt2man -t BS1770GAIN -d 2016-12-11 -s 1 debian/bs1770gain.txtman > $@
+override_dh_installman: debian/bs1770gain.1
+	dh_installman
+	$(RM) debian/bs1770gain.1

-- 
bs1770gain packaging



More information about the pkg-multimedia-commits mailing list