Re: [PATCH 18/22] docs: trace: ring-buffer-design.txt: convert to ReST format

From: Mauro Carvalho Chehab
Date: Tue Jun 16 2020 - 03:19:34 EST


Em Mon, 15 Jun 2020 10:48:10 -0700
Joe Perches <joe@xxxxxxxxxxx> escreveu:

> On Mon, 2020-06-15 at 08:50 +0200, Mauro Carvalho Chehab wrote:
> > - Just like some media documents, this file is dual licensed
> > with GPL and GFDL. As right now the GFDL SPDX definition is
> > bogus (as it doesn't tell anything about invariant parts),
> > let's not use SPDX here. Let's use, instead, the same test
> > as we have on media.
> []
> > diff --git a/Documentation/trace/ring-buffer-design.txt b/Documentation/trace/ring-buffer-design.rst
> > []
> > +.. Or, alternatively,
> > +..
> > +.. b) Permission is granted to copy, distribute and/or modify this
> > +.. document under the terms of the GNU Free Documentation License,
> > +.. Version 1.1 or any later version published by the Free Software
> > +.. Foundation, with no Invariant Sections, no Front-Cover Texts
> > +.. and no Back-Cover Texts. A copy of the license is available at
> > +.. https://www.gnu.org/licenses/old-licenses/fdl-1.2.html
>
> Use of a version 1.1 reference with a 1.2 link.

Right. I'll fix it.

>
> Perhaps the link should be:
> https://www.gnu.org/licenses/old-licenses/fdl-1.1.html
>
> > +..
> > +.. TODO: replace it to GPL-2.0 OR GFDL-1.2-or-later WITH no-invariant-sections
>
> Is there some reason a new GFDL entry has not yet been added
> to the LICENSES directory?

Yes:

https://github.com/spdx/license-list-XML/issues/686
https://github.com/spdx/license-list-XML/issues/970

In summary, GFDL can either be a free or non-free license, depending
on having or not "invariant sections", but SPDX spec is incomplete on
that matter.

From the discussions, it *seems* that we'll end having a SPDX header
like:

GFDL-1.2-or-later-no-invariant https://github.com/spdx/license-list-XML/milestone/12


But the discussion is still open, and so far there's no such tag.
So, we'll need to keep track at the above issues, until they finally
create the new ones.

It sounds that this is expected to happen on SPDX version 3.10:

https://github.com/spdx/license-list-XML/milestone/12

Btw, thanks for asking. I just added some comments there, in order
to indicate what it is needed for the Linux Kernel.

Thanks,
Mauro