2019-05-09 03:07:14

by Ruan Shiyang

[permalink] [raw]
Subject: [PATCH] Documentation: xfs: Fix typo

In "Y+P" of this line, there are two non-ASCII characters(0xd9 0x8d)
following behind the 'Y'. Shown as a small '=' under the '+' in VIM
and a '賺' in webpage[1].

I think it's a mistake and remove these strange characters.

[1]: https://www.kernel.org/doc/Documentation/filesystems/xfs-delayed-logging-design.txt

Signed-off-by: Shiyang Ruan <[email protected]>
---
Documentation/filesystems/xfs-delayed-logging-design.txt | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/filesystems/xfs-delayed-logging-design.txt b/Documentation/filesystems/xfs-delayed-logging-design.txt
index 2ce36439c09f..9a6dd289b17b 100644
--- a/Documentation/filesystems/xfs-delayed-logging-design.txt
+++ b/Documentation/filesystems/xfs-delayed-logging-design.txt
@@ -34,7 +34,7 @@ transaction:
D A+B+C+D X+n+m+o
<object written to disk>
E E Y (> X+n+m+o)
- F E+F Yٍ+p
+ F E+F Y+p

In other words, each time an object is relogged, the new transaction contains
the aggregation of all the previous changes currently held only in the log.
--
2.17.0




2019-06-07 19:02:15

by Darrick J. Wong

[permalink] [raw]
Subject: Re: [PATCH] Documentation: xfs: Fix typo

On Fri, Jun 07, 2019 at 11:44:15AM -0600, Jonathan Corbet wrote:
> On Thu, 9 May 2019 11:05:49 +0800
> Shiyang Ruan <[email protected]> wrote:
>
> > In "Y+P" of this line, there are two non-ASCII characters(0xd9 0x8d)
> > following behind the 'Y'. Shown as a small '=' under the '+' in VIM
> > and a '賺' in webpage[1].
> >
> > I think it's a mistake and remove these strange characters.
> >
> > [1]: https://www.kernel.org/doc/Documentation/filesystems/xfs-delayed-logging-design.txt
> >
> > Signed-off-by: Shiyang Ruan <[email protected]>
> > ---
> > Documentation/filesystems/xfs-delayed-logging-design.txt | 2 +-
> > 1 file changed, 1 insertion(+), 1 deletion(-)
> >
> > diff --git a/Documentation/filesystems/xfs-delayed-logging-design.txt b/Documentation/filesystems/xfs-delayed-logging-design.txt
> > index 2ce36439c09f..9a6dd289b17b 100644
> > --- a/Documentation/filesystems/xfs-delayed-logging-design.txt
> > +++ b/Documentation/filesystems/xfs-delayed-logging-design.txt
> > @@ -34,7 +34,7 @@ transaction:
> > D A+B+C+D X+n+m+o
> > <object written to disk>
> > E E Y (> X+n+m+o)
> > - F E+F Yٍ+p
> > + F E+F Y+p
>
> OK, that does look funky, applied.
>
> This patch probably should have been copied to the XFS list (added), even
> though get_maintainer.pl doesn't know that.

Yeah, it's "Y+p" not "Y<weird plusequals thing>p" in the xfs
documentation repo:

https://git.kernel.org/pub/scm/fs/xfs/xfs-documentation.git/tree/design/XFS_Filesystem_Structure/delayed_logging.asciidoc

Reviewed-by: Darrick J. Wong <[email protected]>

I doubt the value of maintaining duplicate copies of this document in
the kernel and the xfs documentation repo, and since the xfs docs and
kernel licences aren't compatible maybe we should withdraw one...

...but since Dave is the author I'm gonna punt to him. IMHO either we
should claim responsibility for those files in MAINTAINERS or drop them.
:)

Thanks for the heads-up,
--D

> Thanks,
>
> jon

2019-06-07 19:32:46

by Jonathan Corbet

[permalink] [raw]
Subject: Re: [PATCH] Documentation: xfs: Fix typo

On Thu, 9 May 2019 11:05:49 +0800
Shiyang Ruan <[email protected]> wrote:

> In "Y+P" of this line, there are two non-ASCII characters(0xd9 0x8d)
> following behind the 'Y'. Shown as a small '=' under the '+' in VIM
> and a '賺' in webpage[1].
>
> I think it's a mistake and remove these strange characters.
>
> [1]: https://www.kernel.org/doc/Documentation/filesystems/xfs-delayed-logging-design.txt
>
> Signed-off-by: Shiyang Ruan <[email protected]>
> ---
> Documentation/filesystems/xfs-delayed-logging-design.txt | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/filesystems/xfs-delayed-logging-design.txt b/Documentation/filesystems/xfs-delayed-logging-design.txt
> index 2ce36439c09f..9a6dd289b17b 100644
> --- a/Documentation/filesystems/xfs-delayed-logging-design.txt
> +++ b/Documentation/filesystems/xfs-delayed-logging-design.txt
> @@ -34,7 +34,7 @@ transaction:
> D A+B+C+D X+n+m+o
> <object written to disk>
> E E Y (> X+n+m+o)
> - F E+F Yٍ+p
> + F E+F Y+p

OK, that does look funky, applied.

This patch probably should have been copied to the XFS list (added), even
though get_maintainer.pl doesn't know that.

Thanks,

jon

2019-06-07 20:06:54

by Jonathan Corbet

[permalink] [raw]
Subject: Re: [PATCH] Documentation: xfs: Fix typo

On Fri, 7 Jun 2019 11:34:10 -0700
"Darrick J. Wong" <[email protected]> wrote:

> I doubt the value of maintaining duplicate copies of this document in
> the kernel and the xfs documentation repo, and since the xfs docs and
> kernel licences aren't compatible maybe we should withdraw one...

Um .... the in-kernel docs say nothing about an incompatible license. I
see only a GPL license at the repo you pointed to as well. Is there
something I don't know going on here? If the licenses aren't compatible
then those files shouldn't be there.

Thanks,

jon