Skip to content

Commit

Permalink
[media] docs-rst: use C domain for enum references on uapi
Browse files Browse the repository at this point in the history
Change the parse-headers.pl and the corresponding files to use
the C domain for enum references.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
  • Loading branch information
mchehab committed Sep 9, 2016
1 parent fb91161 commit ffa0441
Show file tree
Hide file tree
Showing 8 changed files with 23 additions and 23 deletions.
2 changes: 1 addition & 1 deletion Documentation/media/uapi/v4l/hist-v4l2.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1361,7 +1361,7 @@ V4L2 in Linux 3.19
:ref:`v4l2_quantization <v4l2-quantization>` fields to struct
:c:type:`v4l2_pix_format`, struct
: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
Expand Down
2 changes: 1 addition & 1 deletion Documentation/media/uapi/v4l/subdev-formats.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ Media Bus Formats

.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|

.. _v4l2-mbus-framefmt:
.. c:type:: v4l2_mbus_framefmt
.. flat-table:: struct v4l2_mbus_framefmt
:header-rows: 0
Expand Down
2 changes: 1 addition & 1 deletion Documentation/media/uapi/v4l/v4l2.rst
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ Rewrote Colorspace chapter, added new enum
:ref:`v4l2_quantization <v4l2-quantization>` fields to struct
:c:type:`v4l2_pix_format`, 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*)
Expand Down
2 changes: 1 addition & 1 deletion Documentation/media/uapi/v4l/vidioc-dqevent.rst
Original file line number Diff line number Diff line change
Expand Up @@ -356,7 +356,7 @@ call.

-
- The type of the control. See enum
:ref:`v4l2_ctrl_type <v4l2-ctrl-type>`.
:c:type:`v4l2_ctrl_type`.

- .. row 3

Expand Down
2 changes: 1 addition & 1 deletion Documentation/media/uapi/v4l/vidioc-g-priority.rst
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ an enum v4l2_priority variable and call :ref:`VIDIOC_S_PRIORITY <VIDIOC_G_PRIORI
with a pointer to this variable.
.. _v4l2-priority:
.. c:type:: v4l2_priority
.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
Expand Down
14 changes: 7 additions & 7 deletions Documentation/media/uapi/v4l/vidioc-queryctrl.rst
Original file line number Diff line number Diff line change
Expand Up @@ -142,7 +142,7 @@ See also the examples in :ref:`control`.
- ``minimum``
- 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.
Note that this a signed 32-bit value.
Expand All @@ -153,7 +153,7 @@ See also the examples in :ref:`control`.
- ``maximum``
- 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.
Note that this a signed 32-bit value.
Expand All @@ -164,7 +164,7 @@ See also the examples in :ref:`control`.
- ``step``
- 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
unsigned 32-bit value.
Expand Down Expand Up @@ -269,7 +269,7 @@ See also the examples in :ref:`control`.
- ``minimum``
- 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.
Note that this a signed 64-bit value.
Expand All @@ -280,7 +280,7 @@ See also the examples in :ref:`control`.
- ``maximum``
- 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.
Note that this a signed 64-bit value.
Expand All @@ -291,7 +291,7 @@ See also the examples in :ref:`control`.
- ``step``
- 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
unsigned 64-bit value.
Expand Down Expand Up @@ -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}|
.. _v4l2-ctrl-type:
.. c:type:: v4l2_ctrl_type
.. cssclass:: longtable
Expand Down
10 changes: 5 additions & 5 deletions Documentation/media/uapi/v4l/vidioc-subdev-g-fmt.rst
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ These ioctls are used to negotiate the frame format at specific subdev
pads in the image pipeline.
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
``V4L2_SUBDEV_FORMAT_ACTIVE``. When they call the
``VIDIOC_SUBDEV_G_FMT`` ioctl with a pointer to this structure the
Expand All @@ -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
driver verifies the requested format, adjusts it based on the hardware
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.
Applications can query the device capabilities by setting the ``which``
Expand Down Expand Up @@ -78,7 +78,7 @@ should be as close as possible to the original request.
.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
.. _v4l2-subdev-format:
.. c:type:: v4l2_subdev_format
.. flat-table:: struct v4l2_subdev_format
:header-rows: 0
Expand All @@ -105,7 +105,7 @@ should be as close as possible to the original request.
- .. row 3
- struct :ref:`v4l2_mbus_framefmt <v4l2-mbus-framefmt>`
- struct :c:type:`v4l2_mbus_framefmt`
- ``format``
Expand Down Expand Up @@ -164,7 +164,7 @@ EBUSY
fix the problem first. Only returned by ``VIDIOC_SUBDEV_S_FMT``
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
references a non-existing format.
Expand Down
12 changes: 6 additions & 6 deletions include/media/v4l2-dev.h
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ struct v4l2_ctrl_handler;
*
* .. note::
* 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 {
atomic_t prios[4];
Expand All @@ -73,8 +73,8 @@ void v4l2_prio_init(struct v4l2_prio_state *global);
* v4l2_prio_change - changes the v4l2 file handler priority
*
* @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>`
* @new: Priority type requested, 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 enum &v4l2_priority.
*
* .. note::
* This function should be used only by the V4L2 core.
Expand All @@ -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
*
* @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::
* This function should be used only by the V4L2 core.
Expand All @@ -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
*
* @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::
* This function should be used only by the V4L2 core.
Expand All @@ -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
*
* @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::
* This function should be used only by the V4L2 core.
Expand Down

0 comments on commit ffa0441

Please sign in to comment.