From patchwork Thu Sep 7 02:29:21 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13376099 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 9BBE7EE14D4 for ; Thu, 7 Sep 2023 02:29:49 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 803B0280027; Wed, 6 Sep 2023 22:29:44 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 76F0D28002B; Wed, 6 Sep 2023 22:29:44 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 458EE280027; Wed, 6 Sep 2023 22:29:44 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0012.hostedemail.com [216.40.44.12]) by kanga.kvack.org (Postfix) with ESMTP id 24AD3280029 for ; Wed, 6 Sep 2023 22:29:44 -0400 (EDT) Received: from smtpin24.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id 01FBD120B14 for ; Thu, 7 Sep 2023 02:29:43 +0000 (UTC) X-FDA: 81208220688.24.A074323 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by imf27.hostedemail.com (Postfix) with ESMTP id 48A3F40003 for ; Thu, 7 Sep 2023 02:29:42 +0000 (UTC) Authentication-Results: imf27.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=VfeGOqRl; spf=pass (imf27.hostedemail.com: domain of sj@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1694053782; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=uvHisJ3wMf7FZhz1RjxYMdXBF9iWlOlTysfYQoTsdZ8=; b=YC7my0QRcAmI5vOOQrb7R06JroBSFOZZugit/gEO3tloJjNg+ILCxIgpDtHDPzMOgO5nZs 1KKQw+ezkB63+9eP7Kdz+zzwTr0wmK6pTQAxb3Fk2+rVuk3vAbwd+Q/HaVuWYXwqBVjxwS LKGG0mRBF6Z4Vu5/jfn+C/CSNt/Ez1Y= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1694053782; a=rsa-sha256; cv=none; b=LReeQsEXjoxm7MLFeXP2+OrvjFf5teAnPpPHGPCjCjpX/pYYgn9JccY++bveFT5S7mGYKx Ubb5NUq2PkYC4ra/+ZHRoaFUkdyCV9nts2bSsy/5cn3ATauzwBcbj7ex2B4KwhdQjzd/pI 7Wq8DJi+Ug9kxKCIljcEKjGpNn400t4= ARC-Authentication-Results: i=1; imf27.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=VfeGOqRl; spf=pass (imf27.hostedemail.com: domain of sj@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id 043CEB80920; Thu, 7 Sep 2023 02:29:41 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 4271BC43391; Thu, 7 Sep 2023 02:29:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1694053779; bh=DPwXZPd8fZ7k76FJchCmgeNiFjKUbh+BZTC85e+typU=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=VfeGOqRlnm1Nvu7Y2kpqlsGEtfB0Kla59hAm6h5Y/p0nAKX8Y+yr52/mK2U5nrH+2 hfS//w3W7c4ET/DXTDnly0qtrnvotoU8irI8jZt6PdrASx/nf/QCHupesbiS82wbFj KiEcIUhAXFG2uDrfO7LiMuLy2Rl8udgQmP0xafcIhBpkH7aY7lDryUSN0oIFlsieQ6 w46kYv6osQmpIdkqCMMZ7FT6hb0JL4NY4ZUNEszYWhQrH29kzmKstStqhSqFr9tdTC teVpDaZxwOf9lyI69y4dN4BLbnN/YZPQNcQueIoGSoDt4n070hfVug2XT9bl33UsZ8 IXUNAIM0JHyvA== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 03/11] Docs/admin-guide/mm/damon/usage: move debugfs intro to the bottom of the section Date: Thu, 7 Sep 2023 02:29:21 +0000 Message-Id: <20230907022929.91361-4-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230907022929.91361-1-sj@kernel.org> References: <20230907022929.91361-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Queue-Id: 48A3F40003 X-Rspam-User: X-Rspamd-Server: rspam11 X-Stat-Signature: gdwmooszx4qrqoqymucus5n7ejcweumd X-HE-Tag: 1694053782-262476 X-HE-Meta: U2FsdGVkX1/Xcx8uaBPVNz+aQBuR319Ujkr6fxjZkZz66Z8VxSUM/IHVPAOn9VziiL5nJxrnzFRYQ5N6OENu3BVqgMeHoaGCMvXHwjrLeyCEAASatBpksSHtmT4+CMJ06aBKBot08ItZCwQn9Dvk3ashcOhqYqdvuWb58Pn21uUHVjldy6yxMvvXQ0CfUJqFx3LSB3NdIKuDnNxk5dp5NlCJWrZSvvzNG2xK1xE40MOLmkgCOAK+rb5HicDsiwc40tWWY/BT6e7LFbje9JdetyRjvnqIP2L9TgIB0/1Lcw7Xq5XtQ/5eH0ZNDRYleLXRTKC15Lxy2NE/ktaxVl2CU51Bsq1nS6PkgM2xR6XdVZIZ0bhtDzfoVaD29ZJ6XxMbAPP81Bld6DLjKv1o6oTCH/7GawTrl0gBpugowZxKMBI3DauuKFxt2taRzh34wb71OzLz5tI7oTUdwcRyRJe83aF8JAW61UaP+ue+n+eaBUGuF6wStRk/zGSYGLjH/KJH4bcBq0toLF+0wxU39UpgtVyWcfLWtBAi0pQky3DBzh+t9PrVAZN1E3kAN7zwLQvzwR8vLXw4E9PWAT9+xjJ14OWyztSmH9NecZTCEcuxr1a7zdWx2ppeFmTCwUg60UxaYq57CdbejC3dd9cOMW6DZgb17b6AcU3/5/GY68LCejcZEE75Msa02+9zn4sFLHN8hpNWrrsprGC0MR/aVnHMWLGSumzCTjkPPjd3t5md9xTIqWMr+zqKYEQVKnUOn3sJ6QFByIxNfF4qTv+3s7xK4W3fFe3qjSS5QX3WI7NPg86NK/A8qghznxv+4BEsJiChy/jaPlqUupef14C8BPJpDJ4SpLrWQWd2E+lQOCE6GbOvbIXwuS4UIRosVtYhGKcWZGxdDRibkyGZSXJ6uEifJSwGgIQOsWvLVMMBv50a89azQfqFeDwiLrK2z9tsa76hTZlc2M6npRp1sakiYVC 4JkHH1Og 5cEQfacrbveMbfSqcinfYF4mt5baJfGVSZx93o20696CIwpElau+bJJvxEx2i3GyH3Dazw17p92tVo8xzQ1jhEyilDDqmD4bd0vFgV+vzSWh8sgRgFG05quUo1a4EN9Mk6goXZMKhCCewsmRD+8xQcajCkU3zSCs6s69gaG30b46G6NTJqiG9Aj95Gi+/2MvQ+ooajHSDkKCc40uR/VDnnrVeVWhsFrYAz5wxHioPnfBGKHLL3nEm5SM5jw3RuzzMlSVfkoZDcP06u4F2oeZiCDZ1FsPgWiRZF02pytd1QiFb6g6JBDKucvX7qIOpwXMUFFM0AaZfu6nb4zk7Vt0lHcNZWipfuJZVeznkUcqjchd/LD8jnrjfcKu7OrlLFdQuQ3LIOoWzVwR9algm0d7Bqg5+PnKyksnx922dVdYx0acCROTyjUk0LXuimcq7X6HE+JmI7b7it5+SAgGv7OFKx1AR0d/zRY8vyzbj X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: On the DAMON usage introduction section, the introduction of DAMON debugfs interface, which is deprecated, is above kernel API, which is actively supported. Move the DAMON debugfs intro to bottom, so that readers have less chances to read it. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index bffe9dd9b0d6..e48101c777e1 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -20,18 +20,18 @@ DAMON provides below interfaces for different users. you can write and use your personalized DAMON sysfs wrapper programs that reads/writes the sysfs files instead of you. The `DAMON user space tool `_ is one example of such programs. -- *debugfs interface. (DEPRECATED!)* - :ref:`This ` is almost identical to :ref:`sysfs interface - `. This is deprecated, so users should move to the - :ref:`sysfs interface `. If you depend on this and cannot - move, please report your usecase to damon@lists.linux.dev and - linux-mm@kvack.org. - *Kernel Space Programming Interface.* :doc:`This ` is for kernel space programmers. Using this, users can utilize every feature of DAMON most flexibly and efficiently by writing kernel space DAMON application programs for you. You can even extend DAMON for various address spaces. For detail, please refer to the interface :doc:`document `. +- *debugfs interface. (DEPRECATED!)* + :ref:`This ` is almost identical to :ref:`sysfs interface + `. This is deprecated, so users should move to the + :ref:`sysfs interface `. If you depend on this and cannot + move, please report your usecase to damon@lists.linux.dev and + linux-mm@kvack.org. .. _sysfs_interface: