From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.1 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI,SPF_HELO_NONE, SPF_PASS,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 8FBA1C433E6 for ; Fri, 28 Aug 2020 09:16:58 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 51D082086A for ; Fri, 28 Aug 2020 09:16:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1598606218; bh=kZht2C+aKEFukt+Dpw8/uAC66G7++P2KlvN5dkpjiv8=; h=From:To:Cc:Subject:Date:List-ID:From; b=s9zDhSlz8eF7UW3ojk0PAiKcy6Ru5NAq4imhuEqmwzJdElWkSA9gu34JxTFCJKsG6 XRGGoC5qrop6UI2yGFCDoMyG9qGv9qaYTTb7KtPS9sOeuIumNFP5ui6GSy4IFIv3PG vqTnzxWWws/l5m8nfDRutVpnmQvebjrvApMYpcOY= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728556AbgH1JQ5 (ORCPT ); Fri, 28 Aug 2020 05:16:57 -0400 Received: from mail.kernel.org ([198.145.29.99]:48522 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728016AbgH1JQx (ORCPT ); Fri, 28 Aug 2020 05:16:53 -0400 Received: from mail.kernel.org (unknown [95.90.213.181]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 231372086A; Fri, 28 Aug 2020 09:16:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1598606213; bh=kZht2C+aKEFukt+Dpw8/uAC66G7++P2KlvN5dkpjiv8=; h=From:To:Cc:Subject:Date:From; b=b6608CxzsO8U32iO3dCebVcMJ+B243b1Eq/KkXefLcSxsWTam7Q/Vvk79xnfossNR xc8+H1B4qyJVaPQww3euXmFhtjX2mAgBAt//5qJ+9ZE9EoW5e9iodWBClHXuOxn0s5 +QoPrJJl/wMuw0Z9BWroT440Z87dMBLuFsP9KvPs= Received: from mchehab by mail.kernel.org with local (Exim 4.94) (envelope-from ) id 1kBaV9-0047A9-6F; Fri, 28 Aug 2020 11:16:51 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet , linux-media@vger.kernel.org, Sakari Ailus , Hans Verkuil Subject: [PATCH v11 0/4] Add a glossary for the media subsystem Date: Fri, 28 Aug 2020 11:16:46 +0200 Message-Id: X-Mailer: git-send-email 2.26.2 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org There are too many technical terms at the media subsystem, and sometimes the same thing is refered differently at the documentation and on the ML and IRC discussions. Let's add a glossary to the uAPI documentation, in order to start using a common vocabulary at the subsystem's discussion and to let things clearer for people trying to understand the subsystem. I'm pretty sure that this document doesn't cover everything, but it can (and should) be improved overtime. On version 11, I addressed the comments from Sakari over the past version with some text improvements on a couple of paragraphs. Mauro Carvalho Chehab (4): media: open.rst: better document device node naming media: open.rst: remove the minor number range media: docs: add glossary.rst with common terms used at V4L2 spec media: open.rst: document mc-centric and video-node-centric .../userspace-api/media/glossary.rst | 216 ++++++++++++++++++ Documentation/userspace-api/media/index.rst | 3 + .../userspace-api/media/v4l/open.rst | 111 +++++++-- 3 files changed, 316 insertions(+), 14 deletions(-) create mode 100644 Documentation/userspace-api/media/glossary.rst -- 2.26.2