linux-toradex.git/Documentation/DocBook/media/Makefile, branch v3.2.5

[media] DocBook: Add a chapter to describe media errors

2011-07-27T20:53:35+00:00

There are several errors reported by V4L that aren't described.
They can occur on almost all ioctl's. Instead of adding them
into each ioctl, create a new chapter.

For V4L, the new chapter will automatically be listed on all
places, as there's a macro used everywhere there.

Acked-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

[media] DocBook: Use base64 for gif/png files

2011-07-27T20:52:59+00:00

The patch utility doesn't work with non-binary files. This causes some
tools to break, like generating tarball targets and the scripts that
generate diff patches at http://www.kernel.org/pub/linux/kernel/v2.6/.

So, let's convert all binaries to ascii using base64, and add a
logic at Makefile to convert them back into binaries at runtime.

Reported-by: Randy Dunlap 
Reported-by: Andrew Morton 
Reviewed-by: Michal Marek 
Signed-off-by: Mauro Carvalho Chehab

[media] DocBook: Don't be noisy at make cleanmediadocs

2011-07-27T20:52:58+00:00

While here, remove the mediaindexdocs from PHONY.

Reported-by: Randy Dunlap 
Signed-off-by: Mauro Carvalho Chehab

[media] DocBook/video.xml: Fix section references with video.h.xml

2011-07-27T20:52:58+00:00

Make the reference links at video.h.xml to match the ones at video.xml.

Signed-off-by: Mauro Carvalho Chehab

[media] DocBook/Makefile: Remove osd.h header

2011-07-27T20:52:58+00:00

The av7110 uses an OSD API. Such API is not documented at all. Also,
the osd.h API uses camelCase and some other weird stuff. Also, dvb-core
doesn't recognize it.

I don't see any good reason why we should document it. It seems better
to just let it as-is. If ever needed, it is probably better to write
a different API for dvb-core.

Signed-off-by: Mauro Carvalho Chehab

[media] DocBook/net.xml: Synchronize Network data structure

2011-07-27T20:52:57+00:00

There's no documentation at all for the DVB net API. Still, better to
remove a few warnings about the missing symbols. So, add the net data
structure inside the net.xml. Now, only the ioctl documentation is missed.

Signed-off-by: Mauro Carvalho Chehab

[media] DocBook/demux.xml: Fix section references with dmx.h.xml

2011-07-27T20:52:57+00:00

Make the reference links at dmx.h.xml to match the ones at demux.xml.

While here, also syncronizes the structures defined inside the API,
in order to match the current API.

Signed-off-by: Mauro Carvalho Chehab

[media] Docbook/ca.xml: match section ID's with the reference links

2011-07-27T20:52:57+00:00

Make sure that both ca.h.xml and ca.xml will match the same names for
the sections/links.

This way, it is now possible to identify API spec gaps:

Error: no ID for constraint linkend: ca-pid.
Error: no ID for constraint linkend: ca-pid.
Error: no ID for constraint linkend: CA_RESET.
Error: no ID for constraint linkend: CA_GET_CAP.
Error: no ID for constraint linkend: CA_GET_SLOT_INFO.
Error: no ID for constraint linkend: CA_GET_DESCR_INFO.
Error: no ID for constraint linkend: CA_GET_MSG.
Error: no ID for constraint linkend: CA_SEND_MSG.
Error: no ID for constraint linkend: CA_SET_DESCR.
Error: no ID for constraint linkend: CA_SET_PID.

Basically, in this case, no CA ioctl is described at the specs, and one
file structure (ca-pid) is missing.

Signed-off-by: Mauro Carvalho Chehab

[media] DocBook/audio.xml: match section ID's with the reference links

2011-07-27T20:52:55+00:00

Make sure that both audio.h.xml and audio.xml will match the same names.
This way, it is now possible to identify API spec gaps:

Error: no ID for constraint linkend: AUDIO_CONTINUE.
Error: no ID for constraint linkend: AUDIO_GET_PTS.
Error: no ID for constraint linkend: AUDIO_BILINGUAL_CHANNEL_SELECT.

While here, fix the cut-and-paste description error on AUDIO_SET_KARAOKE.

Signed-off-by: Mauro Carvalho Chehab

[media] DocBook: Add the other DVB API header files

2011-07-27T20:52:55+00:00

Signed-off-by: Mauro Carvalho Chehab