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=-5.4 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_HELO_NONE,SPF_PASS,USER_AGENT_SANE_1 autolearn=unavailable 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 7CB5CC5ACBF for ; Thu, 12 Mar 2020 07:25:27 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 6B22B206F7 for ; Thu, 12 Mar 2020 07:25:27 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=xs4all.nl header.i=@xs4all.nl header.b="J1ti6MHR" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2387869AbgCLHZX (ORCPT ); Thu, 12 Mar 2020 03:25:23 -0400 Received: from lb3-smtp-cloud9.xs4all.net ([194.109.24.30]:46155 "EHLO lb3-smtp-cloud9.xs4all.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2388079AbgCLHZX (ORCPT ); Thu, 12 Mar 2020 03:25:23 -0400 Received: from [192.168.2.10] ([46.9.234.233]) by smtp-cloud9.xs4all.net with ESMTPA id CIDNjX37o9Im2CIDQjieLY; Thu, 12 Mar 2020 08:25:21 +0100 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=xs4all.nl; s=s1; t=1583997921; bh=mQr4GeLcmudw1gcKjKPAz1IuVLY4RaQ2nqWH7wqy+jw=; h=Subject:To:From:Message-ID:Date:MIME-Version:Content-Type:From: Subject; b=J1ti6MHRpdDak2qI1ISVFWbNX/Eqk8v5HE0MuKtdT/18vdtgVe8KxFi6lCp6EdztZ 7xL6+6t2eupX1X9SZgNXtHPz6UAXzMVxtdq35evePdisQZ0+Y6iPdgdTiTHqheMeiQ MniCy3+cYl0PytP94YPxVEqMCjgbKXQV9tqiij/a/TkxOxrjFeLYQSFLj/EEGUr0Nn r25LlAdnendD0rs3I7qnrPXfKoe9oSTm/Pb5OTMVCPAqmJ3mjB7DQouQpyRcovcdyK Zin/io82gE0kW1IQnH4/Uuc4V2nYsqcsrmILIQQz4dUA869j+iUndTXI4JsQyg52cH 3cQHKyoh9Xk+Q== Subject: Re: [PATCH v2 19/22] media: docs: move user-facing docs to the admin guide To: Mauro Carvalho Chehab , Linux Doc Mailing List Cc: linux-kernel@vger.kernel.org, Jonathan Corbet , linux-media@vger.kernel.org, Steve Longerbeam , Philipp Zabel , Shawn Guo , Sascha Hauer , Pengutronix Kernel Team , Fabio Estevam , NXP Linux Team , Rui Miguel Silva , Sakari Ailus , Andy Walls , Todor Tomov , Antoine Jacquet , Harry Wei , Alex Shi , Malcolm Priestley , linux-arm-kernel@lists.infradead.org, linux-usb@vger.kernel.org References: <05c08367b2c6a5b3f8f29499093d34b1f0d864fe.1583847557.git.mchehab+huawei@kernel.org> From: Hans Verkuil Message-ID: Date: Thu, 12 Mar 2020 08:25:09 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.5.0 MIME-Version: 1.0 In-Reply-To: <05c08367b2c6a5b3f8f29499093d34b1f0d864fe.1583847557.git.mchehab+huawei@kernel.org> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit X-CMAE-Envelope: MS4wfPeQb6Gl82DsP63bTAkbA0dckPqu5XZD0bRXQh7WyweZShLnApqbc6Kmta6Dz/FXo0jepjepVtp54e9tV17baAmZH8XNNx0AC9x9y0H5xPeS8TWdweK1 vOg1rjf7ek0WywQzmv5/gMJupK32K7deLroJmkkkkeYUKclOO22+VaLj+1C0J9S6iwPBSRcItauCYIEA86W9//RGOxfQHnglxP6CbKiODlmmEai4wnU7pCoW 9joPOuP2nMzieB0ZaVtdRHysTwbmJ0PWQI3P7IqoeenjJ2aG2RrBPpSSSMC1R95k7wpNmRIWNRuPM3MJoIgmMbl4dQoJrOnhc73wOOMG4CDjJ5OvNsrLHr+g skgB/VK/I1CJU0Zj0CWvnm/wLjVyBZa5ipOkt/3Uov+6hOTMMuft+v8Hibo71AFp3a431I9Ljb7rF193nY31Sv/yDT5mFjVOTBEL6EUZ9rwl+as6iCIztNRY rTuTN5ualcPabXhFkgbq62Zz5wqFqfbb/g+e1WnIKhGtx08xjIxmyDWrVMSO6BI4U59tyCyMJ45WJaO0Xkveow4rOCH6WPCXMXi7VGe3+XH8YzFxlLEaDIOh YDMdbjutw8KGEte1hWst83KMCwzfHGTTUhg0/jMblQvTWgq9n0RL9KVciAIk0VRr1kK47CFROFkmpIXuk4R+j4izQ8wMnhcWou6WT3YDCBFKEcGaUjz9Dzir Eu2XIZ8v+VzfkNCwmlsKMS6D2xwI+xLAXgBS8Oyhtfl6h9GZ8bWkKkYXmu/mIJbd0e/9RJdd0VMNvIJB3hSUzV02/xFBy3BcJ41ReZxkvODmI2fZDJvFkWfn VFZz7JC5MeddpJzXQAyA7367IslgEYTl66DP8KDgqDBoAK5bk8dIS/iw7nnqZzkMon9KMMoiJEfhG4kk/tY= Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On 3/10/20 2:43 PM, Mauro Carvalho Chehab wrote: > Most of the driver-specific documentation is meant to help > users of the media subsystem. > > Move them to the admin-guide. > > It should be noticed, however, that several of those files > are outdated and will require further work in order to make > them useful again. > > Signed-off-by: Mauro Carvalho Chehab > --- > Documentation/admin-guide/index.rst | 1 + > .../admin-guide/kernel-parameters.txt | 4 +- > .../media}/au0828-cardlist.rst | 0 > .../media}/avermedia.rst | 0 > .../media}/bt8xx.rst | 8 +- > .../media}/bttv-cardlist.rst | 0 > .../media}/bttv.rst | 0 > .../media}/cafe_ccic.rst | 0 > .../media}/cardlist.rst | 0 > .../media}/cards.rst | 0 > .../dvb-drivers => admin-guide/media}/ci.rst | 0 > .../media}/cpia2.rst | 0 > .../media}/cx23885-cardlist.rst | 0 > .../media}/cx88-cardlist.rst | 0 > .../media}/cx88.rst | 0 > .../media}/davinci-vpbe.rst | 0 > .../media}/em28xx-cardlist.rst | 0 > .../dvb-drivers => admin-guide/media}/faq.rst | 0 > .../media}/fimc.rst | 0 > .../media}/gspca-cardlist.rst | 0 > .../v4l-drivers => admin-guide/media}/imx.rst | 0 > .../media}/imx7.rst | 0 > Documentation/admin-guide/media/index.rst | 104 ++++++++++++++++++ > .../media}/intro.rst | 0 > .../media}/ipu3.rst | 0 > .../media}/ipu3_rcb.svg | 0 > .../media}/ivtv-cardlist.rst | 0 > .../media}/ivtv.rst | 0 > .../media}/lmedm04.rst | 0 > .../media}/meye.rst | 0 > .../media}/omap3isp.rst | 0 > .../media}/omap4_camera.rst | 0 > .../media}/opera-firmware.rst | 0 > .../media}/philips.rst | 0 > .../media}/pulse8-cec.rst | 0 > .../media}/qcom_camss.rst | 0 > .../media}/qcom_camss_8x96_graph.dot | 0 > .../media}/qcom_camss_graph.dot | 0 > .../media}/rcar-fdp1.rst | 0 > .../media}/saa7134-cardlist.rst | 0 > .../media}/saa7134.rst | 0 > .../media}/saa7164-cardlist.rst | 0 > .../media}/si470x.rst | 0 > .../media}/si4713.rst | 0 > .../media}/si476x.rst | 0 > .../media}/technisat.rst | 0 > .../media}/tm6000-cardlist.rst | 0 > .../media}/ttusb-dec.rst | 0 > .../media}/tuner-cardlist.rst | 0 > .../media}/udev.rst | 0 > .../media}/usbvision-cardlist.rst | 0 > .../media}/v4l-with-ir.rst | 0 > .../media}/vimc.dot | 0 > .../media}/vimc.rst | 0 > .../media}/vivid.rst | 0 > .../media}/zr364xx.rst | 0 > Documentation/media/cec-drivers/index.rst | 34 ------ > Documentation/media/dvb-drivers/index.rst | 11 -- > Documentation/media/index.rst | 4 +- > Documentation/media/v4l-drivers/index.rst | 25 ----- > .../zh_CN/video4linux/omap3isp.txt | 4 +- > .../media/v4l/dev-sliced-vbi.rst | 2 +- > .../media/v4l/ext-ctrls-codec.rst | 2 +- > .../media/v4l/ext-ctrls-image-process.rst | 2 +- > .../media/v4l/pixfmt-reserved.rst | 2 +- > MAINTAINERS | 22 ++-- > drivers/media/pci/bt8xx/Kconfig | 2 +- > drivers/media/pci/meye/Kconfig | 2 +- > drivers/media/radio/si470x/Kconfig | 2 +- > drivers/media/usb/dvb-usb-v2/lmedm04.c | 2 +- > drivers/media/usb/gspca/Kconfig | 2 +- > drivers/media/usb/zr364xx/Kconfig | 2 +- > 72 files changed, 136 insertions(+), 101 deletions(-) > rename Documentation/{media/v4l-drivers => admin-guide/media}/au0828-cardlist.rst (100%) > rename Documentation/{media/dvb-drivers => admin-guide/media}/avermedia.rst (100%) > rename Documentation/{media/dvb-drivers => admin-guide/media}/bt8xx.rst (93%) I would personally prefer to keep the split between v4l and dvb drivers, rather then putting them all in the same directory. What was the reason behind this choice? Regards, Hans