.

will be generated. You may view the manual page with: nroff -man .

| less'. A typical entry in a Makefile or Makefile.am is: DB2MAN = /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/manpages/docbook.xsl XP = xsltproc -''-nonet -''-param man.charmap.use.subset "0" manpage.1: manpage.xml $(XP) $(DB2MAN) $< The xsltproc binary is found in the xsltproc package. The XSL files are in docbook-xsl. A description of the parameters you can use can be found in the docbook-xsl-doc-* packages. Please remember that if you create the nroff version in one of the debian/rules file targets (such as build), you will need to include xsltproc and docbook-xsl in your Build-Depends control field. Alternatively use the xmlto command/package. That will also automatically pull in xsltproc and docbook-xsl. Notes for using docbook2x: docbook2x-man does not automatically create the AUTHOR(S) and COPYRIGHT sections. In this case, please add them manually as ... . To disable the automatic creation of the AUTHOR(S) and COPYRIGHT sections read /usr/share/doc/docbook-xsl/doc/manpages/authors.html. This file can be found in the docbook-xsl-doc-html package. Validation can be done using: `xmllint -''-noout -''-valid manpage.xml` General documentation about man-pages and man-page-formatting: man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ --> ]> &header; &dhpackage; &dhpackage; will try to maintain some titles ahead in your play list following different policies. &dhpackage; --daemon --config=conf_file --var_dir=var_directory --pid=pid_file --log=log_file --host=mpd_host --mpd_port=mpd_port --new-version &dhpackage; --var_dir=var_directory --create-db> &dhpackage; -h --help --version This manual page documents briefly the &dhpackage; commands. At start up default configuration is first overridden by user configuration in mpd_sima.cfg (see ) and finally command lines options are honored. For instance you can override default MPD_HOST set in defaults (localhost) or in your configuration file with -S my_mpd_server option. For default configuration see . Here follows an example on how to launch &dhpackage; as a service on your system, not attach to regular user configuration/database. &dhpackage; --daemon --conf=/etc/mpd_sima.cfg --var_dir=/var/cache/mpd-sima/ --pid=/var/run/mpd-sima.pid --log=/var/log/mpd-sima.log Launching &dhpackage; from/whithin your user acount is easy, you can simply call &dhpackage; from your shell or one of the following command: Background execution (dæmonise), log in the specified file, save pid: &dhpackage; --daemon --pid=$HOME/var/run/mpd-sima.pid --log=$HOME/var/log/mpd-sima.log Foreground execution, connect my.mpd.server.org, log to std(out|err): &dhpackage; --host=my.mpd.server.org The program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below. -h --help Print help and exit. --version Print version and exit. --daemon Start as a daemon. Log redirected to /dev/null, usually setting --log and --pid options in daemon mode are a good idea to monitor/stop the process. -p pid_file --pid=pid_file Use the specific file pid_file to store pid to.Default is not to store pid info. -l log_file --log=log_file Use the specific file log_file to log messages to.Default is to log to stdout/stderr. -c conf_file --config=conf_file Use the specific file conf_file to set up configuration instead of looking for the default user configuration file.Default is to look for $XDG_CONFIG_HOME/mpd_sima/mpd_sima.cfg. Concerning this file see also .Pay attention: Because you load a specific configuration file from command line interface does not mean it will override others options pass to mpd_sima. In other words launching with -P 6666 will override port setting whatever the configuration file your using, default or command line specified. --var_dir=var_directory Use the specific path var_directory to look for (or create) var files (ie. database) instead of looking at the default user data location.Default is to look in $XDG_DATA_HOME/mpd_sima/. Concerning $XDG_DATA_HOME see also --create-db Create the database and exit. Uses folder specified with --var_dir or default directory.Default is to use $XDG_DATA_HOME/mpd_sima/. Concerning $XDG_DATA_HOME see also -S mpd_host --host=mpd_host Use the specific host mpd_host as MPD server.mpd_host can be an IP or a fully qualified domain name as long as your system can resolve it. This overrides MPD_HOST environment variable.Default is localhost. See also . -P mpd_port --port=mpd_port Use the specific port number mpd_port on MPD server. This overrides MPD_PORT environment variable.Default is 6600. See also --new-version Check and log for new version at start up (issue a warning). ${XDG_CONFIG_HOME}/mpd_sima/mpd_sima.cfg The per-user configuration file. Usually XDG_CONFIG_HOME is set to ${HOME}/.config. ${XDG_DATA_HOME}/mpd_sima/sima.db SQLite database. Usually XDG_DATA_HOME is set to ${HOME}/.local/share. MPD_HOST, MPD_PORT &dhutils; will look for MPD_HOST and MPD_PORT to override built-in configuration (set to "localhost:6600"). &dhutils; expects MPD_HOST syntax as documented in mpc manual, cf. mpc1. To use a password, provide a value of the form "password@host". mpd_sima.cfg mpd_sima.cfg is read if present. Otherwise built-ib defaults are used. An example should be provided in the tarball within doc/examples/mpd_sima.cfg. On Debian system please look in /usr/share/doc/&dhpackage;. DEFAULTS Default is to look for MPD server at localhost:6600 (or MPD_HOST/MPD_PORT env. var. if set). The default behavior is to add one track, this track is to be chosen among titles from artists similar to the artist of the currently played track. MPD_sima will add one track when the play list is one track long. To change these defaults, use the configuration file mpd_sima.cfg &feedback_bugs; mpc 1 , mpd 1 /usr/share/doc/mpd-sima/