% dtas-sinkedit(1) dtas user manual =head1 NAME dtas-sinkedit - edit the command and environment of a sink =head1 SYNOPSYS dtas-sinkedit SINKNAME =head1 DESCRIPTION dtas-sinkedit spawns an editor to allow editing of a sink as a YAML file. See L for details on SINKARGS. On Linux machines with the sleepy_penguin RubyGem installed, L is used to monitor the file for changes while the text exitor is running. Each time a user finishes saving a file, changes are committed immediately. This behavior may be disabled by using the -N or --no-watch command-line switch. =head1 OPTIONS =over =item -N, --no-watch Disable L support on Linux systems =item -n, --dry-run Only print commands which would be sent to dtas-player =item -V, --verbose Print out commands as they are sent to dtas-player =back =head1 EXAMPLES To get a list of existing sink names $ dtas-ctl ls Invoking dtas-sinkedit will spawn your favorite text editor on a given SINKNAME: $ dtas-sinkedit SINKNAME If SINKNAME was not listed, it will be created (in an inactive state). Successfully exiting your text editor will send the changes to the running dtas-player. =head1 ENVIRONMENT VISUAL / EDITOR - your favorite *nix text editor, defaults to 'vi' if unset. DTAS_PLAYER_SOCK - the path to the dtas-player control socket. This defaults to ~/.dtas/player.sock =head1 CONTACT All feedback welcome via plain-text mail to: L Mailing list archives available at L and L No subscription is necessary to post to the mailing list. =head1 COPYRIGHT Copyright 2013-2016 all contributors L License: GPL-3.0+ L =head1 SEE ALSO L, L, L