From 7d2848a57e6a804443dba70e6ffd719c3145cb6a Mon Sep 17 00:00:00 2001 From: Mauro Carvalho Chehab Date: Wed, 16 Sep 2009 11:35:29 -0300 Subject: DocBook: Update with the -git changes From: Mauro Carvalho Chehab After this patch, -git and -hg trees were updated to have the DocBook at the kernel tree. All duplicated info were removed. Still pending: there are some dynamic files generated: media-entities.tmpl and media-indexes.tmpl: created from v4l and dvb *.xml files; *.c.xml *.h.xml: created from some in-trees and out-trees files. We need a proccess to auto-generate those files every time someone touches a file that affects the DocBook. It would be possible to add the rules to generate some of them at kernel's Makefile, but what to do with the out-of-tree files? move them to kernel tree? kernel-sync: Signed-off-by: Mauro Carvalho Chehab --- linux/Documentation/DocBook/dvb/examples.xml | 2 +- linux/Documentation/DocBook/dvb/frontend.xml | 4 ++-- linux/Documentation/DocBook/dvb/intro.xml | 8 ++++---- linux/Documentation/DocBook/media.tmpl | 4 ++-- linux/Documentation/DocBook/v4l/common.xml | 11 +---------- linux/Documentation/DocBook/v4l/dev-teletext.xml | 4 ++-- linux/Documentation/DocBook/v4l/pixfmt.xml | 2 +- linux/Documentation/DocBook/v4l/remote_controllers.xml | 9 +++++++-- 8 files changed, 20 insertions(+), 24 deletions(-) (limited to 'linux/Documentation/DocBook') diff --git a/linux/Documentation/DocBook/dvb/examples.xml b/linux/Documentation/DocBook/dvb/examples.xml index b89dceda6..f037e568e 100644 --- a/linux/Documentation/DocBook/dvb/examples.xml +++ b/linux/Documentation/DocBook/dvb/examples.xml @@ -2,7 +2,7 @@ In this section we would like to present some examples for using the DVB API. Maintainer note: This section is out of date. Please refer to the sample programs packaged -with the driver distribution from http://linuxtv.org/. +with the driver distribution from .
diff --git a/linux/Documentation/DocBook/dvb/frontend.xml b/linux/Documentation/DocBook/dvb/frontend.xml index 91a749f70..028c9f23f 100644 --- a/linux/Documentation/DocBook/dvb/frontend.xml +++ b/linux/Documentation/DocBook/dvb/frontend.xml @@ -11,8 +11,8 @@ role="tt">linux/dvb/frontend.h in your application. is not yet handled by this API but a future extension is possible. For DVB-S the frontend device also supports satellite equipment control (SEC) via DiSEqC and V-SEC protocols. The DiSEqC (digital SEC) -specification is available from Eutelsat http://www.eutelsat.org/. +specification is available from +Eutelsat. Note that the DVB API may also be used for MPEG decoder-only PCI cards, in which case there exists no frontend device. diff --git a/linux/Documentation/DocBook/dvb/intro.xml b/linux/Documentation/DocBook/dvb/intro.xml index 83676c44e..0dc83f672 100644 --- a/linux/Documentation/DocBook/dvb/intro.xml +++ b/linux/Documentation/DocBook/dvb/intro.xml @@ -10,8 +10,8 @@ you should know what a program/transport stream (PS/TS) is and what is meant by a packetized elementary stream (PES) or an I-frame. Various DVB standards documents are available from -http://www.dvb.org/ and/or -http://www.etsi.org/. + and/or +. It is also necessary to know how to access unix/linux devices and how to use ioctl calls. This also includes the knowledge of C or C++. @@ -31,8 +31,8 @@ and filtering several section and PES data streams at the same time. In early 2000, we were approached by Nokia with a proposal for a new standard Linux DVB API. As a commitment to the development of terminals based on open standards, Nokia and Convergence made it -available to all Linux developers and published it on http://www.linuxtv.org/ in September 2000. +available to all Linux developers and published it on + in September 2000. Convergence is the maintainer of the Linux DVB API. Together with the LinuxTV community (i.e. you, the reader of this document), the Linux DVB API will be constantly reviewed and improved. With the Linux driver for diff --git a/linux/Documentation/DocBook/media.tmpl b/linux/Documentation/DocBook/media.tmpl index 14302589d..eea564bb1 100644 --- a/linux/Documentation/DocBook/media.tmpl +++ b/linux/Documentation/DocBook/media.tmpl @@ -1,8 +1,8 @@ %media-entities; - + %media-entities; + diff --git a/linux/Documentation/DocBook/v4l/common.xml b/linux/Documentation/DocBook/v4l/common.xml index dd598ac9a..b1a81d246 100644 --- a/linux/Documentation/DocBook/v4l/common.xml +++ b/linux/Documentation/DocBook/v4l/common.xml @@ -506,15 +506,6 @@ are used for TV and radio devices alike. Drivers must support both ioctls when the tuner or modulator ioctls are supported, or when the device is a radio device.
- -
- Satellite Receivers - - To be discussed. See also -proposals by Peter Schlaf, video4linux-list@redhat.com on 23 Oct 2002, -subject: "Re: [V4L] Re: v4l2 api". -
@@ -802,7 +793,7 @@ optional. a special ioctl to enumerate all image formats supported by video capture, overlay or output devices is available. Enumerating formats an application has no a-priori -knowledge of (otherwise it could explicitely ask for them and need not +knowledge of (otherwise it could explicitly ask for them and need not enumerate) seems useless, but there are applications serving as proxy between drivers and the actual video applications for which this is useful. diff --git a/linux/Documentation/DocBook/v4l/dev-teletext.xml b/linux/Documentation/DocBook/v4l/dev-teletext.xml index 59f9993e1..76184e8ed 100644 --- a/linux/Documentation/DocBook/v4l/dev-teletext.xml +++ b/linux/Documentation/DocBook/v4l/dev-teletext.xml @@ -10,8 +10,8 @@ connected to the PC parallel port. The Teletext API was designed by Martin Buck. It is defined in the kernel header file linux/videotext.h, the -specification is available from -http://home.pages.de/~videotext/. (Videotext is the name of +specification is available from +ftp://ftp.gwdg.de/pub/linux/misc/videotext/. (Videotext is the name of the German public television Teletext service.) Conventional character device file names are /dev/vtx and /dev/vttuner, with device number 83, 0 and 83, 16 diff --git a/linux/Documentation/DocBook/v4l/pixfmt.xml b/linux/Documentation/DocBook/v4l/pixfmt.xml index aaea55d44..ebfbed03d 100644 --- a/linux/Documentation/DocBook/v4l/pixfmt.xml +++ b/linux/Documentation/DocBook/v4l/pixfmt.xml @@ -157,7 +157,7 @@ used in the Windows world. +http://www.poynton.com/notes/colour_and_gamma/ColorFAQ.html --> diff --git a/linux/Documentation/DocBook/v4l/remote_controllers.xml b/linux/Documentation/DocBook/v4l/remote_controllers.xml index eb669537a..73f5eab09 100644 --- a/linux/Documentation/DocBook/v4l/remote_controllers.xml +++ b/linux/Documentation/DocBook/v4l/remote_controllers.xml @@ -2,8 +2,13 @@
Introduction -Currently, most analog and digital devices have a Infrared input for remote controllers. Each manufacturer has their own type of control. It is not rare that the same manufacturer to ship different types of controls, depending on the device. -Unfortunately, during several years, there weren't any effort to uniform the IR keycodes under different boards. This resulted that the same IR keyname to be mapped completely different on different IR's. Due to that, V4L2 API now specifies a standard for mapping Media keys on IR. +Currently, most analog and digital devices have a Infrared input for remote controllers. Each +manufacturer has their own type of control. It is not rare for the same manufacturer to ship different +types of controls, depending on the device. +Unfortunately, for several years, there was no effort to create uniform IR keycodes for +different devices. This caused the same IR keyname to be mapped completely differently on +different IR devices. This resulted that the same IR keyname to be mapped completely different on +different IR's. Due to that, V4L2 API now specifies a standard for mapping Media keys on IR. This standard should be used by both V4L/DVB drivers and userspace applications The modules register the remote as keyboard within the linux input layer. This means that the IR key strokes will look like normal keyboard key strokes (if CONFIG_INPUT_KEYBOARD is enabled). Using the event devices (CONFIG_INPUT_EVDEV) it is possible for applications to access the remote via /dev/input/event devices. -- cgit v1.2.3