From 97e74ab40f208840f2330d64f5f053aab9d5fa44 Mon Sep 17 00:00:00 2001
From: Andre <maan@p133.(none)>
Date: Tue, 18 Apr 2006 22:36:37 +0200
Subject: [PATCH] reformat and improve write.ggo

add more documentation for the --writer option, reorder options
and move alsa-specific options to an own section.
---
 write.ggo | 78 +++++++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 65 insertions(+), 13 deletions(-)

diff --git a/write.ggo b/write.ggo
index b1c80839..4afff0c0 100644
--- a/write.ggo
+++ b/write.ggo
@@ -1,33 +1,85 @@
 section "general options"
-option "start_time" t "start playback at given time which must be in a:b format where a denotes seconds and b denotes microseconds since the epoch" string typestr="timeval" optional
-option "device" d "set PCM device" string typestr="device" default="plughw:0,0" optional
-option "channels" c "number of channels (only neccessary for raw audio)" int typestr="num" default="2" optional
-option "sample_rate" s "force given sample rate (only neccessary for raw audio)" int typestr="num" default="44100" optional
-option "bufsize" b "input buffer size" int typestr="kilobytes" default="64" optional
-option "prebuffer" p "delay playback until buffer is filled" int typestr="percent" default="100" optional
+#########################
+
+option "list_writers" L
+#~~~~~~~~~~~~~~~~~~~~~~
+"print available writers and exit"
+
+	flag off
+	optional
+
 option "loglevel" l
 #~~~~~~~~~~~~~~~~~~
-
 "set loglevel (0-6)"
 
 	int typestr="level"
 	default="4"
 	optional
 
+option "bufsize" b
+#~~~~~~~~~~~~~~~~~
+"input buffer size"
+
+	int typestr="kilobytes"
+	default="64"
+	optional
+
+option "prebuffer" p
+#~~~~~~~~~~~~~~~~~~~
+"delay playback until buffer is filled"
+
+	int typestr="percent"
+	default="100"
+	optional
 
 option "writer" w
-#~~~~~~~~~~~~~~~
+#~~~~~~~~~~~~~~~~
 
-"select stream writer"
+"select stream writer
+may be give multiple times. The same writer
+may be specified more than once"
 
 	string typestr="name"
 	default="alsa (file if alsa is unsupported)"
 	optional
 	multiple
 
-option "list_writers" L
-#~~~~~~~~~~~~~~~~~~~~~~
-"print available writers and exit"
+option "start_time" t
+#~~~~~~~~~~~~~~~~~~~~
+"start playback at given time which must be
+in a:b format where a denotes seconds and b
+denotes microseconds since the epoch"
 
-	flag off
+	string typestr="timeval"
+	optional
+
+
+section "alsa options"
+######################
+
+option "device" d
+#~~~~~~~~~~~~~~~~
+"set PCM device"
+	string typestr="device"
+	default="plughw:0,0"
 	optional
+
+option "channels" c
+#~~~~~~~~~~~~~~~~~~
+"number of channels (only neccessary for raw
+audio)"
+
+	int typestr="num"
+	default="2"
+	optional
+
+option "sample_rate" s
+#~~~~~~~~~~~~~~~~~~~~~
+
+"force given sample rate (only neccessary for
+raw audio)"
+
+	int typestr="num"
+	default="44100"
+	optional
+
-- 
2.39.5