dtas 0.16.1 → 0.19.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (170) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +1 -1
  3. data/Documentation/.gitignore +1 -1
  4. data/Documentation/GNUmakefile +2 -2
  5. data/Documentation/dtas-archive.pod +2 -2
  6. data/Documentation/dtas-console.pod +2 -2
  7. data/Documentation/dtas-ctl.pod +2 -2
  8. data/Documentation/dtas-cueedit.pod +2 -2
  9. data/Documentation/dtas-enq.pod +2 -2
  10. data/Documentation/dtas-env.pod +3 -3
  11. data/Documentation/dtas-msinkctl.pod +2 -2
  12. data/Documentation/dtas-player.pod +2 -2
  13. data/Documentation/dtas-player_effects.pod +2 -2
  14. data/Documentation/dtas-player_protocol.pod +4 -4
  15. data/Documentation/dtas-player_sink_examples.pod +2 -2
  16. data/Documentation/dtas-sinkedit.pod +4 -4
  17. data/Documentation/dtas-sourceedit.pod +4 -4
  18. data/Documentation/dtas-splitfx.pod +7 -1
  19. data/Documentation/dtas-tl.pod +4 -4
  20. data/Documentation/dtas-xdelay.pod +2 -2
  21. data/Documentation/update-footer.rb +2 -2
  22. data/GIT-VERSION-FILE +1 -1
  23. data/GIT-VERSION-GEN +2 -2
  24. data/GNUmakefile +13 -1
  25. data/HACKING +2 -2
  26. data/INSTALL +10 -24
  27. data/NEWS +103 -0
  28. data/README +14 -8
  29. data/Rakefile +1 -1
  30. data/TODO +3 -1
  31. data/bin/dtas-archive +1 -1
  32. data/bin/dtas-console +17 -21
  33. data/bin/dtas-ctl +1 -1
  34. data/bin/dtas-cueedit +1 -1
  35. data/bin/dtas-enq +1 -1
  36. data/bin/dtas-mlib +1 -1
  37. data/bin/dtas-msinkctl +1 -1
  38. data/bin/dtas-partstats +1 -1
  39. data/bin/dtas-player +1 -1
  40. data/bin/dtas-readahead +3 -3
  41. data/bin/dtas-sinkedit +1 -1
  42. data/bin/dtas-sourceedit +1 -1
  43. data/bin/dtas-splitfx +8 -1
  44. data/bin/dtas-tl +1 -1
  45. data/bin/dtas-xdelay +1 -1
  46. data/dtas-linux.gemspec +2 -2
  47. data/dtas-mpris.gemspec +2 -2
  48. data/dtas.gemspec +3 -3
  49. data/dtas.sh +7 -0
  50. data/examples/zsh-completion/README +3 -0
  51. data/examples/zsh-completion/_dtas-archive +16 -0
  52. data/examples/zsh-completion/_dtas-ctl +114 -0
  53. data/examples/zsh-completion/_dtas-cueedit +7 -0
  54. data/examples/zsh-completion/_dtas-enq +7 -0
  55. data/examples/zsh-completion/_dtas-mlib +29 -0
  56. data/examples/zsh-completion/_dtas-msinkctl +8 -0
  57. data/examples/zsh-completion/_dtas-partstats +7 -0
  58. data/examples/zsh-completion/_dtas-sinkedit +11 -0
  59. data/examples/zsh-completion/_dtas-sourceedit +11 -0
  60. data/examples/zsh-completion/_dtas-splitfx +17 -0
  61. data/examples/zsh-completion/_dtas-tl +52 -0
  62. data/examples/zsh-completion/_dtas-xdelay +17 -0
  63. data/lib/dtas/buffer/fiddle_splice.rb +216 -0
  64. data/lib/dtas/buffer/read_write.rb +3 -3
  65. data/lib/dtas/buffer/splice.rb +9 -5
  66. data/lib/dtas/buffer.rb +10 -7
  67. data/lib/dtas/command.rb +1 -1
  68. data/lib/dtas/compat_onenine.rb +1 -1
  69. data/lib/dtas/cue_index.rb +1 -1
  70. data/lib/dtas/disclaimer.rb +1 -1
  71. data/lib/dtas/edit_client.rb +1 -1
  72. data/lib/dtas/encoding.rb +8 -9
  73. data/lib/dtas/fadefx.rb +1 -1
  74. data/lib/dtas/format.rb +1 -1
  75. data/lib/dtas/mcache.rb +1 -1
  76. data/lib/dtas/mlib/migrations/0001_initial.rb +1 -1
  77. data/lib/dtas/mlib.rb +19 -7
  78. data/lib/dtas/nonblock.rb +1 -1
  79. data/lib/dtas/parse_freq.rb +1 -1
  80. data/lib/dtas/parse_time.rb +1 -1
  81. data/lib/dtas/partstats.rb +2 -3
  82. data/lib/dtas/pipe.rb +13 -9
  83. data/lib/dtas/pipeline.rb +1 -1
  84. data/lib/dtas/player/client_handler.rb +23 -15
  85. data/lib/dtas/player.rb +3 -3
  86. data/lib/dtas/process.rb +1 -1
  87. data/lib/dtas/replaygain.rb +1 -1
  88. data/lib/dtas/rg_state.rb +1 -1
  89. data/lib/dtas/serialize.rb +1 -1
  90. data/lib/dtas/sigevent/efd.rb +3 -1
  91. data/lib/dtas/sigevent/fiddle_efd.rb +38 -0
  92. data/lib/dtas/sigevent/pipe.rb +2 -2
  93. data/lib/dtas/sigevent.rb +6 -3
  94. data/lib/dtas/sink.rb +1 -1
  95. data/lib/dtas/source/av.rb +1 -1
  96. data/lib/dtas/source/av_ff_common.rb +2 -2
  97. data/lib/dtas/source/cmd.rb +1 -1
  98. data/lib/dtas/source/common.rb +1 -1
  99. data/lib/dtas/source/ff.rb +1 -1
  100. data/lib/dtas/source/file.rb +1 -1
  101. data/lib/dtas/source/mp3gain.rb +1 -1
  102. data/lib/dtas/source/sox.rb +2 -2
  103. data/lib/dtas/source/splitfx.rb +1 -1
  104. data/lib/dtas/source.rb +1 -1
  105. data/lib/dtas/spawn_fix.rb +1 -1
  106. data/lib/dtas/splitfx.rb +9 -8
  107. data/lib/dtas/state_file.rb +1 -1
  108. data/lib/dtas/tfx.rb +1 -1
  109. data/lib/dtas/track.rb +1 -1
  110. data/lib/dtas/tracklist.rb +1 -1
  111. data/lib/dtas/unix_accepted.rb +1 -1
  112. data/lib/dtas/unix_client.rb +1 -1
  113. data/lib/dtas/unix_server.rb +1 -1
  114. data/lib/dtas/util.rb +1 -1
  115. data/lib/dtas/version.rb +1 -1
  116. data/lib/dtas/watchable/fiddle_ino.rb +78 -0
  117. data/lib/dtas/watchable/inotify.rb +13 -0
  118. data/lib/dtas/watchable.rb +59 -58
  119. data/lib/dtas/writable_iter.rb +1 -1
  120. data/lib/dtas/xs.rb +1 -1
  121. data/lib/dtas.rb +10 -2
  122. data/man/dtas-archive.1 +15 -15
  123. data/man/dtas-console.1 +19 -19
  124. data/man/dtas-ctl.1 +16 -16
  125. data/man/dtas-cueedit.1 +12 -12
  126. data/man/dtas-enq.1 +12 -12
  127. data/man/dtas-env.7 +15 -15
  128. data/man/dtas-msinkctl.1 +12 -12
  129. data/man/dtas-player.1 +24 -24
  130. data/man/dtas-player_effects.7 +9 -9
  131. data/man/dtas-player_protocol.7 +48 -48
  132. data/man/dtas-player_sink_examples.7 +15 -15
  133. data/man/dtas-sinkedit.1 +16 -16
  134. data/man/dtas-sourceedit.1 +17 -17
  135. data/man/dtas-splitfx.1 +43 -38
  136. data/man/dtas-tl.1 +16 -16
  137. data/man/dtas-xdelay.1 +16 -16
  138. data/perl/dtas-graph +7 -2
  139. data/setup.rb +1 -2
  140. data/test/covshow.rb +1 -1
  141. data/test/helper.rb +1 -1
  142. data/test/player_integration.rb +1 -1
  143. data/test/test_buffer.rb +6 -6
  144. data/test/test_encoding.rb +1 -1
  145. data/test/test_env.rb +1 -1
  146. data/test/test_fadefx.rb +1 -1
  147. data/test/test_format.rb +1 -1
  148. data/test/test_format_change.rb +1 -1
  149. data/test/test_mcache.rb +1 -1
  150. data/test/test_mlib.rb +1 -1
  151. data/test/test_parse_freq.rb +1 -1
  152. data/test/test_pipeline.rb +1 -1
  153. data/test/test_player.rb +1 -1
  154. data/test/test_player_client_handler.rb +1 -1
  155. data/test/test_player_integration.rb +1 -1
  156. data/test/test_process.rb +1 -1
  157. data/test/test_rg_integration.rb +1 -1
  158. data/test/test_rg_state.rb +1 -1
  159. data/test/test_sigevent.rb +20 -0
  160. data/test/test_sink.rb +1 -1
  161. data/test/test_sink_pipe_size.rb +13 -16
  162. data/test/test_sink_tee_integration.rb +1 -1
  163. data/test/test_source_av.rb +1 -1
  164. data/test/test_source_sox.rb +1 -1
  165. data/test/test_splitfx.rb +1 -1
  166. data/test/test_tfx.rb +1 -1
  167. data/test/test_tracklist.rb +1 -1
  168. data/test/test_unixserver.rb +1 -1
  169. data/test/test_util.rb +1 -1
  170. metadata +23 -4
@@ -1,4 +1,4 @@
1
- .\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
1
+ .\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
2
2
  .\"
3
3
  .\" Standard preamble:
4
4
  .\" ========================================================================
@@ -46,7 +46,7 @@
46
46
  .ie \n(.g .ds Aq \(aq
47
47
  .el .ds Aq '
48
48
  .\"
49
- .\" If the F register is turned on, we'll generate index entries on stderr for
49
+ .\" If the F register is >0, we'll generate index entries on stderr for
50
50
  .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
51
51
  .\" entries marked with X<> in POD. Of course, you'll have to process the
52
52
  .\" output yourself in some meaningful fashion.
@@ -56,12 +56,12 @@
56
56
  ..
57
57
  .nr rF 0
58
58
  .if \n(.g .if rF .nr rF 1
59
- .if (\n(rF:(\n(.g==0)) \{
60
- . if \nF \{
59
+ .if (\n(rF:(\n(.g==0)) \{\
60
+ . if \nF \{\
61
61
  . de IX
62
62
  . tm Index:\\$1\t\\n%\t"\\$2"
63
63
  ..
64
- . if !\nF==2 \{
64
+ . if !\nF==2 \{\
65
65
  . nr % 0
66
66
  . nr F 2
67
67
  . \}
@@ -133,7 +133,7 @@
133
133
  .\" ========================================================================
134
134
  .\"
135
135
  .IX Title "DTAS-PLAYER_SINK_EXAMPLES 7"
136
- .TH DTAS-PLAYER_SINK_EXAMPLES 7 "1994-10-02" "dtas 0.14.2.13.g9152" "dtas user manual"
136
+ .TH DTAS-PLAYER_SINK_EXAMPLES 7 "1994-10-02" "dtas 0.18.1" "dtas user manual"
137
137
  .\" For nroff, turn off justification. Always turn off hyphenation; it makes
138
138
  .\" way too many mistakes in technical documents.
139
139
  .if n .ad l
@@ -149,7 +149,7 @@ dtas-sinkedit \s-1SINKNAME\s0
149
149
  .IX Header "EXAMPLES"
150
150
  .SS "Streaming Ogg-Vorbis to Icecast"
151
151
  .IX Subsection "Streaming Ogg-Vorbis to Icecast"
152
- To use \fIoggfwd\fR\|(1) and Icecast, the following sink works.
152
+ To use \fBoggfwd\fR\|(1) and Icecast, the following sink works.
153
153
  Warning: the following example will likely expose your Icecast source
154
154
  password to any local users on the system.
155
155
  .PP
@@ -161,7 +161,7 @@ password to any local users on the system.
161
161
  .Ve
162
162
  .SS "Stream to a remote host via ssh"
163
163
  .IX Subsection "Stream to a remote host via ssh"
164
- Alternatively, if you have \fIplay\fR\|(1) installed on any remote host and
164
+ Alternatively, if you have \fBplay\fR\|(1) installed on any remote host and
165
165
  a slow connection using Ogg-Vorbis:
166
166
  .PP
167
167
  .Vb 6
@@ -191,7 +191,7 @@ the above Ogg-Vorbis example.
191
191
  To configure a dumper sink (in addition to the \*(L"default\*(R" sink). Note
192
192
  the use of \f(CW$SOXFMT\fR, this will be automatically expanded to match the
193
193
  internal format of the player. The internal format of the player is
194
- described in \fIdtas\-player_protocol\fR\|(7).
194
+ described in \fBdtas\-player_protocol\fR\|(7).
195
195
  .PP
196
196
  .Vb 1
197
197
  \& $ dtas\-ctl sink ed dumper command=\*(Aqsox $SOXFMT \- /tmp/dump.sox\*(Aq
@@ -206,21 +206,21 @@ Non\-\*(L"default\*(R" sinks are not active by default, but may be made active.
206
206
  Changing it again to \*(L"active=false\*(R" will deactivate the sink.
207
207
  .SS "Apply a short delay to low frequencies to improve time-alignment"
208
208
  .IX Subsection "Apply a short delay to low frequencies to improve time-alignment"
209
- See \fIdtas\-xdelay\fR\|(1).
209
+ See \fBdtas\-xdelay\fR\|(1).
210
210
  .SH "CONTACT"
211
211
  .IX Header "CONTACT"
212
212
  All feedback welcome via plain-text mail to: <mailto:dtas\-all@nongnu.org>
213
213
  .PP
214
214
  Mailing list archives available at <https://80x24.org/dtas\-all/>
215
- and <ftp://lists.gnu.org/dtas\-all/>
215
+ and <https://lists.gnu.org/archive/html/dtas\-all/>
216
216
  .PP
217
217
  No subscription is necessary to post to the mailing list.
218
218
  .SH "COPYRIGHT"
219
219
  .IX Header "COPYRIGHT"
220
- Copyright 2013\-2016 all contributors <mailto:dtas\-all@nongnu.org>
220
+ Copyright 2013\-2020 all contributors <mailto:dtas\-all@nongnu.org>
221
221
  .PP
222
- License: \s-1GPL\-3.0+ \s0<https://www.gnu.org/licenses/gpl\-3.0.txt>
222
+ License: \s-1GPL\-3.0+\s0 <https://www.gnu.org/licenses/gpl\-3.0.txt>
223
223
  .SH "SEE ALSO"
224
224
  .IX Header "SEE ALSO"
225
- \&\fIdtas\-ctl\fR\|(1), \fIdtas\-sinkedit\fR\|(1), \fIdtas\-xdelay\fR\|(1),
226
- \&\fIsox\fR\|(1), \fIplay\fR\|(1), \fIoggfwd\fR\|(1), \fIssh\fR\|(1), \fIssh_config\fR\|(5), \fIenv\fR\|(1)
225
+ \&\fBdtas\-ctl\fR\|(1), \fBdtas\-sinkedit\fR\|(1), \fBdtas\-xdelay\fR\|(1),
226
+ \&\fBsox\fR\|(1), \fBplay\fR\|(1), \fBoggfwd\fR\|(1), \fBssh\fR\|(1), \fBssh_config\fR\|(5), \fBenv\fR\|(1)
data/man/dtas-sinkedit.1 CHANGED
@@ -1,4 +1,4 @@
1
- .\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
1
+ .\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
2
2
  .\"
3
3
  .\" Standard preamble:
4
4
  .\" ========================================================================
@@ -46,7 +46,7 @@
46
46
  .ie \n(.g .ds Aq \(aq
47
47
  .el .ds Aq '
48
48
  .\"
49
- .\" If the F register is turned on, we'll generate index entries on stderr for
49
+ .\" If the F register is >0, we'll generate index entries on stderr for
50
50
  .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
51
51
  .\" entries marked with X<> in POD. Of course, you'll have to process the
52
52
  .\" output yourself in some meaningful fashion.
@@ -56,12 +56,12 @@
56
56
  ..
57
57
  .nr rF 0
58
58
  .if \n(.g .if rF .nr rF 1
59
- .if (\n(rF:(\n(.g==0)) \{
60
- . if \nF \{
59
+ .if (\n(rF:(\n(.g==0)) \{\
60
+ . if \nF \{\
61
61
  . de IX
62
62
  . tm Index:\\$1\t\\n%\t"\\$2"
63
63
  ..
64
- . if !\nF==2 \{
64
+ . if !\nF==2 \{\
65
65
  . nr % 0
66
66
  . nr F 2
67
67
  . \}
@@ -133,7 +133,7 @@
133
133
  .\" ========================================================================
134
134
  .\"
135
135
  .IX Title "DTAS-SINKEDIT 1"
136
- .TH DTAS-SINKEDIT 1 "1994-10-02" "dtas 0.14.2.13.g9152" "dtas user manual"
136
+ .TH DTAS-SINKEDIT 1 "1994-10-02" "dtas 0.18.1" "dtas user manual"
137
137
  .\" For nroff, turn off justification. Always turn off hyphenation; it makes
138
138
  .\" way too many mistakes in technical documents.
139
139
  .if n .ad l
@@ -146,10 +146,10 @@ dtas-sinkedit \s-1SINKNAME\s0
146
146
  .SH "DESCRIPTION"
147
147
  .IX Header "DESCRIPTION"
148
148
  dtas-sinkedit spawns an editor to allow editing of a sink as a \s-1YAML\s0 file.
149
- See \fIdtas\-player_protocol\fR\|(7) for details on \s-1SINKARGS.\s0
149
+ See \fBdtas\-player_protocol\fR\|(7) for details on \s-1SINKARGS.\s0
150
150
  .PP
151
- On Linux machines with the sleepy_penguin RubyGem installed, \fIinotify\fR\|(7)
152
- is used to monitor the file for changes while the text exitor is running.
151
+ On Linux machines, \fBinotify\fR\|(7)
152
+ is used to monitor the file for changes while the text editor is running.
153
153
  Each time a user finishes saving a file, changes are committed immediately.
154
154
  This behavior may be disabled by using the \-N or \-\-no\-watch command-line
155
155
  switch.
@@ -157,7 +157,7 @@ switch.
157
157
  .IX Header "OPTIONS"
158
158
  .IP "\-N, \-\-no\-watch" 4
159
159
  .IX Item "-N, --no-watch"
160
- Disable \fIinotify\fR\|(7) support on Linux systems
160
+ Disable \fBinotify\fR\|(7) support on Linux systems
161
161
  .IP "\-n, \-\-dry\-run" 4
162
162
  .IX Item "-n, --dry-run"
163
163
  Only print commands which would be sent to dtas-player
@@ -184,23 +184,23 @@ Successfully exiting your text editor will send the changes to the
184
184
  running dtas-player.
185
185
  .SH "ENVIRONMENT"
186
186
  .IX Header "ENVIRONMENT"
187
- \&\s-1VISUAL / EDITOR \-\s0 your favorite *nix text editor, defaults to 'vi' if unset.
187
+ \&\s-1VISUAL / EDITOR\s0 \- your favorite *nix text editor, defaults to 'vi' if unset.
188
188
  .PP
189
- \&\s-1DTAS_PLAYER_SOCK \-\s0 the path to the dtas-player control socket.
189
+ \&\s-1DTAS_PLAYER_SOCK\s0 \- the path to the dtas-player control socket.
190
190
  This defaults to ~/.dtas/player.sock
191
191
  .SH "CONTACT"
192
192
  .IX Header "CONTACT"
193
193
  All feedback welcome via plain-text mail to: <mailto:dtas\-all@nongnu.org>
194
194
  .PP
195
195
  Mailing list archives available at <https://80x24.org/dtas\-all/>
196
- and <ftp://lists.gnu.org/dtas\-all/>
196
+ and <https://lists.gnu.org/archive/html/dtas\-all/>
197
197
  .PP
198
198
  No subscription is necessary to post to the mailing list.
199
199
  .SH "COPYRIGHT"
200
200
  .IX Header "COPYRIGHT"
201
- Copyright 2013\-2016 all contributors <mailto:dtas\-all@nongnu.org>
201
+ Copyright 2013\-2020 all contributors <mailto:dtas\-all@nongnu.org>
202
202
  .PP
203
- License: \s-1GPL\-3.0+ \s0<https://www.gnu.org/licenses/gpl\-3.0.txt>
203
+ License: \s-1GPL\-3.0+\s0 <https://www.gnu.org/licenses/gpl\-3.0.txt>
204
204
  .SH "SEE ALSO"
205
205
  .IX Header "SEE ALSO"
206
- \&\fIdtas\-player\fR\|(1), \fIdtas\-player_protocol\fR\|(7), \fIdtas\-ctl\fR\|(1)
206
+ \&\fBdtas\-player\fR\|(1), \fBdtas\-player_protocol\fR\|(7), \fBdtas\-ctl\fR\|(1)
@@ -1,4 +1,4 @@
1
- .\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
1
+ .\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
2
2
  .\"
3
3
  .\" Standard preamble:
4
4
  .\" ========================================================================
@@ -46,7 +46,7 @@
46
46
  .ie \n(.g .ds Aq \(aq
47
47
  .el .ds Aq '
48
48
  .\"
49
- .\" If the F register is turned on, we'll generate index entries on stderr for
49
+ .\" If the F register is >0, we'll generate index entries on stderr for
50
50
  .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
51
51
  .\" entries marked with X<> in POD. Of course, you'll have to process the
52
52
  .\" output yourself in some meaningful fashion.
@@ -56,12 +56,12 @@
56
56
  ..
57
57
  .nr rF 0
58
58
  .if \n(.g .if rF .nr rF 1
59
- .if (\n(rF:(\n(.g==0)) \{
60
- . if \nF \{
59
+ .if (\n(rF:(\n(.g==0)) \{\
60
+ . if \nF \{\
61
61
  . de IX
62
62
  . tm Index:\\$1\t\\n%\t"\\$2"
63
63
  ..
64
- . if !\nF==2 \{
64
+ . if !\nF==2 \{\
65
65
  . nr % 0
66
66
  . nr F 2
67
67
  . \}
@@ -133,7 +133,7 @@
133
133
  .\" ========================================================================
134
134
  .\"
135
135
  .IX Title "DTAS-SOURCEEDIT 1"
136
- .TH DTAS-SOURCEEDIT 1 "1994-10-02" "dtas 0.14.2.13.g9152" "dtas user manual"
136
+ .TH DTAS-SOURCEEDIT 1 "1994-10-02" "dtas 0.18.1" "dtas user manual"
137
137
  .\" For nroff, turn off justification. Always turn off hyphenation; it makes
138
138
  .\" way too many mistakes in technical documents.
139
139
  .if n .ad l
@@ -146,13 +146,13 @@ dtas-sourceedit {sox | av | ff}
146
146
  .SH "DESCRIPTION"
147
147
  .IX Header "DESCRIPTION"
148
148
  dtas-sourceedit spawns an editor to allow editing of a source as a \s-1YAML\s0 file.
149
- See \fIdtas\-player_protocol\fR\|(7) for details on \s-1SOURCEARGS. \s0 If standard input is
150
- a pipe or file, it is parsed as \s-1YAML\s0 and fed to the \fIdtas\-player\fR\|(1) instance
149
+ See \fBdtas\-player_protocol\fR\|(7) for details on \s-1SOURCEARGS.\s0 If standard input is
150
+ a pipe or file, it is parsed as \s-1YAML\s0 and fed to the \fBdtas\-player\fR\|(1) instance
151
151
  non-interactively. This is useful for loading various profiles from the
152
152
  filesystem.
153
153
  .PP
154
- On Linux machines with the sleepy_penguin RubyGem installed, \fIinotify\fR\|(7)
155
- is used to monitor the file for changes while the text exitor is running.
154
+ On Linux machines, \fBinotify\fR\|(7)
155
+ is used to monitor the file for changes while the text editor is running.
156
156
  Each time a user finishes saving a file, changes are committed immediately.
157
157
  This behavior may be disabled by using the \-N or \-\-no\-watch command-line
158
158
  switch.
@@ -160,7 +160,7 @@ switch.
160
160
  .IX Header "OPTIONS"
161
161
  .IP "\-N, \-\-no\-watch" 4
162
162
  .IX Item "-N, --no-watch"
163
- Disable \fIinotify\fR\|(7) support on Linux systems
163
+ Disable \fBinotify\fR\|(7) support on Linux systems
164
164
  .IP "\-n, \-\-dry\-run" 4
165
165
  .IX Item "-n, --dry-run"
166
166
  Only print commands which would be sent to dtas-player
@@ -195,23 +195,23 @@ To change the way dtas-player calls ffmpeg (lightly-tested):
195
195
  .Ve
196
196
  .SH "ENVIRONMENT"
197
197
  .IX Header "ENVIRONMENT"
198
- \&\s-1VISUAL / EDITOR \-\s0 your favorite *nix text editor, defaults to 'vi' if unset.
198
+ \&\s-1VISUAL / EDITOR\s0 \- your favorite *nix text editor, defaults to 'vi' if unset.
199
199
  .PP
200
- \&\s-1DTAS_PLAYER_SOCK \-\s0 the path to the dtas-player control socket.
200
+ \&\s-1DTAS_PLAYER_SOCK\s0 \- the path to the dtas-player control socket.
201
201
  This defaults to ~/.dtas/player.sock
202
202
  .SH "CONTACT"
203
203
  .IX Header "CONTACT"
204
204
  All feedback welcome via plain-text mail to: <mailto:dtas\-all@nongnu.org>
205
205
  .PP
206
206
  Mailing list archives available at <https://80x24.org/dtas\-all/>
207
- and <ftp://lists.gnu.org/dtas\-all/>
207
+ and <https://lists.gnu.org/archive/html/dtas\-all/>
208
208
  .PP
209
209
  No subscription is necessary to post to the mailing list.
210
210
  .SH "COPYRIGHT"
211
211
  .IX Header "COPYRIGHT"
212
- Copyright 2013\-2016 all contributors <mailto:dtas\-all@nongnu.org>
212
+ Copyright 2013\-2020 all contributors <mailto:dtas\-all@nongnu.org>
213
213
  .PP
214
- License: \s-1GPL\-3.0+ \s0<https://www.gnu.org/licenses/gpl\-3.0.txt>
214
+ License: \s-1GPL\-3.0+\s0 <https://www.gnu.org/licenses/gpl\-3.0.txt>
215
215
  .SH "SEE ALSO"
216
216
  .IX Header "SEE ALSO"
217
- \&\fIdtas\-player\fR\|(1), \fIdtas\-player_protocol\fR\|(7), \fIdtas\-ctl\fR\|(1)
217
+ \&\fBdtas\-player\fR\|(1), \fBdtas\-player_protocol\fR\|(7), \fBdtas\-ctl\fR\|(1)
data/man/dtas-splitfx.1 CHANGED
@@ -1,4 +1,4 @@
1
- .\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
1
+ .\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
2
2
  .\"
3
3
  .\" Standard preamble:
4
4
  .\" ========================================================================
@@ -46,7 +46,7 @@
46
46
  .ie \n(.g .ds Aq \(aq
47
47
  .el .ds Aq '
48
48
  .\"
49
- .\" If the F register is turned on, we'll generate index entries on stderr for
49
+ .\" If the F register is >0, we'll generate index entries on stderr for
50
50
  .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
51
51
  .\" entries marked with X<> in POD. Of course, you'll have to process the
52
52
  .\" output yourself in some meaningful fashion.
@@ -56,12 +56,12 @@
56
56
  ..
57
57
  .nr rF 0
58
58
  .if \n(.g .if rF .nr rF 1
59
- .if (\n(rF:(\n(.g==0)) \{
60
- . if \nF \{
59
+ .if (\n(rF:(\n(.g==0)) \{\
60
+ . if \nF \{\
61
61
  . de IX
62
62
  . tm Index:\\$1\t\\n%\t"\\$2"
63
63
  ..
64
- . if !\nF==2 \{
64
+ . if !\nF==2 \{\
65
65
  . nr % 0
66
66
  . nr F 2
67
67
  . \}
@@ -133,7 +133,7 @@
133
133
  .\" ========================================================================
134
134
  .\"
135
135
  .IX Title "DTAS-SPLITFX 1"
136
- .TH DTAS-SPLITFX 1 "1994-10-02" "dtas 0.14.2.13.g9152" "dtas user manual"
136
+ .TH DTAS-SPLITFX 1 "1994-10-02" "dtas 0.18.1" "dtas user manual"
137
137
  .\" For nroff, turn off justification. Always turn off hyphenation; it makes
138
138
  .\" way too many mistakes in technical documents.
139
139
  .if n .ad l
@@ -149,10 +149,10 @@ dtas-splitfx reads as \s-1YAML\s0 file and can apply effects (including
149
149
  resampling/dither), split, tag, and encode files in parallel.
150
150
  dtas-splitfx is intended for splitting recordings from vinyl and live
151
151
  concerts into separate files. dtas-splitfx is inspired by cuesheets for
152
- \&\s-1CD\s0 audio and the \fImake\fR\|(1) build tool.
152
+ \&\s-1CD\s0 audio and the \fBmake\fR\|(1) build tool.
153
153
  .PP
154
- dtas-splitfx primarily uses \fIsox\fR\|(1), but it is possible to define targets
155
- to use \fIecasound\fR\|(1), too.
154
+ dtas-splitfx primarily uses \fBsox\fR\|(1), but it is possible to define targets
155
+ to use \fBecasound\fR\|(1), too.
156
156
  .SH "OPTIONS"
157
157
  .IX Header "OPTIONS"
158
158
  .IP "\-j, \-\-jobs [\s-1JOBS\s0]" 4
@@ -168,7 +168,12 @@ Silent operation, commands are not printed as executed
168
168
  .IP "\-D, \-\-no\-dither" 4
169
169
  .IX Item "-D, --no-dither"
170
170
  Disable automatic setting of the \s-1DITHERFX\s0 env. This also passes
171
- the option to \fIsox\fR\|(1) via \s-1SOX_OPTS.\s0
171
+ the option to \fBsox\fR\|(1) via \s-1SOX_OPTS.\s0
172
+ .IP "\-E, \-\-err\-suffix \s-1SUFFIX\s0" 4
173
+ .IX Item "-E, --err-suffix SUFFIX"
174
+ Write the contents of \f(CW\*(C`stderr\*(C'\fR. This is useful for capturing
175
+ the per-track output of the \fBsox\fR\|(1) \f(CW\*(C`stats\*(C'\fR effect when
176
+ combined with parallel \f(CW\*(C`\-\-jobs\*(C'\fR.
172
177
  .IP "\-O, \-\-outdir \s-1OUTDIR\s0" 4
173
178
  .IX Item "-O, --outdir OUTDIR"
174
179
  Set output directory instead of current directory.
@@ -177,7 +182,7 @@ User-created targets must allow a placeholder for the
177
182
  in the output command.
178
183
  .IP "\-C, \-\-compression \s-1FACTOR\s0" 4
179
184
  .IX Item "-C, --compression FACTOR"
180
- Set the compression factor passed to \fIsox\fR\|(1). See \fIsoxformat\fR\|(7)
185
+ Set the compression factor passed to \fBsox\fR\|(1). See \fBsoxformat\fR\|(7)
181
186
  for more information on how it works across different formats.
182
187
  .IP "\-r, \-\-rate \s-1RATE\s0" 4
183
188
  .IX Item "-r, --rate RATE"
@@ -196,7 +201,7 @@ argument are automatically expanded to spaces when passed to sox.
196
201
  .IP "\-p, \-\-sox\-pipe" 4
197
202
  .IX Item "-p, --sox-pipe"
198
203
  Used in place of an output target to specify outputting audio data in
199
- the native \*(L"sox\*(R" format to another \fIsox\fR\|(1) or \fIplay\fR\|(1) command. This
204
+ the native \*(L"sox\*(R" format to another \fBsox\fR\|(1) or \fBplay\fR\|(1) command. This
200
205
  moves printing of output to stderr and disables parallel job invocation.
201
206
  .SH "FILE FORMAT"
202
207
  .IX Header "FILE FORMAT"
@@ -237,7 +242,7 @@ highest-numbered track. Default: true
237
242
  .ie n .IP "targets \- hash, see ""\s-1TARGETS""\s0 section" 4
238
243
  .el .IP "targets \- hash, see ``\s-1TARGETS''\s0 section" 4
239
244
  .IX Item "targets - hash, see TARGETS section"
240
- .IP "command \- used only by \fIdtas\-player\fR\|(1)" 4
245
+ .IP "command \- used only by \fBdtas\-player\fR\|(1)" 4
241
246
  .IX Item "command - used only by dtas-player"
242
247
  .PD
243
248
  .SH "TRACKS"
@@ -248,14 +253,14 @@ segment.
248
253
  .IP "t \s-1TIME TITLE\s0 [fade_in/fade_out=FADE_ARGS]" 4
249
254
  .IX Item "t TIME TITLE [fade_in/fade_out=FADE_ARGS]"
250
255
  The start of a new track
251
- at \s-1TIME\s0 with \s-1TITLE. \s0 An optional fade_in and fade_out may be specified
256
+ at \s-1TIME\s0 with \s-1TITLE.\s0 An optional fade_in and fade_out may be specified
252
257
  for the first/last tracks.
253
- .IP "skip \s-1TIME \-\s0 skip a segment starting at \s-1TIME\s0" 4
258
+ .IP "skip \s-1TIME\s0 \- skip a segment starting at \s-1TIME\s0" 4
254
259
  .IX Item "skip TIME - skip a segment starting at TIME"
255
260
  \&\*(L"skip\*(R" segments are
256
261
  useful for skipping long gaps between tracks (such as flipping vinyl
257
262
  or intermission at concerts)
258
- .IP "stop \s-1TIME \-\s0 stop the last track" 4
263
+ .IP "stop \s-1TIME\s0 \- stop the last track" 4
259
264
  .IX Item "stop TIME - stop the last track"
260
265
  This should be the last directive in the \*(L"tracks\*(R" array.
261
266
  .PP
@@ -272,7 +277,7 @@ An example of the tracks array for a 4 track \s-1EP\s0 follows:
272
277
  .Ve
273
278
  .SH "FADES"
274
279
  .IX Header "FADES"
275
- dtas-splitfx automatically sets up fade\-in/fade\-out effects for \fIsox\fR\|(1)
280
+ dtas-splitfx automatically sets up fade\-in/fade\-out effects for \fBsox\fR\|(1)
276
281
  based on track times. These are to be used in \*(L"t\*(R" (track) directives in
277
282
  the \*(L"tracks\*(R" array:
278
283
  .ie n .IP "fade_in=""[\s-1TYPE\s0] \s-1LENGTH""\s0" 4
@@ -284,51 +289,51 @@ the \*(L"tracks\*(R" array:
284
289
  .IX Item "fade_out=[TYPE] LENGTH"
285
290
  .PD
286
291
  .PP
287
- \&\s-1TYPE\s0 is optional, but \s-1LENGTH\s0 is required. See \fIsox\fR\|(1) for a description
292
+ \&\s-1TYPE\s0 is optional, but \s-1LENGTH\s0 is required. See \fBsox\fR\|(1) for a description
288
293
  of the fade type.
289
294
  .SH "ENVIRONMENT"
290
295
  .IX Header "ENVIRONMENT"
291
296
  dtas-splitfx sets several default environment variables for commands to
292
297
  use in targets:
293
- .ie n .IP "\s-1INFILE \-\s0 this matches the ""infile"" directive in the \s-1YAML\s0 file" 4
294
- .el .IP "\s-1INFILE \-\s0 this matches the ``infile'' directive in the \s-1YAML\s0 file" 4
298
+ .ie n .IP "\s-1INFILE\s0 \- this matches the ""infile"" directive in the \s-1YAML\s0 file" 4
299
+ .el .IP "\s-1INFILE\s0 \- this matches the ``infile'' directive in the \s-1YAML\s0 file" 4
295
300
  .IX Item "INFILE - this matches the infile directive in the YAML file"
296
301
  .PD 0
297
- .IP "\s-1INDIR \-\s0 the directory \s-1INFILE\s0 belongs to, without trailing slash" 4
302
+ .IP "\s-1INDIR\s0 \- the directory \s-1INFILE\s0 belongs to, without trailing slash" 4
298
303
  .IX Item "INDIR - the directory INFILE belongs to, without trailing slash"
299
- .IP "\s-1INBASE \-\s0 the basename of \s-1INFILE\s0" 4
304
+ .IP "\s-1INBASE\s0 \- the basename of \s-1INFILE\s0" 4
300
305
  .IX Item "INBASE - the basename of INFILE"
301
- .IP "\s-1TBEG \-\s0 the integer sample offset where the \fIsox\fR\|(1) trim effect starts" 4
306
+ .IP "\s-1TBEG\s0 \- the integer sample offset where the \fBsox\fR\|(1) trim effect starts" 4
302
307
  .IX Item "TBEG - the integer sample offset where the sox trim effect starts"
303
- .IP "\s-1TLEN \-\s0 the integer sample count representing the length of the trim" 4
308
+ .IP "\s-1TLEN\s0 \- the integer sample count representing the length of the trim" 4
304
309
  .IX Item "TLEN - the integer sample count representing the length of the trim"
305
- .IP "\s-1TRIMFX \-\s0 essential" 4
310
+ .IP "\s-1TRIMFX\s0 \- essential" 4
306
311
  .IX Item "TRIMFX - essential"
307
312
  .PD
308
- Supplies the necessary \fIsox\fR\|(1) trim effect to
313
+ Supplies the necessary \fBsox\fR\|(1) trim effect to
309
314
  each track. In other words, this is: \*(L"trim ${\s-1TBEG\s0}s ${\s-1TLEN\s0}s\*(R"
310
- .IP "\s-1COMMENTS \-\s0 expands to \-\-comment\-file=PATH for \fIsox\fR\|(1)" 4
315
+ .IP "\s-1COMMENTS\s0 \- expands to \-\-comment\-file=PATH for \fBsox\fR\|(1)" 4
311
316
  .IX Item "COMMENTS - expands to --comment-file=PATH for sox"
312
317
  .PD 0
313
- .IP "\s-1OUTDIR \-\s0 placeholder for \-\-outdir, defaults to an empty string" 4
318
+ .IP "\s-1OUTDIR\s0 \- placeholder for \-\-outdir, defaults to an empty string" 4
314
319
  .IX Item "OUTDIR - placeholder for --outdir, defaults to an empty string"
315
- .ie n .IP "\s-1SUFFIX \-\s0 the suffix of the output format without ""."" (e.g. ""flac"", ""ogg"")" 4
316
- .el .IP "\s-1SUFFIX \-\s0 the suffix of the output format without ``.'' (e.g. ``flac'', ``ogg'')" 4
320
+ .ie n .IP "\s-1SUFFIX\s0 \- the suffix of the output format without ""."" (e.g. ""flac"", ""ogg"")" 4
321
+ .el .IP "\s-1SUFFIX\s0 \- the suffix of the output format without ``.'' (e.g. ``flac'', ``ogg'')" 4
317
322
  .IX Item "SUFFIX - the suffix of the output format without . (e.g. flac, ogg)"
318
- .IP "\s-1TRACKNUMBER \-\s0 the track number, useful for comments and filenames" 4
323
+ .IP "\s-1TRACKNUMBER\s0 \- the track number, useful for comments and filenames" 4
319
324
  .IX Item "TRACKNUMBER - the track number, useful for comments and filenames"
320
- .IP "\s-1RATEFX \-\s0 rate effect and arguments for \fIsox\fR\|(1) resampling" 4
325
+ .IP "\s-1RATEFX\s0 \- rate effect and arguments for \fBsox\fR\|(1) resampling" 4
321
326
  .IX Item "RATEFX - rate effect and arguments for sox resampling"
322
- .IP "\s-1DITHERFX \-\s0 dither effect and arguments for \fIsox\fR\|(1) dithering" 4
327
+ .IP "\s-1DITHERFX\s0 \- dither effect and arguments for \fBsox\fR\|(1) dithering" 4
323
328
  .IX Item "DITHERFX - dither effect and arguments for sox dithering"
324
- .IP "\s-1FX \-\s0 any user-specified sox effects which encompases the entire file." 4
329
+ .IP "\s-1FX\s0 \- any user-specified sox effects which encompases the entire file." 4
325
330
  .IX Item "FX - any user-specified sox effects which encompases the entire file."
326
331
  .PD
327
332
  (e.g. \*(L"highpass 35 gain 3 stats\*(R")
328
333
  .SH "TARGETS"
329
334
  .IX Header "TARGETS"
330
335
  The default targets will split audio and avoid applying any effects.
331
- They are named after common audio formats supported by \fIsox\fR\|(1):
336
+ They are named after common audio formats supported by \fBsox\fR\|(1):
332
337
  .IP "flac" 4
333
338
  .IX Item "flac"
334
339
  .PD 0
@@ -369,9 +374,9 @@ imbalance in a live concert recording from the audience:
369
374
  .Ve
370
375
  .SH "COPYRIGHT"
371
376
  .IX Header "COPYRIGHT"
372
- Copyright 2013\-2016 all contributors <mailto:dtas\-all@nongnu.org>
377
+ Copyright 2013\-2020 all contributors <mailto:dtas\-all@nongnu.org>
373
378
  .PP
374
- License: \s-1GPL\-3.0+ \s0<https://www.gnu.org/licenses/gpl\-3.0.txt>
379
+ License: \s-1GPL\-3.0+\s0 <https://www.gnu.org/licenses/gpl\-3.0.txt>
375
380
  .SH "SEE ALSO"
376
381
  .IX Header "SEE ALSO"
377
- \&\fIsox\fR\|(1), \fIecasound\fR\|(1), \fIflac\fR\|(1), \fIdtas\-player\fR\|(1)
382
+ \&\fBsox\fR\|(1), \fBecasound\fR\|(1), \fBflac\fR\|(1), \fBdtas\-player\fR\|(1)