[MPlayer-dev-eng] [PATCH] Updated documentation to describe RTSP/RTP streaming

[Ross Finlayson]

(This is English only, unfortunately; I can't write well enough in other 
languages.)

	Ross.
-------------- next part --------------
Index: mplayer.1
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/mplayer.1,v
retrieving revision 1.250
diff -u -r1.250 mplayer.1
--- mplayer.1	19 Oct 2002 04:28:52 -0000	1.250
+++ mplayer.1	20 Oct 2002 10:22:21 -0000
@@ -271,6 +271,11 @@
 .B \-quiet \ \ 
 Display less output and status messages.
 .TP
+.B \-sdp
+Specifies that the input file is a SDP ('Session Description Protocol')
+file that describes a RTP session.
+(See <http://www.live.com/mplayer/>.)
+.TP
 .B \-skin <skin\ directory> (BETA CODE)
 Load skin from the given directory (WITHOUT path name).
 
@@ -542,6 +547,14 @@
 .PD 1
 .
 .TP
+.B \-rtsp-stream-over-tcp
+Used with 'rtsp://' URLs to specify that the resulting incoming
+RTP and RTCP packets be streamed over TCP (using the same TCP connection
+as RTSP).
+This option may be useful if you have a broken Internet connection that
+does not pass incoming UDP packets.
+(See <http://www.live.com/mplayer/>.)
+.TP
 .B \-skipopening
 Skip DVD opening (dvdnav only).
 .TP
@@ -2605,6 +2618,9 @@
 .TP
 .B Stream from HTTP
 mplayer http://mplayer.hq/\:example.avi
+.TP
+.B Stream using RTSP
+mplayer rtsp://server.example.com/\:streamName
 .TP
 .B Convert subtitle to MPsub (to ./\:dump.mpsub)
 mplayer dummy.avi \-sub source.sub \-dumpmpsub

Index: documentation.html
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/documentation.html,v
retrieving revision 1.317
diff -u -r1.317 documentation.html
--- documentation.html	19 Oct 2002 04:22:50 -0000	1.317
+++ documentation.html	20 Oct 2002 10:22:47 -0000
@@ -61,6 +61,7 @@
               <LI><A HREF="formats.html#film">2.1.1.10 FILM files</A></LI>
               <LI><A HREF="formats.html#roq">2.1.1.11 RoQ files</A></LI>
               <LI><A HREF="formats.html#ogg">2.1.1.12 OGG/OGM files</A></LI>
+              <LI><A HREF="formats.html#sdp">2.1.1.12 SDP files</A></LI>
             </UL>
           </LI>
           <LI><A HREF="formats.html#audio_formats">2.1.2 Audio formats</A>
@@ -435,6 +436,7 @@
     suggested version is <B>always the newest</B> (at least 3.90).</LI>
   <LI><B>libogg</B> - optional, needed for playing OGG file format.</LI>
   <LI><B>libvorbis</B> - optional, needed for playing OGG Vorbis audio.</LI>
+  <LI><B><a HREF="http://www.live.com/mplayer/">LIVE.COM Streaming Media</a></B> - optional, needed for playing RTSP/RTP streams.</LI>
 </UL>
 
 <H4>Codecs:</H4>
@@ -995,7 +997,8 @@
   <TR><TD></TD><TD>files</TD><TD></TD><TD><CODE>mplayer [default options] [path/]filename1 [options for filename1] filename2 [options for filename2] ...</CODE></TD></TR>
   <TR><TD></TD><TD>VCD</TD><TD></TD><TD><CODE>mplayer [options] -vcd trackno [-cdrom-device /dev/cdrom]</CODE></TD></TR>
   <TR><TD></TD><TD>DVD</TD><TD></TD><TD><CODE>mplayer [options] -dvd titleno [-dvd-device /dev/dvd]</CODE></TD></TR>
-  <TR><TD></TD><TD>net</TD><TD></TD><TD><CODE>mplayer [options] http://site.com/file.asf (playlists can be used too)</CODE></TD></TR>
+  <TR><TD></TD><TD>WWW</TD><TD></TD><TD><CODE>mplayer [options] http://site.com/file.asf (playlists can be used too)</CODE></TD></TR>
+  <TR><TD></TD><TD>RTSP</TD><TD></TD><TD><CODE>mplayer [options] rtsp://server.example.com/streamName</CODE></TD></TR>
 </TABLE>
 
 <P>
@@ -1223,7 +1226,9 @@
 
 <H2><A NAME="streaming">3.3 Streaming from network or pipes</A></H2>
 
-<P><B>MPlayer</B> can play files from network, using the HTTP or MMS protocol.</P>
+<P><B>MPlayer</B> can play files from network, using the HTTP,
+MMS,
+or RTSP/RTP protocol.</P>
 
 <P>Playing goes by simply using adding the URL to the command line.
   <B>MPlayer</B> also honors the http_proxy environment variable, and uses

Index: formats.html
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/formats.html,v
retrieving revision 1.43
diff -u -r1.43 formats.html
--- formats.html	18 Oct 2002 17:57:05 -0000	1.43
+++ formats.html	20 Oct 2002 10:23:13 -0000
@@ -216,6 +216,15 @@
   before compiling <B>MPlayer</B> to be able to play it.</P>
 
 
+<H4><A NAME="sdp">2.1.1.13 SDP files</A></H4>
+
+<P><a HREF="ftp://ftp.rfc-editor.org/in-notes/rfc2327.txt">SDP</a>
+is an IETF standard format
+for describing video and/or audio RTP streams.
+(The "<a HREF="http://www.live.com/mplayer/">LIVE.COM Streaming Media</a>"
+libraries are required.) 
+
+
 <H3><A NAME="audio_formats">2.1.2 Audio formats</A></H3>
 
 <P><B>MPlayer</B> is a <B>Movie</B> and not a <B>Media</B> player, although