rev 9286 - kde-extras/kmplayer/trunk/debian

Jonathan Patrick Davies jpatrick-guest at alioth.debian.org
Tue Feb 5 12:20:11 UTC 2008


Author: jpatrick-guest
Date: 2008-02-05 12:20:10 +0000 (Tue, 05 Feb 2008)
New Revision: 9286

Added:
   kde-extras/kmplayer/trunk/debian/kmplayer-common.manpages
   kde-extras/kmplayer/trunk/debian/kmplayer.1.docbook
   kde-extras/kmplayer/trunk/debian/kmplayer.manpages
   kde-extras/kmplayer/trunk/debian/kxineplayer.1.docbook
   kde-extras/kmplayer/trunk/debian/kxvplayer.1.docbook
Modified:
   kde-extras/kmplayer/trunk/debian/changelog
   kde-extras/kmplayer/trunk/debian/compat
   kde-extras/kmplayer/trunk/debian/control
   kde-extras/kmplayer/trunk/debian/rules
Log:
kde-extras/kmplayer:
* Added manpages for kxineplayer, kxvplayer and kmplayer (Closes: #458609).
* Added build dependency on docbook2x.
* Added rules to generate and clean manpages.
* Updated compat and debhelper version to 6.


Modified: kde-extras/kmplayer/trunk/debian/changelog
===================================================================
--- kde-extras/kmplayer/trunk/debian/changelog	2008-02-05 11:33:13 UTC (rev 9285)
+++ kde-extras/kmplayer/trunk/debian/changelog	2008-02-05 12:20:10 UTC (rev 9286)
@@ -1,5 +1,11 @@
 kmplayer (1:0.10.0c-2) UNRELEASED; urgency=low
 
+  +++ Changes by Jonathan Patrick Davies:
+  * Added manpages for kxineplayer, kxvplayer and kmplayer (Closes: #458609).
+  * Added build dependency on docbook2x.
+  * Added rules to generate and clean manpages.
+  * Updated compat and debhelper version to 6.
+
   * NOT RELEASED YET.
 
  -- Fathi Boudra <fabo at debian.org>  Sat, 22 Dec 2007 15:43:49 +0100

Modified: kde-extras/kmplayer/trunk/debian/compat
===================================================================
--- kde-extras/kmplayer/trunk/debian/compat	2008-02-05 11:33:13 UTC (rev 9285)
+++ kde-extras/kmplayer/trunk/debian/compat	2008-02-05 12:20:10 UTC (rev 9286)
@@ -1 +1 @@
-5
+6

Modified: kde-extras/kmplayer/trunk/debian/control
===================================================================
--- kde-extras/kmplayer/trunk/debian/control	2008-02-05 11:33:13 UTC (rev 9285)
+++ kde-extras/kmplayer/trunk/debian/control	2008-02-05 12:20:10 UTC (rev 9286)
@@ -3,9 +3,10 @@
 Priority: optional
 Maintainer: Debian KDE Extras Team <pkg-kde-extras at lists.alioth.debian.org>
 Uploaders: Fathi Boudra <fabo at debian.org>, Mark Purcell <msp at debian.org>
-Build-Depends: cdbs, debhelper (>= 5), quilt, automake1.9, kdelibs4-dev,
+Build-Depends: cdbs, debhelper (>= 6), quilt, automake1.9, kdelibs4-dev,
  libcairo2-dev, libdbus-1-dev, libdbus-glib-1-dev, libdbus-qt-1-dev,
- libgstreamer-plugins-base0.10-dev, libgtk2.0-dev, libxine-dev, libxv-dev
+ libgstreamer-plugins-base0.10-dev, libgtk2.0-dev, libxine-dev, libxv-dev,
+ docbook2x
 Standards-Version: 3.7.3
 Homepage: http://kmplayer.kde.org
 

Added: kde-extras/kmplayer/trunk/debian/kmplayer-common.manpages
===================================================================
--- kde-extras/kmplayer/trunk/debian/kmplayer-common.manpages	                        (rev 0)
+++ kde-extras/kmplayer/trunk/debian/kmplayer-common.manpages	2008-02-05 12:20:10 UTC (rev 9286)
@@ -0,0 +1 @@
+kxineplayer.1

Added: kde-extras/kmplayer/trunk/debian/kmplayer.1.docbook
===================================================================
--- kde-extras/kmplayer/trunk/debian/kmplayer.1.docbook	                        (rev 0)
+++ kde-extras/kmplayer/trunk/debian/kmplayer.1.docbook	2008-02-05 12:20:10 UTC (rev 9286)
@@ -0,0 +1,122 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+]>
+<refentry>
+  <refentryinfo>
+    <author>
+      <firstname>Jonathan Patrick</firstname>
+      <surname>Davies</surname>
+      <email>jpatrick at kubuntu.org</email>
+    </author>
+    <copyright>
+      <year>2006-2008</year>
+      <holder>Jonathan Patrick Davies</holder>
+    </copyright>
+    <!-- XXX IMPORTANT XXX -->
+    <!-- Keep this date up to date: -->
+    <date>2008-02-05</date>
+    <!--  ^^^^^^^^^^ -->
+  </refentryinfo>
+  <refmeta>
+    <refentrytitle>kmplayer</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+  <refnamediv>
+    <refname>kmplayer</refname>
+    <refpurpose>a media player for KDE</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>kmplayer</command>
+      <arg choice="opt">
+        <option><replaceable>Qt-options</replaceable></option>
+      </arg>
+      <arg choice="opt">
+        <option><replaceable>KDE-options</replaceable></option>
+      </arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>DESCRIPTION</title>
+    <para>
+      KMPlayer is a basic audio/video viewer application for KDE.<br />
+      <br />
+      KMPlayer can:<br />
+      * play DVD (DVDNav only with the Xine player).<br />
+      * play VCD.<br />
+      * let the backend players play from a pipe (read from stdin).<br />
+      * play from a TV device (experimental).<br />
+      * show backend player's console output.<br />
+      * launch ffserver (only 0.4.8 works) when viewing from a v4l device.<br />
+      * DCOP KMediaPlayer interface support.<br />
+      * VDR viewer frontend (with *kxvplayer), configure VDR keys with standard KDE<br />
+        shortcut configure window.<br />
+      * Lots of configurable shortcuts. Highly recommended for the VDR keys<br />
+        (if you have VDR) and volume increase/decrease.<br />
+    </para>
+  </refsect1>
+  <refsect1>
+    <title>OPTIONS</title>
+    <para>
+      All <productname>KDE</productname> and <productname>Qt</productname>
+      programs accept a some common command-line options.  KMPlayer has no
+      application-specific options.
+    </para>
+    <para>
+      <variablelist>
+        <title>Generic options:</title>
+        <varlistentry>
+          <term> <option>--help</option> </term>
+          <listitem> <para>Show help about options</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>--help-qt</option> </term>
+          <listitem> <para>Show Qt specific options</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>--help-kde</option> </term>
+          <listitem> <para>Show KDE specific options</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>--help-all</option> </term>
+          <listitem> <para>Show all options</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>--author</option> </term>
+          <listitem> <para>Show author information</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-v</option>, <option>--version</option> </term>
+          <listitem> <para>Show version information</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>--license</option> </term>
+          <listitem> <para>Show license information</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>--</option> </term>
+          <listitem> <para>Indicates end of options</para> </listitem>
+        </varlistentry>
+      </variablelist>
+      <!-- TODO * add all the rest of the options, but maybe find an automated
+      way to keep it up to date -->
+    </para>
+  </refsect1>
+  <refsect1>
+    <title>COPYRIGHT</title>
+    <para>
+      This manual page was written by Jonathan Patrick Davies
+      <email>jpatrick at kubuntu.org</email> for the
+      <productname>Debian</productname> system (but may be used by others).
+      Permission is granted to copy, distribute and/or modify this document
+      under the terms of the <acronym>GNU</acronym> General Public License,
+      Version 3 or any later version published by the Free Software Foundation.
+    </para>
+    <para>
+      On Debian systems, the complete text of the GNU General Public
+      License can be found in
+      <filename>/usr/share/common-licenses/GPL</filename>.
+    </para>
+  </refsect1>
+</refentry>

Added: kde-extras/kmplayer/trunk/debian/kmplayer.manpages
===================================================================
--- kde-extras/kmplayer/trunk/debian/kmplayer.manpages	                        (rev 0)
+++ kde-extras/kmplayer/trunk/debian/kmplayer.manpages	2008-02-05 12:20:10 UTC (rev 9286)
@@ -0,0 +1,2 @@
+kmplayer.1
+kxvplayer.1

Added: kde-extras/kmplayer/trunk/debian/kxineplayer.1.docbook
===================================================================
--- kde-extras/kmplayer/trunk/debian/kxineplayer.1.docbook	                        (rev 0)
+++ kde-extras/kmplayer/trunk/debian/kxineplayer.1.docbook	2008-02-05 12:20:10 UTC (rev 9286)
@@ -0,0 +1,116 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+]>
+<refentry>
+  <refentryinfo>
+    <author>
+      <firstname>Jonathan Patrick</firstname>
+      <surname>Davies</surname>
+      <email>jpatrick at kubuntu.org</email>
+    </author>
+    <copyright>
+      <year>2008</year>
+      <holder>Jonathan Patrick Davies</holder>
+    </copyright>
+    <!-- XXX IMPORTANT XXX -->
+    <!-- Keep this date up to date: -->
+    <date>2008-02-05</date>
+    <!--  ^^^^^^^^^^ -->
+  </refentryinfo>
+  <refmeta>
+    <refentrytitle>kxineplayer</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+  <refnamediv>
+    <refname>kxineplayer</refname>
+    <refpurpose>xine part for kmplayer</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+        <command>kxineplayer</command>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>DESCRIPTION</title>
+    <para>
+        Xine player part for KMPlayer. The KMPlayer is a basic audio/video viewer
+        application for KDE.<br />
+    </para>
+  </refsect1>
+  <refsect1>
+      <title>OPTIONS</title>
+      <para>
+      <variablelist>
+        <title>Generic options:</title>
+        <varlistentry>
+            <term> <option>-vo</option> [xv|xshm] </term>
+            <listitem> <para>Engine kxineplayer should use for video output.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-ao</option> [arts|esd|...] </term>
+          <listitem> <para>Engine kxineplayer should use for audio output.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-f</option> [configuration file] </term>
+          <listitem> <para>Configuration file kxineplayer should use.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-dvd-device</option> [dvd-device] </term>
+          <listitem> <para>DVD device kxineplayer should use.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-vcd-device</option> [vcd-device] </term>
+          <listitem> <para>VCD device kxineplayer should use.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-vd</option> [video device] </term>
+          <listitem> <para>Video device kxineplayer should use.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-wid</option> [X11-window|-root] </term>
+          <listitem> <para>Window kxineplayer should use.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-sub</option> [subtitle-url] </term>
+          <listitem> <para>Subtitles kxineplayer should use for video.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-lang</option> [language] </term>
+          <listitem> <para>Language kxineplayer should use for video.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-loop</option> [repeat] </term>
+          <listitem> <para>How many times kxineplayer should repeat entered
+                  video.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+            <term> <option>-cb</option> [DCOP callback name] </term>
+          <listitem> <para>DCOP callback name kxineplayer should use.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>[url]</option></term>
+          <listitem> <para>URL that kxineplayer should play.</para> </listitem>
+        </varlistentry>
+      </variablelist>
+      <!-- TODO * add all the rest of the options, but maybe find an automated
+      way to keep it up to date -->
+  </para>
+  </refsect1>
+  <refsect1>
+    <title>COPYRIGHT</title>
+    <para>
+      This manual page was written by Jonathan Patrick Davies
+      <email>jpatrick at kubuntu.org</email> for the
+      <productname>Debian</productname> system (but may be used by others).
+      Permission is granted to copy, distribute and/or modify this document
+      under the terms of the <acronym>GNU</acronym> General Public License,
+      Version 3 or any later version published by the Free Software Foundation.
+    </para>
+    <para>
+      On Debian systems, the complete text of the GNU General Public
+      License can be found in
+      <filename>/usr/share/common-licenses/GPL</filename>.
+    </para>
+  </refsect1>
+</refentry>

Added: kde-extras/kmplayer/trunk/debian/kxvplayer.1.docbook
===================================================================
--- kde-extras/kmplayer/trunk/debian/kxvplayer.1.docbook	                        (rev 0)
+++ kde-extras/kmplayer/trunk/debian/kxvplayer.1.docbook	2008-02-05 12:20:10 UTC (rev 9286)
@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+]>
+<refentry>
+  <refentryinfo>
+    <author>
+      <firstname>Jonathan Patrick</firstname>
+      <surname>Davies</surname>
+      <email>jpatrick at kubuntu.org</email>
+    </author>
+    <copyright>
+      <year>2008</year>
+      <holder>Jonathan Patrick Davies</holder>
+    </copyright>
+    <!-- XXX IMPORTANT XXX -->
+    <!-- Keep this date up to date: -->
+    <date>2008-02-05</date>
+    <!--  ^^^^^^^^^^ -->
+  </refentryinfo>
+  <refmeta>
+    <refentrytitle>kxvplayer</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+  <refnamediv>
+    <refname>kxvplayer</refname>
+    <refpurpose>a media player for KDE</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>kxvplayer</command>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>DESCRIPTION</title>
+    <para>
+        KXVPLayer is the Xine video player for KMPlayer. KMPlayer is a basic
+        audio/video viewer application for KDE.<br />
+    </para>
+  </refsect1>
+  <refsect1>
+    <title>OPTIONS</title>
+    <para>
+      <variablelist>
+        <title>Generic options:</title>
+        <varlistentry>
+          <term> <option>-port</option> </term>
+          <listitem> <para>Video port kxvplayer should listen to.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-enc</option> </term>
+          <listitem> <para>Encoding option.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-freq</option> </term>
+          <listitem> <para>Freqency option.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-f [configuration file]</option> </term>
+          <listitem> <para>Which configuration file the player should use.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-wid</option>, <option>--window-id</option> [window] </term>
+          <listitem> <para>Which window the player should use.</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-root</option>, <option>--window</option></term>
+          <listitem> <para>Whetever kxvplayer should use an existing .</para> </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term> <option>-cb [DCOP callback name]</option> </term>
+          <listitem> <para>Which callback name kxvplayer should use.</para> </listitem>
+        </varlistentry>
+      </variablelist>
+      <!-- TODO * add all the rest of the options, but maybe find an automated
+      way to keep it up to date -->
+  </para>
+  </refsect1>
+  <refsect1>
+    <title>COPYRIGHT</title>
+    <para>
+      This manual page was written by Jonathan Patrick Davies
+      <email>jpatrick at kubuntu.org</email> for the
+      <productname>Debian</productname> system (but may be used by others).
+      Permission is granted to copy, distribute and/or modify this document
+      under the terms of the <acronym>GNU</acronym> General Public License,
+      Version 3 or any later version published by the Free Software Foundation.
+    </para>
+    <para>
+      On Debian systems, the complete text of the GNU General Public
+      License can be found in
+      <filename>/usr/share/common-licenses/GPL</filename>.
+    </para>
+  </refsect1>
+</refentry>

Modified: kde-extras/kmplayer/trunk/debian/rules
===================================================================
--- kde-extras/kmplayer/trunk/debian/rules	2008-02-05 11:33:13 UTC (rev 9285)
+++ kde-extras/kmplayer/trunk/debian/rules	2008-02-05 12:20:10 UTC (rev 9286)
@@ -9,6 +9,14 @@
 DEB_CONFIGURE_SCRIPT_ENV += LDFLAGS="-Wl,--as-needed"
 DEB_DH_INSTALL_ARGS := --sourcedir=debian/tmp
 
+build/kmplayer::
+	# Generate manpages from docbook.
+	docbook2x-man debian/kmplayer.1.docbook
+	docbook2x-man debian/kxvplayer.1.docbook
+
+build/kmplayer-common::
+	docbook2x-man debian/kxineplayer.1.docbook
+
 install/kmplayer::
 	install -D -p -m644 debian/kmplayer.lintian-overrides \
 	  debian/kmplayer/usr/share/lintian/overrides/kmplayer
@@ -22,3 +30,8 @@
 	 @@[ -d ../tarballs/. ]
 	 @@dpatch-get-origtargz ../tarballs
 
+clean::
+	rm -f kmplayer.1
+	rm -f kxvplayer.1
+	rm -f kxineplayer.1
+




More information about the pkg-kde-commits mailing list