Commit ffa0441e authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab

[media] docs-rst: use C domain for enum references on uapi

Change the parse-headers.pl and the corresponding files to use
the C domain for enum references.
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent fb91161a
...@@ -1361,7 +1361,7 @@ V4L2 in Linux 3.19 ...@@ -1361,7 +1361,7 @@ V4L2 in Linux 3.19
:ref:`v4l2_quantization <v4l2-quantization>` fields to struct :ref:`v4l2_quantization <v4l2-quantization>` fields to struct
:c:type:`v4l2_pix_format`, struct :c:type:`v4l2_pix_format`, struct
:c:type:`v4l2_pix_format_mplane` and :c:type:`v4l2_pix_format_mplane` and
struct :ref:`v4l2_mbus_framefmt <v4l2-mbus-framefmt>`. struct :c:type:`v4l2_mbus_framefmt`.
V4L2 in Linux 4.4 V4L2 in Linux 4.4
......
...@@ -7,7 +7,7 @@ Media Bus Formats ...@@ -7,7 +7,7 @@ Media Bus Formats
.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
.. _v4l2-mbus-framefmt: .. c:type:: v4l2_mbus_framefmt
.. flat-table:: struct v4l2_mbus_framefmt .. flat-table:: struct v4l2_mbus_framefmt
:header-rows: 0 :header-rows: 0
......
...@@ -116,7 +116,7 @@ Rewrote Colorspace chapter, added new enum ...@@ -116,7 +116,7 @@ Rewrote Colorspace chapter, added new enum
:ref:`v4l2_quantization <v4l2-quantization>` fields to struct :ref:`v4l2_quantization <v4l2-quantization>` fields to struct
:c:type:`v4l2_pix_format`, struct :c:type:`v4l2_pix_format`, struct
:c:type:`v4l2_pix_format_mplane` and struct :c:type:`v4l2_pix_format_mplane` and struct
:ref:`v4l2_mbus_framefmt <v4l2-mbus-framefmt>`. :c:type:`v4l2_mbus_framefmt`.
:revision: 3.17 / 2014-08-04 (*lp, hv*) :revision: 3.17 / 2014-08-04 (*lp, hv*)
......
...@@ -356,7 +356,7 @@ call. ...@@ -356,7 +356,7 @@ call.
- -
- The type of the control. See enum - The type of the control. See enum
:ref:`v4l2_ctrl_type <v4l2-ctrl-type>`. :c:type:`v4l2_ctrl_type`.
- .. row 3 - .. row 3
......
...@@ -44,7 +44,7 @@ an enum v4l2_priority variable and call :ref:`VIDIOC_S_PRIORITY <VIDIOC_G_PRIORI ...@@ -44,7 +44,7 @@ an enum v4l2_priority variable and call :ref:`VIDIOC_S_PRIORITY <VIDIOC_G_PRIORI
with a pointer to this variable. with a pointer to this variable.
.. _v4l2-priority: .. c:type:: v4l2_priority
.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
......
...@@ -142,7 +142,7 @@ See also the examples in :ref:`control`. ...@@ -142,7 +142,7 @@ See also the examples in :ref:`control`.
- ``minimum`` - ``minimum``
- Minimum value, inclusive. This field gives a lower bound for the - Minimum value, inclusive. This field gives a lower bound for the
control. See enum :ref:`v4l2_ctrl_type <v4l2-ctrl-type>` how control. See enum :c:type:`v4l2_ctrl_type` how
the minimum value is to be used for each possible control type. the minimum value is to be used for each possible control type.
Note that this a signed 32-bit value. Note that this a signed 32-bit value.
...@@ -153,7 +153,7 @@ See also the examples in :ref:`control`. ...@@ -153,7 +153,7 @@ See also the examples in :ref:`control`.
- ``maximum`` - ``maximum``
- Maximum value, inclusive. This field gives an upper bound for the - Maximum value, inclusive. This field gives an upper bound for the
control. See enum :ref:`v4l2_ctrl_type <v4l2-ctrl-type>` how control. See enum :c:type:`v4l2_ctrl_type` how
the maximum value is to be used for each possible control type. the maximum value is to be used for each possible control type.
Note that this a signed 32-bit value. Note that this a signed 32-bit value.
...@@ -164,7 +164,7 @@ See also the examples in :ref:`control`. ...@@ -164,7 +164,7 @@ See also the examples in :ref:`control`.
- ``step`` - ``step``
- This field gives a step size for the control. See enum - This field gives a step size for the control. See enum
:ref:`v4l2_ctrl_type <v4l2-ctrl-type>` how the step value is :c:type:`v4l2_ctrl_type` how the step value is
to be used for each possible control type. Note that this an to be used for each possible control type. Note that this an
unsigned 32-bit value. unsigned 32-bit value.
...@@ -269,7 +269,7 @@ See also the examples in :ref:`control`. ...@@ -269,7 +269,7 @@ See also the examples in :ref:`control`.
- ``minimum`` - ``minimum``
- Minimum value, inclusive. This field gives a lower bound for the - Minimum value, inclusive. This field gives a lower bound for the
control. See enum :ref:`v4l2_ctrl_type <v4l2-ctrl-type>` how control. See enum :c:type:`v4l2_ctrl_type` how
the minimum value is to be used for each possible control type. the minimum value is to be used for each possible control type.
Note that this a signed 64-bit value. Note that this a signed 64-bit value.
...@@ -280,7 +280,7 @@ See also the examples in :ref:`control`. ...@@ -280,7 +280,7 @@ See also the examples in :ref:`control`.
- ``maximum`` - ``maximum``
- Maximum value, inclusive. This field gives an upper bound for the - Maximum value, inclusive. This field gives an upper bound for the
control. See enum :ref:`v4l2_ctrl_type <v4l2-ctrl-type>` how control. See enum :c:type:`v4l2_ctrl_type` how
the maximum value is to be used for each possible control type. the maximum value is to be used for each possible control type.
Note that this a signed 64-bit value. Note that this a signed 64-bit value.
...@@ -291,7 +291,7 @@ See also the examples in :ref:`control`. ...@@ -291,7 +291,7 @@ See also the examples in :ref:`control`.
- ``step`` - ``step``
- This field gives a step size for the control. See enum - This field gives a step size for the control. See enum
:ref:`v4l2_ctrl_type <v4l2-ctrl-type>` how the step value is :c:type:`v4l2_ctrl_type` how the step value is
to be used for each possible control type. Note that this an to be used for each possible control type. Note that this an
unsigned 64-bit value. unsigned 64-bit value.
...@@ -456,7 +456,7 @@ See also the examples in :ref:`control`. ...@@ -456,7 +456,7 @@ See also the examples in :ref:`control`.
.. tabularcolumns:: |p{5.8cm}|p{1.4cm}|p{1.0cm}|p{1.4cm}|p{6.9cm}| .. tabularcolumns:: |p{5.8cm}|p{1.4cm}|p{1.0cm}|p{1.4cm}|p{6.9cm}|
.. _v4l2-ctrl-type: .. c:type:: v4l2_ctrl_type
.. cssclass:: longtable .. cssclass:: longtable
......
...@@ -38,7 +38,7 @@ These ioctls are used to negotiate the frame format at specific subdev ...@@ -38,7 +38,7 @@ These ioctls are used to negotiate the frame format at specific subdev
pads in the image pipeline. pads in the image pipeline.
To retrieve the current format applications set the ``pad`` field of a To retrieve the current format applications set the ``pad`` field of a
struct :ref:`v4l2_subdev_format <v4l2-subdev-format>` to the desired struct :c:type:`v4l2_subdev_format` to the desired
pad number as reported by the media API and the ``which`` field to pad number as reported by the media API and the ``which`` field to
``V4L2_SUBDEV_FORMAT_ACTIVE``. When they call the ``V4L2_SUBDEV_FORMAT_ACTIVE``. When they call the
``VIDIOC_SUBDEV_G_FMT`` ioctl with a pointer to this structure the ``VIDIOC_SUBDEV_G_FMT`` ioctl with a pointer to this structure the
...@@ -49,7 +49,7 @@ To change the current format applications set both the ``pad`` and ...@@ -49,7 +49,7 @@ To change the current format applications set both the ``pad`` and
the ``VIDIOC_SUBDEV_S_FMT`` ioctl with a pointer to this structure the the ``VIDIOC_SUBDEV_S_FMT`` ioctl with a pointer to this structure the
driver verifies the requested format, adjusts it based on the hardware driver verifies the requested format, adjusts it based on the hardware
capabilities and configures the device. Upon return the struct capabilities and configures the device. Upon return the struct
:ref:`v4l2_subdev_format <v4l2-subdev-format>` contains the current :c:type:`v4l2_subdev_format` contains the current
format as would be returned by a ``VIDIOC_SUBDEV_G_FMT`` call. format as would be returned by a ``VIDIOC_SUBDEV_G_FMT`` call.
Applications can query the device capabilities by setting the ``which`` Applications can query the device capabilities by setting the ``which``
...@@ -78,7 +78,7 @@ should be as close as possible to the original request. ...@@ -78,7 +78,7 @@ should be as close as possible to the original request.
.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
.. _v4l2-subdev-format: .. c:type:: v4l2_subdev_format
.. flat-table:: struct v4l2_subdev_format .. flat-table:: struct v4l2_subdev_format
:header-rows: 0 :header-rows: 0
...@@ -105,7 +105,7 @@ should be as close as possible to the original request. ...@@ -105,7 +105,7 @@ should be as close as possible to the original request.
- .. row 3 - .. row 3
- struct :ref:`v4l2_mbus_framefmt <v4l2-mbus-framefmt>` - struct :c:type:`v4l2_mbus_framefmt`
- ``format`` - ``format``
...@@ -164,7 +164,7 @@ EBUSY ...@@ -164,7 +164,7 @@ EBUSY
fix the problem first. Only returned by ``VIDIOC_SUBDEV_S_FMT`` fix the problem first. Only returned by ``VIDIOC_SUBDEV_S_FMT``
EINVAL EINVAL
The struct :ref:`v4l2_subdev_format <v4l2-subdev-format>` The struct :c:type:`v4l2_subdev_format`
``pad`` references a non-existing pad, or the ``which`` field ``pad`` references a non-existing pad, or the ``which`` field
references a non-existing format. references a non-existing format.
......
...@@ -56,7 +56,7 @@ struct v4l2_ctrl_handler; ...@@ -56,7 +56,7 @@ struct v4l2_ctrl_handler;
* *
* .. note:: * .. note::
* The size of @prios array matches the number of priority types defined * The size of @prios array matches the number of priority types defined
* by :ref:`enum v4l2_priority <v4l2-priority>`. * by enum &v4l2_priority.
*/ */
struct v4l2_prio_state { struct v4l2_prio_state {
atomic_t prios[4]; atomic_t prios[4];
...@@ -73,8 +73,8 @@ void v4l2_prio_init(struct v4l2_prio_state *global); ...@@ -73,8 +73,8 @@ void v4l2_prio_init(struct v4l2_prio_state *global);
* v4l2_prio_change - changes the v4l2 file handler priority * v4l2_prio_change - changes the v4l2 file handler priority
* *
* @global: pointer to the &struct v4l2_prio_state of the device node. * @global: pointer to the &struct v4l2_prio_state of the device node.
* @local: pointer to the desired priority, as defined by :ref:`enum v4l2_priority <v4l2-priority>` * @local: pointer to the desired priority, as defined by enum &v4l2_priority
* @new: Priority type requested, as defined by :ref:`enum v4l2_priority <v4l2-priority>`. * @new: Priority type requested, as defined by enum &v4l2_priority.
* *
* .. note:: * .. note::
* This function should be used only by the V4L2 core. * This function should be used only by the V4L2 core.
...@@ -86,7 +86,7 @@ int v4l2_prio_change(struct v4l2_prio_state *global, enum v4l2_priority *local, ...@@ -86,7 +86,7 @@ int v4l2_prio_change(struct v4l2_prio_state *global, enum v4l2_priority *local,
* v4l2_prio_open - Implements the priority logic for a file handler open * v4l2_prio_open - Implements the priority logic for a file handler open
* *
* @global: pointer to the &struct v4l2_prio_state of the device node. * @global: pointer to the &struct v4l2_prio_state of the device node.
* @local: pointer to the desired priority, as defined by :ref:`enum v4l2_priority <v4l2-priority>` * @local: pointer to the desired priority, as defined by enum &v4l2_priority
* *
* .. note:: * .. note::
* This function should be used only by the V4L2 core. * This function should be used only by the V4L2 core.
...@@ -97,7 +97,7 @@ void v4l2_prio_open(struct v4l2_prio_state *global, enum v4l2_priority *local); ...@@ -97,7 +97,7 @@ void v4l2_prio_open(struct v4l2_prio_state *global, enum v4l2_priority *local);
* v4l2_prio_close - Implements the priority logic for a file handler close * v4l2_prio_close - Implements the priority logic for a file handler close
* *
* @global: pointer to the &struct v4l2_prio_state of the device node. * @global: pointer to the &struct v4l2_prio_state of the device node.
* @local: priority to be released, as defined by :ref:`enum v4l2_priority <v4l2-priority>` * @local: priority to be released, as defined by enum &v4l2_priority
* *
* .. note:: * .. note::
* This function should be used only by the V4L2 core. * This function should be used only by the V4L2 core.
...@@ -118,7 +118,7 @@ enum v4l2_priority v4l2_prio_max(struct v4l2_prio_state *global); ...@@ -118,7 +118,7 @@ enum v4l2_priority v4l2_prio_max(struct v4l2_prio_state *global);
* v4l2_prio_close - Implements the priority logic for a file handler close * v4l2_prio_close - Implements the priority logic for a file handler close
* *
* @global: pointer to the &struct v4l2_prio_state of the device node. * @global: pointer to the &struct v4l2_prio_state of the device node.
* @local: desired priority, as defined by :ref:`enum v4l2_priority <v4l2-priority>` local * @local: desired priority, as defined by enum &v4l2_priority local
* *
* .. note:: * .. note::
* This function should be used only by the V4L2 core. * This function should be used only by the V4L2 core.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment