Received: by 2002:a25:4158:0:0:0:0:0 with SMTP id o85csp6909994yba; Thu, 2 May 2019 00:08:06 -0700 (PDT) X-Google-Smtp-Source: APXvYqxiTXw8wkgxox/M1yQbGoXmRj7AtKU9kYkMG6df0KpBgUDIa+TdfSNbEBjdQ/Vxl90H+N8L X-Received: by 2002:a17:902:6f17:: with SMTP id w23mr2044417plk.29.1556780886058; Thu, 02 May 2019 00:08:06 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1556780886; cv=none; d=google.com; s=arc-20160816; b=TGgKKflWfmUt9FzBadn7M2HABNjpFKiLxKXDCoS0mQ5cXTT0WlZ2j2mDzQ9z9bwYpL jG2l8mGmc3RCMsbbI/GB4XH09HvkmQ20yPP80Bk3LtFCydKp+g6TL13v5FI1Fn1tKY8x lufo2PGvi/pG99qGQvs6OAq7tTLqCdiiHqFDV0mbqwzhl4f/zA5AZQePqcBRg29zjb2P WgUlF03wi/3mZCw25YLEX+ZLJq0jne3gdx7EJ+NGEdcWJ17dueKzYoP0nk4oiQmAXq1R nnh8md+vwhKHYTQq7shwexAQui394UxySp5C1OccfxaRQHvxaidkR3TgpQu5idVyXv6m wX3w== 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=1iojIKq0qYZauCisNrqQ2nSiIWqNq6mXDinNFGhjpZU=; b=mfjKm/ECCxk0GWDCNV/0jROvEjeQQdo86ZKGp+afcKwDdfaSO+o+zox7pEmYOKCbKg pvUqrD+M1bf9oRDViGyzkxAg0wn0M1WWAnCXCGvUpDSVH4/u2DCDejAFIUhcf0hjFaXZ 37YcqB6jjB2I4gMQceMEDQr6TKejX9rUMZH9ktP2b35LGST3KpcYQbh7drqX0Pj3aPgx ck0er4lKZgjO+bkZjUN5Z7vRXTGmtkZlbV8RcP+ODRwW6dTxGK9x2ogL6JmS8aaPG1Et Pk2LSMnFJZkMRM5Wd4QJAOkhJ3RsItLAeycIe0Oj/dgiDJZmenfkLL+ljm90SMSmC8a0 6BPg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=as3Q+Qiu; 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 o15si21082622pgb.393.2019.05.02.00.07.49; Thu, 02 May 2019 00:08: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; dkim=pass header.i=@gmail.com header.s=20161025 header.b=as3Q+Qiu; 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 S1726390AbfEBHHA (ORCPT + 99 others); Thu, 2 May 2019 03:07:00 -0400 Received: from mail-pl1-f194.google.com ([209.85.214.194]:42610 "EHLO mail-pl1-f194.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725791AbfEBHG7 (ORCPT ); Thu, 2 May 2019 03:06:59 -0400 Received: by mail-pl1-f194.google.com with SMTP id x15so596383pln.9; Thu, 02 May 2019 00:06:58 -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=1iojIKq0qYZauCisNrqQ2nSiIWqNq6mXDinNFGhjpZU=; b=as3Q+QiuQRf+4Zt8oZHvfIlDwS164zQ9oXj2NhOaaFmwB0QkUh7MvGRr3QshX5zKHq wC1fEzVZYMO5GFkuoLOYWYwJa37nuupblZMi5ygjKYu45l6ReuWylPxhPLw+FOcssc/B Vnn3O3BXfJ1G8+VVWgSvO49vZ4nEPJedeJWSvCqMq/a/6AZgb+wVjhxoUDVaN4t6SYc4 y1DNZGrB6U+nE4grD/eMpXf/EAONCZ726o62bbZKR/a0HvQrsH1NtVdxzoZ+uad4uHLd bHRVB76Kp1E+KGp/mk1PT0NRCyA+KUh4QkLY6Qo8CgkkSYxoZQR08W6DfPtnPplktk9C QBDg== 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=1iojIKq0qYZauCisNrqQ2nSiIWqNq6mXDinNFGhjpZU=; b=AUh952t1/ouFbILSbBu8BK7pY/H0qEYg+HEBqDaZ/u3kY6ivtMqkSz0BuELEdfb0Yn kAQ57SroMfVD/WkdeVpaAioOKg75G1fJFb07aNqKfz4U285KasLZk4CHPDBFZ7OtNmpz V55hnjkVd14Ll7Hruhxu9q6VQGQSCkJ3Q5LBSWSS6dm1hdj1zI78JDBCXz4PYG621+Nx Vok25Y7IrZ7TkHzvlTmqhJNCvFebay2ThqTh0i9aktJQgfduVOaFXrb3cmdtDCsFHAqm FxOXHcxVYGi3L+zclO/niYHpzdLa7bBQptB39gpyL1ejiA+nnac6iU78sTJ3q16jbWuW WLsA== X-Gm-Message-State: APjAAAXDrTw5Rz6zXK8qOhe8xY5xCD8kRqzLP7q5rCDdMzoLQYoUn8LH E4i6fbCO+tbCTFYmlOchy/o= X-Received: by 2002:a17:902:ba8e:: with SMTP id k14mr2146939pls.80.1556780818316; Thu, 02 May 2019 00:06:58 -0700 (PDT) Received: from laptop.DHCP ([104.238.181.70]) by smtp.gmail.com with ESMTPSA id u24sm4686976pfh.91.2019.05.02.00.06.53 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 02 May 2019 00:06:57 -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 v2 00/27] Include linux x86 docs into Sphinx TOC tree Date: Thu, 2 May 2019 15:06:06 +0800 Message-Id: <20190502070633.9809-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! 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} | 527 ++++++---- .../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(+), 2059 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