document zsr's start and stop times options
authorBrian Chen <bpchen@mit.edu>
Tue, 15 Dec 2015 00:56:23 +0000 (19:56 -0500)
committersipb-www <sipb-www@cats-whiskers.mit.edu>
Tue, 15 Dec 2015 00:56:23 +0000 (19:56 -0500)
doc/using-sipbmp3.mdwn

index 71d07aa15333db63024830eb0cc412fa21ded0e8..cbe87b130955e0e66ec2bc9c82e3d072e1c42dba 100644 (file)
@@ -8,7 +8,12 @@ If you are running [Debathena](http://debathena.mit.edu) but do not want to use
     `lprm -Psipbmp3 job#`<br />
 If you do not specify a job number, then the first song will be removed.
 
-Instead of specifying a music file, you can alternatively print a YouTube URL from the standard input.
+You can specify start and stop times with options:<br />
+    `lpr -Psipbmp3 song.mp3 -o start=10 -o stop=123`
+
+The numbers are in seconds, but you can also use syntax like `4m33s` or `4:33`. Instead of specifying a music file, you can alternatively print a YouTube URL from the standard input; there, you can also append flags like `start=10 stop=123` to the line, so for example you can print the line<br />
+`https://www.youtube.com/watch?v=a3ww0gwEszo start=10 stop=123`<br />
+Finally, you can use various synonyms for "start" or "stop", such as "begin" and "end", because the author keeps on accidentally typing the latter.
 
 ***