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