media: cec: documentation fixes

Return Value

============

:c:func:`close()` returns 0 on success. On error, -1 is returned, and

:c:func:`close() <cec-close>` returns 0 on success. On error, -1 is returned, and

``errno`` is set appropriately. Possible error codes are:

``EBADF``

Description

===========

The :c:func:`ioctl()` function manipulates cec device parameters. The

The :c:func:`ioctl() <cec-ioctl>` function manipulates cec device parameters. The

argument ``fd`` must be an open file descriptor.

The ioctl ``request`` code specifies the cec function to be called. It

Description

===========

To open a cec device applications call :c:func:`open()` with the

To open a cec device applications call :c:func:`open() <cec-open>` with the

desired device name. The function has no side effects; the device

configuration remain unchanged.

Return Value

============

:c:func:`open()` returns the new file descriptor on success. On error,

:c:func:`open() <cec-open>` returns the new file descriptor on success. On error,

-1 is returned, and ``errno`` is set appropriately. Possible error codes

include:

Description

===========

With the :c:func:`poll()` function applications can wait for CEC

With the :c:func:`poll() <cec-poll>` function applications can wait for CEC

events.

On success :c:func:`poll()` returns the number of file descriptors

On success :c:func:`poll() <cec-poll>` returns the number of file descriptors

that have been selected (that is, file descriptors for which the

``revents`` field of the respective struct :c:type:`pollfd`

is non-zero). CEC devices set the ``POLLIN`` and ``POLLRDNORM`` flags in

a value of zero, on failure it returns -1 and the ``errno`` variable is

set appropriately.

For more details see the :c:func:`poll()` manual page.

For more details see the :c:func:`poll() <cec-poll>` manual page.

Return Value

============

On success, :c:func:`poll()` returns the number structures which have

On success, :c:func:`poll() <cec-poll>` returns the number structures which have

non-zero ``revents`` fields, or zero if the call timed out. On error -1

is returned, and the ``errno`` variable is set appropriately:

=========

``fd``

    File descriptor returned by :ref:`open() <cec-func-open>`.

    File descriptor returned by :c:func:`open() <cec-open>`.

``argp``