Make mp3_seek_next_header() more readable.

[paraslash.git] / fade.ggo

diff --git a/fade.ggo b/fade.ggo
index c57267da6bec471ae598d4948c422dac56f1adfd..814a656f1145ef474176602825b6b6d45a3cc90f 100644 (file)
--- a/fade.ggo
+++ b/fade.ggo
@@ -1,27 +1,155 @@
 section "general options"
-option "mode" o "{sleep|fade|snooze}" string default="sleep" no
-option "config_file" c "(default='~/.paraslash/fade.conf')" string typestr="filename" no
-option "mixer_device" m "mixer device file" string typestr="device" default="/dev/mixer" no
+#########################
+
+option "mode" o
+#~~~~~~~~~~~~~~
+
+"{sleep|fade|snooze}"
+       string default="sleep"
+       optional
+
+option "config_file" c
+#~~~~~~~~~~~~~~~~~~~~~
+ "(default='~/.paraslash/fade.conf')"
+       string typestr="filename"
+       optional
+
+option "mixer_device" m
+#~~~~~~~~~~~~~~~~~~~~~~
+ "mixer device file"
+       string typestr="device"
+       default="/dev/mixer"
+       optional
 
 section "sleep options (only relevant in sleep mode)"
-option "sleep_ivol" - "set initial volume before doing anything else" int typestr="volume" default="60" no
-option "fa_stream" - "fall asleep stream. Change to this stream right after setting the volume" string typestr="streamname" default="fa" no
-option "fa_fade" - "fall asleep fading time, no fading if set to 0" int typestr="seconds" default="1800" no
-option "fa_vol" - "volume to fade to" int typestr="volume" default="20" no
-option "sleep_stream" - "change to this stream after fading, stop playing if unset" string typestr="streamname" default="sleep" no
-option "wake_hour" H "(0-23)" int default="8" no
-option "wake_min" M "(0-59)" int default="0" no
-option "wake_stream" - "changed to on waketime" string typestr="streamname" default="wake" no
-option "wake_fade" - "no fading in if set to 0" int typestr="seconds" default="1200" no
-option "wake_vol" - "vol to fade to at waketime" int typestr="volume" default="80" no
+#####################################################
+
+option "sleep_ivol" -
+#~~~~~~~~~~~~~~~~~~~~
+ "set initial volume before doing anything else"
+       int typestr="volume"
+       default="60"
+       optional
+
+option "fa_mode" -
+#~~~~~~~~~~~~~~~~~~~
+ "fall asleep afs mode. Select this mode
+right after setting the volume. Example:
+       --fa_mode m:sleep
+"
+
+       string typestr="afs_mode"
+       default="m:fa"
+       optional
+
+option "fa_fade" -
+#~~~~~~~~~~~~~~~~~
+ "fall asleep fading time, no fading if set
+to 0"
+       int typestr="seconds"
+       default="1800"
+       optional
+
+option "fa_vol" -
+#~~~~~~~~~~~~~~~~
+ "volume to fade to"
+       int typestr="volume"
+       default="20"
+       optional
+
+option "sleep_mode" -
+#~~~~~~~~~~~~~~~~~~~~~~
+ "change to this afs mode after fading, stop
+playing if unset."
+       string typestr="afs_mode"
+       default="m:sleep"
+       optional
+
+option "wake_hour" H
+#~~~~~~~~~~~~~~~~~~~
+ "(0-23) (default: now + 9 hours)"
+       int typestr="hour"
+       optional
+
+option "wake_min" M
+#~~~~~~~~~~~~~~~~~~
+"(0-59)"
+       int typestr="seconds"
+       default="0"
+       optional
+
+option "wake_mode" -
+#~~~~~~~~~~~~~~~~~~~~~
+ "change to this afs mode on waketime"
+       string typestr="afs_mode"
+       default="m:wake"
+       optional
+
+option "wake_fade" -
+#~~~~~~~~~~~~~~~~~~~
+ "no fading in if set to 0"
+       int typestr="seconds"
+       default="1200"
+       optional
+
+option "wake_vol" -
+#~~~~~~~~~~~~~~~~~~
+ "vol to fade to at waketime"
+       int typestr="volume"
+       default="80"
+       optional
 
 section "snooze options"
-option "snooze_out_fade" - "fade out time" int typestr="seconds" default="30" no
-option "snooze_out_vol" - "vol to fade to before snooze" int typestr="volume" default="20" no
-option "snooze_time" - "delay" int typestr="seconds" default="600" no 
-option "snooze_in_fade" - "fade in time" int typestr="seconds" default="180" no
-option "snooze_in_vol" - "vol to fade to after snooze" int typestr="volume" default="80" no
+########################
+
+option "snooze_out_fade" -
+#~~~~~~~~~~~~~~~~~~~~~~~~~
+ "fade out time"
+       int typestr="seconds"
+       default="30"
+       optional
+
+option "snooze_out_vol" -
+#~~~~~~~~~~~~~~~~~~~~~~~~
+ "vol to fade to before snooze"
+       int typestr="volume"
+       default="20"
+       optional
+
+option "snooze_time" -
+#~~~~~~~~~~~~~~~~~~~~~
+ "delay"
+       int typestr="seconds"
+       default="600"
+       optional
+
+option "snooze_in_fade" -
+#~~~~~~~~~~~~~~~~~~~~~~~~
+ "fade in time"
+       int typestr="seconds"
+       default="180"
+       optional
+
+option "snooze_in_vol" -
+#~~~~~~~~~~~~~~~~~~~~~~~
+ "vol to fade to after snooze"
+       int typestr="volume"
+       default="80"
+       optional
 
 section "fade options"
-option "fade_vol" f "volume to fade to" int typestr="volume" default="50" no
-option "fade_time" t "time to fade in" int typestr="seconds" default="5" no
+######################
+
+option "fade_vol" f
+#~~~~~~~~~~~~~~~~~~
+ "volume to fade to"
+       int typestr="volume"
+       default="50"
+       optional
+
+option "fade_time" t
+#~~~~~~~~~~~~~~~~~~~
+ "time to fade in"
+       int typestr="seconds"
+       default="5"
+       optional