]> git.sesse.net Git - vlc/blobdiff - doc/vlc.1
Use var_InheritString for --decklink-video-connection.
[vlc] / doc / vlc.1
index 3015c2007a8bff93cc45beb5798332c88e51e507..45f0d0c3f9e9ecad5dacc87ef2d4b68c11d7e5dd 100644 (file)
--- a/doc/vlc.1
+++ b/doc/vlc.1
@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH VLC 1 "March 10, 2001"
+.TH VLC 1 "Feb 14, 2005"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
 .\" .sp <n>    insert n+1 empty lines
 .\" for manpage-specific macros, see man(7)
 .SH NAME
-vlc, gvlc, kvlc, qvlc \- The VideoLAN Client
+vlc, qvlc, svlc, nvlc, rvlc, cvlc \- the VLC media player
 .SH SYNOPSIS
 .B vlc
 .RI [ OPTIONS ]
-.RI [ PARAMETERS ]
-.RI [ FILE ]...
+.RI [ ITEMS ]...
 .SH DESCRIPTION
 This manual page documents briefly the
-.B vlc
-, a free MPEG, MPEG2 and DVD player.
+.B VLC
+multimedia player and server.
+
 .SH OPTIONS
-.B vlc
+.B VLC
 follows the usual GNU command line syntax, with long
 options starting with two dashes (`-').
-A summary of options is included below.
-.TP
-.B \-I, \-\-intf <module>
-Specify an interface module: "gnome", "curses", "qt", for instance.
-.TP
-.B \-\-warning <level>
-Select the warning level. 0 is the most verbose, 3 is almost mute.
-.TP
-.B \-\-noaudio
-Disable audio output.
-.TP
-.B \-A, \-\-aout <module>
-Specify an audio output module: "dsp", "esd", for instance.
-.TP
-.B \-\-stereo, \-\-mono
-Choose stereo or mono audio output
-.TP
-.B \-\-novideo
-Disable video output.
-.TP
-.B \-V, \-\-vout <module>
-Specify a video output module: "x11", "sdl", "fb", for instance.
-.TP
-.B \-\-motion <module>
-Specify a module for motion compensation: "motion", "motionmmx", for instance.
-.TP
-.B \-\-idct <module>
-Specify a module for IDCT: "idct", "idctmmx", for instance.
-.TP
-.B \-\-yuv <module>
-Specify a YUV module: "yuv", "yuvmmx", for instance.
-.TP
-.B \-\-display <display>
-Specify the display name.
-.TP
-.B \-\-width <w>, \-\-height <h>
-Choose the display coordinates.
-.TP
-.B \-g, \-\-grayscale
-Grayscale output.
-.TP
-.B \-\-fullscreen
-Full screen output.
-.TP
-.B \-\-overlay
-Overlay (hardware accelerated output), if available.
-.TP
-.B \-\-color
-Color output.
-.TP
-.B \-\-synchro <type>
-Choose a fixed synchro value instead of the internal auto-adaptative
-heuristics based on CPU usage.
+For a precise description of options, please use "vlc \-\-help".
 
-`I' displays only I images, `IP' displays I and P images, `IP+'
-displays I and P images and every second B image, and `IPB' forces
-displaying of all images.
+The complete list of
+.B VLC
+options depends on what plugins are installed because they automatically
+add their own options. Please use "vlc \-\-longhelp \-\-advanced" for a
+complete list of available options.
 
-Note that vlc is not guaranteed to behave properly if you ask it to
-display more images than your CPU can cope with.
-.TP
-.B \-t, \-\-dvdtitle <title>
-Choose the DVD title. Most movies on DVDs start on the first title, but you may want to manually select another title.
-.TP
-.B \-T, \-\-dvdchapter <title>
-Choose the DVD chapter. DVDs are divided into titles, which in turn are divided into chapters.
-.TP
-.B \-a, \-\-dvdaudio [ ac3 | lpcm | mpeg | off ]
-Choose the audio channel type. Most DVDs have AC3 audio channels, but
-you can also have Linear PCM or MPEG layer 2 sound. Also, one might decide
-not to activate the audio channel.
-.TP
-.B \-c, \-\-dvdchannel [ 0\-15 ]
-Select the audio channel. Most DVDs only have one or two audio channels,
-but some of them have a great number of available languages. Note that the
-audio channel will also depend on the channel type.
+.SH ITEMS
+.B VLC
+recognizes several URL-style items:
 .TP
-.B \-s, \-\-dvdsubtitle [ 0\-31 ]
-Select the subtitle channel, if there is one in the stream.
+.B *.mpg, *.vob, *.avi, *.mp3, *.ogg
+Various multimedia file formats
 .TP
-.B \-\-input <method>
-Choose the input method, "dvd", "ps", "ts" for instance.
-.TP
-.B \-\-vlans
-Enable VLANs support. This feature isn't activated yet.
-.TP
-.B \-\-server <host>, \-\-port <port>
-Choose the video server address and port.
-.TP
-.B \-\-broadcast
-Set broadcast mode for network input.
-.TP
-.B \-h, \-\-help
-Print help and exit.
-.TP
-.B \-H, \-\-longhelp
-Print long help and exit.
-.TP
-.B \-v, \-\-version
-Output version information and exit.
-.SH PARAMETERS
-.B vlc
-also accepts a lot of parameters to customize its behaviour.
+.B dvd://[<device>][@<raw device>][@[<title>][:[<chapter>][:<angle>]]]
+DVD device (for instance dvd:///dev/dvd). The raw device is optional and
+must have been prepared beforehand.
 .TP
-.B Interface parameters:
- vlc_intf=<method name>   interface method
- vlc_init=<filename>      initialization script
- vlc_channels=<filename>  channels list
- warning_level=<level>    warning level
+.B vcd://[<device>][@{E|P|E|T|S}[<number>]]
+VCD device (for instance vcd:///dev/cdrom).
 .TP
-.B Audio parameters:
- vlc_aout=<method name>   audio method
- vlc_dsp=<filename>       dsp device path
- vlc_stereo={1|0}         stereo or mono output
- vlc_audio_rate=<rate>    output rate
+.B udp://[@[<multicast address>][:<local port>]]
+UDP stream, such as one sent by VLS or another VLC.
+Usually "udp://" is enough.
 .TP
-.B Video parameters:
- vlc_vout=<method name>        display method
- vlc_display=<display>         display used
- vlc_width=<width>             display width
- vlc_height=<height>           dislay height
- vlc_fb_dev=<filename>         framebuffer device
- vlc_grayscale={1|0}           grayscale or color
- vlc_fullscreen={1|0}          full screen
- vlc_overlay={1|0}             overlay
- vlc_idct=<method name>        IDCT method
- vlc_yuv=<method name>         YUV method
- vlc_synchro={I|I+|IP|IP+|IPB} synchro algorithm
+.B http://<server address>[:<server port>]/[<file>]
+HTTP stream
 .TP
-.B DVD parameters:
- vlc_dvd_device=<device>           DVD device
- vlc_input_title=<title>           title number
- vlc_input_chapter=<chapter>       chapter number
- vlc_audio={ac3|lpcm|mpeg|off}     audio type
- vlc_channel=[0-15]                audio channel
- vlc_subtitle=[0-31]               subtitle channel
+.B rtsp://<server address>[:<server port>]/<stream name>
+RTSP Video On Demand stream
 .TP
-.B Input parameters:
- vlc_server=<hostname>    video server
- vlc_server_port=<port>   video server port
- vlc_broadcast={1|0}      broadcast mode
- vlc_iface=<interface>    network interface
- vlc_vlan_server=<host>   vlan server
- vlc_vlan_port=<port>     vlan server port
+.B vlc://<command>
+Execute a playlist command. Commands are:
+.B pause
+(pause execution of other items), and
+.B quit
+(close VLC).
 
 .SH SEE ALSO
-.BR vls (1), vlms (1)
-.br
+Online documentation: http://www.videolan.org/doc/
+.PP
 .SH AUTHOR
-This manual page was written by Samuel Hocevar <sam@zoy.org>, for the Debian GNU/Linux system (but may be used by others).
+This manual page was written by Sam Hocevar <sam@zoy.org>, for the Debian
+GNU/Linux system (but may be used by others).