about summary refs log tree commit homepage
path: root/Documentation/dtas-player_protocol.txt
diff options
context:
space:
mode:
authorEric Wong <normalperson@yhbt.net>2013-08-27 23:36:37 +0000
committerEric Wong <normalperson@yhbt.net>2013-08-28 00:24:27 +0000
commitcd6065bcd94397fa23dd29621196e71f2183dc01 (patch)
treed7b38c058435766dbe195de2f371f69b61075de3 /Documentation/dtas-player_protocol.txt
parente37e3d8a086c385b243d73e20f22c6b86b280d07 (diff)
downloaddtas-cd6065bcd94397fa23dd29621196e71f2183dc01.tar.gz
Minor notes for future development.
Diffstat (limited to 'Documentation/dtas-player_protocol.txt')
-rw-r--r--Documentation/dtas-player_protocol.txt8
1 files changed, 7 insertions, 1 deletions
diff --git a/Documentation/dtas-player_protocol.txt b/Documentation/dtas-player_protocol.txt
index f92f151..aa3eca4 100644
--- a/Documentation/dtas-player_protocol.txt
+++ b/Documentation/dtas-player_protocol.txt
@@ -70,6 +70,8 @@ For little-endian machines, $ECAFMT defaults to: -fs32_le,2,44100
 
 # COMMANDS
 
+Commands here should be alphabetized according to `LC_ALL=C sort'
+
 * cd - change the current working directory of the player
 
 * clear - clear current queue (current track/command continues running)
@@ -187,7 +189,7 @@ For little-endian machines, $ECAFMT defaults to: -fs32_le,2,44100
     + nonblock=BOOLEAN - drop audio data to avoid holding back other sinks
     + pipe_size=UNSIGNED - set the size of the pipe for the sink (Linux-only)
 
-* source SOURCENAME cat - dump the current source command and env in YAML
+* source cat SOURCENAME - dump the current source command and env in YAML
 
 * source ed SOURCENAME SOURCEARGS - edit the source parameters.
   This changes here will immediately restart the source process.
@@ -196,6 +198,10 @@ For little-endian machines, $ECAFMT defaults to: -fs32_le,2,44100
     + env.ENVNAME=ENVVALUE - set ENVNAME to ENVVALUE for the source process
     + env#ENVNAME - unset ENVNAME in the source process (only)
     + tryorder=INTEGER - lower values are tried first
+    PENDING: tryorder here is wrong and may be removed or changed.
+    We need to account for at least two variables input file:
+        1. input type (flac/opus/mp3/etc)
+        2. transport protocol (local FS/http/ftp/sftp/etc)
 
 * watch - adds the client to the passive watch list for notifications.
   It is recommended clients issue no further commands and open