linux-kernel - Re: [PATCH] Documentation: Remove repeated word in docs

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: <Z6VhD9_0qt4yRV6N@archie.me>
Date: Fri, 7 Feb 2025 08:25:35 +0700
From: Bagas Sanjaya <bagasdotme@...il.com>
To: Vincent Mailhol <mailhol.vincent@...adoo.fr>,
	Charles Han <hanchunchao@...pur.com>
Cc: linux-can@...r.kernel.org, devicetree@...r.kernel.org,
	linux-kernel@...r.kernel.org, linux-xfs@...r.kernel.org,
	linux-doc@...r.kernel.org, mkl@...gutronix.de,
	manivannan.sadhasivam@...aro.org, thomas.kopp@...rochip.com,
	robh@...nel.org, krzk+dt@...nel.org, conor+dt@...nel.org,
	cem@...nel.org, djwong@...nel.org, corbet@....net
Subject: Re: [PATCH] Documentation: Remove repeated word in docs

On Thu, Feb 06, 2025 at 07:56:36PM +0900, Vincent Mailhol wrote:
> On 06/02/2025 at 18:15, Charles Han wrote:
> > diff --git a/Documentation/filesystems/xfs/xfs-online-fsck-design.rst b/Documentation/filesystems/xfs/xfs-online-fsck-design.rst
> > index 12aa63840830..994f9e5638ee 100644
> > --- a/Documentation/filesystems/xfs/xfs-online-fsck-design.rst
> > +++ b/Documentation/filesystems/xfs/xfs-online-fsck-design.rst
> > @@ -4521,7 +4521,7 @@ Both online and offline repair can use this strategy.
> >  | For this second effort, the ondisk parent pointer format as originally   |
> >  | proposed was ``(parent_inum, parent_gen, dirent_pos) → (dirent_name)``.  |
> >  | The format was changed during development to eliminate the requirement   |
> > -| of repair tools needing to to ensure that the ``dirent_pos`` field       |
> > +| of repair tools needing to ensure that the ``dirent_pos`` field       |
> 
> This breaks the indentation of the pipe on the right.

Indeed because Sphinx spills out malformed table error:

Documentation/filesystems/xfs/xfs-online-fsck-design.rst:4479: ERROR: Malformed table.
> <snipped>...
| For this second effort, the ondisk parent pointer format as originally   |
| proposed was ``(parent_inum, parent_gen, dirent_pos) → (dirent_name)``.  |
| The format was changed during development to eliminate the requirement   |
| of repair tools needing to ensure that the ``dirent_pos`` field       |
| always matched when reconstructing a directory.                          |
|                                                                          |
| There were a few other ways to have solved that problem:                 |
> <snipped>... 

Hence I didn't see that historical sidebar in htmldocs output.

Thanks.

-- 
An old man doll... just what I always wanted! - Clara

Download attachment "signature.asc" of type "application/pgp-signature" (229 bytes)