changeset 2323:a7a52cbc08fc trunk

[svn] - move manpages to subdir man/
author nenolod
date Sat, 13 Jan 2007 14:40:03 -0800
parents e448fee6c0e3
children 2ab9ef1e9544
files ChangeLog Makefile audacious.1.in audtool.1.in configure.ac man/Makefile man/audacious.1.in man/audtool.1.in
diffstat 8 files changed, 461 insertions(+), 444 deletions(-) [+]
line wrap: on
line diff
--- a/ChangeLog	Sat Jan 13 14:35:56 2007 -0800
+++ b/ChangeLog	Sat Jan 13 14:40:03 2007 -0800
@@ -1,3 +1,13 @@
+2007-01-13 22:35:56 +0000  William Pitcock <nenolod@sacredspiral.co.uk>
+  revision [3654]
+  - remove audacious.spec -- we don't use it for anything, and we're not 
+    packaging RPMs so we don't really need it
+  
+  trunk/audacious.spec.in |  182 ------------------------------------------------
+  trunk/configure.ac      |    1 
+  2 files changed, 183 deletions(-)
+
+
 2007-01-13 22:27:13 +0000  William Pitcock <nenolod@sacredspiral.co.uk>
   revision [3652]
   - update bulgarian translation by proxy
--- a/Makefile	Sat Jan 13 14:35:56 2007 -0800
+++ b/Makefile	Sat Jan 13 14:40:03 2007 -0800
@@ -3,7 +3,7 @@
 include mk/rules.mk
 include mk/init.mk
 
-SUBDIRS = src po icons skins
+SUBDIRS = src man po icons skins
 
 include mk/objective.mk
 
--- a/audacious.1.in	Sat Jan 13 14:35:56 2007 -0800
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,217 +0,0 @@
-.TH AUDACIOUS "1" "24 October 2005" "Version @PACKAGE_VERSION@" "Audacious Manual Pages"
-.SH NAME
-Audacious \- an audio player for X.
-.SH SYNOPSIS
-.B audacious
-[\-h] [\-\-help] [\-n \fI<session>\fP] [\-\-session=\fI<session>\fP] [\-r]
-[\-\-rew] [\-p] [\-\-play] [\-u] [\-\-pause] [\-s] [\-\-stop] [\-f]
-[\-\-fwd] [\-e] [\-\-enqueue] [\-m] [\-\-show\-main\-window] [\-v]
-[\-\-version] [\-\-headless] [\fIfilename\fP]...
-.SH DESCRIPTION
-\fIAudacious\fP is a media player, based on Beep Media Player, 
-which is in turn based on the X Multimedia System.
-It is used to play audio and other kinds of media files.  By default
-Audacious can play MPEG audio, Ogg Vorbis, RIFF wav, most module formats,
-and a few other formats.  Audacious can be extended through plugins to play
-a number of other audio and video formats.
-.SH OPTIONS
-Audacious accepts the following options:
-.TP
-.B \-h, \-\-help
-Show summary of options.
-.TP
-.B \-n, \-\-session
-Select Audacious/BMP/XMMS session (Default: 0).
-.TP
-.B \-r, \-\-rew
-Skip backwards in playlist.
-.TP
-.B \-p, \-\-play
-Start playing current playlist.
-.TP
-.B \-u, \-\-pause
-Pause current song.
-.TP
-.B \-s, \-\-stop
-Stop current song.
-.TP
-.B \-t, \-\-play\-pause
-Pause if playing, play otherwise.
-.TP
-.B \-f, \-\-fwd
-Skip forward in playlist.
-.TP
-.B \-e, \-\-enqueue
-Don't clear the playlist.
-.TP
-.B \-m, \-\-show\-main\-window
-Show the main window.
-.TP
-.B \-v, \-\-version
-Print version number and exit.
-.TP
-.B \-H, \-\-headless
-Starts Audacious in headless mode.
-.SH SKINS
-Audacious supports Winamp Classic style skins.  Skins may be stored in either
-archived (\fI.zip\fP, \fI.wsz\fP, \fI.tgz\fP, \fI.tar.gz\fP, 
-or \fI.tar.bz2\fP) or unarchived format.  Audacious looks for skinfiles in
-@datadir@/audacious/Skins, ~/.audacious/Skins, and locations specified by the
-\fBSKINSDIR\fP variable.
-.SH KEYBINDINGS
-Global keybindings for Audacious:
-
-.in +2
-.ta \w'Shift + Control + w 'u
-z	Previous song
-.br
-x	Play
-.br
-c	Pause
-.br
-v	Stop
-.br
-b	Next song
-.br
-l	Play file
-.br
-j	Jump to file
-.br
-r	Toggle Repeat
-.br
-s	Toggle Shuffle
-.br
-Shift + l	Play directory
-.br
-Control + l	Play location
-.br
-Control + p	Preferences dialog
-.br
-Control + v	Visualization plugin dialog
-.br
-Control + r	Time remaining
-.br
-Control + a	Always on top
-.br
-Control + w	Winshade mode
-.br
-Control + d	Doublesize mode
-.br
-Control + e	Easy move
-.br
-Control + j	Jump to time
-.br
-Control + z	Start of list
-.br
-Control + n	No Playlist Advance
-.br
-Control + 3	File info dialog
-.br
-Control + Alt + w	Toggle Equalizer winshade mode
-.br
-Shift + Control + w	Playlist winshade mode
-.br
-Alt + w	Hide/show mainwindow
-.br
-Alt + e	Hide/show playlistwindow
-.br
-Alt + g	Hide/show Equalizer
-.br
-Alt + s	Skin selecting window
-.in -2
-
-Main window specific:
-
-.in +2
-.br
-Arrow key up	Volume up 2%
-.br
-Arrow key down	Volume down 2%
-.br
-Arrow key right	Skip 5 seconds forward in song
-.br
-Arrow key left	Skip 5 seconds back in song
-.in -2
-
-Playlist window specific:
-
-.in +2
-.br
-Arrow key up	Up one step in playlist
-.br
-Arrow key down	Down one step in playlist
-.br
-Delete	Remove selected songs from playlist
-.br
-Page Up	Move one page up
-.br
-Page Down	Move one page down
-.br
-Home	First page in playlist
-.br
-End	Last page in playlist
-.br
-Enter	Play selected song
-.br
-Insert	Add file dialog
-.br
-Shift + Insert	Add directory dialog
-.br
-Alt + Insert	Add url dialog
-.in -2 
-
-Equalizer shade mode specific:
-
-.in +2
-.br
-Arrow key up	Volume up 2%
-.br
-Arrow key down	Volume down 2%
-.br
-Arrow key right	Balance 4% to right
-.br
-Arrow key left	Balance 4% to left
-.in -2
-.SH HEADLESS OPERATION
-Audacious supports a headless operation mode, where Audacious does not use
-X11 and instead operates as a daemon. You should note that you cannot switch
-between daemonized mode and X11 mode, and that if you wish to switch back
-and forth, that you need to do so when starting the program.
-
-When using Audacious in headless mode, you will need a client. Clients
-compatible with Audacious are listed on the Audacious website.
-.SH FILES
-.TP \w'~/.audacious/playlist.m3uXX'u
-~/.audacious/config
-User's Audacious configuration.
-.TP
-~/.audacious/playlist.m3u
-Default playlist usually loaded on startup.
-.TP
-~/.audacious/gtkrc 
-User's set of Audacious-specific GTK config settings. Options such as widget
-color and fonts sizes can be set here.
-.TP
-~/.audacious/menurc 
-User's set of keybindings.
-.TP
-~/.audacious/Skins, @datadir@/audacious/Skins
-Default location(s) where Audacious should look for skinfiles.
-.TP
-~/.audacious/Plugins
-Location of user-installed plugins.
-.SH ENVIRONMENT
-.TP 12
-.B SKINSDIR
-Colon separated list of paths where Audacious should look for skinfiles.
-.TP
-.B TARCMD
-Tar command supporting GNU tar style decompression.  Used for
-unpacking gzip and bzip2 compressed skins.  Default is \fItar\fP.
-.TP
-.B UNZIPCMD
-Command for decompressing zip files (skins).  Default is \fIunzip\fP.
-.SH OTHER INFO
-The webpage for Audacious is at http://www.audacious-media-player.org.  
-Here you can find info about Audacious, download the latest version, 
-plugins, and skins.
--- a/audtool.1.in	Sat Jan 13 14:35:56 2007 -0800
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,223 +0,0 @@
-.TH AUDTOOL 1 "November 2006" "Version @VERSION@"
-.SH NAME
-.B audtool
-- a small tool to modify behavior of a running audacious instance.
-.SH SYNOPSIS
-.B audtool
-[\-\-[[handler [parameters]]
-.SH DESCRIPTION
-.B audtool
-is designed to send commands to a running audacious.
-.PP
-It can handle various things like jumping to the next track in playlist
-or returning the current playing track title, as well as other status
-information.
-.SH OPTIONS
-.B "Now playing information:"
-.TP
-.I --current-song
-Returns current song title.
-.TP
-.I --current-song-filename
-Returns current song filename.
-.TP
-.I --current-song-length
-Returns current song length.
-.TP
-.I --current-song-length-seconds
-Returns current song length in seconds.
-.TP
-.I --current-song-length-frames
-Returns current song length in frames.
-.TP
-.I --current-song-output-length
-Returns current song output length.
-.TP
-.I --current-song-output-length-seconds
-Returns current song output length in seconds.
-.TP
-.I --current-song-output-length-frames
-Returns current song output length in frames.
-.TP
-.I --current-song-bitrate
-Returns current song bitrate in bits per second.
-.TP
-.I --current-song-bitrate-kbps
-Returns current song bitrate in kilobits per second.
-.TP
-.I --current-song-frequency
-Returns current song frequency in hertz.
-.TP
-.I --current-song-frequency-khz
-Returns current song frequency in kilohertz.
-.TP
-.I --current-song-channels
-Returns current song channels.
-.PP
-.B "Playlist manipulation:"
-.TP
-.I --playlist-advance
-Go to the next song in the playlist.
-.TP
-.I --playlist-reverse
-Go to the previous song in the playlist.
-.TP
-.I --playlist-addurl <uri>
-Adds a uri to the playlist.
-.TP
-.I --playlist-delete <position>
-Deletes the song at <position> from the playlist.
-.TP
-.I --playlist-length
-Returns the total length of the playlist.
-.TP
-.I --playlist-song <position>
-Returns the title of the song at <position> in the playlist.
-.TP
-.I --playlist-song-filename <position>
-Returns the filename of the song at <position> in the playlist.
-.TP
-.I --playlist-song-length <position>
-Returns the length of the song at <position> in the playlist.
-.TP
-.I --playlist-song-length-seconds <position>
-Returns the length of the song at <position> in the playlist in seconds.
-.TP
-.I --playlist-song-length-frames <position>
-Returns the length of the song at <position> in the playlist in frames.
-.TP
-.I --playlist-display
-Returns the entire playlist.
-.TP
-.I --playlist-position
-Returns the current position in the playlist.
-.TP
-.I --playlist-jump <position>
-Jumps to <position> in the playlist.
-.TP
-.I --playlist-clear
-Clears the playlist.
-.TP
-.I --playlist-repeat-status
-Returns the status of playlist repeat.
-.TP
-.I --playlist-repeat-toggle
-Toggles playlist repeat.
-.TP
-.I --playlist-shuffle-status
-Returns the status of playlist shuffle.
-.TP
-.I --playlist-shuffle-toggle
-Toggles playlist shuffle.
-.PP
-.B Playqueue manipulation:
-.TP
-.I --playqueue-add <position>
-Adds the song at <position> in the playlist to the playqueue.
-.TP
-.I --playqueue-remove <position>
-Removes the song at <position> in the playlist from the playqueue.
-.TP
-.I --playqueue-is-queued <position>
-Returns OK if the song at <postion> in the playtlist is queued.
-.TP
-.I --playqueue-get-position <position>
-Returns the playqueue position of the song at <position> in the playlist.
-.TP
-.I --playqueue-get-qposition <qposition>
-Returns the playlist position of the song at <qposition> in the playqueue.
-.TP
-.I --playqueue-length
-Returns the length of the playqueue.
-.TP
-.I --playqueue-display
-Returns a list of currently\-queued songs.
-.TP
-.I --playqueue-clear
-Clears the playqueue.
-.PP
-.B "Playback manipulation:"
-.TP
-.I --playback-play
-Starts/unpauses song playback.
-.TP
-.I --playback-pause
-(Un)pauses song playback.
-.TP
-.I --playback-playpause
-Plays/(un)pauses song playback.
-.TP
-.I --playback-stop
-Stops song playback.
-.TP
-.I --playback-playing
-Returns OK if audacious is playing.
-.TP
-.I --playback-paused
-Returns OK if audacious is paused.
-.TP
-.I --playback-stopped
-Returns OK if audacious is stopped.
-.TP
-.I --playback-status
-Returns the playback status.
-.TP
-.I --playback-seek
-Performs an absolute seek in milliseconds.
-.TP
-.I --playback-seek-relative
-Performs a seek relative to the current position in milliseconds.
-.PP
-.B "Volume control:"
-.TP
-.I --get-volume
-Returns the current volume level in percent.
-.TP
-.I --set-volume <level>
-Sets the current volume level in percent.
-.PP
-.B "Miscellaneous:"
-.TP
-.I --preferences
-Shows/hides the preferences window.
-.TP
-.I --jumptofile
-Shows the jump to file window.
-.TP
-.I --shutdown
-Shuts down audacious.
-.PP
-.B "Help system:"
-.TP
-.I --list-handlers
-Shows handlers list.
-.TP
-.I --help
-Shows handlers list.
-.PP
-Handlers may be prefixed with `\-\-' (GNU\-style long\-options) or not, your choice.
-.SH BUGS
-There are no known bugs in audtool at this time; if you find any please
-report them to <bugs+audtool@atheme.org>.
-.SH AUTHORS
-.B audtool
-was written by George Averill <nhjm@nhjm.net> and William 
-Pitcock <nenolod@atheme.org>.
-.PP
-This manual page was written by Adam Cecile <gandalf@le-vert.net> and 
-Kiyoshi Aman <kiyoshi@atheme.org>. Some additional tweaks were done by 
-William Pitcock <nenolod@atheme.org>.
-.PP
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU General Public License, Version 2 or any
-later version published by the Free Software Foundation.
-.PP
-The complete text of the GNU General Public License is available in the
-sourcecode of Audacious, and is typically included with binary packages 
-as well.
-.PP
-If installed with an operating system, see your Operating System's 
-documentation for licensing details.
-.SH SEE ALSO
-.B Homepage:
-http://audacious-media-player.org/
--- a/configure.ac	Sat Jan 13 14:35:56 2007 -0800
+++ b/configure.ac	Sat Jan 13 14:40:03 2007 -0800
@@ -391,12 +391,12 @@
 AC_SUBST(plugindir)
 
 AC_CONFIG_FILES([
-	audtool.1
-	audacious.1
 	audacious.pc
+	mk/rules.mk
+	man/audtool.1
+	man/audacious.1
 	src/audacious/audacious.desktop
 	po/Makefile.in
-	mk/rules.mk
 ])
 
 AC_OUTPUT
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/man/Makefile	Sat Jan 13 14:40:03 2007 -0800
@@ -0,0 +1,7 @@
+include ../mk/rules.mk
+include ../mk/init.mk
+include ../mk/objective.mk
+
+OBJECTIVE_DATA =	\
+	audtool.1:$(man1dir) \
+	audacious.1:$(man1dir)
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/man/audacious.1.in	Sat Jan 13 14:40:03 2007 -0800
@@ -0,0 +1,217 @@
+.TH AUDACIOUS "1" "24 October 2005" "Version @PACKAGE_VERSION@" "Audacious Manual Pages"
+.SH NAME
+Audacious \- an audio player for X.
+.SH SYNOPSIS
+.B audacious
+[\-h] [\-\-help] [\-n \fI<session>\fP] [\-\-session=\fI<session>\fP] [\-r]
+[\-\-rew] [\-p] [\-\-play] [\-u] [\-\-pause] [\-s] [\-\-stop] [\-f]
+[\-\-fwd] [\-e] [\-\-enqueue] [\-m] [\-\-show\-main\-window] [\-v]
+[\-\-version] [\-\-headless] [\fIfilename\fP]...
+.SH DESCRIPTION
+\fIAudacious\fP is a media player, based on Beep Media Player, 
+which is in turn based on the X Multimedia System.
+It is used to play audio and other kinds of media files.  By default
+Audacious can play MPEG audio, Ogg Vorbis, RIFF wav, most module formats,
+and a few other formats.  Audacious can be extended through plugins to play
+a number of other audio and video formats.
+.SH OPTIONS
+Audacious accepts the following options:
+.TP
+.B \-h, \-\-help
+Show summary of options.
+.TP
+.B \-n, \-\-session
+Select Audacious/BMP/XMMS session (Default: 0).
+.TP
+.B \-r, \-\-rew
+Skip backwards in playlist.
+.TP
+.B \-p, \-\-play
+Start playing current playlist.
+.TP
+.B \-u, \-\-pause
+Pause current song.
+.TP
+.B \-s, \-\-stop
+Stop current song.
+.TP
+.B \-t, \-\-play\-pause
+Pause if playing, play otherwise.
+.TP
+.B \-f, \-\-fwd
+Skip forward in playlist.
+.TP
+.B \-e, \-\-enqueue
+Don't clear the playlist.
+.TP
+.B \-m, \-\-show\-main\-window
+Show the main window.
+.TP
+.B \-v, \-\-version
+Print version number and exit.
+.TP
+.B \-H, \-\-headless
+Starts Audacious in headless mode.
+.SH SKINS
+Audacious supports Winamp Classic style skins.  Skins may be stored in either
+archived (\fI.zip\fP, \fI.wsz\fP, \fI.tgz\fP, \fI.tar.gz\fP, 
+or \fI.tar.bz2\fP) or unarchived format.  Audacious looks for skinfiles in
+@datadir@/audacious/Skins, ~/.audacious/Skins, and locations specified by the
+\fBSKINSDIR\fP variable.
+.SH KEYBINDINGS
+Global keybindings for Audacious:
+
+.in +2
+.ta \w'Shift + Control + w 'u
+z	Previous song
+.br
+x	Play
+.br
+c	Pause
+.br
+v	Stop
+.br
+b	Next song
+.br
+l	Play file
+.br
+j	Jump to file
+.br
+r	Toggle Repeat
+.br
+s	Toggle Shuffle
+.br
+Shift + l	Play directory
+.br
+Control + l	Play location
+.br
+Control + p	Preferences dialog
+.br
+Control + v	Visualization plugin dialog
+.br
+Control + r	Time remaining
+.br
+Control + a	Always on top
+.br
+Control + w	Winshade mode
+.br
+Control + d	Doublesize mode
+.br
+Control + e	Easy move
+.br
+Control + j	Jump to time
+.br
+Control + z	Start of list
+.br
+Control + n	No Playlist Advance
+.br
+Control + 3	File info dialog
+.br
+Control + Alt + w	Toggle Equalizer winshade mode
+.br
+Shift + Control + w	Playlist winshade mode
+.br
+Alt + w	Hide/show mainwindow
+.br
+Alt + e	Hide/show playlistwindow
+.br
+Alt + g	Hide/show Equalizer
+.br
+Alt + s	Skin selecting window
+.in -2
+
+Main window specific:
+
+.in +2
+.br
+Arrow key up	Volume up 2%
+.br
+Arrow key down	Volume down 2%
+.br
+Arrow key right	Skip 5 seconds forward in song
+.br
+Arrow key left	Skip 5 seconds back in song
+.in -2
+
+Playlist window specific:
+
+.in +2
+.br
+Arrow key up	Up one step in playlist
+.br
+Arrow key down	Down one step in playlist
+.br
+Delete	Remove selected songs from playlist
+.br
+Page Up	Move one page up
+.br
+Page Down	Move one page down
+.br
+Home	First page in playlist
+.br
+End	Last page in playlist
+.br
+Enter	Play selected song
+.br
+Insert	Add file dialog
+.br
+Shift + Insert	Add directory dialog
+.br
+Alt + Insert	Add url dialog
+.in -2 
+
+Equalizer shade mode specific:
+
+.in +2
+.br
+Arrow key up	Volume up 2%
+.br
+Arrow key down	Volume down 2%
+.br
+Arrow key right	Balance 4% to right
+.br
+Arrow key left	Balance 4% to left
+.in -2
+.SH HEADLESS OPERATION
+Audacious supports a headless operation mode, where Audacious does not use
+X11 and instead operates as a daemon. You should note that you cannot switch
+between daemonized mode and X11 mode, and that if you wish to switch back
+and forth, that you need to do so when starting the program.
+
+When using Audacious in headless mode, you will need a client. Clients
+compatible with Audacious are listed on the Audacious website.
+.SH FILES
+.TP \w'~/.audacious/playlist.m3uXX'u
+~/.audacious/config
+User's Audacious configuration.
+.TP
+~/.audacious/playlist.m3u
+Default playlist usually loaded on startup.
+.TP
+~/.audacious/gtkrc 
+User's set of Audacious-specific GTK config settings. Options such as widget
+color and fonts sizes can be set here.
+.TP
+~/.audacious/menurc 
+User's set of keybindings.
+.TP
+~/.audacious/Skins, @datadir@/audacious/Skins
+Default location(s) where Audacious should look for skinfiles.
+.TP
+~/.audacious/Plugins
+Location of user-installed plugins.
+.SH ENVIRONMENT
+.TP 12
+.B SKINSDIR
+Colon separated list of paths where Audacious should look for skinfiles.
+.TP
+.B TARCMD
+Tar command supporting GNU tar style decompression.  Used for
+unpacking gzip and bzip2 compressed skins.  Default is \fItar\fP.
+.TP
+.B UNZIPCMD
+Command for decompressing zip files (skins).  Default is \fIunzip\fP.
+.SH OTHER INFO
+The webpage for Audacious is at http://www.audacious-media-player.org.  
+Here you can find info about Audacious, download the latest version, 
+plugins, and skins.
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/man/audtool.1.in	Sat Jan 13 14:40:03 2007 -0800
@@ -0,0 +1,223 @@
+.TH AUDTOOL 1 "November 2006" "Version @VERSION@"
+.SH NAME
+.B audtool
+- a small tool to modify behavior of a running audacious instance.
+.SH SYNOPSIS
+.B audtool
+[\-\-[[handler [parameters]]
+.SH DESCRIPTION
+.B audtool
+is designed to send commands to a running audacious.
+.PP
+It can handle various things like jumping to the next track in playlist
+or returning the current playing track title, as well as other status
+information.
+.SH OPTIONS
+.B "Now playing information:"
+.TP
+.I --current-song
+Returns current song title.
+.TP
+.I --current-song-filename
+Returns current song filename.
+.TP
+.I --current-song-length
+Returns current song length.
+.TP
+.I --current-song-length-seconds
+Returns current song length in seconds.
+.TP
+.I --current-song-length-frames
+Returns current song length in frames.
+.TP
+.I --current-song-output-length
+Returns current song output length.
+.TP
+.I --current-song-output-length-seconds
+Returns current song output length in seconds.
+.TP
+.I --current-song-output-length-frames
+Returns current song output length in frames.
+.TP
+.I --current-song-bitrate
+Returns current song bitrate in bits per second.
+.TP
+.I --current-song-bitrate-kbps
+Returns current song bitrate in kilobits per second.
+.TP
+.I --current-song-frequency
+Returns current song frequency in hertz.
+.TP
+.I --current-song-frequency-khz
+Returns current song frequency in kilohertz.
+.TP
+.I --current-song-channels
+Returns current song channels.
+.PP
+.B "Playlist manipulation:"
+.TP
+.I --playlist-advance
+Go to the next song in the playlist.
+.TP
+.I --playlist-reverse
+Go to the previous song in the playlist.
+.TP
+.I --playlist-addurl <uri>
+Adds a uri to the playlist.
+.TP
+.I --playlist-delete <position>
+Deletes the song at <position> from the playlist.
+.TP
+.I --playlist-length
+Returns the total length of the playlist.
+.TP
+.I --playlist-song <position>
+Returns the title of the song at <position> in the playlist.
+.TP
+.I --playlist-song-filename <position>
+Returns the filename of the song at <position> in the playlist.
+.TP
+.I --playlist-song-length <position>
+Returns the length of the song at <position> in the playlist.
+.TP
+.I --playlist-song-length-seconds <position>
+Returns the length of the song at <position> in the playlist in seconds.
+.TP
+.I --playlist-song-length-frames <position>
+Returns the length of the song at <position> in the playlist in frames.
+.TP
+.I --playlist-display
+Returns the entire playlist.
+.TP
+.I --playlist-position
+Returns the current position in the playlist.
+.TP
+.I --playlist-jump <position>
+Jumps to <position> in the playlist.
+.TP
+.I --playlist-clear
+Clears the playlist.
+.TP
+.I --playlist-repeat-status
+Returns the status of playlist repeat.
+.TP
+.I --playlist-repeat-toggle
+Toggles playlist repeat.
+.TP
+.I --playlist-shuffle-status
+Returns the status of playlist shuffle.
+.TP
+.I --playlist-shuffle-toggle
+Toggles playlist shuffle.
+.PP
+.B Playqueue manipulation:
+.TP
+.I --playqueue-add <position>
+Adds the song at <position> in the playlist to the playqueue.
+.TP
+.I --playqueue-remove <position>
+Removes the song at <position> in the playlist from the playqueue.
+.TP
+.I --playqueue-is-queued <position>
+Returns OK if the song at <postion> in the playtlist is queued.
+.TP
+.I --playqueue-get-position <position>
+Returns the playqueue position of the song at <position> in the playlist.
+.TP
+.I --playqueue-get-qposition <qposition>
+Returns the playlist position of the song at <qposition> in the playqueue.
+.TP
+.I --playqueue-length
+Returns the length of the playqueue.
+.TP
+.I --playqueue-display
+Returns a list of currently\-queued songs.
+.TP
+.I --playqueue-clear
+Clears the playqueue.
+.PP
+.B "Playback manipulation:"
+.TP
+.I --playback-play
+Starts/unpauses song playback.
+.TP
+.I --playback-pause
+(Un)pauses song playback.
+.TP
+.I --playback-playpause
+Plays/(un)pauses song playback.
+.TP
+.I --playback-stop
+Stops song playback.
+.TP
+.I --playback-playing
+Returns OK if audacious is playing.
+.TP
+.I --playback-paused
+Returns OK if audacious is paused.
+.TP
+.I --playback-stopped
+Returns OK if audacious is stopped.
+.TP
+.I --playback-status
+Returns the playback status.
+.TP
+.I --playback-seek
+Performs an absolute seek in milliseconds.
+.TP
+.I --playback-seek-relative
+Performs a seek relative to the current position in milliseconds.
+.PP
+.B "Volume control:"
+.TP
+.I --get-volume
+Returns the current volume level in percent.
+.TP
+.I --set-volume <level>
+Sets the current volume level in percent.
+.PP
+.B "Miscellaneous:"
+.TP
+.I --preferences
+Shows/hides the preferences window.
+.TP
+.I --jumptofile
+Shows the jump to file window.
+.TP
+.I --shutdown
+Shuts down audacious.
+.PP
+.B "Help system:"
+.TP
+.I --list-handlers
+Shows handlers list.
+.TP
+.I --help
+Shows handlers list.
+.PP
+Handlers may be prefixed with `\-\-' (GNU\-style long\-options) or not, your choice.
+.SH BUGS
+There are no known bugs in audtool at this time; if you find any please
+report them to <bugs+audtool@atheme.org>.
+.SH AUTHORS
+.B audtool
+was written by George Averill <nhjm@nhjm.net> and William 
+Pitcock <nenolod@atheme.org>.
+.PP
+This manual page was written by Adam Cecile <gandalf@le-vert.net> and 
+Kiyoshi Aman <kiyoshi@atheme.org>. Some additional tweaks were done by 
+William Pitcock <nenolod@atheme.org>.
+.PP
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU General Public License, Version 2 or any
+later version published by the Free Software Foundation.
+.PP
+The complete text of the GNU General Public License is available in the
+sourcecode of Audacious, and is typically included with binary packages 
+as well.
+.PP
+If installed with an operating system, see your Operating System's 
+documentation for licensing details.
+.SH SEE ALSO
+.B Homepage:
+http://audacious-media-player.org/