Update remote control doc and push version of interface to v3.

git-svn-id: svn://scm.orgis.org/mpg123/trunk@1302 35dc7657-300d-0410-a2e5-dc2837fedb53

doc/README.remote

@@ -20,7 +20,7 @@ The command respones are still sent to standard out or standard error (depending
 COMMAND CODES
 -------------
 
-You can get this info via the control command "help"
+You can get this info via the control command "help".
 
 HELP/H: command listing (LONG/SHORT forms), command case insensitve
 
@@ -40,10 +40,22 @@ RVA off|(mix|radio)|(album|audiophile): set rva mode
 
 EQ/E <channel> <band> <value>: set equalizer value for frequency band on channel
 
+SEEK/K <sample>|<+offset>|<-offset>: jump to output sample position <samples> or change position by offset
+
 SEQ <bass> <mid> <treble>: simple eq setting...
 
 SILENCE: be silent during playback (meaning silence in text form)
 
+TAG/T: Print all available (ID3) tag info, for ID3v2 that gives output of all collected text fields, using the ID3v2.3/4 4-character 
+names.
+
+meaning of the @S stream info:
+S <mpeg-version> <layer> <sampling freq> <mode(stereo/mono/...)> <mode_ext> <framesize> <stereo> <copyright> <error_protected> <emphasis> <bitrate> <extension> <vbr(0/1=yes/no)>
+The @I lines after loading a track give some ID3 info, the format:
+     @I ID3:artist  album  year  comment genretext
+    where artist,album and comment are exactly 30 characters each, year is 4 characters, genre text unspecified.
+    You will encounter "@I ID3.genre:<number>" and "@I ID3.track:<number>".
+    Then, there is an excerpt of ID3v2 info in the structure
 
 RESPONSE CODES
 --------------
@@ -51,8 +63,8 @@ RESPONSE CODES
 Note: mpg123 returns errors on stderr, so your frontend should
       look not only at stdout but also at stderr for responses.
 
-@R MPG123
+@R MPG123 (ThOr) v3
-			Startup version message
+	Startup version message. Rverything after MPG123 is auxilliary information about behaviour and command support, ID3v2 tag support is new in v3.
 
 @I ID3:<a><b><c>
 	Status message after loading a song (ID3 song info)
@@ -63,6 +75,13 @@ Note: mpg123 returns errors on stderr, so your frontend should
 	e = comment (exactly 30 chars)
 	f = genre (string)
 
+@I ID3.genre:<number>
+@I ID3.track:<number>
+	Optional lines with additional ID3v1 info (if present): Genre ID and track number in set.
+
+@I ID3v2.title:<text>
+	After loading a track with ID3v2 info, such lines occur for every line of the "title" data field and likewise for other fields (author, album, etc).
+
 @I <a>
 			Status message after loading a song (no ID3 song info)
 			a = filename without path and extension
@@ -120,6 +139,14 @@ Note: mpg123 returns errors on stderr, so your frontend should
 @bass: <b> mid: <m> treble: <t>
 	Set simple equalizer control for bass, mid, treble.
 
+@T <response from TAG command>
+	The output is multiple lines, begin marked by "@T {", end by "@T }".
+	ID3v1 data is like in the @I info lines, just with "@T" in front.
+	An ID3v2 data field is introduced via ([ ... ] means optional):
+		@T ID3v2.<NAME>[ [lang(<LANG>)] desc(<description>)]:
+	The lines of data follow with "=" prefixed:
+		@T =<one line of content in UTF-8 encoding>
+
 
 Info about the equalizer control:
 

src/control_generic.c

@@ -261,7 +261,7 @@ int control_generic (mpg123_handle *fr)
 #endif
 	/* the command behaviour is different, so is the ID */
 	/* now also with version for command availability */
-	fprintf(outstream, "@R MPG123 (ThOr) v2\n");
+	fprintf(outstream, "@R MPG123 (ThOr) v3\n");
 #ifdef FIFO
 	if(param.fifo)
 	{