From patchwork Mon Jul 1 19:05:11 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13718556 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 71704C3065A for ; Mon, 1 Jul 2024 19:05:28 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id EF1326B0096; Mon, 1 Jul 2024 15:05:23 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id E7A576B0098; Mon, 1 Jul 2024 15:05:23 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id D66566B0099; Mon, 1 Jul 2024 15:05:23 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id B3A766B0096 for ; Mon, 1 Jul 2024 15:05:23 -0400 (EDT) Received: from smtpin06.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay10.hostedemail.com (Postfix) with ESMTP id 53B27C1D8C for ; Mon, 1 Jul 2024 19:05:23 +0000 (UTC) X-FDA: 82292112126.06.7660DF8 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf30.hostedemail.com (Postfix) with ESMTP id 7EE0A80019 for ; Mon, 1 Jul 2024 19:05:21 +0000 (UTC) Authentication-Results: imf30.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=O06d+nZY; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf30.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1719860703; a=rsa-sha256; cv=none; b=ob1gFnzVFRer2uiaP+RCefe7swekucKZLZPKX9cAdD7pkeEkQKIWzoUVWVgCBVx/B1kt+Y lYyMk+JgNL1341CDq2C9D6HXz+9mqfGwPKugX4UjAkxCTI1AwveRlONOdMb/+lAUyn1s02 FAXzYkdadddw9NlCjK47wJTU2X0qW0Q= ARC-Authentication-Results: i=1; imf30.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=O06d+nZY; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf30.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1719860703; 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=VFvoGWQKVTXdOlytX3TeHkmv1M2dYteJyQc63wW8+K8=; b=LAB05IEJHNCBfC3HakEKDbCSnDKcZd28Gmeu+4nrrZnan8fT9fyPXoOG240SZK9peHWEOK piOYzli5P2MmYeG80NhSgZoHaFDMIM7irAGAm4OCGSxc76lzYklgpF7luuPUd1UEQOTphO B+wwja9Iw4mGXRQ5N/ntFwToT1ovynA= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id A64E861767; Mon, 1 Jul 2024 19:05:20 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 05BB2C32781; Mon, 1 Jul 2024 19:05:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1719860720; bh=bTyMdjkq+AKoAxGCqmfrGvEJ/bhfbC9NVbA58uF3Mcg=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=O06d+nZYXSie+R7axuFItnJh1jChfKyEno2jo+BIVJ3vTt+DaCGh7iPBH3zmoHkRt o1scDSLXwcPP/2dXowFKicO1b1hpfwCXXPFQpjAsB4st1Va8D34ENoDjZ0pTosmdSd 4XT+NVgmYalVbax2MDnhyFaBtMrIoE0B9JcPp3I7jxptITyF1lC7BqRE5lawmCxtgi yl2Oy2W2+6cpB0aNadUMsfo78oijYGjbMe4CjiV2RfGyytPpqSRb5zIFoO7ggv3apE badyGrmnS28QV9Wrx07VGX4smRa+a77goPG3KmMdG+JxhCyqNazlJk1BaBRAZhKvQi juEastP2T4mNQ== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 3/4] Docs/mm/index: rename 'Legacy Documentation' to 'Unsorted Documentation' Date: Mon, 1 Jul 2024 12:05:11 -0700 Message-Id: <20240701190512.49379-4-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240701190512.49379-1-sj@kernel.org> References: <20240701190512.49379-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Server: rspam12 X-Rspamd-Queue-Id: 7EE0A80019 X-Stat-Signature: tm5keez3shtjfda846py71ofqr4b76bk X-Rspam-User: X-HE-Tag: 1719860721-137409 X-HE-Meta: U2FsdGVkX18fCljRy7B03wsIdsjWVJdMMt6S4ICQa2k3I9qCnQepjgzP0QspiT49Fl36vGoROkgs3KKPIOJ12XqYE+J8+aGRftkUSz+XS4+manSffT8LzENh3PUy9wgBo0nS1Ixny93rSHQxi24SC6nyEyvQGxJdK2Rnby9jTaONHq14I3w5x8VU5hcFabE+oNpeyZLy3aWvWayAjz8Xn5NJ3X/8D/RuMPfP0Z/emjngXyM4qc7LoT6uz9wW5LG5ZwLKgnRkSQzn5R6FTl+wMLfxWOl2UDv7ZZZ9UidRi5nx1DHx2hkgXcEuSMbrRrHQJW8NBL5NQP1RDuB/lQVW9BMr51F5B/ApsNayqJF1rmrn7llqk5vGVcn/61F7+WcdA9uBZHDD1r4oKXSOEYy/EqnpTY0nFevwPPAy56723otx7Qqp4iDWCG2ghoHPrfNvsngZhcBtF9Pm9no2y4PH+kipIZl2e04s1bnZpjj8Zro0NODgEkKavz/Wia1DedGEb6qt9F3XgyT/eVb4R9DF0vqMxQlbgX0YKZOIp+/rCyLwvyKQzwiL9pGdVDofIDTTmjc6gT4ovB+XH5VS2UM69NoM2ZnRkCWY04L15eDbW/Hr12n4Zs9G3r16wpNcE45s1GGzJ8EULf5Z05EBHT6A0YsvaMiHXrY7y4DCpyW2C9J2zk5UAJh7vhMr3bLLLXA44T30Xbke3pU9JG2JfwaDIDp2xk+pE7m/MYTuf/BzkFwPz9pcETZ4RtbFUIL4WmEx/NZrZxi30wYQHfT6blmyVP9dpMWNfj4Yde75wsXrMgrMkXn8rlrCszoQsoGc/T0eb3g5LeJpYXzf7mXXN+n7VEYeuuH1gofi2IteyEqVmP7eIWjubFNOlYHzKJyxCO8dT/OPscWKJwzRYU6t7mBQIhJiJpKLXSzZ2MyXkEmTna8JlqSdDZyvA/fDOOPh96500tXT6KBS4XKTvQCjL57 b08fBd1b 1IAXK2Uq75bae0KcY/5fAEovGIZcBe1jSraMgx/frIu07DHNBMxqONp/NlRNWB8WiyjXViVjFr5rIDJw8cMPIgKQDqyJBDoTNYPYjUNXlpB0L2cZLonsR/+LduTajXEwnEIS38HAyvw+wJtM1ddyETxuqMDa3a4dIxpdCQjI2APfRTrNihIb/gZ8EFTsTndi2ORHBGhRjzMFQdGtOJIK5XV+D/pjgDhJX05fxMBIPfewsTY4= 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: List-Subscribe: List-Unsubscribe: The intention of 'Legacy Documentation' chapter is to keep the old documents that not yet sorted into the new outline, and encourage new documents to be integrated in the new outline from the beginning. However, the new outline will take some more time to be completed. It has started about two years ago, and still many parts are not yet written. Also, there is no clear guidline for placing each document for all cases, for not only the 'legacy' documents, but also for new documents. For example, memory allocation profiling document has been added to the bottom of the new outline. Apparently it was not following some well-defined guideliens or a result of a discussion. Furthermore, the title ("legacy") makes people feel the documents on the chapter might be outdated or not actively maintained. Rename 'Legacy Documentation' to 'Unsorted Documentation' and remove the description saying it is for 'older' documents. After this change, new documents that not clear enough where it should be placed on the new outline can be added on the chapter while well-defined guidelines or discussion for the new outline is made. Signed-off-by: SeongJae Park --- Documentation/mm/index.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/Documentation/mm/index.rst b/Documentation/mm/index.rst index 5007815405f1..15614df2b989 100644 --- a/Documentation/mm/index.rst +++ b/Documentation/mm/index.rst @@ -25,14 +25,14 @@ see the :doc:`admin guide <../admin-guide/mm/index>`. oom allocation-profiling -Legacy Documentation -==================== +Unsorted Documentation +====================== -This is a collection of older documents about the Linux memory management -(MM) subsystem internals with different level of details ranging from -notes and mailing list responses for elaborating descriptions of data -structures and algorithms. It should all be integrated nicely into the -above structured documentation, or deleted if it has served its purpose. +This is a collection of unsorted documents about the Linux memory management +(MM) subsystem internals with different level of details ranging from notes and +mailing list responses for elaborating descriptions of data structures and +algorithms. It should all be integrated nicely into the above structured +documentation, or deleted if it has served its purpose. .. toctree:: :maxdepth: 1