* doc/vlc-howto.sgml: Spelling mistakes, small updates, harmonization
authorJohan Bilien <jobi@videolan.org>
Tue, 14 May 2002 01:14:39 +0000 (01:14 +0000)
committerJohan Bilien <jobi@videolan.org>
Tue, 14 May 2002 01:14:39 +0000 (01:14 +0000)
                          with other documentations (thank you Alexis)
    * plugins/satellite/*: some fixes in options parsing (thank you Sam)

doc/vlc-howto.sgml
plugins/satellite/input_satellite.c
plugins/satellite/satellite.c

index aea356b..a1549e3 100644 (file)
@@ -2,11 +2,11 @@
 <linuxdoc><article>
 <titlepag>
  <title>VLC HOWTO</title>
- <author>by the Videolan Team<tt><htmlurl url="mailto:videolan@videolan.org" name="videolan@videolan.org"></tt></author>
+ <author>Originally written by Henri Fallon, maintained by Johan Bilien<tt><htmlurl url="mailto:jobi@videolan.org" name="<jobi@videolan.org>"></tt></author>
  <date>v0.0.9, 16 april 2002</date>
 
  <abstract>
-  This document describes how to use the vlc (VideoLAN client) to read DVDs and mpeg files and DVDs.
+  This document describes how to use the vlc (VideoLAN client) to read DVDs and mpeg files, locally or from a network.
  </abstract>
 </titlepag>
 
  </sect1>
  
  <sect1>
-  <heading>What is the vlc</heading>
+  <heading>What is the VideoLAN project ?</heading>
   <p>
-   Vlc stands for VideoLAN client. It is the name of the program which is
-   capable of decoding MPEG streams, and displaying them onto your screen,
-   so you can watch you favourite movies, confortably sit in your armchair
-   :-).
+    VideoLAN is a complete software solution for video streaming, developed
+    by students at the <htmlurl url="http://www.ecp.fr" name="Ecole Centrale
+    Paris"> and contributors from all over the world, under the General
+    Public License (GPL). It has been designed for streaming MPEG 1 and MPEG
+    2 videos on local area networks (LAN), but it can be extended to
+    metropolitan or wide area networks (MAN, WAN), 
+    thanks to the multicast technology.
+    The VideoLAN solution includes a server, which can stream video from
+    various sources (file, DVD, satellite, camera, ...), a client, which can
+    receive, decode and display MPEG 1 and MPEG 2 streams and, if necessary,
+    a channel server which tells automatically to the client the parameters
+    needed to receive the stream.
+
+    <verb>
+
+        DVD --->-                 Unicast/Broadcast/Multicast
+                  \                           ---
+        File --->--     --------            /     \            --------
+                   |->-| Server |=====>====|  LAN  |---->-----| Client |
+     Satellite ->--    | (VLS)  |           \     /           | (VLC)  |
+                  /     --------              ---              --------
+       MPEG2 -->-                              ^
+      encoder                                  |
+                                               v
+                                        ----------------
+                                       | Channel Server |
+                                       |    (VLCS)      |
+                                        ----------------
+    </verb>
+    More details about the project can be found on the
+    <htmlurl url="http://www.videolan.org" name="VideoLAN Web site">.
+
   </p>
  </sect1>
+ <sect1>
+  <heading>The documentation of the project</heading>
+  <p>
+    There are four main documents :
+<itemize>
+<item>the <htmlurl
+url="http://www.videolan.org/doc/videolan-quickstart/videolan-quickstart.html"
+name="VideoLAN Quickstart">,
+<item>the <htmlurl url="http://www.videolan.org/network/doc/videolan-howto.html"
+name="VideoLAN HOWTO">,
+<item>the <htmlurl url="http://www.videolan.org/vls/doc/vls-guide.html"
+name="VideoLAN Server user guide">,
+<item>this VideoLAN Client Howto.
+</itemize>
+
+The up-to-date version of these documents can be found on the <htmlurl
+url="http://www.videolan.org/doc" name="VideoLAN Web Site">.
 
  <sect1>
   <heading>Translated versions of this document</heading>
   </p>
  </sect1>
 
+ <sect1>
+  <heading>Requirements</heading>
+  <sect2>
+   <heading>Operating system</heading>
+   <p>
+    VLC works under the following systems :
+   </p>
+   <p>
+   <itemize>
+    <item> Linux (all distributions, including iPAQ Familiar Linux)
+    <item> Windows (all 32bit versions)
+    <item> Mas OS X
+    <item> FreeBSD, NetBSD, OpenBSD, BSD/OS
+    <item> BeOS
+    <item> QNX RTOS
+    <item> Solaris
+   </itemize>
+   </p>
+   <p>
+    Please note that the Linux, Windows and MacOS X are generally the most
+    uptodate versions.
+  </p>
+   </sect2>
+   <sect2>
+   <heading>Software requirements</heading>
+   <p>
+    Depending on the outputs and inputs you are using, you may need 
+    additionnal libraries. Please see <ref id="modules" name="description">.
+   </p>
+   <p>
+    For playing encrypted DVDs, you will need libdvdcss, which you can found
+    on this page :
+    <htmlurl name="http://www.videolan.org/libdvdcss/download.html"
+    url="http://www.videolan.org/libdvdcss/download.html">.
+   </p>
+  </sect2>
+  <sect2>
+   <heading>Hardware requirements</heading>
+   <p>
+    The hardware power needed depends a lot of the type of stream. 
+    For reading a DVD, a CPU working at around 450 MHz is required.
+   </p>
+   <p>
+    VLC can benefits from hardware acceleration from modern video cards
+    for YUV transformation and window rescaling. it also uses MMX, MMX EXT,
+    SSE, 3Dnow! optimizations if available.
+   </p>
+  </sect2>
+ </sect1>
+
  <sect1> 
   <heading>Disclaimer</heading> 
   <p> 
    <heading>Which package to chose ?</heading>
    <p>
     There are different packages because vlc has "plugins" which provide 
-    features but also enlarge the executable and require external libs. 
+    features but also enlarge the executable and require external libraries. 
    </p>
    <p>
     SDL is a lib which allows you to have an accelerated video output.
    </p>
    <p>
     Depending on the package you have downloaded, you may have dependency
-    problems. You have to solve them, by installing the required libs.
+    problems. You have to solve them, by installing the required libraries.
    </p>
   </sect2>
    
     </verb>
    </p>
    <p>
-    You may have to install external libs to meet dependencies, depending on
+    You may have to install external libraries to meet dependencies, depending on
     the package you downloaded (gnome, gtk, esd, ...).
    </p>
   </sect2>
    <p>
     Double-click on the archive. It should open your favorite archive extracter.
     You can then execute the vlc from there, or extract the archive to a 
-    diretory and run it from there.
+    directory and run it from there.
    </p>
   </sect2>
   
   <sect2>
    <heading>Windows users</heading>
    <p>
-    Decompress the archive with your favourite extracter in a directory of your
-    choice.
+    Launch the installer by double-clicking on it, and follow the installation
+    instructions. Please note that in most cases you will need administrator
+    rights to install it under Windows NT, 2000 and XP
    </p>
   </sect2>
  </sect1>
    name="http://www.videolan.org/libdvdcss/download.html" 
    url="http://www.videolan.org/libdvdcss/download.html">
   </p>
+  <p>
+   For Windows users, libdvdcss is statically linked in the 
+   Windows binary, so you don't have to install it.
+  </p>
  </sect1>
  
  <sect1>
    <sect2>
     <heading>Windows users</heading>
     <p>
-     The path to your DVD drive usually is D: or E:. You may have a look
+     The path to your DVD drive usually is D:\ or E:\. You may have a look
      in "My Computer" and look to which letter your DVD drive is assigned.
     </p>
    </sect2>
       start.
      </p>
      <p>
-      If nothing appears and you are sure that a program is broadcasted in
+      If nothing appears and you are sure that a program is streamed in
       this channel, you may try once again, because a problem of communication
       with the channel server could have occured (in you launched vlc from
       a terminal, you should see "Network error: no answer from vlcs").
   </p>
   <p>
    In every tab, you may click on "Save" to store your settings in your
-   ~/.videolan/vlrrc file.
+   ~/.videolan/vlcrc file.
   </p>
   <sect2>
    <heading>Interface tab</heading>
     <verb> vlc udpstream:</verb> should be sufficient. If the stream
     is multicasted, you must specify the multicast address, for example 
     <verb> vlc udpstream:@239.255.255.42  </verb>
+   <p>
+    To receive a http stream, start vlc with <tt>vlc &lt;your URL&gt;</tt>.
 
    
    </p>
     make
     </verb>
    It should compile without any error. If there are, please check you 
-   have the required libs 
+   have the required librarie
    installed on your system, as the configure script can't check them all.
   </p>
   <p>
    <p>
     This is the basic x11 video output. It only requires a 
     working X11 server. You will need xlibs headers to compile it
-    (xlibs-dev packet on Debian systems).
+    (xlibs-dev package on Debian systems).
    </p>
   </sect2>
   
     This is the VideoCD input. 
    </p>
   </sect2>
+  <sect2>
+   <heading>http</heading>
+   <p>default: enabled</p>
+   <p>
+    This is the http input. You can use it for Video On Demand.
+   </p>
+  </sect2>
   <sect2>
    <heading>satellite</heading>
    <p>default: disabled</p>
   <heading>Get more help</heading>
   <p>
    First of all, it something seems to go wrong, read and try to 
-   understand the error messages. If you are a confirmed user, you 
-   may try the "-vvv" option which makes the vlc very verbose.
+   understand the error messages. You can have detailed messages by
+   choosing messages in the view menu, in GTK, Gnome and Win32 interfaces.
   </p>
   <p>
    There is a FAQ page on our website :
index 3a32a37..cec7c83 100644 (file)
@@ -90,7 +90,7 @@ static int SatelliteOpen( input_thread_t * p_input )
     int                 i_freq = 0;
     int                 i_srate = 0;
     boolean_t           b_pol = 0;
-    int                 i_fec = 1;
+    int                 i_fec = 0;
     float               f_fec = 1./2;
     boolean_t           b_diseqc;
     int                 i_lnb_lof1;
@@ -127,29 +127,50 @@ static int SatelliteOpen( input_thread_t * p_input )
 
     if( i_freq > 12999 || i_freq < 10000 )
     {
-        intf_WarnMsg( 1, "input: satellite: invalid frequency, using"\
+        intf_WarnMsg( 1, "input: satellite: invalid frequency, using "\
                 "default one" );
-        i_srate = config_GetIntVariable( "frequency" );
+        i_freq = config_GetIntVariable( "frequency" );
+        if( i_freq > 12999 || i_freq < 10000 )
+        {
+            intf_ErrMsg( "input: satellite: invalid default frequency" );
+            return -1;
+        }
     }
 
     if( i_srate > 30000 || i_srate < 1000 )
     {
-        intf_WarnMsg( 1, "input: satellite: invalid symbol rate, using"\
+        intf_WarnMsg( 1, "input: satellite: invalid symbol rate, using "\
                 "default one" );
         i_srate = config_GetIntVariable( "symbol-rate" );
+        if( i_srate > 30000 || i_srate < 1000 )
+        {
+            intf_ErrMsg( "input: satellite: invalid default symbol rate" );
+            return -1;
+        }
     }
 
-    if( !b_pol && b_pol != 1 )
+    if( b_pol && b_pol != 1 )
     {
-        intf_WarnMsg( 1, "input: satellite: invalid polarization, using"\
+        intf_WarnMsg( 1, "input: satellite: invalid polarization, using "\
                 "default one" );
         b_pol = config_GetIntVariable( "polarization" );
+        fprintf(stderr, "%d\n", b_pol);
+        if( b_pol && b_pol != 1 )
+        {
+            intf_ErrMsg( "input: satellite: invalid default polarization" );
+            return -1;
+        }
     }
 
     if( i_fec > 7 || i_fec < 1 )
     {
-        intf_WarnMsg( 1, "input: satellite: invalid FEC, using default one" );
+        intf_WarnMsg( 1, "input: satellite: invalid FEC, using default one " );
         i_fec = config_GetIntVariable( "fec" );
+        if( i_fec > 7 || i_fec < 1 )
+        {
+            intf_ErrMsg( "input: satellite: invalid default FEC" );
+            return -1;
+        }
     }
 
     switch( i_fec )
index 8616eb9..b787977 100644 (file)
@@ -38,16 +38,16 @@ void _M( demux_getfunctions )( function_list_t * p_function_list );
  * Build configuration tree.
  *****************************************************************************/
 
-#define FREQ_TEXT N_("satellite transponder frequency")
+#define FREQ_TEXT N_("satellite default transponder frequency")
 #define FREQ_LONGTEXT ""
 
-#define POL_TEXT N_("satellite transponder polarization")
+#define POL_TEXT N_("satellite default transponder polarization")
 #define POL_LONGTEXT ""
 
-#define FEC_TEXT N_("satellite transponder FEC")
+#define FEC_TEXT N_("satellite default transponder FEC")
 #define FEC_LONGTEXT ""
 
-#define SRATE_TEXT N_("satellite transponder symbol rate")
+#define SRATE_TEXT N_("satellite default transponder symbol rate")
 #define SRATE_LONGTEXT ""
 
 #define DISEQC_TEXT N_("use diseqc with antenna")