Merge branch 't/misc_cleanups'
[paraslash.git] / m4 / gengetopt / play.m4
1 args "--unamed-opts=audio_file --no-handle-version --conf-parser --no-handle-help"
2
3 purpose "Command line audio player."
4
5 description "para_play operates either in command mode or in insert
6 mode. In insert mode it presents a prompt and allows to enter commands
7 like stop, play, pause etc. In command mode the current audio file
8 is shown and the program reads single key strokes from stdin. Keys
9 may be mapped to commands. Whenever a mapped key is pressed, the
10 associated command is executed."
11
12 include(header.m4)
13 define(CURRENT_PROGRAM,para_play)
14 define(DEFAULT_CONFIG_FILE,~/.paraslash/play.conf)
15 define(DEFAULT_HISTORY_FILE,~/.paraslash/play.history)
16
17 <qu>
18 #########################
19 section "General options"
20 #########################
21 </qu>
22 include(loglevel.m4)
23 include(config_file.m4)
24 include(history_file.m4)
25 <qu>
26
27 ###############################
28 section "Options for para_play"
29 ###############################
30
31 option "randomize" z
32 #~~~~~~~~~~~~~~~~~~~
33 "randomize playlist at startup."
34 flag off
35
36 option "key-map" k
37 #~~~~~~~~~~~~~~~~~
38 "Map key k to a command."
39
40 string typestr = "key:command [args]"
41 optional
42 multiple
43 details = "
44         This option may be given multiple times, one for each key
45         mapping. Example:
46                 5:jmp 50
47 "
48 </qu>