lists.openwall.net   lists  /  announce  owl-users  owl-dev  john-users  john-dev  passwdqc-users  yescrypt  popa3d-users  /  oss-security  kernel-hardening  musl  sabotage  tlsify  passwords  /  crypt-dev  xvendor  /  Bugtraq  Full-Disclosure  linux-kernel  linux-netdev  linux-ext4  linux-hardening  linux-cve-announce  PHC 
Open Source and information security mailing list archives
 
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [<thread-prev] [day] [month] [year] [list]
Message-ID: <1412ff8c-50ff-4e51-b1c5-a4a404aafb86@infradead.org>
Date: Sat, 26 Jul 2025 20:16:26 -0700
From: Randy Dunlap <rdunlap@...radead.org>
To: Bjorn Helgaas <helgaas@...nel.org>, Jonathan Corbet <corbet@....net>
Cc: linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org,
 Bjorn Helgaas <bhelgaas@...gle.com>
Subject: Re: [PATCH 1/2] Documentation: Fix typos



On 7/23/25 1:32 PM, Bjorn Helgaas wrote:
> From: Bjorn Helgaas <bhelgaas@...gle.com>
> 
> Fix typos.
> 
> Signed-off-by: Bjorn Helgaas <bhelgaas@...gle.com>
> ---
>  .../PCI/endpoint/pci-endpoint-cfs.rst         |  4 +--
>  Documentation/PCI/endpoint/pci-endpoint.rst   |  6 ++--
>  Documentation/RCU/lockdep.rst                 |  2 +-
>  Documentation/RCU/stallwarn.rst               |  2 +-
>  Documentation/accel/qaic/aic100.rst           |  4 +--
>  Documentation/accounting/taskstats.rst        |  2 +-
>  Documentation/admin-guide/LSM/SafeSetID.rst   |  2 +-
>  Documentation/admin-guide/RAS/main.rst        |  2 +-
>  Documentation/admin-guide/blockdev/paride.rst |  2 +-
>  .../admin-guide/device-mapper/vdo-design.rst  |  2 +-
>  Documentation/admin-guide/hw-vuln/mds.rst     |  2 +-
>  Documentation/admin-guide/kdump/kdump.rst     |  2 +-
>  .../admin-guide/kernel-parameters.txt         | 10 +++---
>  Documentation/admin-guide/laptops/sonypi.rst  |  2 +-
>  Documentation/admin-guide/media/imx.rst       |  2 +-
>  Documentation/admin-guide/media/si4713.rst    |  6 ++--
>  Documentation/admin-guide/mm/damon/usage.rst  |  2 +-
>  Documentation/admin-guide/perf/hisi-pmu.rst   |  4 +--
>  .../quickly-build-trimmed-linux.rst           |  4 +--
>  .../admin-guide/reporting-issues.rst          |  4 +--
>  .../verify-bugs-and-bisect-regressions.rst    |  2 +-
>  Documentation/arch/arm/keystone/knav-qmss.rst |  2 +-
>  Documentation/arch/x86/cpuinfo.rst            |  2 +-
>  Documentation/core-api/irq/irq-affinity.rst   |  6 ++--
>  Documentation/core-api/irq/irq-domain.rst     | 36 +++++++++----------
>  .../bindings/sound/davinci-evm-audio.txt      |  2 +-
>  Documentation/devicetree/usage-model.rst      |  2 +-
>  Documentation/driver-api/vfio.rst             |  2 +-
>  Documentation/filesystems/erofs.rst           |  2 +-
>  Documentation/filesystems/gfs2-glocks.rst     |  2 +-
>  Documentation/filesystems/hpfs.rst            |  2 +-
>  Documentation/filesystems/resctrl.rst         |  2 +-
>  .../xfs/xfs-online-fsck-design.rst            |  4 +--
>  .../firmware-guide/acpi/gpio-properties.rst   |  4 +--
>  Documentation/hwmon/f71805f.rst               |  2 +-
>  Documentation/misc-devices/apds990x.rst       |  2 +-
>  Documentation/mm/hwpoison.rst                 |  2 +-
>  Documentation/networking/can.rst              |  2 +-
>  .../ethernet/ti/am65_nuss_cpsw_switchdev.rst  |  2 +-
>  .../ethernet/ti/cpsw_switchdev.rst            |  2 +-
>  Documentation/networking/rds.rst              |  2 +-
>  Documentation/power/pci.rst                   |  4 +--
>  .../power/suspend-and-cpuhotplug.rst          |  2 +-
>  Documentation/sound/cards/emu-mixer.rst       |  2 +-
>  Documentation/trace/fprobe.rst                |  2 +-
>  Documentation/trace/ftrace-uses.rst           |  2 +-
>  Documentation/trace/ftrace.rst                | 14 ++++----
>  Documentation/trace/histogram.rst             |  2 +-
>  .../translations/zh_TW/process/5.Posting.rst  |  2 +-
>  .../userspace-api/media/rc/rc-protos.rst      | 20 +++++------
>  50 files changed, 100 insertions(+), 100 deletions(-)
> 



> diff --git a/Documentation/admin-guide/kernel-parameters.txt b/Documentation/admin-guide/kernel-parameters.txt
> index f1f2c0874da9..09f319f8e8ce 100644
> --- a/Documentation/admin-guide/kernel-parameters.txt
> +++ b/Documentation/admin-guide/kernel-parameters.txt

> @@ -7390,11 +7390,11 @@
>  			section.
>  
>  	trace_trigger=[trigger-list]
> -			[FTRACE] Add a event trigger on specific events.
> +			[FTRACE] Add an event trigger on specific events.
>  			Set a trigger on top of a specific event, with an optional
>  			filter.
>  
> -			The format is is "trace_trigger=<event>.<trigger>[ if <filter>],..."
> +			The format is "trace_trigger=<event>.<trigger>[ if <filter>],..."
>  			Where more than one trigger may be specified that are comma deliminated.

			                                                            delimited.

>  
>  			For example:

> diff --git a/Documentation/admin-guide/media/si4713.rst b/Documentation/admin-guide/media/si4713.rst
> index be8e6b49b7b4..01131c267287 100644
> --- a/Documentation/admin-guide/media/si4713.rst
> +++ b/Documentation/admin-guide/media/si4713.rst

> @@ -113,7 +113,7 @@ Here is a summary of them:
>  - acomp_attack_time - Sets the attack time for audio dynamic range control.
>  - acomp_release_time - Sets the release time for audio dynamic range control.
>  
> -* Limiter setups audio deviation limiter feature. Once a over deviation occurs,
> +* Limiter setups audio deviation limiter feature. Once an over deviation occurs,

   * Limiter sets up the audio deviation limiter feature.

>    it is possible to adjust the front-end gain of the audio input and always
>    prevent over deviation.
>  


> diff --git a/Documentation/core-api/irq/irq-domain.rst b/Documentation/core-api/irq/irq-domain.rst
> index a01c6ead1bc0..f259042b12f9 100644
> --- a/Documentation/core-api/irq/irq-domain.rst
> +++ b/Documentation/core-api/irq/irq-domain.rst

> @@ -77,14 +77,14 @@ Once a mapping has been established, it can be retrieved or used via a
>  variety of methods:
>  
>  - irq_resolve_mapping() returns a pointer to the irq_desc structure
> -  for a given domain and hwirq number, and NULL if there was no
> +  for a given domain and hwirq number, or NULL if there was no
>    mapping.
>  - irq_find_mapping() returns a Linux IRQ number for a given domain and
> -  hwirq number, and 0 if there was no mapping
> +  hwirq number, or 0 if there was no mapping
>  - generic_handle_domain_irq() handles an interrupt described by a
>    domain and a hwirq number
>  
> -Note that irq domain lookups must happen in contexts that are
> +Note that irq_domain lookups must happen in contexts that are
>  compatible with a RCU read-side critical section.

                   an RCU

>  
>  The irq_create_mapping() function must be called *at least once*

> diff --git a/Documentation/filesystems/xfs/xfs-online-fsck-design.rst b/Documentation/filesystems/xfs/xfs-online-fsck-design.rst
> index e231d127cd40..9fe994353395 100644
> --- a/Documentation/filesystems/xfs/xfs-online-fsck-design.rst
> +++ b/Documentation/filesystems/xfs/xfs-online-fsck-design.rst
> @@ -2185,7 +2185,7 @@ The chapter about :ref:`secondary metadata<secondary_metadata>` mentioned that
>  checking and repairing of secondary metadata commonly requires coordination
>  between a live metadata scan of the filesystem and writer threads that are
>  updating that metadata.
> -Keeping the scan data up to date requires requires the ability to propagate
> +Keeping the scan data up to date requires the ability to propagate

   or                    up-to-date
   as in some other patch lines in this patch.

>  metadata updates from the filesystem into the data being collected by the scan.
>  This *can* be done by appending concurrent updates into a separate log file and
>  applying them before writing the new metadata to disk, but this leads to

> diff --git a/Documentation/userspace-api/media/rc/rc-protos.rst b/Documentation/userspace-api/media/rc/rc-protos.rst
> index 2a888ff5829f..c4675a2098ad 100644
> --- a/Documentation/userspace-api/media/rc/rc-protos.rst
> +++ b/Documentation/userspace-api/media/rc/rc-protos.rst
> @@ -11,7 +11,7 @@ protocols can encode e.g. an address (which device should respond) and a
>  command: what it should do. The values for these are not always consistent
>  across different devices for a given protocol.
>  
> -Therefore out the output of the IR decoder is a scancode; a single u32
> +Therefore the output of the IR decoder is a scancode; a single u32
>  value. Using keymap tables this can be mapped to linux key codes.

                                                    Linux ?

>  
>  Other things can be encoded too. Some IR protocols encode a toggle bit; this
> @@ -182,7 +182,7 @@ jvc (RC_PROTO_JVC)
>  The jvc protocol is much like nec, without the inverted values. It is
>  described here https://www.sbprojects.net/knowledge/ir/jvc.php.
>  
> -The scancode is a 16 bits value, where the address is the lower 8 bits
> +The scancode is a 16 bit value, where the address is the lower 8 bits

or                   16-bit

>  and the command the higher 8 bits; this is reversed from IR order.
>  
>  sony-12 (RC_PROTO_SONY12)
> @@ -329,11 +329,11 @@ The scancode has a somewhat unusual encoding.
>  sanyo (RC_PROTO_SANYO)
>  ----------------------
>  
> -The sanyo protocol is like the nec protocol, but with 13 bits address
> +The sanyo protocol is like the nec protocol, but with 13 bit address
>  rather than 8 bits. Both the address and the command are followed by
>  their inverted versions, but these are not present in the scancodes.
>  
> -Bis 8 to 20 of the scancode is the 13 bits address, and the lower 8
> +Bis 8 to 20 of the scancode is the 13 bit address, and the lower 8

   Bits                        are    13-bit

>  bits are the command.
>  
>  mcir2-kbd (RC_PROTO_MCIR2_KBD)

> @@ -399,7 +399,7 @@ https://www.sbprojects.net/knowledge/ir/sharp.php. There is a very long
>  (40ms) space between the normal and inverted values, and some IR receivers
>  cannot decode this.
>  
> -There is a 5 bit address and a 8 bit command. In the scancode the address is
> +There is a 5 bit address and an 8 bit command. In the scancode the address is

              5-bit                8-bit

>  in bits 8 to 12, and the command in bits 0 to 7.
>  
>  xmp (RC_PROTO_XMP)

Thanks for the cleanup.

Reviewed-by: Randy Dunlap <rdunlap@...radead.org>

whether you make an update to this or not.

-- 
~Randy

Powered by blists - more mailing lists

Powered by Openwall GNU/*/Linux Powered by OpenVZ