dtas-sourceedit.1 in dtas-0.3.0

- old
+ new

@@ -8,20 +8,33 @@
 .SH DESCRIPTION
 .PP
 dtas-sourceedit spawns an editor to allow editing of a source as a YAML
 file.
 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.
 .SH EXAMPLES
 .PP
 Invoking dtas-sourceedit will spawn your favorite text editor on "sox":
 .IP
 .nf
 \f[C]
 $\ dtas-sourceedit\ sox
 \f[]
 .fi
 .PP
+To load an existing YAML profile for sox.
+saved.yml could be the output of a previous "dtas-ctl source cat sox"
+invocation:
+.IP
+.nf
+\f[C]
+$\ dtas-sourceedit\ sox\ <\ saved.yml
+\f[]
+.fi
+.PP
 To change the way dtas-player calls avconv (part of libav):
 .IP
 .nf
 \f[C]
 $\ dtas-sourceedit\ av
@@ -40,9 +53,20 @@
 VISUAL / EDITOR - your favorite *nix text editor, defaults to
 \[aq]vi\[aq] if unset.
 .PP
 DTAS_PLAYER_SOCK - the path to the dtas-player control socket.
 This defaults to ~/.dtas/player.sock
+.SH CONTACT
+.PP
+All feedback welcome via plain-text mail to <dtas-all@nongnu.org>
+.PD 0
+.P
+.PD
+Mailing list archives available at <ftp://lists.gnu.org/dtas-all/>
+.PD 0
+.P
+.PD
+No subscription is necessary to post to the mailing list.
 .SH COPYRIGHT
 .PP
 Copyright 2013, Eric Wong <normalperson@yhbt.net> and all contributors.
 .PD 0
 .P