[MPlayer-DOCS] [PATCH] Teletext documentation (draft)

[Diego Biurrun]

On Fri, Sep 21, 2007 at 01:35:33PM +0700, Vladimir Voroshilov wrote:
> 
> 2007/9/21, Compn <tempn at twmi.rr.com>:
> > here is a quick review. i did not check the syntax/code, just the text.
> 
> Also changed vbi_device to tdevice
> Hope attached version is better.
> 
> What about this docs structure (TV currently contains only one "sect1"):
> 10 TV
> 10.1 TV input
> 10.2 Teletext
> 
> instead of current
> 10.TV
> 10.1 TV input
> ...
> 10.1.3 Teletext
> 
> Will it be better or not?

Your alternative is better I think.

> --- mplayer/DOCS/xml/en/tvinput.xml	(revision 24586)
> +++ mplayer/DOCS/xml/en/tvinput.xml	(working copy)
> @@ -137,6 +137,99 @@
>  
> +Teletext is a television information retrieval information service.
> +It provides various text-based information like international and sporting news,

sports

> +weather and TV schedules. Details can be found on
> +<ulink url="en.wikipedia.org/wiki/Teletext">Wikipedia's Teletext page</ulink>

Hmm, do we need to explain what teletext is?

Also, please lowercase teletext, same below.

> +<application>MPlayer</application> supports regular text, graphics and navigation links.
> +Unfortunately, colored pages are not fully supported yet - all pages are shown as greyscaled.

grAyscaled

Please try to not use overly long lines.

> +Subtitle pages (also known as Closed Captions) are supported too.

, too

> +<para>
> +<application>MPlayer</application> starts caching all teletext pages immediately after
> +starting tv://, so you don't need to wait until requested page is loaded.

do not, until the

What do you mean by "starting tv://"?

> +To enable Teletext decoding you must specify VBI device to get Teletext data

the VBI device

> +from (usually <filename>/dev/vbi0</filename> for Linux). This can be done by specifying
> +<option>tdevice</option> in your config, like shown below:
> +<screen>tv=tdevice=/dev/vbi0</screen>

config what?  configuration file?

> +Here is example for Russian:

an example

> +<row>
> +  <entry>digits</entry>
> +  <entry>Enters teletext page number to jump to</entry>

Enter

Diego