[SCM] handbrake/master: adding man pages

Thu Oct 4 13:43:27 UTC 2012

The following commit has been merged in the master branch:
commit 85458a07e683bef05d6bb1b0407b28e6426873c4
Author: Dmitry Smirnov <onlyjob at member.fsf.org>
Date:   Thu Oct 4 23:08:00 2012 +1000

    adding man pages

diff --git a/debian/HandBrakeCLI.1 b/debian/HandBrakeCLI.1
new file mode 100644
index 0000000..ac6988d
--- /dev/null
+++ b/debian/HandBrakeCLI.1
@@ -0,0 +1,422 @@
+.\" This file was generated by help2man 1.40.10 and edited by Dmitry Smirnov <onlyjob at member.fsf.org>
+.TH HANDBRAKECLI: "1" "October 2012" "HandBrakeCLI 0.9.8" "User Commands"
+.SH NAME
+HandBrakeCLI \- versatile DVD ripper and video transcoder (command line)
+.SH DESCRIPTION
+Syntax: HandBrakeCLI [options] \fB\-i\fR <device> \fB\-o\fR <file>
+.SS
+### General Handbrake Options
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help
+.TP
+\fB\-u\fR, \fB\-\-update\fR
+Check for updates and exit
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR <#>
+Be verbose (optional argument: logging level)
+.TP
+\fB\-Z\fR. \fB\-\-preset\fR <string>
+Use a built\-in preset. Capitalization matters, and
+if the preset name has spaces, surround it with
+double quotation marks
+.TP
+\fB\-z\fR, \fB\-\-preset\-list\fR
+See a list of available built\-in presets
+.TP
+\fB\-\-no\-dvdnav\fR
+Do not use dvdnav for reading DVDs
+(experimental, enabled by default for testing)
+.SS
+### Source Options
+.TP
+\fB\-i\fR, \fB\-\-input\fR <string>
+Set input device
+.TP
+\fB\-t\fR, \fB\-\-title\fR <number>
+Select a title to encode (0 to scan all titles only,
+default: 1)
+.TP
+\fB\-\-min\-duration\fR
+Set the minimum title duration (in seconds). Shorter
+titles will not be scanned (default: 10).
+.TP
+\fB\-\-scan\fR
+Scan selected title only.
+.TP
+\fB\-\-main\-feature\fR
+Detect and select the main feature title.
+.TP
+\fB\-c\fR, \fB\-\-chapters\fR <string>
+Select chapters (e.g. "1\-3" for chapters
+1 to 3, or "3" for chapter 3 only,
+default: all chapters)
+.TP
+\fB\-\-angle\fR <number>
+Select the DVD angle
+.TP
+\fB\-\-previews\fR <#:B>
+Select how many preview images are generated (max 30),
+and whether or not they're stored to disk (0 or 1).
+(default: 10:0)
+.TP
+\fB\-\-start\-at\-preview\fR <#>
+Start encoding at a given preview.
+.TP
+\fB\-\-start\-at\fR <unit:#>
+Start encoding at a given frame, duration (in seconds),
+or pts (on a 90kHz clock)
+.TP
+\fB\-\-stop\-at\fR <unit:#>
+Stop encoding at a given frame, duration (in seconds),
+or pts (on a 90kHz clock)
+.SS
+### Destination Options
+.TP
+\fB\-o\fR, \fB\-\-output\fR <string>
+Set output file name
+.TP
+\fB\-f\fR, \fB\-\-format\fR <string>
+Set output format (mp4/mkv, default:
+autodetected from file name)
+.TP
+\fB\-m\fR, \fB\-\-markers\fR
+Add chapter markers (mp4 and mkv output formats only)
+.TP
+\fB\-4\fR, \fB\-\-large\-file\fR
+Use 64\-bit mp4 files that can hold more than
+4 GB. Note: Breaks iPod, PS3 compatibility.
+.TP
+\fB\-O\fR, \fB\-\-optimize\fR
+Optimize mp4 files for HTTP streaming
+.TP
+\fB\-I\fR, \fB\-\-ipod\-atom\fR
+Mark mp4 files so 5.5G iPods will accept them
+.SS
+### Video Options
+.TP
+\fB\-e\fR, \fB\-\-encoder\fR <string>
+Set video library encoder
+Options: x264 / ffmpeg4 / ffmpeg2 / theora
+(default: ffmpeg4)
+.TP
+\fB\-\-x264\-preset\fR <string>
+When using x264, selects the x264 preset:
+.IP
+ultrafast / superfast / veryfast / faster / fast / medium / slow / slower / veryslow / placebo
+.TP
+\fB\-\-x264\-tune\fR <string>
+When using x264, selects the x264 tuning:
+.IP
+film / animation / grain / stillimage / psnr / ssim / fastdecode / zerolatency
+.TP
+\fB\-x\fR, \fB\-\-encopts\fR <string>
+Specify advanced encoder options in the
+same style as mencoder (x264 and ffmpeg only):
+option1=value1:option2=value2
+.TP
+\fB\-\-x264\-profile\fR <string>
+When using x264, ensures compliance with the
+specified h.264 profile:
+.IP
+baseline / main / high / high10 / high422 / high444
+.TP
+\fB\-q\fR, \fB\-\-quality\fR <number>
+Set video quality
+.TP
+\fB\-b\fR, \fB\-\-vb\fR <kb/s>
+Set video bitrate (default: 1000)
+.TP
+\fB\-2\fR, \fB\-\-two\-pass\fR
+Use two\-pass mode
+.TP
+\fB\-T\fR, \fB\-\-turbo\fR
+When using 2\-pass use the turbo options
+on the first pass to improve speed
+(only works with x264, affects PSNR by about 0.05dB,
+and increases first pass speed two to four times)
+.TP
+\fB\-r\fR, \fB\-\-rate\fR
+Set video framerate
+(5 / 10 / 12 / 15 / 23.976 / 24 / 25 / 29.97 / 30 / 50 / 59.94 / 60)
+Be aware that not specifying a framerate lets
+HandBrake preserve a source's time stamps,
+potentially creating variable framerate video
+.TP
+\fB\-\-vfr\fR, \fB\-\-cfr\fR, \fB\-\-pfr\fR
+Select variable, constant or peak\-limited
+frame rate control. VFR preserves the source
+timing. CFR makes the output constant rate at
+the rate given by the \fB\-r\fR flag (or the source's
+average rate if no \fB\-r\fR is given). PFR doesn't
+allow the rate to go over the rate specified
+with the \fB\-r\fR flag but won't change the source
+timing if it's below that rate.
+If none of these flags are given, the default
+is \fB\-\-cfr\fR when \fB\-r\fR is given and \fB\-\-vfr\fR otherwise
+.SS
+### Audio Options
+.TP
+\fB\-a\fR, \fB\-\-audio\fR <string>
+Select audio track(s), separated by commas
+("none" for no audio, "1,2,3" for multiple
+tracks, default: first one).
+Multiple output tracks can be used for one input.
+.TP
+\fB\-E\fR, \fB\-\-aencoder\fR <string>
+Audio encoder(s):
+    faac
+    ffaac
+    copy:aac
+    ffac3
+    copy:ac3
+    copy:dts
+    copy:dtshd
+    lame
+    copy:mp3
+    vorbis
+    ffflac
+    copy
+.IP
+copy:* will passthrough the corresponding
+audio unmodified to the muxer if it is a
+supported passthrough audio type.
+Separated by commas for more than one audio track.
+(default: faac for mp4, lame for mkv)
+.TP
+\fB\-\-audio\-copy\-mask\fR <string>
+Set audio codecs that are permitted when the
+"copy" audio encoder option is specified
+(aac/ac3/dts/dtshd/mp3, default: all).
+Separated by commas for multiple allowed options.
+.TP
+\fB\-\-audio\-fallback\fR <string>
+Set audio codec to use when it is not possible
+to copy an audio track without re\-encoding.
+.TP
+\fB\-B\fR, \fB\-\-ab\fR <kb/s>
+Set audio bitrate(s) (default: depends on the
+selected codec, mixdown and samplerate)
+Separated by commas for more than one audio track.
+.TP
+\fB\-Q\fR, \fB\-\-aq\fR <quality>
+Set audio quality metric (default: depends on the
+selected codec)
+Separated by commas for more than one audio track.
+.TP
+\fB\-C\fR, \fB\-\-ac\fR <compression>
+Set audio compression metric (default: depends on the
+selected codec)
+Separated by commas for more than one audio track.
+.TP
+\fB\-6\fR, \fB\-\-mixdown\fR <string>
+Format(s) for surround sound downmixing
+Separated by commas for more than one audio track.
+(mono/stereo/dpl1/dpl2/6ch, default: up to 6ch for ac3,
+up to dpl2 for other encoders)
+.TP
+\fB\-R\fR, \fB\-\-arate\fR
+Set audio samplerate(s) (22.05/24/32/44.1/48 kHz)
+Separated by commas for more than one audio track.
+.TP
+\fB\-D\fR, \fB\-\-drc\fR <float>
+Apply extra dynamic range compression to the audio,
+making soft sounds louder. Range is 1.0 to 4.0
+(too loud), with 1.5 \- 2.5 being a useful range.
+Separated by commas for more than one audio track.
+.TP
+\fB\-\-gain\fR <float>
+Amplify or attenuate audio before encoding.  Does
+NOT work with audio passthru (copy). Values are in
+dB.  Negative values attenuate, positive values
+amplify. A 1 dB difference is barely audible.
+.TP
+\fB\-A\fR, \fB\-\-aname\fR <string>
+Audio track name(s),
+Separated by commas for more than one audio track.
+.SS
+### Picture Settings
+.TP
+\fB\-w\fR, \fB\-\-width\fR <number>
+Set picture width
+.TP
+\fB\-l\fR, \fB\-\-height\fR <number>
+Set picture height
+.TP
+\fB\-\-crop\fR <T:B:L:R>
+Set cropping values (default: autocrop)
+.TP
+\fB\-\-loose\-crop\fR <#>
+Always crop to a multiple of the modulus
+Specifies the maximum number of extra pixels
+which may be cropped (default: 15)
+.TP
+\fB\-Y\fR, \fB\-\-maxHeight\fR <#>
+Set maximum height
+.TP
+\fB\-X\fR, \fB\-\-maxWidth\fR <#>
+Set maximum width
+.TP
+\fB\-\-strict\-anamorphic\fR
+Store pixel aspect ratio in video stream
+.TP
+\fB\-\-loose\-anamorphic\fR
+Store pixel aspect ratio with specified width
+.TP
+\fB\-\-custom\-anamorphic\fR
+Store pixel aspect ratio in video stream and
+directly control all parameters.
+.TP
+\fB\-\-display\-width\fR <number>
+Set the width to scale the actual pixels to
+at playback, for custom anamorphic.
+.TP
+\fB\-\-keep\-display\-aspect\fR
+Preserve the source's display aspect ratio
+when using custom anamorphic
+.TP
+\fB\-\-pixel\-aspect\fR <PARX:PARY>
+Set a custom pixel aspect for custom anamorphic
+(\fB\-\-display\-width\fR and \fB\-\-pixel\-aspect\fR are mutually
+exclusive and the former will override the latter)
+.TP
+\fB\-\-itu\-par\fR
+Use wider, ITU pixel aspect values for loose and
+custom anamorphic, useful with underscanned sources
+.TP
+\fB\-\-modulus\fR
+Set the number you want the scaled pixel dimensions
+.TP
+<number>
+to divide cleanly by. Does not affect strict
+anamorphic mode, which is always mod 2 (default: 16)
+.TP
+\fB\-M\fR  \fB\-\-color\-matrix\fR <601 or 709>
+Set the color space signaled by the output
+(Bt.601 is mostly for SD content, Bt.709 for HD,
+default: set by resolution)
+.SS
+### Filters
+.TP
+\fB\-d\fR, \fB\-\-deinterlace\fR <YM:FD:MM:QP> or <fast/slow/slower>
+Deinterlace video with yadif/mcdeint filter
+(default 0:\-1:\-1:1)
+.TP
+\fB\-5\fR, \fB\-\-decomb\fR <MO:ME:MT:ST:BT:BX:BY:MG:VA:LA:DI:ER:NO:MD:PP:FD>
+Selectively deinterlaces when it detects combing
+(default: 7:2:6:9:80:16:16:10:20:20:4:2:50:24:1:\-1)
+.TP
+\fB\-9\fR, \fB\-\-detelecine\fR <L:R:T:B:SB:MP:FD>
+Detelecine (ivtc) video with pullup filter
+Note: this filter drops duplicate frames to
+restore the pre\-telecine framerate, unless you
+specify a constant framerate (\fB\-\-rate\fR 29.97)
+(default 1:1:4:4:0:0:\-1)
+.TP
+\fB\-8\fR, \fB\-\-denoise\fR <SL:SC:TL:TC> or <weak/medium/strong>
+Denoise video with hqdn3d filter
+(default 4:3:6:4.5)
+.TP
+\fB\-7\fR, \fB\-\-deblock\fR <QP:M>
+Deblock video with pp7 filter
+(default 5:2)
+.TP
+\fB\-\-rotate\fR <M>
+Flips images axes
+(default 3)
+.TP
+\fB\-g\fR, \fB\-\-grayscale\fR
+Grayscale encoding
+.SS
+### Subtitle Options
+.TP
+\fB\-s\fR, \fB\-\-subtitle\fR <string>
+Select subtitle track(s), separated by commas
+More than one output track can be used for one
+input.
+Example: "1,2,3" for multiple tracks.
+A special track name "scan" adds an extra 1st pass.
+This extra pass scans subtitles matching the
+language of the first audio or the language
+selected by \fB\-\-native\-language\fR.
+The one that's only used 10 percent of the time
+or less is selected. This should locate subtitles
+for short foreign language segments. Best used in
+conjunction with \fB\-\-subtitle\-forced\fR.
+.TP
+\fB\-F\fR, \fB\-\-subtitle\-forced\fR <string>
+Only display subtitles from the selected stream if
+the subtitle has the forced flag set. The values in
+"string" are indexes into the subtitle list
+specified with '\-\-subtitle'.
+Separated by commas for more than one subtitle track.
+Example: "1,2,3" for multiple tracks.
+If "string" is omitted, the first track is forced.
+.TP
+\fB\-\-subtitle\-burned\fR <number>
+"Burn" the selected subtitle into the video track
+If "number" is omitted, the first track is burned.
+"number" is an index into the subtitle list
+specified with '\-\-subtitle'.
+.TP
+\fB\-\-subtitle\-default\fR <number>
+Flag the selected subtitle as the default subtitle
+to be displayed upon playback.  Setting no default
+means no subtitle will be automatically displayed
+If "number" is omitted, the first track is default.
+"number" is an index into the subtitle list
+specified with '\-\-subtitle'.
+.TP
+\fB\-N\fR, \fB\-\-native\-language\fR <string>
+Specifiy your language preference. When the first
+audio track does not match your native language then
+select the first subtitle that does. When used in
+conjunction with \fB\-\-native\-dub\fR the audio track is
+changed in preference to subtitles. Provide the
+language's iso639\-2 code (fre, eng, spa, dut, et cetera)
+.TP
+\fB\-\-native\-dub\fR
+Used in conjunction with \fB\-\-native\-language\fR
+requests that if no audio tracks are selected the
+default selected audio track will be the first one
+that matches the \fB\-\-native\-language\fR. If there are no
+matching audio tracks then the first matching
+subtitle track is used instead.
+.HP
+\fB\-\-srt\-file\fR <string>
+SubRip SRT filename(s), separated by commas.
+.TP
+\fB\-\-srt\-codeset\fR <string>
+Character codeset(s) that the SRT file(s) are
+encoded in, separted by commas.
+Use 'iconv \fB\-l\fR' for a list of valid
+codesets. If not specified latin1 is assumed
+.TP
+\fB\-\-srt\-offset\fR <string>
+Offset in milli\-seconds to apply to the SRT file(s)
+separted by commas. If not specified zero is assumed.
+Offsets may be negative.
+.TP
+\fB\-\-srt\-lang\fR <string>
+Language as an iso639\-2 code fra, eng, spa et cetera)
+for the SRT file(s) separated by commas. If not specified
+then 'und' is used.
+.TP
+\fB\-\-srt\-default\fR <number>
+Flag the selected srt as the default subtitle
+to be displayed upon playback.  Setting no default
+means no subtitle will be automatically displayed
+If "number" is omitted, the first srt is default.
+"number" is an 1 based index into the srt\-file list
+.SH "SEE ALSO"
+The full documentation for
+.B HandBrakeCLI:
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B HandBrakeCLI:
+programs are properly installed at your site, the command
+.IP
+.B info HandBrakeCLI:
+.PP
+should give you access to the complete manual.
diff --git a/debian/handbrake-cli.manpages b/debian/handbrake-cli.manpages
new file mode 100644
index 0000000..efba585
--- /dev/null
+++ b/debian/handbrake-cli.manpages
@@ -0,0 +1 @@
+debian/HandBrakeCLI.1
diff --git a/debian/handbrake-gtk.1 b/debian/handbrake-gtk.1
new file mode 100644
index 0000000..bb15364
--- /dev/null
+++ b/debian/handbrake-gtk.1
@@ -0,0 +1,107 @@
+.\" This file was generated by help2man 1.40.10 and edited by Dmitry Smirnov <onlyjob at member.fsf.org>
+.TH HANDBRAKE-GTK "1" "October 2012" "handbrake-gtk 0.9.8" "User Commands"
+.SH NAME
+handbrake-gtk \- versatile DVD ripper and video transcoder
+.SH DESCRIPTION
+.SS "Usage:"
+.IP
+handbrake\-gtk [OPTION...] \- Transcode media formats
+.SS "Help Options:"
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Show help options
+.TP
+\fB\-\-help\-all\fR
+Show all help options
+.TP
+\fB\-\-help\-gtk\fR
+Show GTK+ Options
+.TP
+\fB\-\-help\-gst\fR
+Show GStreamer Options
+.SS
+GTK+ Options
+.TP
+\fB\-\-class\fR=\fICLASS\fR
+Program class as used by the window manager
+.TP
+\fB\-\-name\fR=\fINAME\fR
+Program name as used by the window manager
+.TP
+\fB\-\-screen\fR=\fISCREEN\fR
+X screen to use
+.TP
+\fB\-\-sync\fR
+Make X calls synchronous
+.TP
+\fB\-\-gtk\-module\fR=\fIMODULES\fR
+Load additional GTK+ modules
+.TP
+\fB\-\-g\-fatal\-warnings\fR
+Make all warnings fatal
+.SS
+GStreamer Options
+.TP
+\fB\-\-gst\-version\fR
+Print the GStreamer version
+.TP
+\fB\-\-gst\-fatal\-warnings\fR
+Make all warnings fatal
+.TP
+\fB\-\-gst\-debug\-help\fR
+Print available debug categories and exit
+.TP
+\fB\-\-gst\-debug\-level\fR=\fILEVEL\fR
+Default debug level from 1 (only error) to 5 (anything) or 0 for no output
+.TP
+\fB\-\-gst\-debug\fR=\fILIST\fR
+Comma\-separated list of category_name:level pairs to set specific levels for the individual categories. Example: GST_AUTOPLUG:5,GST_ELEMENT_*:3
+.TP
+\fB\-\-gst\-debug\-no\-color\fR
+Disable colored debugging output
+.TP
+\fB\-\-gst\-debug\-disable\fR
+Disable debugging
+.TP
+\fB\-\-gst\-plugin\-spew\fR
+Enable verbose plugin loading diagnostics
+.TP
+\fB\-\-gst\-plugin\-path\fR=\fIPATHS\fR
+Colon\-separated paths containing plugins
+.TP
+\fB\-\-gst\-plugin\-load\fR=\fIPLUGINS\fR
+Comma\-separated list of plugins to preload in addition to the list stored in environment variable GST_PLUGIN_PATH
+.TP
+\fB\-\-gst\-disable\-segtrap\fR
+Disable trapping of segmentation faults during plugin loading
+.TP
+\fB\-\-gst\-disable\-registry\-update\fR
+Disable updating the registry
+.TP
+\fB\-\-gst\-disable\-registry\-fork\fR
+Disable spawning a helper process while scanning the registry
+.SS "Application Options:"
+.TP
+\fB\-d\fR, \fB\-\-device\fR
+The device or file to encode
+.TP
+\fB\-p\fR, \fB\-\-preset\fR
+The preset values to use for encoding
+.TP
+\fB\-x\fR, \fB\-\-debug\fR
+Spam a lot
+.TP
+\fB\-\-display\fR=\fIDISPLAY\fR
+X display to use
+.SH "SEE ALSO"
+The full documentation for
+.B handbrake-gtk
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B handbrake-gtk
+programs are properly installed at your site, the command
+.IP
+.B info handbrake-gtk
+.PP
+should give you access to the complete manual.
diff --git a/debian/handbrake-gtk.links b/debian/handbrake-gtk.links
index fde2667..40e48b2 100644
--- a/debian/handbrake-gtk.links
+++ b/debian/handbrake-gtk.links
@@ -1 +1,2 @@
 usr/bin/ghb	usr/bin/handbrake-gtk
+usr/share/man/man1/handbrake-gtk.1	usr/share/man/man1/ghb.1
diff --git a/debian/handbrake-gtk.manpages b/debian/handbrake-gtk.manpages
new file mode 100644
index 0000000..c4aaf6d
--- /dev/null
+++ b/debian/handbrake-gtk.manpages
@@ -0,0 +1 @@
+debian/handbrake-gtk.1

-- 
handbrake packaging

