
                     CMus - C* Music Player

                Copyright 2004-2005 Timo Hirvonen

Installation
============

Configuration
-------------

  ./configure --help
  ./configure

Before running 'make' verify that all features you want have been
configured (see lines after 'Configuration:'). You need to install
development versions of the dependencies.

For example if you want to use 'mad' input plugin (mp3) you need to
install libmad0-dev (Debian) or libmad-devel (RPM) package. After
installing dependencies you need to run ./configure again, of course.

Building
--------

  make help
  make

Installation
------------

  make install


Documentation
=============

See $datadir/cmus/doc/cmus.html (e.g. /usr/share/cmus/doc/cmus.html).


Known Problems
==============

According to the README file included in libmodplug, it should
understand following compressed mods:

    zip:  mdz,  s3z,  xmz,  itz
    rar:  mdr,  s3r,  xmr,  itr
    gzip: mdgz, s3gz, xmgz, itgz

But I've not been able to play any compressed mods. Uncompressed mods
play without problems.


Reporting Bugs
==============

After a crash send bug report with last lines of /tmp/cmus-debug to
tihirvon@ee.oulu.fi.  /tmp/cmus-debug file exists only if you configured
cmus with maximum debug level (./configure DEBUG=2).

Also it would be good to know what distribution/kernel you are using, so
please include output of 'uname -a' command in the bug report.
