Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
From:   Michael Riesch <michael.riesch@wolfvision.net>
Date:   Tue, 25 Apr 2023 11:45:11 +0200
Subject: [PATCH RFC v2 1/6] media: v4l2-ctrls: fix documentation of
 V4L2_CID_FOCUS_ABSOLUTE unit
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
Message-Id: <20230406-feature-controls-lens-v2-1-faa8ad2bc404@wolfvision.net>
References: <20230406-feature-controls-lens-v2-0-faa8ad2bc404@wolfvision.net>
In-Reply-To: <20230406-feature-controls-lens-v2-0-faa8ad2bc404@wolfvision.net>
To:     Mauro Carvalho Chehab <mchehab@kernel.org>
Cc:     libcamera-devel@lists.libcamera.org,
        Laurent Pinchart <laurent.pinchart@ideasonboard.com>,
        Sakari Ailus <sakari.ailus@linux.intel.com>,
        Hans Verkuil <hverkuil-cisco@xs4all.nl>,
        Matthias Fend <Matthias.Fend@wolfvision.net>,
        Dave Stevenson <dave.stevenson@raspberrypi.com>,
        linux-media@vger.kernel.org, linux-kernel@vger.kernel.org,
        Michael Riesch <michael.riesch@wolfvision.net>
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?OGtYcTRjRThpbWJYTE9BclhpZUF2VE43cUNyS0RkYmdPdDZOZkY2NHh3V0FN?=
 =?utf-8?B?c29JYWN6YlkrN0k3NzZZRlA1ZlR1VlM3THVVWjRwY09LL1hKWXFQMHZTRnJj?=
 =?utf-8?B?eGpBMWRJZlRXM054WUV3ME5NV2w3ZjZEbzdrYVlVdWt5L3oyTUltQ0lPVGR5?=
 =?utf-8?B?dmxRQ0NpbjA0cXUvenViOHgyVk93Yk5sRlpwbGYxeWpJVDNQa2ovYlpYR2VF?=
 =?utf-8?B?WHd3eEduc2lWWGVHRzZTR0daRmNLTmJwSlYzZzhCQ1Y5ck94YzNOUkxwL2I1?=
 =?utf-8?B?T0NHS1BPUmdxNXdEWXNvbnlJOHY5bExRSXJPbnBzVjhnT1A0MU9RVHY1V3dl?=
 =?utf-8?B?Uy85b3RKbCtrRU5MTXBEV1Qzc3JjMlJhdnRSUlpMaTdKQ0h4OGp3SWR1Zm1B?=
 =?utf-8?B?cVV6eDhkdS9SSDArZDJ2MlZHc3JUL1hQSmlFUDRXVFh2UGVMMG9TRUJ2Ly84?=
 =?utf-8?B?MnJVVHJMb3Y4dXE3dlYwL0M4dGxBOE1EVm02Y3Y5QnZ5U01Obmp0UVdydzN6?=
 =?utf-8?B?T0ZYdGtVQitDYVFlemJHOUxsdFlDSml1QUJhaC81MGdvNjdHWVE1UXlUVERh?=
 =?utf-8?B?MmlrS29XUlRROWk2ZEpoekNkd296MWJZaUNNVlo2MW1ZR1pUZ0xVRTd5LzZn?=
 =?utf-8?B?eW5zRTVncGRTcE1vQ2tpTnhHdVhRMEJ4RjNGdnNuT3B2Tzg0L3Zyd1VKZW1o?=
 =?utf-8?B?RVM5RmJtbStzaXdzajFCVklMeW1tUXQzWjFaMGJndzQ0dS9OdFJVNnhaUnZN?=
 =?utf-8?B?WUI4UWpneVg4LzJIcGN3QlFxdGhablAwUDJva0ZzRTZ5R2NlUHpYTy8waFBB?=
 =?utf-8?B?TFlnS2lSZzg1bzJhQzZOSFduNkZkREhsOVJ0TTVOUk01VDFNSkZ0bGJOQlhh?=
 =?utf-8?B?WFg3enNJZ29yVXkvcEI2UjBhZEZrVndnTlFIaC9uMUFpeS9GQWo4OWtERDhQ?=
 =?utf-8?B?WjZlOFA1d0Y2Y2tEZzFxTzVkSnNIRytUaW41TlZ0dkFqc3huTFlPS1pRUXQx?=
 =?utf-8?B?QkZKbkdRRk0wd1ZXM09WV1hFOVZGQzZHam9MM1BTSHpLWWY3a1poWUgxUWgx?=
 =?utf-8?B?RjZkSEUzKzBEVE5zY0l5ZG52R3JTOEdnYzg3bEFnaDA4VllYdDdDaGdMWk1V?=
 =?utf-8?B?WWtQaFpiQ1l4ZUpJTlRTOGxqenpXWGdoa1FEa2FpNzgraUJMUEZKeHdCRmNq?=
 =?utf-8?B?QmNZUE5idFd1bjFaTmIzd2NGM2dSNXpIK0JpQUtEcEpkWi9DYkxTR3FsRDFJ?=
 =?utf-8?B?STFxL1VuUXZmQlBuRnBHQXljTW16SDRpeFdXZU9mNHVjaWtRVnZvc2dZYllp?=
 =?utf-8?B?b05ITHdqanZuRHFteWZYNXlHZ01DQThaSHF0S05WdmtZVnNvbEZoVEJ3Tlls?=
 =?utf-8?B?bnMwbFhJWUdOTGJYdWozVFBWU3BZSzBoTWN3Y09LZnNmWE8rMkI1cXpUMldw?=
 =?utf-8?B?OEVGck1YZS9XOFhnOGhhb3RMMEVhZ0F6YnFkQWU0UThwZzJSUVVRSzhxRlg2?=
 =?utf-8?B?WXpLMTF6MHA0QWUva3BMeVc5UHJJcDlheHF3V1VTUlJPV2p6Y2Y0UURTMDhY?=
 =?utf-8?B?bC9TOEJFZlowWEEvRzBOUXpFSXJIMzVEOTRCVWtHcCtvL1RmZXpNRURKM3Bl?=
 =?utf-8?B?L2txK0g0aW1YTHByN3p1ZGYveW91NmJOR0huMWFJamlqamNaRmpSdVZWWEs1?=
 =?utf-8?B?cU1ndUtwWk1HNERIU0JIM2JiYUlqV3hQbHdaRk00MTduOWZmaEJIanp0cFBt?=
 =?utf-8?B?RVJlR3JwTExpbUVybkt5VWF1ZU56QjdsMDFMclNNcXFjdVJNSCtaeWpmNkUy?=
 =?utf-8?B?TjFkcVZGRXhIWG85cGFTS05xSlhqRjRtZ3lkVVRMb1lmKzJ1TTZaS1JMUm45?=
 =?utf-8?B?SDF2SkJkUmJZRVJxeTdKc1VOa1F1U3AzRHdiVjR0UDJGQVUrSVFTNnVuL0xt?=
 =?utf-8?B?TFdaQkU1bFNLcXlMcG02Z1RDeHFOWEdBL1VuV25NUDloZVpjRDBKRVRNRWtj?=
 =?utf-8?B?OXMvRVA0c1dHQlhMbnJpTUJ4a1cyQ1oyMFZUcENoYmlRNjVDcGFtNzZiTlVF?=
 =?utf-8?B?N21xcU41VktnY2JLa2FQb0Rramkyb0NKWFQ1RFBLMm5OODVNMXJGVThLMGVh?=
 =?utf-8?B?MUZ0dXBOZkRETkxJQnRwRHhad0tZSnhISlRiakdyNHFhdkJpTzdtSUl6Nm0z?=
 =?utf-8?B?cEE9PQ==?=
X-OriginatorOrg: wolfvision.net
X-MS-Exchange-CrossTenant-Network-Message-Id: 3b4356f3-14d9-4cd8-b376-08db4571caad
X-MS-Exchange-CrossTenant-AuthSource: GV1SPRMB0046.eurprd08.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 25 Apr 2023 09:45:23.9518
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: e94ec9da-9183-471e-83b3-51baa8eb804f
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: jmseUhbvjM/qRoDvC7JYfFdSD75bfxI3qXkYxrfUqd3GsQs0OYvdQBDkzDLZAW2GXPk8D+K666yjzEdaMYGOtIPzHITSeHwo/8Y+kY+zaCM=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DU0PR08MB7995
X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE,
        RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS,T_SCC_BODY_TEXT_LINE,
        URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

The current unit description of the V4L2_CID_FOCUS_ABSOLUTE does not
make sense and was probably copy-pasted from V4L2_CID_FOCUS_RELATIVE.
Fix the unit description in the documentation.

Signed-off-by: Michael Riesch <michael.riesch@wolfvision.net>
---
 Documentation/userspace-api/media/v4l/ext-ctrls-camera.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-camera.rst b/Documentation/userspace-api/media/v4l/ext-ctrls-camera.rst
index daa4f40869f8..df29150dce7b 100644
--- a/Documentation/userspace-api/media/v4l/ext-ctrls-camera.rst
+++ b/Documentation/userspace-api/media/v4l/ext-ctrls-camera.rst
@@ -140,8 +140,8 @@ enum v4l2_exposure_metering -
 
 ``V4L2_CID_FOCUS_ABSOLUTE (integer)``
     This control sets the focal point of the camera to the specified
-    position. The unit is undefined. Positive values set the focus
-    closer to the camera, negative values towards infinity.
+    position. The unit is undefined. Larger values move the focus closer to
+    the camera, smaller values move the focus to infinity.
 
 ``V4L2_CID_FOCUS_RELATIVE (integer)``
     This control moves the focal point of the camera by the specified

-- 
2.37.2