Bug#228474: Man page rhythmbox(1)

Max Vozeler Max Vozeler <max@hinterhof.net>, 228474@bugs.debian.org
Sat, 3 Apr 2004 17:36:49 +0200


--T4sUOijqQbZv57TR
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

Hi,

here it goes .. rhythmbox(1) based on the --help output and some bits
from the FAQ. It is not derived from the GFDL manual.

I've attached the Docbook XML source and a rhythmbox.1 generated by
  "xmlto man rhythmbox.1.xml"

Please consider including it.

Cheers
Max

-- 
308E81E7B97963BCA0E6ED889D5BD511B7CDA2DC

--T4sUOijqQbZv57TR
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="rhythmbox.1"

.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "RHYTHMBOX" 1 "" "" ""
.SH NAME
rhythmbox \- music player and organizer for GNOME
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 19
\fB/usr/bin/rhythmbox\fR [\fB\fIoptions\fR\fR]
.ad
.hy

.SH "DESCRIPTION"

.PP
Rhythmbox is an integrated music playing and management application\&. It is designed to work well under the GNOME Desktop and based on the powerful GStreamer media framework, or the Xine framework, to support a wide range of audio formats (including mp3 and ogg)\&.

.SH "OPTIONS"

.PP
Rhythmbox accepts some options common to all X and GNOME applications, like \fB\-display \fIdisplayname\fR\fR\&. These are not included in the list of options below\&. You can use the \fB\-\-usage\fR argument to show the complete list of accepted options\&.

.TP
\fB\-\-usage\fR, \fB\-\-help\fR
Print all accepted command line options

.TP
\fB\-\-print\-playing\fR
Print the playing song and exit

.TP
\fB\-\-print\-playing\-path\fR
Print the playing song URI and exit

.TP
\fB\-\-print\-song\-length\fR
Print the playing song length in seconds and exit

.TP
\fB\-\-print\-play\-time\fR
Print the current elapsed time of playing song and exit

.TP
\fB\-\-set\-play\-time=\fILONG\fR\fR
Seek to the specified time in playing song if possible and exit

.TP
\fB\-\-play\-pause\fR
Toggle play/pause mode

.TP
\fB\-\-focus\fR
Focus the running player

.TP
\fB\-\-previous\fR
Jump to previous song

.TP
\fB\-\-next\fR
Jump to next song

.TP
\fB\-n, \-\-no\-registration\fR
Do not register the shell\&. Use this option when Rhythmbox is not installed in the same prefix as GNOME and complains about ``failed to activate the shell: (null)''\&. The Rhythmbox FAQ has more information about this issue\&.

.TP
\fB\-\-load\-modules=\fIMODULE1\fR, \fIMODULE2\fR, \fI\&.\&.\&.\fR \fR
Dynamic modules to load

.TP
\fB\-\-dry\-run\fR
Don't save changes permanently (implies \fB\-\-no\-registration\fR)

.TP
\fB\-d\fR
Enable debugging code

.TP
\fB\-q, \-\-quit\fR
Quit Rhythmbox

.SH "AUTHOR"

.PP
Upstream authors: 

.TP 3
\(bu
Colin Walters <walters@debian\&.org>
.TP
\(bu
Jorn Baayen <jorn@nl\&.linux\&.org>
.TP
\(bu
Marco Pesenti Gritti <marco@it\&.gnome\&.org> 
.TP
\(bu
Bastien Nocera <hadess@hadess\&.net>
.TP
\(bu
Seth Nickell <seth@stanford\&.edu>
.TP
\(bu
Olivier Martin <omartin@ifrance\&.com>
.TP
\(bu
See \fI/usr/share/doc/rhythmbox/AUTHORS\fR 
.LP
 

.PP
This manual page was written by Max Vozeler <max@hinterhof\&.net>

.SH "SEE ALSO"

.TP
Music Player Manual
Part of the program online help\&.

.TP
Debian package documentation
\fI/usr/share/doc/rhythmbox/README\&.Debian\fR and \fI/usr/share/doc/rhythmbox/README\fR

.TP
Rhythmbox FAQ
Frequently Asked Questions: \fIhttp://www.rhythmbox.org/faq.html\fR


--T4sUOijqQbZv57TR
Content-Type: text/xml; charset=us-ascii
Content-Disposition: attachment; filename="rhythmbox.1.xml"

<?xml version='1.0'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
  "/usr/share/sgml/docbook/dtd/xml/4.2/docbookx.dtd">

<!--
  Copyright (c) 2004, Max Vozeler <max@hinterhof.net>
  Released under the terms of the GNU GPL
-->

<refentry>
  <refmeta>
    <refentrytitle>rhythmbox</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <!-- Title -->
  <refnamediv>
    <refname>rhythmbox</refname>
    <refpurpose>music player and organizer for GNOME</refpurpose>
  </refnamediv>

  <!-- Synopsis -->
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>/usr/bin/rhythmbox</command>
      <arg><option><replaceable>options</replaceable></option></arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Description</title>
    <para>Rhythmbox is an integrated music playing and
    management application.  It is designed to work well under the GNOME
    Desktop and based on the powerful GStreamer media framework, or
    the Xine framework, to support a wide range of audio formats (including
    mp3 and ogg).</para> </refsect1>

  <refsect1>
    <title>Options</title>
    <para>Rhythmbox accepts some options common to all X and GNOME
    applications, like
    <option>-display <replaceable>displayname</replaceable></option>. These
    are not included in the list of options below. You can use the
    <option>--usage</option> argument to show the complete list of accepted
    options.</para>
    
    <variablelist>

      <varlistentry>
        <term><option>--usage</option></term>
        <term><option>--help</option></term>
        <listitem>
          <para>Print all accepted command line options</para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term><option>--print-playing</option></term>
        <listitem>
          <para>Print the playing song and exit</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--print-playing-path</option></term>
        <listitem>
          <para>Print the playing song URI and exit</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--print-song-length</option></term>
        <listitem>
          <para>Print the playing song length in seconds and exit</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--print-play-time</option></term>
        <listitem>
          <para>Print the current elapsed time of playing song and exit</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--set-play-time=<replaceable>LONG</replaceable></option>
          </term>
        <listitem>
          <para>Seek to the specified time in playing song if possible and
            exit</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--play-pause</option></term>
        <listitem><para>Toggle play/pause mode</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--focus</option></term>
        <listitem><para>Focus the running player</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--previous</option></term>
        <listitem><para>Jump to previous song</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--next</option></term>
        <listitem><para>Jump to next song</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-n, --no-registration</option></term>
        <listitem><para>Do not register the shell. Use this option when
        Rhythmbox is not installed in the same prefix as GNOME and complains
        about <quote>failed to activate the shell: (null)</quote>. The
        Rhythmbox FAQ has more information about this issue.</para>
        </listitem> </varlistentry>

      <varlistentry>
        <term><option>--load-modules=<replaceable>MODULE1</replaceable>,
        <replaceable>MODULE2</replaceable>, <replaceable>...</replaceable>
        </option></term>
        <listitem><para>Dynamic modules to load</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--dry-run</option></term>
        <listitem><para>Don't save changes permanently (implies
              <option>--no-registration</option>)</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-d</option></term>
        <listitem><para>Enable debugging code</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-q, --quit</option></term>
        <listitem><para>Quit Rhythmbox</para></listitem>
      </varlistentry>

    </variablelist>
  </refsect1>

  <refsect1>
    <title>Author</title>
    <para>Upstream authors:
    <itemizedlist spacing="compact">
      <listitem>
        <simpara>Colin Walters <email>walters@debian.org</email></simpara>
      </listitem>
      <listitem>
        <simpara>Jorn Baayen <email>jorn@nl.linux.org</email></simpara>
      </listitem>
      <listitem>
        <simpara>Marco Pesenti Gritti <email>marco@it.gnome.org</email>
        </simpara>
      </listitem>
      <listitem>
        <simpara>Bastien Nocera <email>hadess@hadess.net</email></simpara>
      </listitem>
      <listitem>
        <simpara>Seth Nickell <email>seth@stanford.edu</email></simpara>
      </listitem>
      <listitem>
        <simpara>Olivier Martin <email>omartin@ifrance.com</email></simpara>
      </listitem>
      <listitem>
        <simpara>See <filename>/usr/share/doc/rhythmbox/AUTHORS</filename>
          </simpara>
      </listitem>
    </itemizedlist>
    </para>

    <para>This manual page was written by Max Vozeler
    <email>max@hinterhof.net</email></para>
  </refsect1>

  <refsect1>
    <title>See also</title>
    <variablelist>
      <varlistentry><term>Music Player Manual</term>
        <listitem><simpara>Part of the program online help.</simpara>
        </listitem>
      </varlistentry>

      <varlistentry><term>Debian package documentation</term>
        <listitem>
          <simpara><filename>/usr/share/doc/rhythmbox/README.Debian</filename>
          and <filename>/usr/share/doc/rhythmbox/README</filename></simpara>
        </listitem>
      </varlistentry>

      <varlistentry><term>Rhythmbox FAQ</term>
        <listitem><simpara><ulink url="http://www.rhythmbox.org/faq.html">Frequently Asked Questions</ulink></simpara>
        </listitem>
      </varlistentry>
    </variablelist>
     
  </refsect1>
</refentry>

--T4sUOijqQbZv57TR--