Received: by 2002:a05:6500:1b8f:b0:1fa:5c73:8e2d with SMTP id df15csp749478lqb; Wed, 29 May 2024 09:23:27 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCXQ3coomksWyo6ryAp6fBmFAEdVkE2sAJPesBiuaSp+gicjoAGXM84CAyxWWDIwfmMQPt1HFpNd9DcIDd7O/G4Qz3i4Zc0pGs2yflBBOQ== X-Google-Smtp-Source: AGHT+IHqeWVLHDd25q3DFmbs5eBFNq+rmhhY+KsKsZD3RGprJzY9BOqve1fs9otPdXBwjv2Yox8K X-Received: by 2002:a50:a683:0:b0:578:59f1:e3a3 with SMTP id 4fb4d7f45d1cf-57859f1e6bemr8365660a12.7.1716999806948; Wed, 29 May 2024 09:23:26 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1716999806; cv=pass; d=google.com; s=arc-20160816; b=h2BXkaxGKdCpVymRs8CDg98d1JRkJUexo5U57Mo4db6oSWXYpWOWyGzDIAWLrf+idx LvUrmL1Ufpg+vmIgZfZQcQ2FSksxkCpzwqVuxa9S9paU1Iv6N8pBydmiUYpy/3ClcEix hJk/TIeL8wJlE/RbrB1f7IFvMFfa6+oH09ibMhQO9r7bzWxaK46UpthqNgxs/Q4nZ37f FZR7SGsrqBw1EL7SBaRDnedPbONAIcs68ZyPR7Y6UJIk/UvjYwpUk4WUh3mQDRmQ3TWC 6fnCYfxdGQGc903X0j9GU+cXgkO0sJhDmMW6DKmWYQbJBDKnug0kVfK84u91XyiEFr4f v8pg== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:list-unsubscribe:list-subscribe:list-id:precedence :subject:date:from:dkim-signature; bh=inM8DCo47rhJ9DWN7K17yz15/g158T05bva4qurTEO8=; fh=L5RKyn4FGE9CM/DO5weAf09VC+/PcKpCkiS6NdDLsQc=; b=f3pw5Mi0WEus3W2Tpmhe0qQySIfnQOoQAu3e9YTu3Kc/UHi4O7eg4kT6/Z9OXl+io7 WiTUGjbMXmy1ZQUXpuaPpiBTZy6MzXUD7NwEncMqctjIrkYfRouQAC/oDklVGVoXo/kd ZFb30pvcJUQx/uYYDuxha5sJxH+N4k+rDwEHZQgt/BZeI3ozzWpbdundrM4EHY5R2wsx 5oNUFGmPTB79l0gpKNZH+nfjvjcSo603ODS1Lh4sgEOjaU5HLFLouhvFupHXZjRcuvUa 63RtXNGaiSXPzfHR/+ccySBkRmAe6zecrYwbOclzyTmS6VZ77lOOHFPiL7LiCZj2nWym 5ygA==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=gUU7E2rN; arc=pass (i=1 spf=pass spfdomain=collabora.com dkim=pass dkdomain=collabora.com dmarc=pass fromdomain=collabora.com); spf=pass (google.com: domain of linux-kernel+bounces-194434-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-194434-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=collabora.com Return-Path: Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [2604:1380:4601:e00::3]) by mx.google.com with ESMTPS id 4fb4d7f45d1cf-578c703d8e9si5282134a12.636.2024.05.29.09.23.26 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 May 2024 09:23:26 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-194434-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3; Authentication-Results: mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=gUU7E2rN; arc=pass (i=1 spf=pass spfdomain=collabora.com dkim=pass dkdomain=collabora.com dmarc=pass fromdomain=collabora.com); spf=pass (google.com: domain of linux-kernel+bounces-194434-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-194434-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=collabora.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by am.mirrors.kernel.org (Postfix) with ESMTPS id A9F261F21F71 for ; Wed, 29 May 2024 16:23:26 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id C18BF184129; Wed, 29 May 2024 16:23:08 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=collabora.com header.i=@collabora.com header.b="gUU7E2rN" Received: from madrid.collaboradmins.com (madrid.collaboradmins.com [46.235.227.194]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 6ECBD181B8B; Wed, 29 May 2024 16:23:06 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=46.235.227.194 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1716999788; cv=none; b=ArukjwI8FV07E2RBew2iBam4CtOYZ2OzT/32tW62+XNV5jG2t+H3UbX/U9KoEUk1bl+TdJ1PqLwtuTf1oMw+qAbZ4nAc1kB2ueVodaCF5A5Th29RVbyDcfA7pDD1rTgagPgVkd54mzwA09YCLc3JZO4O+a92K1bJ3DQQaFPCEpk= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1716999788; c=relaxed/simple; bh=g5pHQd73mBrP9X400nvFyG13JPUFcrrvEIFvGsi6JJg=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=LgVrBFJlyveOmEz8qUYGLn+st2YzvuU44epPWa0Lirb0DFP2zGitms5Iy69XcvGK1ek6eedl5zP6cppITtqOiC36kvp/Zu2wNl8qOQocYN6OElytNitjC48kGq25WREa6z5D05keel0e7A/v+FjeR6/4CXutHYZQH5QBxkkbScE= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=collabora.com; spf=pass smtp.mailfrom=collabora.com; dkim=pass (2048-bit key) header.d=collabora.com header.i=@collabora.com header.b=gUU7E2rN; arc=none smtp.client-ip=46.235.227.194 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=collabora.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=collabora.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=collabora.com; s=mail; t=1716999784; bh=g5pHQd73mBrP9X400nvFyG13JPUFcrrvEIFvGsi6JJg=; h=From:Date:Subject:References:In-Reply-To:To:Cc:From; b=gUU7E2rNyrmIiJbOzVcdyExhr6tCisnPx49KpV6y231HX0g9xmPEFi/bBRH3Q6e/J +/HPD2yTXjYilZJJi9ZFsZtNh2g7i7V4Kq6xBu3J+woJLb9XVqa1mr6WB2m9rGVt3b osX6HLSb7MDGcSZR1ExJWI4flLVe3DAeGTN8Xo0tA8PcGjTovcgwnpy6cC0PFCZ7kc 0jT/mQDxypj7rjkqlUKzRoDQ/FZPuRc8cX/9RdiZhiwZCMmVsWn8KQ14FWMfK0K0UT LmGx4pHuL63rQ1xAaYVgMpVrO1A2oV9YBzNFAI8E4DwjuMroOS4KQ1ZfkM8AAOCBX0 HWoMtNwdE/zDg== Received: from localhost (cola.collaboradmins.com [195.201.22.229]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (prime256v1) server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: sebastianfricke) by madrid.collaboradmins.com (Postfix) with ESMTPSA id 956163782192; Wed, 29 May 2024 16:23:04 +0000 (UTC) From: Sebastian Fricke Date: Wed, 29 May 2024 18:22:56 +0200 Subject: [PATCH RFC 1/2] docs: media: Create separate documentation folder for media Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20240529-b4-media_docs_improve-v1-1-9ddb111c4433@collabora.com> References: <20240529-b4-media_docs_improve-v1-0-9ddb111c4433@collabora.com> In-Reply-To: <20240529-b4-media_docs_improve-v1-0-9ddb111c4433@collabora.com> To: Jonathan Corbet Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-media@vger.kernel.org, laurent.pinchart@ideasonboard.com, hverkuil-cisco@xs4all.nl, mauro.chehab@linux.intel.com, kernel@collabora.com, Sebastian Fricke X-Mailer: b4 0.11.1 X-Developer-Signature: v=1; a=ed25519-sha256; t=1716999782; l=1395; i=sebastian.fricke@collabora.com; s=linux-media; h=from:subject:message-id; bh=g5pHQd73mBrP9X400nvFyG13JPUFcrrvEIFvGsi6JJg=; b=o75jPj20EaePaRSJ+J20i20PUyuNl60NtA9hXX/axl6/MA0ymHy9IlLpk2it++ToZcCAc/l1Ps29 RFm7rD+KB2ZlY3knlxkwBKZpvG/hdl4JP9bdvuRZ2l2nMjS7YmYb X-Developer-Key: i=sebastian.fricke@collabora.com; a=ed25519; pk=pYXedPwrTtErcj7ERYeo/IpTrpe4QbJuEzSB52fslBg= The media subsystem currently only maintains a set of Kernel API documentations, with the intent of adding guides for the subsystem a separate location is required. Create an empty folder with an index and embed it into the subsystem listing. Signed-off-by: Sebastian Fricke --- Documentation/media/index.rst | 19 +++++++++++++++++++ Documentation/subsystem-apis.rst | 1 + 2 files changed, 20 insertions(+) diff --git a/Documentation/media/index.rst b/Documentation/media/index.rst new file mode 100644 index 000000000000..d056a9e99dca --- /dev/null +++ b/Documentation/media/index.rst @@ -0,0 +1,19 @@ +.. SPDX-License-Identifier: GPL-2.0 + +============================= +Media Subsystem Documentation +============================= + +.. toctree:: + :maxdepth: 2 + + ../userspace-api/media/index + ../driver-api/media/index.rst + ../admin-guide/media/index + +.. only:: subproject and html + + Indices + ======= + + * :ref:`genindex` diff --git a/Documentation/subsystem-apis.rst b/Documentation/subsystem-apis.rst index 74af50d2ef7f..5a1d90fd1af6 100644 --- a/Documentation/subsystem-apis.rst +++ b/Documentation/subsystem-apis.rst @@ -33,6 +33,7 @@ Human interfaces input/index hid/index sound/index + media/index gpu/index fb/index leds/index -- 2.25.1