gentoo-ebuilds/media-sound/mpd/files/mpd.1-0.24.2
Nicolas PARLANT 3f83d2daec
media-sound/mpd: add 0.24.2
SRC_URI : use $(ver_cut 1-2)

iuse :
* rm cue, no dep
* rm fifo, no dep
* rm pipe, no dep
* rm udisks (this is only dbus)
* rm network (was httpd+shout, but this is two different plugins)
* rm yajl, it's used only with qobuz/snapcast/soundcloud
* add httpd
* add shout
* add tremor
* upstream prefers mpg123 over mad, so +mpg123
REQUIRED_USE :
* soundcloud don't require qobuz

deps :
* boost is not longer required
* libogg is required only for opus/tremor/vorbis
* for qobuz, select ffmpeg/libgcrypt with ffmpeg/!ffmpeg
* media-libs/libsidplay is no longer supported (masked for ppc/ppc64)
* twolame/lame are only required for httpd/shout/recorder

documentation :
* add sphinx-rtd-theme
* set HTML_DOCS
* use manpages from DISTFILES if !doc

initscript :
* use eerror and return 1 for failures
* stop sed of mpd.conf after the first occurence of 'user'

Closes: https://bugs.gentoo.org/939943
Closes: https://bugs.gentoo.org/944145
Signed-off-by: Nicolas PARLANT <nicolas.parlant@parhuet.fr>
Signed-off-by: Sam James <sam@gentoo.org>
2025-04-08 10:32:11 +01:00

105 lines
2.7 KiB
Groff

.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "MPD" "1" "Apr 08, 2025" "0.24.2" "Music Player Daemon"
.SH NAME
mpd \- MPD documentation
.SH SYNOPSIS
.sp
\fBmpd\fP [options] [CONF_FILE]
.SH DESCRIPTION
.sp
MPD is a daemon for playing music. Music is played through the configured audio output(s) (which are generally local, but can be remote). The daemon stores info about all available music, and this info can be easily searched and retrieved. Player control, info retrieval, and playlist management can all be managed remotely.
.sp
MPD searches for a config file in \fB$XDG_CONFIG_HOME/mpd/mpd.conf\fP
then \fB~/.mpdconf\fP then \fB~/.mpd/mpd.conf\fP then \fB/etc/mpd.conf\fP or uses \fBCONF_FILE\fP\&.
.sp
Read more about MPD at \X'tty: link http://www.musicpd.org/'\fI\%http://www.musicpd.org/\fP\X'tty: link'
.SH OPTIONS
.INDENT 0.0
.TP
.B \-\-help
Output a brief help message.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-kill
Kill the currently running mpd session. The pid_file parameter must be specified in the config file for this to work.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-config
Don\(aqt read from the configuration file.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-daemon
Don\(aqt detach from console.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-stderr
Print messages to stderr.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-systemd
Used on Linux only so MPD can reliably detect whether it was started as a systemd service. Users shouldn\(aqt use this switch on the command line.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-verbose
Verbose logging.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-version
Print version information.
.UNINDENT
.SH FILES
.INDENT 0.0
.TP
.B \fB$XDG_CONFIG_HOME/mpd/mpd.conf\fP
User configuration file (usually \fB~/.config/mpd/mpd.conf\fP).
.TP
.B \fB/etc/mpd.conf\fP
Global configuration file.
.UNINDENT
.SH SEE ALSO
.sp
\fBmpd.conf(5)\fP, \fBmpc(1)\fP
.SH BUGS
.sp
If you find a bug, please report it at \X'tty: link https://github.com/MusicPlayerDaemon/MPD/issues/'\fI\%https://github.com/MusicPlayerDaemon/MPD/issues/\fP\X'tty: link'
.SH AUTHOR
Max Kellermann
.SH COPYRIGHT
2003-2025 The Music Player Daemon Project
.\" Generated by docutils manpage writer.
.