From patchwork Sat Feb 3 21:53:45 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thorsten Blum X-Patchwork-Id: 196404 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:168b:b0:106:860b:bbdd with SMTP id ma11csp151783dyb; Sat, 3 Feb 2024 17:36:15 -0800 (PST) X-Google-Smtp-Source: AGHT+IENvCqJShTn15tWFtSxxG1krhY8zO7VUlvD8hwztQHIotg+egOlAsMzqglcV9HpJOBHacll X-Received: by 2002:a17:906:dda:b0:a30:3323:8ea1 with SMTP id p26-20020a1709060dda00b00a3033238ea1mr9376810eji.23.1707010575001; Sat, 03 Feb 2024 17:36:15 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1707010574; cv=pass; d=google.com; s=arc-20160816; b=VhG4jHk2vvOcigS77trUxc87W0qo3YOa5k8ltjkUPvd5YBGnxdbc+5riktDCQucK2n wlM4T559KXaEDiSj/ALew4ymsffTROqEVmWOLMpuy3cgAG8UGaIiQnIAGSTOxGUhbHK8 oBMVGw74eskHdSV6beeS/yb0cISjH7zvJcrrHSwEQ72tAcgXQJEt70EHA8U1MRd9rqn4 mmB9ixZh1ceUs2H1VHC1BgsVvs+vgWZwUtKqWeWoiEXHdNbD+ASDYv0aNTvS4JOjl+ZF Syvv8310vJG6nH88DFA1uxnSj1HCGTEjvDvyAdn2EGTBaEcOtaPShGl/PpGrkHt52WI3 wZ+g== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:message-id:date:subject:cc:to :from:dkim-signature; bh=QSh3+bsIgvBbpY5uR/zlE9QAypvU9WM+2nXDWZ8TyzQ=; fh=616NTFMhH6uImkoMklG9xYx5vXSVOt/dagXT+2mRGNw=; b=RtunmYHwiqfKAQFHPFvYOqD84MtUVcCA3L3S9iEE0Yol9+jnodcBHkqttwXNsOzpeq hqVXtnuUnUknliH2xBiSXzqePjM+5UbcyLDQD0kHuanWvMx/tdzVekovtLT++w1Hgqib ro9wmCgXYRHMXjjhgiw2fZbmirgjfZtmPPdwifiyjhyGmvf1mm2pWjurgQQGRxVUb5Cv 8Gqdiuo5URE004ShC7C3sr3UqNIWSPHs+1vRUqVLOC2/jr87bLMF9eSJqLJNQxcsg6tE WTqGnK5e1/KhIgDfg5z9kcFSPCyp+DpXYmtYIomPZNaW5KUYFThjyVyTBN+8jTWQdAw+ Zb8w==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@toblux-com.20230601.gappssmtp.com header.s=20230601 header.b="Mm7nqW1/"; arc=pass (i=1 dkim=pass dkdomain=toblux-com.20230601.gappssmtp.com); spf=pass (google.com: domain of linux-kernel+bounces-51306-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-51306-ouuuleilei=gmail.com@vger.kernel.org" X-Forwarded-Encrypted: i=1; AJvYcCUwb7pNYvOEWzoUUbzN4k75I62qsNJ8LVaoUMrWj6B4HE6tYVM9neMGjkBqJgxpl/UrSmSahtOvSEyojzyzYz/BLqhNVQ== Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [147.75.80.249]) by mx.google.com with ESMTPS id ci11-20020a170906c34b00b00a35cd442d8esi2407187ejb.1014.2024.02.03.17.36.14 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 03 Feb 2024 17:36:14 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-51306-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249; Authentication-Results: mx.google.com; dkim=pass header.i=@toblux-com.20230601.gappssmtp.com header.s=20230601 header.b="Mm7nqW1/"; arc=pass (i=1 dkim=pass dkdomain=toblux-com.20230601.gappssmtp.com); spf=pass (google.com: domain of linux-kernel+bounces-51306-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-51306-ouuuleilei=gmail.com@vger.kernel.org" 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 82FF41F235FD for ; Sat, 3 Feb 2024 21:58:06 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id E88F1168BC; Sat, 3 Feb 2024 21:57:52 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=toblux-com.20230601.gappssmtp.com header.i=@toblux-com.20230601.gappssmtp.com header.b="Mm7nqW1/" Received: from mail-lj1-f180.google.com (mail-lj1-f180.google.com [209.85.208.180]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id A0AAA134C6 for ; Sat, 3 Feb 2024 21:57:46 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.208.180 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706997469; cv=none; b=Z2e8uHpiusPcwZ3X1wDawsJMZvVt8lpekGRwiHtjXqSGHCVuzSz2BQYK5SfrqG/WkEgR0XAUOhTzrBt7Y7+xppC5q8VlWeh6Gf1tOde0LIrXjh/g33ZiOQ1ta2SDmWuoH2Cl9IppQ6yvKrM5aebIz/oJjBqOm6V9/2wfhW0LrBs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706997469; c=relaxed/simple; bh=SRerrLKzpZQDtjHackhk1mDgOzORiSIkR/k68ytsI6o=; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version; b=bI5IOezeKIaa4BQcgf6jpmuGa1Dxl/rmRlULNMlJlGfJ4r6MCptNxaAMWMxGtmIro1a6YwUl1wrIj/ThIqBxuCJvJtjdW+RKd1+hfYIUvyACRW83vHMOEgeD8H4bTrhVkNA4XYJt57qXyUYFpnIYOiSM8iG/PGLeIoLNYlN0ieo= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=toblux.com; spf=none smtp.mailfrom=toblux.com; dkim=pass (2048-bit key) header.d=toblux-com.20230601.gappssmtp.com header.i=@toblux-com.20230601.gappssmtp.com header.b=Mm7nqW1/; arc=none smtp.client-ip=209.85.208.180 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=toblux.com Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=toblux.com Received: by mail-lj1-f180.google.com with SMTP id 38308e7fff4ca-2d066b532f0so51284141fa.1 for ; Sat, 03 Feb 2024 13:57:46 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=toblux-com.20230601.gappssmtp.com; s=20230601; t=1706997464; x=1707602264; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=QSh3+bsIgvBbpY5uR/zlE9QAypvU9WM+2nXDWZ8TyzQ=; b=Mm7nqW1/gXemg3gVWgYWHojApGf5oR9A59pVhZ2YcocQsqpQo6rsP9reVLD5kRQNAg G8GoQTQqPyuuHnzS9kTnc/IBBG9KPIJPHc/IrYYNN4Xlwp1xJ72m6nntPhYSJBPVrvPe meWnJr8/2cLGWP83gDGdVUw+LuaEdFCE/1nTxeGm3xQ+xyMnXTqw476u1YdlUO+Z8/M8 b0GHJp0oNWRFRxq3tNObWDsjkq8XauKaG0tGPM3x+xGubVRztqz0X5MzkJ+G8F/yFJWJ SNpYKvNdYCQWhSAdQvpUmx4rpa61Ncvntt/piYCnqqP6tXCHtcaqo42qQXFO//YwMTHO cReA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1706997464; x=1707602264; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=QSh3+bsIgvBbpY5uR/zlE9QAypvU9WM+2nXDWZ8TyzQ=; b=gXhanlUhrey3I240B6ox/gBKS1BYvfUJKs86LgO0U3VGlU0uXAMau8EXU+QeF1ECC6 Xeeq02QMMqdTcOknKZ8dFy0mnAp9jDn6IVgM9AFMTaVb9L4rewICXFTQQcll4bwxKvp7 HHS6c5GmR4LtX2j/CcudClQZL8UtF3Os1ix81aZIwphgHrpN69Ch8YKmLzRpn+AjAG8r Px1fQgFBJcXAJzKzZqMCpNDdxdyYu58YxmEtfWtFpxcrNd4+PFy+L2lH2nuYNxJq4a6W S/bgBAEVG8vIhzGbJ4U4z3xDmiy5bCb9upkYI7aZQHuAFtSYqk9l4EW3/mIwooD6HAD7 9fhg== X-Gm-Message-State: AOJu0YybBF9CTSnh7Fwbvm34fucVYVtqKYj7gT3G/i3VfaK2c+Wz+U5a /BEBb2n0rNVo7agREeb6RI4Qg69Y4MFeM7xSGIZdGPitk8cJ+Z+6U856DKrfTkw= X-Received: by 2002:a2e:7e07:0:b0:2cf:2491:b49f with SMTP id z7-20020a2e7e07000000b002cf2491b49fmr7795002ljc.40.1706997464450; Sat, 03 Feb 2024 13:57:44 -0800 (PST) X-Forwarded-Encrypted: i=0; AJvYcCWbkyPvLdHrWqFoyV5EtfnvFoiGmTXpyKcYEQ3DwU9iOV7UO1is0d9lZBYLJ/BpNmj4pmhjNoAl6Wuu0+/HKIZEZ74TumK1n/3ULmgDJXizfHA25SpsKlG6cGHMZy0ksdj4foJ8SqIzgzM7usBNlbV2HQuf+sTuLId6Inu9jjc6yYc= Received: from debian.fritz.box (aftr-82-135-80-223.dynamic.mnet-online.de. [82.135.80.223]) by smtp.gmail.com with ESMTPSA id p4-20020aa7c884000000b0055f02661ae2sm2063328eds.78.2024.02.03.13.57.43 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 03 Feb 2024 13:57:44 -0800 (PST) From: Thorsten Blum To: Jonathan Corbet Cc: workflows@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Thorsten Blum Subject: [PATCH] Documentation: multiple .rst files: Fix grammar and more consistent formatting Date: Sat, 3 Feb 2024 22:53:45 +0100 Message-Id: <20240203215345.4396-1-thorsten.blum@toblux.com> X-Mailer: git-send-email 2.39.2 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1789930320535185305 X-GMAIL-MSGID: 1789930320535185305 sphinx.rst: - remove unnecessary newline - fix grammar s/check/checks - capitalize heading "The C domain" changes.rst: - remove colon after "pahole" to be consistent with other entries howto.rst: - fix grammar s/you will/will you - hyphenate "real-world problems" Signed-off-by: Thorsten Blum Reviewed-by: Randy Dunlap Reviewed-by: Bagas Sanjaya --- Documentation/doc-guide/sphinx.rst | 7 +++---- Documentation/process/changes.rst | 4 ++-- Documentation/process/howto.rst | 4 ++-- 3 files changed, 7 insertions(+), 8 deletions(-) diff --git a/Documentation/doc-guide/sphinx.rst b/Documentation/doc-guide/sphinx.rst index 3d125fb4139d..2526811489bf 100644 --- a/Documentation/doc-guide/sphinx.rst +++ b/Documentation/doc-guide/sphinx.rst @@ -63,8 +63,7 @@ Image output ------------ The kernel documentation build system contains an extension that -handles images on both GraphViz and SVG formats (see -:ref:`sphinx_kfigure`). +handles images on both GraphViz and SVG formats (see :ref:`sphinx_kfigure`). For it to work, you need to install both GraphViz and ImageMagick packages. If those packages are not installed, the build system will @@ -108,7 +107,7 @@ further info. Checking for Sphinx dependencies -------------------------------- -There's a script that automatically check for Sphinx dependencies. If it can +There's a script that automatically checks for Sphinx dependencies. If it can recognize your distribution, it will also give a hint about the install command line options for your distro:: @@ -283,7 +282,7 @@ Here are some specific guidelines for the kernel documentation: from highlighting. For a short snippet of code embedded in the text, use \`\`. -the C domain +The C domain ------------ The **Sphinx C Domain** (name c) is suited for documentation of C API. E.g. a diff --git a/Documentation/process/changes.rst b/Documentation/process/changes.rst index 50b3d1cb1115..4c1552160321 100644 --- a/Documentation/process/changes.rst +++ b/Documentation/process/changes.rst @@ -144,8 +144,8 @@ Bison Since Linux 4.16, the build system generates parsers during build. This requires bison 2.0 or later. -pahole: -------- +pahole +------ Since Linux 5.2, if CONFIG_DEBUG_INFO_BTF is selected, the build system generates BTF (BPF Type Format) from DWARF in vmlinux, a bit later from kernel diff --git a/Documentation/process/howto.rst b/Documentation/process/howto.rst index 6c73889c98fc..eebda4910a88 100644 --- a/Documentation/process/howto.rst +++ b/Documentation/process/howto.rst @@ -351,8 +351,8 @@ Managing bug reports -------------------- One of the best ways to put into practice your hacking skills is by fixing -bugs reported by other people. Not only you will help to make the kernel -more stable, but you'll also learn to fix real world problems and you will +bugs reported by other people. Not only will you help to make the kernel +more stable, but you'll also learn to fix real-world problems and you will improve your skills, and other developers will be aware of your presence. Fixing bugs is one of the best ways to get merits among other developers, because not many people like wasting time fixing other people's bugs.