Update Documentation/ cross-references

typo:

	page_frag.rst -> page_frags.rst

Fixes f51debc256f8 ("docs/zh_CN: add vm page_frags translation")

Signed-off-by Mauro Carvalho Chehab <[email protected]>

---

To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH v2 00/20] at: https://lore.kernel.org/all/[email protected]/

  Documentation/translations/zh_CN/vm/page_frags.rst | 2 +-
  1 file changed, 1 insertion(+), 1 deletion(-)

Documentation/translations/zh_CN/vm/page_frags.rst +1 -1

index ad27fed33634..38ecddb9e1c0 100644
@@ -1,4 +1,4 @@
-:Original: Documentation/vm/page_frag.rst
+:Original: Documentation/vm/page_frags.rst
 
  :翻译:
 

As the original doc was removed, it doesn't make sense to keep its translation.

Fixes 23b1f18326ec ("Documentation: riscv: Remove the old documentation")

Signed-off-by Mauro Carvalho Chehab <[email protected]>

---

To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH v2 00/20] at: https://lore.kernel.org/all/[email protected]/

  .../translations/zh_CN/riscv/index.rst        |   1 -
  .../translations/zh_CN/riscv/pmu.rst          | 235 ------------------

  2 files changed, 236 deletions(-)

delete mode 100644 Documentation/translations/zh_CN/riscv/pmu.rst

Documentation/translations/zh_CN/riscv/index.rst +0 -1

index 614cde0c0997..131e405aa857 100644
@@ -19,7 +19,6 @@ RISC-V 体系结构
 
      boot-image-header
      vm-layout
-    pmu
      patch-acceptance
 
 

Documentation/translations/zh_CN/riscv/pmu.rst deleted +0 -225

deleted file mode 100644
index 7ec801026c4d..000000000000
@@ -1,235 +0,0 @@
-.. include:: ../disclaimer-zh_CN.rst
-
-:Original: Documentation/riscv/pmu.rst
-
-:翻译:
-
- 司延腾 Yanteng Si <[email protected]>
-
-.. _cn_riscv_pmu:
-
-========================
-RISC-V平台上对PMUs的支持
-========================
-
-Alan Kao <[email protected]>, Mar 2018
-
-简介
-------------
-
-截止本文撰写时，在The RISC-V ISA Privileged Version 1.10中提到的 perf_event
-相关特性如下:
-（详情请查阅手册）
-
-* [m|s]counteren
-* mcycle[h], cycle[h]
-* minstret[h], instret[h]
-* mhpeventx, mhpcounterx[h]
-
-仅有以上这些功能，移植perf需要做很多工作，究其原因是缺少以下通用架构的性能
-监测特性:
-
-* 启用/停用计数器
-  在我们这里，计数器一直在自由运行。
-* 计数器溢出引起的中断
-  规范中没有这种功能。
-* 中断指示器
-  不可能所有的计数器都有很多的中断端口，所以需要一个中断指示器让软件来判断
-  哪个计数器刚好溢出。
-* 写入计数器
-  由于内核不能修改计数器，所以会有一个SBI来支持这个功能[1]。 另外，一些厂商
-  考虑实现M-S-U型号机器的硬件扩展来直接写入计数器。
-
-这篇文档旨在为开发者提供一个在内核中支持PMU的简要指南。下面的章节简要解释了
-perf' 机制和待办事项。
-
-你可以在这里查看以前的讨论[1][2]。 另外，查看附录中的相关内核结构体可能会有
-帮助。
-
-
-1. 初始化
----------
-
-*riscv_pmu* 是一个类型为 *struct riscv_pmu* 的全局指针，它包含了根据perf内部
-约定的各种方法和PMU-specific参数。人们应该声明这样的实例来代表PMU。 默认情况
-下， *riscv_pmu* 指向一个常量结构体 *riscv_base_pmu* ，它对基准QEMU模型有非常
-基础的支持。
-
-
-然后他/她可以将实例的指针分配给 *riscv_pmu* ，这样就可以利用已经实现的最小逻
-辑，或者创建他/她自己的 *riscv_init_platform_pmu* 实现。
-
-换句话说，现有的 *riscv_base_pmu* 源只是提供了一个参考实现。 开发者可以灵活地
-决定多少部分可用，在最极端的情况下，他们可以根据自己的需要定制每一个函数。
-
-
-2. Event Initialization
------------------------
-
-当用户启动perf命令来监控一些事件时，首先会被用户空间的perf工具解释为多个
-*perf_event_open* 系统调用，然后进一步调用上一步分配的 *event_init* 成员函数
-的主体。 在 *riscv_base_pmu* 的情况下，就是 *riscv_event_init* 。
-
-该功能的主要目的是将用户提供的事件翻译成映射图，从而可以直接对HW-related的控
-制寄存器或计数器进行操作。该翻译基于 *riscv_pmu* 中提供的映射和方法。
-
-注意，有些功能也可以在这个阶段完成:
-
-(1) 中断设置，这个在下一节说；
-(2) 特限级设置(仅用户空间、仅内核空间、两者都有)；
-(3) 析构函数设置。 通常应用 *riscv_destroy_event* 即可；
-(4) 对非采样事件的调整，这将被函数应用，如 *perf_adjust_period* ，通常如下::
-
-      if (!is_sampling_event(event)) {
-              hwc->sample_period = x86_pmu.max_period;
-              hwc->last_period = hwc->sample_period;
-              local64_set(&hwc->period_left, hwc->sample_period);
-      }
-
-
-在 *riscv_base_pmu* 的情况下，目前只提供了（3）。
-
-
-3. 中断
--------
-
-3.1. 中断初始化
-
-这种情况经常出现在 *event_init* 方案的开头。通常情况下，这应该是一个代码段，如::
-
-  int x86_reserve_hardware(void)
-  {
-        int err = 0;
-
-        if (!atomic_inc_not_zero(&pmc_refcount)) {
-                mutex_lock(&pmc_reserve_mutex);
-                if (atomic_read(&pmc_refcount) == 0) {
-                        if (!reserve_pmc_hardware())
-                                err = -EBUSY;
-                        else
-                                reserve_ds_buffers();
-                }
-                if (!err)
-                        atomic_inc(&pmc_refcount);
-                mutex_unlock(&pmc_reserve_mutex);
-        }
-
-        return err;
-  }
-
-而神奇的是 *reserve_pmc_hardware* ，它通常做原子操作，使实现的IRQ可以从某个全局函
-数指针访问。 而 *release_pmc_hardware* 的作用正好相反，它用在上一节提到的事件分配
-器中。
-
- (注：从所有架构的实现来看，*reserve/release* 对总是IRQ设置，所以 *pmc_hardware*
- 似乎有些误导。 它并不处理事件和物理计数器之间的绑定，这一点将在下一节介绍。)
-
-3.2. IRQ结构体
-
-基本上，一个IRQ运行以下伪代码::
-
-  for each hardware counter that triggered this overflow
-
-      get the event of this counter
-
-      // following two steps are defined as *read()*,
-      // check the section Reading/Writing Counters for details.
-      count the delta value since previous interrupt
-      update the event->count (# event occurs) by adding delta, and
-                 event->hw.period_left by subtracting delta
-
-      if the event overflows
-          sample data
-          set the counter appropriately for the next overflow
-
-          if the event overflows again
-              too frequently, throttle this event
-          fi
-      fi
-
-  end for
-
- 然而截至目前，没有一个RISC-V的实现为perf设计了中断，所以具体的实现要在未来完成。
-
-4. Reading/Writing 计数
------------------------
-
-它们看似差不多，但perf对待它们的态度却截然不同。 对于读，在 *struct pmu* 中有一个
-*read* 接口，但它的作用不仅仅是读。 根据上下文，*read* 函数不仅要读取计数器的内容
-（event->count），还要更新左周期到下一个中断（event->hw.period_left）。
-
- 但 perf 的核心不需要直接写计数器。 写计数器隐藏在以下两点的抽象化之后，
- 1） *pmu->start* ，从字面上看就是开始计数，所以必须把计数器设置成一个合适的值，以
- 便下一次中断；
- 2）在IRQ里面，应该把计数器设置成同样的合理值。
-
-在RISC-V中，读操作不是问题，但写操作就需要费些力气了，因为S模式不允许写计数器。
-
-
-5. add()/del()/start()/stop()
------------------------------
-
-基本思想: add()/del() 向PMU添加/删除事件，start()/stop() 启动/停止PMU中某个事件
-的计数器。 所有这些函数都使用相同的参数: *struct perf_event *event* 和 *int flag* 。
-
-把 perf 看作一个状态机，那么你会发现这些函数作为这些状态之间的状态转换过程。
-定义了三种状态（event->hw.state）:
-
-* PERF_HES_STOPPED:	计数停止
-* PERF_HES_UPTODATE:	event->count是最新的
-* PERF_HES_ARCH:	依赖于体系结构的用法，。。。我们现在并不需要它。
-
-这些状态转换的正常流程如下:
-
-* 用户启动一个 perf 事件，导致调用 *event_init* 。
-* 当被上下文切换进来的时候，*add* 会被 perf core 调用，并带有一个标志 PERF_EF_START，
-  也就是说事件被添加后应该被启动。 在这个阶段，如果有的话，一般事件会被绑定到一个物
-  理计数器上。当状态变为PERF_HES_STOPPED和PERF_HES_UPTODATE，因为现在已经停止了,
-  （软件）事件计数不需要更新。
-
-  - 然后调用 *start* ，并启用计数器。
-    通过PERF_EF_RELOAD标志，它向计数器写入一个适当的值（详细情况请参考上一节）。
-    如果标志不包含PERF_EF_RELOAD，则不会写入任何内容。
-    现在状态被重置为none，因为它既没有停止也没有更新（计数已经开始）。
-
-*当被上下文切换出来时被调用。 然后，它检查出PMU中的所有事件，并调用 *stop* 来更新它们
- 的计数。
-
-  - *stop* 被 *del* 和perf核心调用，标志为PERF_EF_UPDATE，它经常以相同的逻辑和 *read*
-    共用同一个子程序。
-    状态又一次变为PERF_HES_STOPPED和PERF_HES_UPTODATE。
-
-  - 这两对程序的生命周期: *add* 和 *del* 在任务切换时被反复调用；*start* 和 *stop* 在
-    perf核心需要快速停止和启动时也会被调用，比如在调整中断周期时。
-
-目前的实现已经足够了，将来可以很容易地扩展到功能。
-
-A. 相关结构体
--------------
-
-* struct pmu: include/linux/perf_event.h
-* struct riscv_pmu: arch/riscv/include/asm/perf_event.h
-
-  两个结构体都被设计为只读。
-
-  *struct pmu* 定义了一些函数指针接口，它们大多以 *struct perf_event* 作为主参数，根据
-  perf的内部状态机处理perf事件（详情请查看kernel/events/core.c）。
-
-  *struct riscv_pmu* 定义了PMU的具体参数。 命名遵循所有其它架构的惯例。
-
-* struct perf_event: include/linux/perf_event.h
-* struct hw_perf_event
-
-  表示 perf 事件的通用结构体，以及硬件相关的细节。
-
-* struct riscv_hw_events: arch/riscv/include/asm/perf_event.h

The devicetree directory was using wrong case:

	Devicetree/ -> devicetree/

Fixes a17b0169f29b ("docs/zh_CN: add devicetree index translation")

Fixes c56481299df3 ("docs/zh_CN: add devicetree usage-model translation")

Fixes 09d4466d3f3c ("docs/zh_CN: add devicetree of_unittest translation")

Signed-off-by Mauro Carvalho Chehab <[email protected]>

---

To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH v2 00/20] at: https://lore.kernel.org/all/[email protected]/

  Documentation/translations/zh_CN/devicetree/index.rst       | 2 +-
  Documentation/translations/zh_CN/devicetree/of_unittest.rst | 2 +-
  Documentation/translations/zh_CN/devicetree/usage-model.rst | 2 +-
  3 files changed, 3 insertions(+), 3 deletions(-)

Documentation/translations/zh_CN/devicetree/index.rst +1 -1

index 23d0b6fccd58..3fc355fe0037 100644
@@ -1,7 +1,7 @@
  .. SPDX-License-Identifier: GPL-2.0
  .. include:: ../disclaimer-zh_CN.rst
 
-:Original: Documentation/Devicetree/index.rst
+:Original: Documentation/devicetree/index.rst
 
  :翻译:
 

Documentation/translations/zh_CN/devicetree/of_unittest.rst +1 -1

index abd94e771ef8..11eb08ca8866 100644
@@ -1,7 +1,7 @@
  .. SPDX-License-Identifier: GPL-2.0
  .. include:: ../disclaimer-zh_CN.rst
 
-:Original: Documentation/Devicetree/of_unittest.rst
+:Original: Documentation/devicetree/of_unittest.rst
 
  :翻译:
 

Documentation/translations/zh_CN/devicetree/usage-model.rst +1 -1

index accdc33475a0..c6aee82c7e6e 100644
@@ -1,7 +1,7 @@
  .. SPDX-License-Identifier: GPL-2.0
  .. include:: ../disclaimer-zh_CN.rst
 
-:Original: Documentation/Devicetree/usage-model.rst
+:Original: Documentation/devicetree/usage-model.rst
 
  :翻译:
 

The location of the rust doc is wrong (probably a typo). Fix it.

typo:

	_free_page_reporting.rst -> free_page_reporting.rst

Fixes 9859b277bffe ("docs/zh_CN: add vm frontswap translation")

Fixes adeacecbd36c ("docs/zh_CN: add free_page_reporting translation")

Signed-off-by Mauro Carvalho Chehab <[email protected]>

---

To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH v2 00/20] at: https://lore.kernel.org/all/[email protected]/

  Documentation/translations/zh_CN/vm/free_page_reporting.rst | 2 +-
  Documentation/translations/zh_CN/vm/frontswap.rst           | 2 +-
  2 files changed, 2 insertions(+), 2 deletions(-)

Documentation/translations/zh_CN/vm/free_page_reporting.rst +1 -1

index 31d6c34b956b..14336a3aa5f4 100644
@@ -1,6 +1,6 @@
  .. include:: ../disclaimer-zh_CN.rst
 
-:Original: Documentation/vm/_free_page_reporting.rst
+:Original: Documentation/vm/free_page_reporting.rst
 
  :翻译:
 

Documentation/translations/zh_CN/vm/frontswap.rst +1 -1

index 3eb07870e2ef..98aa6f581ea7 100644
@@ -1,4 +1,4 @@
-:Original: Documentation/vm/_free_page_reporting.rst
+:Original: Documentation/vm/free_page_reporting.rst
 
  :翻译:
 

typo:

	zs_malloc.rst -> zsmalloc.rst

Fixes 6dbc3a5bdb46 ("docs/zh_CN: add vm zsmalloc translation")

Signed-off-by Mauro Carvalho Chehab <[email protected]>

---

To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH v2 00/20] at: https://lore.kernel.org/all/[email protected]/

  Documentation/translations/zh_CN/vm/zsmalloc.rst | 2 +-
  1 file changed, 1 insertion(+), 1 deletion(-)

Documentation/translations/zh_CN/vm/zsmalloc.rst +1 -1

index 29e9c70a8eb6..45a9b7ab2a51 100644
@@ -1,4 +1,4 @@
-:Original: Documentation/vm/zs_malloc.rst
+:Original: Documentation/vm/zsmalloc.rst
 
  :翻译:
 

The reference is missing a .rst on it, causing its cross-reference to not work.

Fixes 9c3519d2b509 ("docs/zh_CN: add vm/index translation")

Signed-off-by Mauro Carvalho Chehab <[email protected]>

---

To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH v2 00/20] at: https://lore.kernel.org/all/[email protected]/

  Documentation/translations/zh_CN/vm/index.rst | 2 +-
  1 file changed, 1 insertion(+), 1 deletion(-)

Documentation/translations/zh_CN/vm/index.rst +0 -0

index a1c6d529b6ff..81a9b782a427 100644

Documentation/translations/zh_CN/vm/index.rst +0 -0

  TODO:待引用文档集被翻译完毕后请及时修改此处）
 
  .. toctree::

Changeset f5461124d59b ("Documentation: move watch_queue to core-api")
renamed: Documentation/watch_queue.rst
to: Documentation/core-api/watch_queue.rst.

Update the cross-references accordingly.

Fixes f5461124d59b ("Documentation: move watch_queue to core-api")

Reviewed-by Randy Dunlap <[email protected]>

Signed-off-by Mauro Carvalho Chehab <[email protected]>

---

To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH v2 00/20] at: https://lore.kernel.org/all/[email protected]/

 Documentation/security/keys/core.rst | 2 +-
 include/linux/watch_queue.h          | 2 +-
 init/Kconfig                         | 2 +-
 kernel/watch_queue.c                 | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

Since IDE support was deleted by Christoph Hellwig <[email protected]>, Jun 16 2021, drop the left-over from README file, updating the documentation to point to ata/pata_falcon.c.

Fixes 44b1fbc0f5f3 ("m68k/q40: Replace q40ide driver with pata_falcon and falconide")

Fixes b7fb14d3ac63 ("ide: remove the legacy ide driver")

Signed-off-by Mauro Carvalho Chehab <[email protected]>

The binding directory for hte was renamed. Update references accordingly.

Fixes af583852d2ef ("dt-bindings: Renamed hte directory to timestamp")

Signed-off-by Mauro Carvalho Chehab <[email protected]>

---

To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH v2 00/20] at: https://lore.kernel.org/all/[email protected]/

 Documentation/driver-api/hte/tegra194-hte.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

Documentation/driver-api/hte/tegra194-hte.rst +0 -0

index 41983e04d2a0..d29b7fe86f31 100644

Quoted 18 lines · Mauro Carvalho Chehab

The binding directory for hte was renamed. Update references accordingly.

Fixes af583852d2ef ("dt-bindings: Renamed hte directory to timestamp")

Signed-off-by Mauro Carvalho Chehab <[email protected]>

---

To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH v2 00/20] at: https://lore.kernel.org/all/[email protected]/

 Documentation/driver-api/hte/tegra194-hte.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

Documentation/driver-api/hte/tegra194-hte.rst +0 -0

index 41983e04d2a0..d29b7fe86f31 100644
@@ -37,7 +37,7 @@ LIC (Legacy Interrupt Controller) IRQ GTE
 

Documentation/driver-api/hte/tegra194-hte.rst LIC (Legacy Interrupt Controller) IRQ GTE · line 43

Quoted 7 lines

Documentation/driver-api/hte/tegra194-hte.rst +1 -1

 This GTE instance timestamps LIC IRQ lines in real time. There are 352 IRQ
 lines which this instance can add timestamps to in real time. The hte
-devicetree binding described at ``Documentation/devicetree/bindings/hte/``
+devicetree binding described at ``Documentation/devicetree/bindings/timestamp``
 provides an example of how a consumer can request an IRQ line. Since it is a
 one-to-one mapping with IRQ GTE provider, consumers can simply specify the IRQ
 number that they are interested in. There is no userspace consumer support for

Reviewed-by Dipen Patel <[email protected]>

EXTERNAL EMAIL: Do not click links or open attachments unless you know the content is safe

Changeset 441613662db7 ("dt-bindings: mfd: Convert da9063 to yaml")
renamed: Documentation/devicetree/bindings/mfd/da9063.txt
to: Documentation/devicetree/bindings/mfd/dlg,da9063.yaml.

Update its cross-reference accordingly.

Fixes 441613662db7 ("dt-bindings: mfd: Convert da9063 to yaml")

Signed-off-by Mauro Carvalho Chehab <[email protected]>

---

To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH v2 00/20] at: https://lore.kernel.org/all/[email protected]/

  Documentation/devicetree/bindings/input/da9062-onkey.txt | 2 +-
  1 file changed, 1 insertion(+), 1 deletion(-)

Documentation/devicetree/bindings/input/da9062-onkey.txt +1 -2

index 5f9fbc68e58a..e5eef59a93dc 100644
@@ -2,7 +2,7 @@
 
  This module is part of the DA9061/DA9062/DA9063. For more details about entire
  DA9062 and DA9061 chips see Documentation/devicetree/bindings/mfd/da9062.txt
-For DA9063 see Documentation/devicetree/bindings/mfd/da9063.txt
+For DA9063 see Documentation/devicetree/bindings/mfd/dlg,da9063.yaml
 
  This module provides the KEY_POWER event.
 
--

2.36.1

Changeset 441613662db7 ("dt-bindings: mfd: Convert da9063 to yaml")
renamed: Documentation/devicetree/bindings/mfd/da9063.txt
to: Documentation/devicetree/bindings/mfd/dlg,da9063.yaml.

Update its cross-reference accordingly.

Fixes 441613662db7 ("dt-bindings: mfd: Convert da9063 to yaml")

Signed-off-by Mauro Carvalho Chehab <[email protected]>

---

To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH v2 00/20] at: https://lore.kernel.org/all/[email protected]/

 Documentation/devicetree/bindings/input/da9062-onkey.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

EXTERNAL EMAIL: Do not click links or open attachments unless you know the content is safe

The entry forgot to add "dlg," to the file pattern.

Fixes 441613662db7 ("dt-bindings: mfd: Convert da9063 to yaml")

Signed-off-by Mauro Carvalho Chehab <[email protected]>

---

To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH v2 00/20] at: https://lore.kernel.org/all/[email protected]/

  MAINTAINERS | 2 +-
  1 file changed, 1 insertion(+), 1 deletion(-)

MAINTAINERS +1 -2

index cd3f4964c14a..6acae3a340cb 100644
@@ -5886,7 +5886,7 @@ W:        http://www.dialog-semiconductor.com/products
  F:     Documentation/devicetree/bindings/input/da90??-onkey.txt
  F:     Documentation/devicetree/bindings/input/dlg,da72??.txt
  F:     Documentation/devicetree/bindings/mfd/da90*.txt
-F:     Documentation/devicetree/bindings/mfd/da90*.yaml
+F:     Documentation/devicetree/bindings/mfd/dlg,da90*.yaml
  F:     Documentation/devicetree/bindings/regulator/dlg,da9*.yaml
  F:     Documentation/devicetree/bindings/regulator/da92*.txt
  F:     Documentation/devicetree/bindings/regulator/slg51000.txt
--

2.36.1

Fix most broken documentation file cross references on next-20220624.

After this series, only 3 references will be broken: