diff --git a/darkice/trunk/darkice.cfg b/darkice/trunk/darkice.cfg
index 42afdf1..4c3f542 100644
--- a/darkice/trunk/darkice.cfg
+++ b/darkice/trunk/darkice.cfg
@@ -1,24 +1,56 @@
 # sample DarkIce configuration file, edit for your needs before using
-# see the DarkIce man page for details
+# see the darkice.cfg man page for details
+
+# this section describes general aspects of the live streaming session
 [general]
-duration        = 60
-bufferSecs      = 5
+duration        = 60        # duration of encoding, in seconds. 0 means forever
+bufferSecs      = 5         # size of internal slip buffer, in seconds
 
+# this section describes the audio input that will be streamed
 [input]
-device          = /dev/dsp
-sampleRate      = 22050
-bitsPerSample   = 16
-channel         = 2
+device          = /dev/dsp  # OSS DSP soundcard device for the audio input
+sampleRate      = 22050     # sample rate in Hz. try 11025, 22050 or 44100
+bitsPerSample   = 16        # bits per sample. try 16
+channel         = 2         # channels. 1 = mono, 2 = stereo
 
-[lame0]
-bitrate         = 96
+# this section describes a streaming connection to an IceCast server
+# there may be up to 8 of these sections, named [icecast-0] ... [icecast-7]
+# these can be mixed with [shoutcast-x] sections
+[icecast-0]
+bitrate         = 96        # bitrate of the mp3 stream sent to the server
 server          = yp.yourserver.com
-port            = 8000
-password        = hackme
-mountPoint      = live96
+                            # host name of the server
+port            = 8000      # port of the IceCast server, usually 8000
+password        = hackme    # source password to the IceCast server
+mountPoint      = sample96  # mount point of this stream on the IceCast server
 name            = DarkIce trial
+                            # name of the stream
 description     = This is only a trial
+                            # description of the stream
 url             = http://www.yourserver.com
-genre           = live
-public          = no
-remoteDumpFile  = /tmp/live96.mp3
+                            # URL related to the stream
+genre           = my own    # genre of the stream
+public          = yes       # advertise this stream?
+
+# this section describes a streaming connection to a ShoutCast server
+# there may be up to 8 of these sections, named [shoutcast-0] ... [shoutcast-7]
+# these can be mixed with [icecast-x] sections
+[shoutcast-0]
+bitrate         = 96        # bitrate of the mp3 stream sent to the server
+server          = yp.yourserver.com
+                            # host name of the server
+port            = 8001      # source port of the ShoutCast server, usually 8001
+password        = hackme    # source password to the ShoutCast server
+name            = DarkIce trial
+                            # name of the stream
+url             = http://www.yourserver.com
+                            # URL related to the stream
+genre           = my own    # genre of the stream
+public          = yes       # advertise this stream?
+irc             = irc.yourserver.com
+                            # IRC info related to the stream
+aim             = aim here  # AIM info related to the stream
+icq             = I see you too
+                            # ICQ info related to the stream
+
+