dtas 0.9.0 → 0.10.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (120) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +1 -1
  3. data/Documentation/.gitignore +1 -1
  4. data/Documentation/GNUmakefile +3 -1
  5. data/Documentation/dtas-archive.txt +61 -0
  6. data/Documentation/dtas-console.txt +4 -3
  7. data/Documentation/dtas-ctl.txt +4 -3
  8. data/Documentation/dtas-cueedit.txt +4 -3
  9. data/Documentation/dtas-enq.txt +4 -3
  10. data/Documentation/dtas-env.txt +60 -0
  11. data/Documentation/dtas-msinkctl.txt +4 -3
  12. data/Documentation/dtas-player.txt +6 -3
  13. data/Documentation/dtas-player_effects.txt +4 -3
  14. data/Documentation/dtas-player_protocol.txt +27 -4
  15. data/Documentation/dtas-player_sink_examples.txt +7 -3
  16. data/Documentation/dtas-sinkedit.txt +20 -3
  17. data/Documentation/dtas-sourceedit.txt +21 -3
  18. data/Documentation/dtas-splitfx.txt +14 -5
  19. data/Documentation/dtas-tl.txt +4 -3
  20. data/Documentation/dtas-xdelay.txt +4 -3
  21. data/Documentation/update-footer.rb +52 -0
  22. data/GIT-VERSION-GEN +2 -2
  23. data/GNUmakefile +1 -1
  24. data/HACKING +3 -2
  25. data/INSTALL +6 -6
  26. data/README +1 -1
  27. data/Rakefile +2 -3
  28. data/TODO +1 -1
  29. data/bin/dtas-archive +187 -0
  30. data/bin/dtas-console +7 -1
  31. data/bin/dtas-ctl +1 -1
  32. data/bin/dtas-cueedit +3 -3
  33. data/bin/dtas-enq +1 -1
  34. data/bin/dtas-msinkctl +1 -1
  35. data/bin/dtas-partstats +10 -4
  36. data/bin/dtas-player +1 -1
  37. data/bin/dtas-sinkedit +82 -20
  38. data/bin/dtas-sourceedit +64 -22
  39. data/bin/dtas-splitfx +1 -1
  40. data/bin/dtas-tl +1 -1
  41. data/bin/dtas-xdelay +1 -1
  42. data/dtas-linux.gemspec +1 -1
  43. data/dtas-mpris.gemspec +1 -1
  44. data/dtas.gemspec +1 -1
  45. data/examples/splitfx.sample.yml +11 -3
  46. data/examples/{trimfx.sample.yml → tfx.sample.yml} +1 -1
  47. data/lib/dtas.rb +2 -1
  48. data/lib/dtas/buffer.rb +5 -5
  49. data/lib/dtas/buffer/read_write.rb +8 -5
  50. data/lib/dtas/buffer/splice.rb +29 -8
  51. data/lib/dtas/command.rb +2 -2
  52. data/lib/dtas/compat_onenine.rb +1 -1
  53. data/lib/dtas/cue_index.rb +3 -1
  54. data/lib/dtas/disclaimer.rb +1 -1
  55. data/lib/dtas/edit_client.rb +1 -1
  56. data/lib/dtas/fadefx.rb +100 -0
  57. data/lib/dtas/format.rb +4 -2
  58. data/lib/dtas/parse_time.rb +3 -1
  59. data/lib/dtas/partstats.rb +8 -10
  60. data/lib/dtas/pipe.rb +2 -1
  61. data/lib/dtas/player.rb +33 -11
  62. data/lib/dtas/player/client_handler.rb +43 -8
  63. data/lib/dtas/process.rb +6 -14
  64. data/lib/dtas/replaygain.rb +3 -3
  65. data/lib/dtas/rg_state.rb +1 -1
  66. data/lib/dtas/serialize.rb +3 -1
  67. data/lib/dtas/sigevent.rb +1 -1
  68. data/lib/dtas/sigevent/efd.rb +5 -4
  69. data/lib/dtas/sigevent/pipe.rb +4 -1
  70. data/lib/dtas/sink.rb +4 -4
  71. data/lib/dtas/source.rb +1 -1
  72. data/lib/dtas/source/av.rb +2 -2
  73. data/lib/dtas/source/av_ff_common.rb +22 -11
  74. data/lib/dtas/source/cmd.rb +3 -3
  75. data/lib/dtas/source/common.rb +3 -2
  76. data/lib/dtas/source/ff.rb +2 -2
  77. data/lib/dtas/source/file.rb +22 -4
  78. data/lib/dtas/source/mp3gain.rb +1 -1
  79. data/lib/dtas/source/sox.rb +7 -7
  80. data/lib/dtas/source/splitfx.rb +99 -0
  81. data/lib/dtas/spawn_fix.rb +10 -0
  82. data/lib/dtas/splitfx.rb +63 -24
  83. data/lib/dtas/state_file.rb +3 -1
  84. data/lib/dtas/{trimfx.rb → tfx.rb} +50 -24
  85. data/lib/dtas/tracklist.rb +2 -1
  86. data/lib/dtas/unix_accepted.rb +2 -2
  87. data/lib/dtas/unix_client.rb +2 -2
  88. data/lib/dtas/unix_server.rb +1 -1
  89. data/lib/dtas/util.rb +1 -1
  90. data/lib/dtas/watchable.rb +54 -0
  91. data/lib/dtas/writable_iter.rb +2 -1
  92. data/lib/dtas/xs.rb +2 -2
  93. data/perl/dtas-graph +1 -1
  94. data/test/covshow.rb +1 -1
  95. data/test/helper.rb +1 -1
  96. data/test/player_integration.rb +1 -1
  97. data/test/test_buffer.rb +1 -1
  98. data/test/test_env.rb +1 -1
  99. data/test/test_fadefx.rb +45 -0
  100. data/test/test_format.rb +1 -1
  101. data/test/test_format_change.rb +1 -1
  102. data/test/test_player.rb +1 -1
  103. data/test/test_player_client_handler.rb +1 -1
  104. data/test/test_player_integration.rb +8 -8
  105. data/test/test_process.rb +1 -1
  106. data/test/test_rg_integration.rb +1 -1
  107. data/test/test_rg_state.rb +1 -1
  108. data/test/test_sink.rb +1 -1
  109. data/test/test_sink_pipe_size.rb +2 -2
  110. data/test/test_sink_tee_integration.rb +1 -1
  111. data/test/test_source_av.rb +1 -1
  112. data/test/test_source_sox.rb +1 -1
  113. data/test/test_splitfx.rb +43 -13
  114. data/test/test_tfx.rb +85 -0
  115. data/test/test_tracklist.rb +1 -1
  116. data/test/test_unixserver.rb +1 -1
  117. data/test/test_util.rb +1 -1
  118. metadata +17 -6
  119. data/lib/dtas/compat_rbx.rb +0 -12
  120. data/test/test_trimfx.rb +0 -81
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 8b0b0d8dd1821f734ace3e87aaa92a223b78ffa7
4
- data.tar.gz: 5814678e639f987d9d5fb9331b845fdfebfa58ba
3
+ metadata.gz: c54778751c0184208c6b3320212ab7e773483b32
4
+ data.tar.gz: d2a8569104855efac0f6c139ac98cd24e63a5df5
5
5
  SHA512:
6
- metadata.gz: 394434abb8864ae92fffea854b42aac8323a1ccbb88b8baec124d2debe55edb06164bc94a31af96eea9b5e1fad3d0be45f3160ae9f88b7364bdef6366b18d1da
7
- data.tar.gz: 9cb48221cf82cc5b1789b7b8778e4b3a06b9e5337767157b691a45a45f24a6a70635aebd916a73b4f10935f1fdd67d7b9e6b08d8510439fd888bdbcaea1697d5
6
+ metadata.gz: 649e06bd203fe263e49283255390af8de78189fffcc69c33ca7851555e845c6055062cb4d2556f59ddc0291e627ce93cb75aa5e6b0f4494849ed63e9d59e5279
7
+ data.tar.gz: dac95c3d27d76984cb0f0493354059531843489dfa393da4a52e07eccbc108f730e899388b5fad19d1a00cc5a0cb2ade6f0bd5c44566a4929e762c608e239d63
data/.gitignore CHANGED
@@ -1,4 +1,4 @@
1
- # Copyright (C) 2013-2014, Eric Wong <e@80x24.org> and all contributors
1
+ # Copyright (C) 2013-2015 all contributors <dtas-all@nongnu.org>
2
2
  # License: GPLv3 or later (https://www.gnu.org/licenses/gpl-3.0.txt)
3
3
  /GIT-VERSION-FILE
4
4
  /Manifest.txt
@@ -1,4 +1,4 @@
1
- # Copyright (C) 2013-2014, Eric Wong <e@80x24.org> and all contributors
1
+ # Copyright (C) 2013-2015 all contributors <dtas-all@nongnu.org>
2
2
  # License: GPLv3 or later (https://www.gnu.org/licenses/gpl-3.0.txt)
3
3
  *.1
4
4
  *.5
@@ -1,4 +1,4 @@
1
- # Copyright (C) 2013-2014, Eric Wong <e@80x24.org> and all contributors
1
+ # Copyright (C) 2013-2015 all contributors <dtas-all@nongnu.org>
2
2
  # License: GPLv3 or later (https://www.gnu.org/licenses/gpl-3.0.txt)
3
3
  all::
4
4
 
@@ -18,10 +18,12 @@ m1 += dtas-sinkedit
18
18
  m1 += dtas-sourceedit
19
19
  m1 += dtas-tl
20
20
  m1 += dtas-splitfx
21
+ m1 += dtas-archive
21
22
 
22
23
  m7 =
23
24
  m7 += dtas-player_protocol
24
25
  m7 += dtas-player_sink_examples
26
+ m7 += dtas-env
25
27
 
26
28
  man1 := $(addsuffix .1, $(m1))
27
29
  man7 := $(addsuffix .7, $(m7))
@@ -0,0 +1,61 @@
1
+ % dtas-archive(1) dtas user manual
2
+ %
3
+
4
+ # NAME
5
+
6
+ dtas-archive - paranoid audio file copy
7
+
8
+ # SYNOPSYS
9
+
10
+ dtas-archive [OPTIONS] SOURCE DESTINATION
11
+
12
+ # DESCRIPTION
13
+
14
+ dtas-archive is intended for archiving audio data to/from laptops and
15
+ computers without ECC memory, attempting to read data multiple times in
16
+ an attempt to detect memory corruption. dtas-archive may only be
17
+ effective on machines running the Linux kernel where posix_fadvise(2)
18
+ can be used to drop caches for a particular file after fsync(2).
19
+
20
+ dtas-archive spawns sox(1) to archive audio data (likely uncompressed
21
+ WAVE) to FLAC and verifies the result using sndfile-cmp(1), a tool
22
+ implemented by different than sox and less likely to share the same bugs
23
+ (if any) as sox.
24
+
25
+ # OPTIONS
26
+
27
+ -j, \--jobs [JOBS]
28
+ : Number of jobs to run in parallel. Incrementing this may hurt
29
+ performance on slow storage devices. Default: 1
30
+
31
+ -n, \--dry-run
32
+ : Print, but do not run the commands to be executed
33
+
34
+ -s, \--quiet, \--silent
35
+ : Silent operation, commands are not printed as executed
36
+
37
+ -S, \--stats
38
+ : Run and save the text output of the sox "stats" effect as
39
+ $DESTINATION_FILE_WITHOUT_SUFFIX.stats next to the output file
40
+
41
+ -k, \--keep-going
42
+ : Continue after error
43
+
44
+ -r, \--repeat [COUNT]
45
+ : Number of times to repeat the sndfile-cmp(1) check. Default: 1
46
+
47
+ # COPYRIGHT
48
+
49
+ Copyright 2015 all contributors <dtas-all@nongnu.org>.\
50
+ License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>
51
+
52
+ # CONTACT
53
+
54
+ All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
55
+ Mailing list archives available at <http://80x24.org/dtas-all/> and
56
+ <ftp://lists.gnu.org/dtas-all/>\
57
+ No subscription is necessary to post to the mailing list.
58
+
59
+ # SEE ALSO
60
+
61
+ sndfile-cmp(1), sox(1)
@@ -53,13 +53,14 @@ a problem.
53
53
 
54
54
  # CONTACT
55
55
 
56
- All feedback welcome via plain-text mail to <dtas-all@nongnu.org>\
57
- Mailing list archives available at <ftp://lists.gnu.org/dtas-all/>\
56
+ All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
57
+ Mailing list archives available at <http://80x24.org/dtas-all/> and
58
+ <ftp://lists.gnu.org/dtas-all/>\
58
59
  No subscription is necessary to post to the mailing list.
59
60
 
60
61
  # COPYRIGHT
61
62
 
62
- Copyright 2013-2014, Eric Wong <e@80x24.org> and all contributors.\
63
+ Copyright 2013-2015 all contributors <dtas-all@nongnu.org>.\
63
64
  License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>
64
65
 
65
66
  # SEE ALSO
@@ -60,13 +60,14 @@ This defaults to ~/.dtas/player.sock
60
60
 
61
61
  # CONTACT
62
62
 
63
- All feedback welcome via plain-text mail to <dtas-all@nongnu.org>\
64
- Mailing list archives available at <ftp://lists.gnu.org/dtas-all/>\
63
+ All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
64
+ Mailing list archives available at <http://80x24.org/dtas-all/> and
65
+ <ftp://lists.gnu.org/dtas-all/>\
65
66
  No subscription is necessary to post to the mailing list.
66
67
 
67
68
  # COPYRIGHT
68
69
 
69
- Copyright 2013-2014, Eric Wong <e@80x24.org> and all contributors.\
70
+ Copyright 2013-2015 all contributors <dtas-all@nongnu.org>.\
70
71
  License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>
71
72
 
72
73
  # SEE ALSO
@@ -21,13 +21,14 @@ VISUAL / EDITOR - your favorite *nix text editor, defaults to 'vi' if unset.
21
21
 
22
22
  # CONTACT
23
23
 
24
- All feedback welcome via plain-text mail to <dtas-all@nongnu.org>\
25
- Mailing list archives available at <ftp://lists.gnu.org/dtas-all/>\
24
+ All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
25
+ Mailing list archives available at <http://80x24.org/dtas-all/> and
26
+ <ftp://lists.gnu.org/dtas-all/>\
26
27
  No subscription is necessary to post to the mailing list.
27
28
 
28
29
  # COPYRIGHT
29
30
 
30
- Copyright 2013-2014, Eric Wong <e@80x24.org> and all contributors.\
31
+ Copyright 2013-2015 all contributors <dtas-all@nongnu.org>.\
31
32
  License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>
32
33
 
33
34
  # SEE ALSO
@@ -26,13 +26,14 @@ This defaults to ~/.dtas/player.sock
26
26
 
27
27
  # CONTACT
28
28
 
29
- All feedback welcome via plain-text mail to <dtas-all@nongnu.org>\
30
- Mailing list archives available at <ftp://lists.gnu.org/dtas-all/>\
29
+ All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
30
+ Mailing list archives available at <http://80x24.org/dtas-all/> and
31
+ <ftp://lists.gnu.org/dtas-all/>\
31
32
  No subscription is necessary to post to the mailing list.
32
33
 
33
34
  # COPYRIGHT
34
35
 
35
- Copyright 2013-2014, Eric Wong <e@80x24.org> and all contributors.\
36
+ Copyright 2013-2015 all contributors <dtas-all@nongnu.org>.\
36
37
  License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>
37
38
 
38
39
  # SEE ALSO
@@ -0,0 +1,60 @@
1
+ % dtas-env(7) dtas user manual
2
+ %
3
+
4
+ # NAME
5
+
6
+ dtas-env - environment variables used through DTAS
7
+
8
+ # DESCRIPTION
9
+
10
+ As dtas uses Bourne shell and exposes it to users, dtas should have
11
+ a cohesive set of common environment variables across its audio
12
+ production and playback environments. This attempts to document
13
+ them. Most of these environments are set and managed by dtas
14
+ itself, but users editing commands (e.g. via dtas-sourcedit(1)
15
+ should be aware of them.
16
+
17
+ # ENVIRONMENT
18
+
19
+ ECAFMT - an snippet of command-line switches for ecasound describing
20
+ audio format parameters (such as word length, channels, sample rate),
21
+ see dtas-player_protocol(7) for more info. (e.g. "-fs32_le,2,44100")
22
+
23
+ INFILE - the primary input file for playback or processing.
24
+ (e.g. "/path/to/ex.flac")
25
+
26
+ RGFX - the sox effect used for applying ReplayGain compensation.
27
+ Only used during playback in dtas-player. (e.g. "vol -6.0dB").
28
+ Removing this prevents ReplayGain from working and may damage
29
+ playback equipment with loudly mastered music.
30
+
31
+ SOXFMT - an snippet of command-line switches for sox describing
32
+ audio format parameters (such as word length, channels, sample rate),
33
+ see dtas-player_protocol(7) for more info. (e.g. "-ts32 -c2 -r44100")
34
+
35
+ TRIMFX - the sox effect used for seeking during playback with dtas-player
36
+ and track offsets for dtas-splitfx. (e.g. "trim 36000s")
37
+
38
+ Additionally, dtas-splitfx(1) documents more environment variables
39
+ which are not used elsewhere.
40
+
41
+ # ENVIRONMENT FOR OTHER EXECUTABLES
42
+
43
+ By virtue of running other programs, dtas indirectly uses many
44
+ commonly-accepted environment variables such as EDITOR / VISUAL for
45
+ selecting a text editor, and SOX_OPTS, AUDIODEV, AUDIODRIVER for sox(1)
46
+ and play(1) commands and LADSPA_PATH for anything using LADSPA plugins
47
+ (including sox). The TMPDIR environment variable controls where
48
+ temporary files are placed for most programs.
49
+
50
+ # CONTACT
51
+
52
+ All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
53
+ Mailing list archives available at <http://80x24.org/dtas-all/> and
54
+ <ftp://lists.gnu.org/dtas-all/>\
55
+ No subscription is necessary to post to the mailing list.
56
+
57
+ # COPYRIGHT
58
+
59
+ Copyright 2015 all contributors <dtas-all@nongnu.org>.\
60
+ License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>
@@ -42,13 +42,14 @@ This defaults to ~/.dtas/player.sock
42
42
 
43
43
  # CONTACT
44
44
 
45
- All feedback welcome via plain-text mail to <dtas-all@nongnu.org>\
46
- Mailing list archives available at <ftp://lists.gnu.org/dtas-all/>\
45
+ All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
46
+ Mailing list archives available at <http://80x24.org/dtas-all/> and
47
+ <ftp://lists.gnu.org/dtas-all/>\
47
48
  No subscription is necessary to post to the mailing list.
48
49
 
49
50
  # COPYRIGHT
50
51
 
51
- Copyright 2013-2014, Eric Wong <e@80x24.org> and all contributors.\
52
+ Copyright 2013-2015 all contributors <dtas-all@nongnu.org>.\
52
53
  License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>
53
54
 
54
55
  # SEE ALSO
@@ -53,6 +53,8 @@ created and playing the audio.
53
53
 
54
54
  # TROUBLESHOOTING
55
55
 
56
+
57
+
56
58
  ## Audio playback does not start
57
59
 
58
60
  The most common problem with dtas-player is the play(1) command
@@ -107,13 +109,14 @@ state across restarts of dtas-player.
107
109
 
108
110
  # CONTACT
109
111
 
110
- All feedback welcome via plain-text mail to <dtas-all@nongnu.org>\
111
- Mailing list archives available at <ftp://lists.gnu.org/dtas-all/>\
112
+ All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
113
+ Mailing list archives available at <http://80x24.org/dtas-all/> and
114
+ <ftp://lists.gnu.org/dtas-all/>\
112
115
  No subscription is necessary to post to the mailing list.
113
116
 
114
117
  # COPYRIGHT
115
118
 
116
- Copyright 2013-2014, Eric Wong <e@80x24.org> and all contributors.\
119
+ Copyright 2013-2015 all contributors <dtas-all@nongnu.org>.\
117
120
  License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>
118
121
 
119
122
  # SEE ALSO
@@ -46,11 +46,12 @@ They are applied in the order described.
46
46
 
47
47
  # CONTACT
48
48
 
49
- All feedback welcome via plain-text mail to <dtas-all@nongnu.org>\
50
- Mailing list archives available at <ftp://lists.gnu.org/dtas-all/>\
49
+ All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
50
+ Mailing list archives available at <http://80x24.org/dtas-all/> and
51
+ <ftp://lists.gnu.org/dtas-all/>\
51
52
  No subscription is necessary to post to the mailing list.
52
53
 
53
54
  # COPYRIGHT
54
55
 
55
- Copyright 2013-2014, Eric Wong <e@80x24.org> and all contributors.\
56
+ Copyright 2013-2015 all contributors <dtas-all@nongnu.org>.\
56
57
  License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>
@@ -169,7 +169,9 @@ Commands here should be alphabetized according to `LC_ALL=C sort'
169
169
  * restart - restarts all processes in the current pipeline. Playback
170
170
  will be momentarily interrupted while this change occurs. This is
171
171
  necessary if one of the commands (e.g. sox or ecasound) or loaded
172
- libraries (e.g. a LADSPA plugin) is upgraded.
172
+ libraries (e.g. a LADSPA plugin) is upgraded. Use "source restart"
173
+ instead to only restart the source chain, leaving the sinks
174
+ untouched.
173
175
 
174
176
  * rg RGARGS - configure ReplayGain support
175
177
  All FLOAT values may be adjusted via '+=' or '-=' instead of simple
@@ -233,6 +235,14 @@ Commands here should be alphabetized according to `LC_ALL=C sort'
233
235
  1. input type (flac/opus/mp3/etc)
234
236
  2. transport protocol (local FS/http/ftp/sftp/etc)
235
237
 
238
+ * source ls - dump the names of sources sorted by tryorder
239
+
240
+ * source restart - restart the current source command
241
+ This can be useful if the source file is changed during playback
242
+ and the current player process is holding onto an unlinked inode.
243
+ This is advantageous over a full "restart" as there is no audible
244
+ gap on most systems.
245
+
236
246
  * state dump [FILENAME]
237
247
  Immediately dump the state of the player. If a FILENAME is specified,
238
248
  the state is written to that file. Otherwise, the default state file
@@ -273,17 +283,30 @@ Commands here should be alphabetized according to `LC_ALL=C sort'
273
283
  * tl tracks
274
284
  returns a list of all TRACKIDS in the tracklist
275
285
 
286
+ * trim [off|TBEG [TLEN]]
287
+ Limits playback of all tracks in the tracklist to the time starting
288
+ at TBEG and ending after TLEN has elapsed. Not specifying TLEN will
289
+ cause sox. Like the sox "trim" effect, prefixing TLEN with a '='
290
+ will be interpreted as an absolute stop time.
291
+ Both TBEG and TLEN should be specified in seconds, not sample counts.
292
+ Specifying "off" (without quotes) disables trim.
293
+ This feature is intended to allow users to "zoom-in" on a particular
294
+ portion of a track to tweak parameters (either with
295
+ dtas-sourceedit(1) or via playback of splitfx YAML files) and often
296
+ combined with looping the tracklist (via "tl repeat").
297
+
276
298
  * watch - adds the client to the passive watch list for notifications.
277
299
  It is recommended clients issue no further commands and open
278
300
  another client socket to issue non-watch commands.
279
301
 
280
302
  # CONTACT
281
303
 
282
- All feedback welcome via plain-text mail to <dtas-all@nongnu.org>\
283
- Mailing list archives available at <ftp://lists.gnu.org/dtas-all/>\
304
+ All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
305
+ Mailing list archives available at <http://80x24.org/dtas-all/> and
306
+ <ftp://lists.gnu.org/dtas-all/>\
284
307
  No subscription is necessary to post to the mailing list.
285
308
 
286
309
  # COPYRIGHT
287
310
 
288
- Copyright 2013-2014, Eric Wong <e@80x24.org> and all contributors.\
311
+ Copyright 2013-2015 all contributors <dtas-all@nongnu.org>.\
289
312
  License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>
@@ -11,6 +11,8 @@ dtas-sinkedit SINKNAME
11
11
 
12
12
  # EXAMPLES
13
13
 
14
+
15
+
14
16
  ## Streaming Ogg-Vorbis to Icecast
15
17
 
16
18
  To use oggfwd(1) and Icecast, the following sink works.
@@ -67,15 +69,17 @@ See dtas-xdelay(1).
67
69
 
68
70
  # CONTACT
69
71
 
70
- All feedback welcome via plain-text mail to <dtas-all@nongnu.org>\
71
- Mailing list archives available at <ftp://lists.gnu.org/dtas-all/>\
72
+ All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
73
+ Mailing list archives available at <http://80x24.org/dtas-all/> and
74
+ <ftp://lists.gnu.org/dtas-all/>\
72
75
  No subscription is necessary to post to the mailing list.
73
76
 
74
77
  # COPYRIGHT
75
78
 
76
- Copyright 2013-2014, Eric Wong <e@80x24.org> and all contributors.\
79
+ Copyright 2013-2015 all contributors <dtas-all@nongnu.org>.\
77
80
  License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>
78
81
 
79
82
  # SEE ALSO
83
+
80
84
  dtas-ctl(1), dtas-sinkedit(1), dtas-xdelay(1),
81
85
  sox(1), play(1), oggfwd(1), ssh(1), ssh_config(5), env(1)
@@ -14,6 +14,22 @@ dtas-sinkedit SINKNAME
14
14
  dtas-sinkedit spawns an editor to allow editing of a sink as a YAML file.
15
15
  See dtas-player_protocol(7) for details on SINKARGS.
16
16
 
17
+ On Linux machines with the sleepy_penguin RubyGem installed, inotify(7)
18
+ is used to monitor the file for changes while the text exitor is running.
19
+ Each time a user finishes saving a file, changes are committed immediately.
20
+ This behavior may be disabled by using the -N or --no-watch command-line
21
+ switch.
22
+
23
+ # OPTIONS
24
+ -N, \--no-watch
25
+ : Disable inotify(7) support on Linux systems
26
+
27
+ -n, \--dry-run
28
+ : Only print commands which would be sent to dtas-player
29
+
30
+ -V, \--verbose
31
+ : Print out commands as they are sent to dtas-player
32
+
17
33
  # EXAMPLES
18
34
 
19
35
  To get a list of existing sink names
@@ -38,13 +54,14 @@ This defaults to ~/.dtas/player.sock
38
54
 
39
55
  # CONTACT
40
56
 
41
- All feedback welcome via plain-text mail to <dtas-all@nongnu.org>\
42
- Mailing list archives available at <ftp://lists.gnu.org/dtas-all/>\
57
+ All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
58
+ Mailing list archives available at <http://80x24.org/dtas-all/> and
59
+ <ftp://lists.gnu.org/dtas-all/>\
43
60
  No subscription is necessary to post to the mailing list.
44
61
 
45
62
  # COPYRIGHT
46
63
 
47
- Copyright 2013-2014, Eric Wong <e@80x24.org> and all contributors.\
64
+ Copyright 2013-2015 all contributors <dtas-all@nongnu.org>.\
48
65
  License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>
49
66
 
50
67
  # SEE ALSO
@@ -17,6 +17,23 @@ a pipe or file, it is parsed as YAML and fed to the dtas-player(1) instance
17
17
  non-interactively. This is useful for loading various profiles from the
18
18
  filesystem.
19
19
 
20
+ On Linux machines with the sleepy_penguin RubyGem installed, inotify(7)
21
+ is used to monitor the file for changes while the text exitor is running.
22
+ Each time a user finishes saving a file, changes are committed immediately.
23
+ This behavior may be disabled by using the -N or --no-watch command-line
24
+ switch.
25
+
26
+ # OPTIONS
27
+
28
+ -N, \--no-watch
29
+ : Disable inotify(7) support on Linux systems
30
+
31
+ -n, \--dry-run
32
+ : Only print commands which would be sent to dtas-player
33
+
34
+ -V, \--verbose
35
+ : Print out commands as they are sent to dtas-player
36
+
20
37
  # EXAMPLES
21
38
 
22
39
  Invoking dtas-sourceedit will spawn your favorite text editor on "sox":
@@ -45,13 +62,14 @@ This defaults to ~/.dtas/player.sock
45
62
 
46
63
  # CONTACT
47
64
 
48
- All feedback welcome via plain-text mail to <dtas-all@nongnu.org>\
49
- Mailing list archives available at <ftp://lists.gnu.org/dtas-all/>\
65
+ All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
66
+ Mailing list archives available at <http://80x24.org/dtas-all/> and
67
+ <ftp://lists.gnu.org/dtas-all/>\
50
68
  No subscription is necessary to post to the mailing list.
51
69
 
52
70
  # COPYRIGHT
53
71
 
54
- Copyright 2013-2014, Eric Wong <e@80x24.org> and all contributors.\
72
+ Copyright 2013-2015 all contributors <dtas-all@nongnu.org>.\
55
73
  License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>
56
74
 
57
75
  # SEE ALSO