From 706f8a9975cb8889742d1f606ff466205ed29805 Mon Sep 17 00:00:00 2001 From: Mauro Carvalho Chehab Date: Sun, 10 Jul 2016 11:57:43 -0300 Subject: [media] doc-rst: improve display of notes and warnings There are several notes and warning mesages in the middle of the media docbook. Use the ReST tags for that, as it makes them visually better and hightlights them. While here, modify a few ones to make them clearer. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/uapi/v4l/vidioc-querystd.rst | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) (limited to 'Documentation/media/uapi/v4l/vidioc-querystd.rst') diff --git a/Documentation/media/uapi/v4l/vidioc-querystd.rst b/Documentation/media/uapi/v4l/vidioc-querystd.rst index 5bf62775c740..b4a4e222c7b0 100644 --- a/Documentation/media/uapi/v4l/vidioc-querystd.rst +++ b/Documentation/media/uapi/v4l/vidioc-querystd.rst @@ -43,16 +43,16 @@ will return V4L2_STD_UNKNOWN. When detection is not possible or fails, the set must contain all standards supported by the current video input or output. -Please note that drivers shall *not* switch the video standard -automatically if a new video standard is detected. Instead, drivers -should send the ``V4L2_EVENT_SOURCE_CHANGE`` event (if they support -this) and expect that userspace will take action by calling -:ref:`VIDIOC_QUERYSTD`. The reason is that a new video standard can mean -different buffer sizes as well, and you cannot change buffer sizes on -the fly. In general, applications that receive the Source Change event -will have to call :ref:`VIDIOC_QUERYSTD`, and if the detected video -standard is valid they will have to stop streaming, set the new -standard, allocate new buffers and start streaming again. +.. note:: Drivers shall *not* switch the video standard + automatically if a new video standard is detected. Instead, drivers + should send the ``V4L2_EVENT_SOURCE_CHANGE`` event (if they support + this) and expect that userspace will take action by calling + :ref:`VIDIOC_QUERYSTD`. The reason is that a new video standard can mean + different buffer sizes as well, and you cannot change buffer sizes on + the fly. In general, applications that receive the Source Change event + will have to call :ref:`VIDIOC_QUERYSTD`, and if the detected video + standard is valid they will have to stop streaming, set the new + standard, allocate new buffers and start streaming again. Return Value -- cgit