dtas-sourcedit: allow loading YAML from stdin

This should make it easy to save/load sink profiles depending on
the users mood.  One could easily create different profiles
depending on different listening criteria.

  dtas-ctl source cat sox > casual.yml
  dtas-sourceedit sox < critical.yml

1 files changed, 9 insertions, 1 deletions

diff --git a/Documentation/dtas-sourceedit.txt b/Documentation/dtas-sourceedit.txt
index 4a47107..9b9fe14 100644
--- a/Documentation/dtas-sourceedit.txt
+++ b/Documentation/dtas-sourceedit.txt
@@ -12,7 +12,10 @@ dtas-sourceedit {sox | av | ff}
 # DESCRIPTION
 
 dtas-sourceedit spawns an editor to allow editing of a source as a YAML file.
-See dtas-player_protocol(7) for details on SOURCEARGS.
+See dtas-player_protocol(7) for details on SOURCEARGS.  If standard input is
+a pipe or file, it is parsed as YAML and fed to the dtas-player(1) instance
+non-interactively.  This is useful for loading various profiles from the
+filesystem.
 
 # EXAMPLES
 
@@ -20,6 +23,11 @@ Invoking dtas-sourceedit will spawn your favorite text editor on "sox":
 
         $ dtas-sourceedit sox
 
+To load an existing YAML profile for sox.  saved.yml could be the output
+of a previous "dtas-ctl source cat sox" invocation:
+
+        $ dtas-sourceedit sox < saved.yml
+
 To change the way dtas-player calls avconv (part of libav):
 
         $ dtas-sourceedit av