Merge branch 't/afh_receiver'
[paraslash.git] / m4 / gengetopt / afh.m4
1 args "--unamed-opts=audio_file --no-handle-version"
2
3 include(header.m4)
4 <qu>
5 text "
6 para_afh, the audio format handler tool, is a simple program for analyzing
7 audio files. It prints technical information about the given audio file to
8 stdout.
9 "
10 </qu>
11
12 include(loglevel.m4)
13
14 <qu>
15 option "chunk_table" c
16 #~~~~~~~~~~~~~~~~~~~~~
17 "print also the chunk table"
18 flag off
19 details = "
20 The 'chunk table' of an audio file is an array of offsets
21 within the audio file. Each offset corresponds to chunk
22 of encoded data. The exact meaning of 'chunk' depends on
23 the audio format.
24
25 Programs which are unaware of the particular audio format can
26 read the chunk table to obtain the timing information needed
27 to stream the file.
28 "
29
30 option "parser-friendly" p
31 #~~~~~~~~~~~~~~~~~~~~~~~~~
32 "do not use human-readable output format"
33 flag off
34 details = "
35 Currently this option only affects the format of the chunk table,
36 so it has no effect if --chunk_table is not given.
37
38 The human-readable output (the default) consists of one output
39 line per chunk and the output contains also the chunk number,
40 the duration and the size of each chunk. The parser-friendly
41 output prints only the offsets, in one line.
42 "
43 </qu>