From patchwork Tue Sep 25 12:06:50 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 10613897 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 2605416B1 for ; Tue, 25 Sep 2018 12:07:27 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 1832028474 for ; Tue, 25 Sep 2018 12:07:27 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 0C998297F0; Tue, 25 Sep 2018 12:07:27 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-7.8 required=2.0 tests=BAYES_00,DKIM_SIGNED, MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI,T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 5BB4A297BA for ; Tue, 25 Sep 2018 12:07:20 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728781AbeIYSOc (ORCPT ); Tue, 25 Sep 2018 14:14:32 -0400 Received: from bombadil.infradead.org ([198.137.202.133]:60070 "EHLO bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726586AbeIYSOc (ORCPT ); Tue, 25 Sep 2018 14:14:32 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20170209; h=Sender:Message-Id:Date:Subject:Cc:To: From:Reply-To:MIME-Version:Content-Type:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=pwL3gmS8OXA2QAk22cgAEIKBJ+Tgw0HJHnEqlyKO2L4=; b=CjBVWfDsUQf/obhZsGomcaeSLA TvwHpo+TPA2CWmlrkZtQCCkMZ7DpkT++A43oIROPy5mIONN/5cm+GKJKDpaKoJ1XSOSLYhVHLMlrt aCsod7VONzdqihR7Ahk3zwHxBqJ0rM5ufVQhSaNHeyc5pUmQ60U211sJpYLoIg3FuJLmbS3sQjFdf QKnRTgd5k2RyGvfAtbbUaV2N2/bsynNStfSjCf7UkIciHwEE4de6MbhgojuzJvXsBl/DTN6S3cHju 8qqCv6kyL6yZi5AvMgmgSsXUijgz9173RIAgqhiIklcplUMPlmIxBHhumM4SasOh1r2JkGs3CYwdb gL1wVwdw==; Received: from 177.43.23.201.dynamic.adsl.gvt.net.br ([177.43.23.201] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.90_1 #2 (Red Hat Linux)) id 1g4m7F-0002Q4-Oe; Tue, 25 Sep 2018 12:07:17 +0000 Received: from mchehab by bombadil.infradead.org with local (Exim 4.91) (envelope-from ) id 1g4m7D-0006rv-0Q; Tue, 25 Sep 2018 09:06:55 -0300 From: Mauro Carvalho Chehab To: Linux Media Mailing List Cc: Mauro Carvalho Chehab , Mauro Carvalho Chehab , Hans Verkuil , Sakari Ailus Subject: [PATCH 0/3] Add a glossary and fix some issues at open.rst docs Date: Tue, 25 Sep 2018 09:06:50 -0300 Message-Id: X-Mailer: git-send-email 2.17.1 Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Those three patches were part of an attempt to add definitions for some terms used at the media subsystem: https://lwn.net/Articles/732022/ On that time, the first patch generated heated discussions, on terms related to mc-centric/vdev-centric. The cern of the discussions were how to call the subdev API and the non-subdev API part of the video4linux API. I ended by being side-tracked by other things, and didn't have a chance to submit an updated version. Well, now I'm doing things differently: at the glossary.rst, I removed everything related to hardware control. So, it should contain only the terms that there aren't any divergences. So, I hope we can manage to merge it this time. After having this series merged, I'll address again the MC/vdev centric hardware control on a separate patchset, perhaps using a different approach together with the new glossary definitions related to it. Mauro Carvalho Chehab (3): media: add glossary.rst with common terms used at V4L2 spec media: open.rst: better document device node naming media: open.rst: remove the minor number range Documentation/media/uapi/v4l/glossary.rst | 108 ++++++++++++++++++++++ Documentation/media/uapi/v4l/open.rst | 53 +++++++++-- Documentation/media/uapi/v4l/v4l2.rst | 1 + 3 files changed, 154 insertions(+), 8 deletions(-) create mode 100644 Documentation/media/uapi/v4l/glossary.rst Acked-by: Sakari Ailus