Received: by 2002:a25:4158:0:0:0:0:0 with SMTP id o85csp5140464yba; Wed, 8 May 2019 08:29:34 -0700 (PDT) X-Google-Smtp-Source: APXvYqxvWgY+EHVcquoMvd1MKzI8N52mhRiUt/prBe4zT28qtfjuDSaqJltqyBQFog6TJ1n0vlVk X-Received: by 2002:a63:8342:: with SMTP id h63mr48469085pge.251.1557329373948; Wed, 08 May 2019 08:29:33 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1557329373; cv=none; d=google.com; s=arc-20160816; b=ilK0PYiEOVhLfnGKx3LXVmBZqAvaaizAGgLyDgIfnC5b278iy++E6DxO/j/eIaI1ra bEUKTO4JVlAnaH7J90yy6TYs8mJUdSV04fE7G6VVS90g2AkLPrKHFe3seKIexvFhyYXb z9UoyPN1OhCyzq09HWIjbYRJFMTnQeVJRKVufpSLZo+42h0qT6CH8z0JgrsSeX9u3e1P GbSLeiKwUHwcoPYf3CkdH5E6rpNb+qJy1CY6UVODiZ4a1buQPMFCVtTXKE5Ewrht6x21 D+Cqpcx3+6AS5Q/Ny/WKcleZx0KInhLHmWrvsuyh8nRRIYG/E02xxvuCkxfo4F0ZL5KH r05g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=XXdDTrkBMomscqKxaDUgTHEj/BRRiivaCmeozZnvf3Y=; b=u2PucfcD0HQaKE122PxQcCuv0JeSDOC5/jMkdYeDQoIj9h1u0pDDONy8czMvCvCeqw c9MnzrNSXexIlu0nnzBe9sF80Y+EQjieyGEyJ2Hm1RNHW+oK+e6J43C1UrSm81Qpor4c R8QFIgI2v/f0S2lRpEOGDRJuTHZ+SZ4hfCxt/0xI22cBgJfZ0ULTFK7BL840WQT3X9Z1 86G539DvdLv2EF2GxGhhEQLfP6kk/NaZMjaq4ll/zhURk1WK0Y6OxKnj5xh1BbQPvagJ ZZlHSxClX8UxaxjvOX0ECcZbWPiNA3gvn5XkEjKH+y2ozeoMvthjPjYviUs9P4dBUGCM 8btg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b="u/5xCEou"; 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=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id x32si24445030pld.16.2019.05.08.08.29.17; Wed, 08 May 2019 08:29:33 -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; dkim=pass header.i=@gmail.com header.s=20161025 header.b="u/5xCEou"; 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=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727255AbfEHPWB (ORCPT + 99 others); Wed, 8 May 2019 11:22:01 -0400 Received: from mail-pg1-f195.google.com ([209.85.215.195]:36695 "EHLO mail-pg1-f195.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726163AbfEHPWB (ORCPT ); Wed, 8 May 2019 11:22:01 -0400 Received: by mail-pg1-f195.google.com with SMTP id a3so1025926pgb.3; Wed, 08 May 2019 08:22:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=XXdDTrkBMomscqKxaDUgTHEj/BRRiivaCmeozZnvf3Y=; b=u/5xCEoumvmIQckjvd4nzXb37vVH12TTlIycHU7eW4cew8nR+hMT5TXw7GfMimfI+1 8UlR9FUOnTxggNElE6p1y5ZHm7Pgyfb8d1tgB2s2J1bohY5XW9mjZkiKkhFxrIqidgWR iy/0iiAYPl/8AqUF8KwEN86KfsyqQ9gCZ6fHJiErd8Sirz7oZsGk4jxPpfuPd4SnbTWT zygbm0yGIsQZdWz7I4rX6DGYItxIyBBd37N8ihPZqljqPlieN+i5W81LMcwLi5oHkcsO zTuIfEkIJtd1GPivmcHEUY3U8uwv+jFbXdLfc9oRL322xtYX5iwKUl/saq0Nci53g1Tb jPyQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=XXdDTrkBMomscqKxaDUgTHEj/BRRiivaCmeozZnvf3Y=; b=NLw4cAQNkXLHMuDZIXurgubTJBZRby/z3N7XF43PDZYuvRTOIoEH1R1/LOi0AaZcK+ RZSGEBu2b1zGeYWard1l9fZ6OKw59PkDHQ/tYPtp1sW9NDLT52O+xNLj3NjJ4bAXk3zz kPQ9RgjyvBjqNPp/V2tMN/iAMNCFfKriNLzIb/oq0cs0SYkCx87JJkzKrX7UxQdLW/bq rFS0d2fboiDoPGpJhpnOsOGuDs753v4V/y1eWdz3XHk1lFTkk6bDOTxA8t96kCmGYPjB MwcNMaYI5s8+DnId+P/6guZKq6IWJEGjXOKiHLTPKdGHpY93TX20ZRGYGSO/ID5ClqA6 7FjA== X-Gm-Message-State: APjAAAUbGYxtosPmq6vn56aF4kHpiAb+efF4ipWgQkO2WF0AcDgDp4kd Qk6GLCejRl90th1m3VPKYzQ= X-Received: by 2002:a63:610f:: with SMTP id v15mr47949725pgb.128.1557328920036; Wed, 08 May 2019 08:22:00 -0700 (PDT) Received: from localhost.localdomain ([104.238.181.70]) by smtp.gmail.com with ESMTPSA id o73sm7459360pfi.137.2019.05.08.08.21.54 (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256); Wed, 08 May 2019 08:21:59 -0700 (PDT) From: Changbin Du To: corbet@lwn.net, tglx@linutronix.de, mingo@redhat.com, bp@alien8.de Cc: x86@kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Changbin Du Subject: [PATCH v4 00/27] Include linux x86 docs into Sphinx TOC tree Date: Wed, 8 May 2019 23:21:14 +0800 Message-Id: <20190508152141.8740-1-changbin.du@gmail.com> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hi all, The kernel now uses Sphinx to generate intelligent and beautiful documentation from reStructuredText files. I converted all of the Linux x86 docs to rst format in this serias. For you to preview, please visit below url: http://www.bytemem.com:8080/kernel-doc/index.html Thank you! v4: fix 2 comments for boot.rst. v3: rebase to docs-next branch (one conflict). v2: resolve comments from Mauro and Borislav. Changbin Du (27): Documentation: add Linux x86 docs to Sphinx TOC tree Documentation: x86: convert boot.txt to reST Documentation: x86: convert topology.txt to reST Documentation: x86: convert exception-tables.txt to reST Documentation: x86: convert kernel-stacks to reST Documentation: x86: convert entry_64.txt to reST Documentation: x86: convert earlyprintk.txt to reST Documentation: x86: convert zero-page.txt to reST Documentation: x86: convert tlb.txt to reST Documentation: x86: convert mtrr.txt to reST Documentation: x86: convert pat.txt to reST Documentation: x86: convert protection-keys.txt to reST Documentation: x86: convert intel_mpx.txt to reST Documentation: x86: convert amd-memory-encryption.txt to reST Documentation: x86: convert pti.txt to reST Documentation: x86: convert microcode.txt to reST Documentation: x86: convert resctrl_ui.txt to reST Documentation: x86: convert orc-unwinder.txt to reST Documentation: x86: convert usb-legacy-support.txt to reST Documentation: x86: convert i386/IO-APIC.txt to reST Documentation: x86: convert x86_64/boot-options.txt to reST Documentation: x86: convert x86_64/uefi.txt to reST Documentation: x86: convert x86_64/mm.txt to reST Documentation: x86: convert x86_64/5level-paging.txt to reST Documentation: x86: convert x86_64/fake-numa-for-cpusets to reST Documentation: x86: convert x86_64/cpu-hotplug-spec to reST Documentation: x86: convert x86_64/machinecheck to reST Documentation/index.rst | 1 + ...cryption.txt => amd-memory-encryption.rst} | 13 +- Documentation/x86/{boot.txt => boot.rst} | 528 ++++++---- .../x86/{earlyprintk.txt => earlyprintk.rst} | 122 +-- .../x86/{entry_64.txt => entry_64.rst} | 12 +- ...eption-tables.txt => exception-tables.rst} | 247 ++--- .../x86/i386/{IO-APIC.txt => IO-APIC.rst} | 28 +- Documentation/x86/i386/index.rst | 10 + Documentation/x86/index.rst | 30 + .../x86/{intel_mpx.txt => intel_mpx.rst} | 120 +-- .../x86/{kernel-stacks => kernel-stacks.rst} | 20 +- .../x86/{microcode.txt => microcode.rst} | 62 +- Documentation/x86/mtrr.rst | 354 +++++++ Documentation/x86/mtrr.txt | 329 ------- .../{orc-unwinder.txt => orc-unwinder.rst} | 27 +- Documentation/x86/pat.rst | 242 +++++ Documentation/x86/pat.txt | 230 ----- ...rotection-keys.txt => protection-keys.rst} | 33 +- Documentation/x86/{pti.txt => pti.rst} | 17 +- .../x86/{resctrl_ui.txt => resctrl_ui.rst} | 916 ++++++++++-------- Documentation/x86/{tlb.txt => tlb.rst} | 30 +- .../x86/{topology.txt => topology.rst} | 92 +- ...acy-support.txt => usb-legacy-support.rst} | 40 +- .../{5level-paging.txt => 5level-paging.rst} | 16 +- Documentation/x86/x86_64/boot-options.rst | 335 +++++++ Documentation/x86/x86_64/boot-options.txt | 278 ------ ...{cpu-hotplug-spec => cpu-hotplug-spec.rst} | 5 +- ...-for-cpusets => fake-numa-for-cpusets.rst} | 25 +- Documentation/x86/x86_64/index.rst | 16 + .../x86_64/{machinecheck => machinecheck.rst} | 12 +- Documentation/x86/x86_64/mm.rst | 161 +++ Documentation/x86/x86_64/mm.txt | 153 --- .../x86/x86_64/{uefi.txt => uefi.rst} | 30 +- Documentation/x86/zero-page.rst | 45 + Documentation/x86/zero-page.txt | 40 - 35 files changed, 2559 insertions(+), 2060 deletions(-) rename Documentation/x86/{amd-memory-encryption.txt => amd-memory-encryption.rst} (94%) rename Documentation/x86/{boot.txt => boot.rst} (73%) rename Documentation/x86/{earlyprintk.txt => earlyprintk.rst} (51%) rename Documentation/x86/{entry_64.txt => entry_64.rst} (95%) rename Documentation/x86/{exception-tables.txt => exception-tables.rst} (64%) rename Documentation/x86/i386/{IO-APIC.txt => IO-APIC.rst} (93%) create mode 100644 Documentation/x86/i386/index.rst create mode 100644 Documentation/x86/index.rst rename Documentation/x86/{intel_mpx.txt => intel_mpx.rst} (75%) rename Documentation/x86/{kernel-stacks => kernel-stacks.rst} (92%) rename Documentation/x86/{microcode.txt => microcode.rst} (81%) create mode 100644 Documentation/x86/mtrr.rst delete mode 100644 Documentation/x86/mtrr.txt rename Documentation/x86/{orc-unwinder.txt => orc-unwinder.rst} (93%) create mode 100644 Documentation/x86/pat.rst delete mode 100644 Documentation/x86/pat.txt rename Documentation/x86/{protection-keys.txt => protection-keys.rst} (83%) rename Documentation/x86/{pti.txt => pti.rst} (96%) rename Documentation/x86/{resctrl_ui.txt => resctrl_ui.rst} (68%) rename Documentation/x86/{tlb.txt => tlb.rst} (81%) rename Documentation/x86/{topology.txt => topology.rst} (74%) rename Documentation/x86/{usb-legacy-support.txt => usb-legacy-support.rst} (53%) rename Documentation/x86/x86_64/{5level-paging.txt => 5level-paging.rst} (91%) create mode 100644 Documentation/x86/x86_64/boot-options.rst delete mode 100644 Documentation/x86/x86_64/boot-options.txt rename Documentation/x86/x86_64/{cpu-hotplug-spec => cpu-hotplug-spec.rst} (88%) rename Documentation/x86/x86_64/{fake-numa-for-cpusets => fake-numa-for-cpusets.rst} (85%) create mode 100644 Documentation/x86/x86_64/index.rst rename Documentation/x86/x86_64/{machinecheck => machinecheck.rst} (92%) create mode 100644 Documentation/x86/x86_64/mm.rst delete mode 100644 Documentation/x86/x86_64/mm.txt rename Documentation/x86/x86_64/{uefi.txt => uefi.rst} (79%) create mode 100644 Documentation/x86/zero-page.rst delete mode 100644 Documentation/x86/zero-page.txt -- 2.20.1