Received: by 2002:ac0:a5b6:0:0:0:0:0 with SMTP id m51-v6csp4159966imm; Mon, 18 Jun 2018 10:05:06 -0700 (PDT) X-Google-Smtp-Source: ADUXVKLqlQb/LlWcACvhDx6Xe8HIk76UkT1lBFIv/guEgUh7kRTV2PRZtyeGpl9DP1IR/+ghGfub X-Received: by 2002:a65:58cc:: with SMTP id e12-v6mr11835126pgu.445.1529341506107; Mon, 18 Jun 2018 10:05:06 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1529341506; cv=none; d=google.com; s=arc-20160816; b=e/KZ438+OMQ17piLm7Vsmp9nz33bSUSRC6a7XJ6ENH4ZY0GEVuJit2E/2vtg7hfonz dxTL4/XXEaXKFBGwG6jcDoKj5pkuPv5kepTz5OBHHAx360+wcNSyw/zFh/vJLAQw9g8z bCvohmQhv0ZsVj9Kqr7sZvySLCZ4NpHuYYkS1+40aZHDcQEz2To3LV8VaGPg63gnlZPK WZdySk7RrKtzLdMt1Uc6PNbRfXj5STwHnrOMpHxSiNEydQ8/P7Fj4BJKK6iNPCLHXaOG txONeEd8kpGzU1h6ZScoxlfLS4LSTXobXFDJ5+T2kt1QKIzs5CILi/a76OlhXpzVIcOJ BkHA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:message-id:date:subject:cc:to:from :arc-authentication-results; bh=05F/j4wVwmFOWy64CvwxDNU++XpozQc3th7+8Bi7yAM=; b=JbMD6swRDbFdbH4IyRC52rCDATqCJJMxi3fifoANyI0xnEkNmBtncrzfynGA5cDfHD Cy1cz/4Y6IrG/ErTooFWCIW6Y5x/mJaaq/P7J/IeaLUprH+yAeHTkTHLawoCiQfUeo84 SDdaDOFa676ARTXT/g2BnqIqg+BF19Ceje9fTV+De8FzPrzPyMXsXKjEUwxbn+YF75H+ x6kYuaOgZGA8n2wYtniQhqLnvaspmbKH1cAlsQxj5hj9aWahh0iYtswJxKD/nV2wAsNH suf29/FT/WdQ95JO7aaStUufyq1X+ctrsGe2IJLWYIZhcq0Lno/8zwkDMRA2DZ1UAVmf jZTQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id n68-v6si15009624pfb.152.2018.06.18.10.04.49; Mon, 18 Jun 2018 10:05:06 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S935166AbeFRRAK (ORCPT + 99 others); Mon, 18 Jun 2018 13:00:10 -0400 Received: from mx0a-001b2d01.pphosted.com ([148.163.156.1]:43188 "EHLO mx0a-001b2d01.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S932762AbeFRRAJ (ORCPT ); Mon, 18 Jun 2018 13:00:09 -0400 Received: from pps.filterd (m0098410.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w5IGwrmk074149 for ; Mon, 18 Jun 2018 13:00:09 -0400 Received: from e06smtp02.uk.ibm.com (e06smtp02.uk.ibm.com [195.75.94.98]) by mx0a-001b2d01.pphosted.com with ESMTP id 2jpe6qq9vd-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Mon, 18 Jun 2018 13:00:08 -0400 Received: from localhost by e06smtp02.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Mon, 18 Jun 2018 18:00:06 +0100 Received: from b06cxnps4076.portsmouth.uk.ibm.com (9.149.109.198) by e06smtp02.uk.ibm.com (192.168.101.132) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Mon, 18 Jun 2018 18:00:04 +0100 Received: from d06av23.portsmouth.uk.ibm.com (d06av23.portsmouth.uk.ibm.com [9.149.105.59]) by b06cxnps4076.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w5IH03Nk14745600 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Mon, 18 Jun 2018 17:00:03 GMT Received: from d06av23.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id A8871A4055; Mon, 18 Jun 2018 17:50:46 +0100 (BST) Received: from d06av23.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 323D9A4040; Mon, 18 Jun 2018 17:50:45 +0100 (BST) Received: from rapoport-lnx (unknown [9.148.8.74]) by d06av23.portsmouth.uk.ibm.com (Postfix) with ESMTPS; Mon, 18 Jun 2018 17:50:45 +0100 (BST) Received: by rapoport-lnx (sSMTP sendmail emulation); Mon, 18 Jun 2018 20:00:01 +0300 From: Mike Rapoport To: Jonathan Corbet Cc: Andrew Morton , linux-doc , linux-mm , lkml , Mike Rapoport Subject: [PATCH 00/11] docs/mm: add boot time memory management docs Date: Mon, 18 Jun 2018 19:59:48 +0300 X-Mailer: git-send-email 2.7.4 X-TM-AS-GCONF: 00 x-cbid: 18061817-0008-0000-0000-000002491693 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18061817-0009-0000-0000-000021AF5E8C Message-Id: <1529341199-17682-1-git-send-email-rppt@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2018-06-18_07:,, signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=3 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=870 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1805220000 definitions=main-1806180197 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hi, Both bootmem and memblock have pretty good documentation coverage. With some fixups and additions we get a nice overall description. The last commit in the series that creates the boot-time-mm.rst depends on the 'nodoc' sphix directive patch [1] I've sent earlier While working on the docs, I've noticed that both bootmem and nobootmem implement some one-line wrappers for the core allocation methods as a global functions rather than 'static inline'. I wonder whether I miss something important here is it just a historic thing? [1] https://marc.info/?l=linux-doc&m=152932901214922&w=2 Mike Rapoport (11): mm/bootmem: drop duplicated kernel-doc comments docs/mm: nobootmem: fixup kernel-doc comments docs/mm: bootmem: fix kernel-doc warnings docs/mm: bootmem: add kernel-doc description of 'struct bootmem_data' docs/mm: bootmem: add overview documentation mm/memblock: add a name for memblock flags enumeration docs/mm: memblock: update kernel-doc comments docs/mm: memblock: add kernel-doc comments for memblock_add[_node] docs/mm: memblock: add kernel-doc description for memblock types docs/mm: memblock: add overview documentation docs/mm: add description of boot time memory management Documentation/core-api/boot-time-mm.rst | 92 +++++++++++++++ Documentation/core-api/index.rst | 1 + include/linux/bootmem.h | 17 ++- include/linux/memblock.h | 76 ++++++++---- mm/bootmem.c | 159 +++++++++---------------- mm/memblock.c | 203 +++++++++++++++++++++++--------- mm/nobootmem.c | 20 +++- 7 files changed, 380 insertions(+), 188 deletions(-) create mode 100644 Documentation/core-api/boot-time-mm.rst -- 2.7.4