From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-Status: No, score=-3.7 required=3.0 tests=AWL,BAYES_00,DKIM_INVALID, DKIM_SIGNED,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED,SPF_HELO_NONE,SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dcvr.yhbt.net (Postfix) with ESMTPS id 901641F55B for ; Sun, 17 May 2020 17:40:04 +0000 (UTC) Received: from localhost ([::1]:35256 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jaNGd-0003OW-74 for normalperson@yhbt.net; Sun, 17 May 2020 13:40:03 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:35162) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jaNGK-0003MV-2i for bug-gnulib@gnu.org; Sun, 17 May 2020 13:39:44 -0400 Received: from mo6-p00-ob.smtp.rzone.de ([2a01:238:20a:202:5300::7]:35806) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jaNGG-0001ZJ-Rt for bug-gnulib@gnu.org; Sun, 17 May 2020 13:39:43 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; t=1589737176; s=strato-dkim-0002; d=clisp.org; h=References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From: X-RZG-CLASS-ID:X-RZG-AUTH:From:Subject:Sender; bh=KvL1rvghYKLbqcyhu8IJFYvhQdcQzAgOVMMCXs1/+Oc=; b=JsHEJSc1AK6vZ7IeVcD2QBGFfvJP2AZMCRJgLEps2oPMTaYNbWJBIUcgCs6C/eYT8v Nj0ZrOXq+CAUqC5RJIPye1WzNA4YT9FOQbqlpFDpCIMvhr1pEx6J4BmW7g0IUNupNBXP V9R+r3sg8lQrL2FEBavZShgFu0Zkld42Qb8nPM72tS0srZU4dFRi7K2XB5qkz/ejnyIU Jt0z5/tqLK0AX4ecthoKCXIHZwE/t+ytMjUExhhqDJVrF8DZtCiTgYYq4fkJMUkmM0tG +MKIZ24F2m69M4mpYNEGEnxOADqmHpbJO1ntcjOujXW3bVgz6Ydtq80UZSU2IXwawLu5 KUMg== X-RZG-AUTH: ":Ln4Re0+Ic/6oZXR1YgKryK8brlshOcZlIWs+iCP5vnk6shH+AHjwLuWOH6fzxfs=" X-RZG-CLASS-ID: mo00 Received: from bruno.haible.de by smtp.strato.de (RZmta 46.6.2 DYNA|AUTH) with ESMTPSA id j093d3w4HHdayDo (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (curve X9_62_prime256v1 with 256 ECDH bits, eq. 3072 bits RSA)) (Client did not present a certificate); Sun, 17 May 2020 19:39:36 +0200 (CEST) From: Bruno Haible To: Asher Gordon Subject: Re: Remove license modules Date: Sun, 17 May 2020 19:39:35 +0200 Message-ID: <2220768.nsYhcXKFcP@omega> User-Agent: KMail/5.1.3 (Linux/4.4.0-177-generic; KDE/5.18.0; x86_64; ; ) In-Reply-To: <87v9kv4v0i.fsf@posteo.net> References: <873685hwin.fsf@posteo.net> <3987483.8Pq7tfHfNr@omega> <87v9kv4v0i.fsf@posteo.net> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" Received-SPF: none client-ip=2a01:238:20a:202:5300::7; envelope-from=bruno@clisp.org; helo=mo6-p00-ob.smtp.rzone.de X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_PASS=-0.001, URIBL_BLOCKED=0.001 autolearn=_AUTOLEARN X-Spam_action: no action X-BeenThere: bug-gnulib@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Gnulib discussion list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: bug-gnulib@gnu.org Errors-To: bug-gnulib-bounces+normalperson=yhbt.net@gnu.org Sender: "bug-gnulib" Hi Asher, > I think the Texinfo format licenses are human readable > enough that it is sufficient to just include those. This is a hairy question. I don't know whether a judge will be convinced by the presence of a Texinfo formatted license, when no plain-text and no PDF version of the license is present - because most judges don't know how to read a Texinfo file (if they know the concept of a markup language at all). But anyway, I'll leave that question to others... I'm going to document existing practice only. I've looked how GNU emacs and GNU gettext do it; the approaches coincide. Also, a plain-text license file is often present in the top-level directory of the VCS because the hoster (Savannah, Gitlab, Github, etc.) requires or suggests it. > Well I didn't include the GFDL in plain text format in my package. I > only included it in Texinfo format, but Ineiev accepted my package > nevertheless. Oh, indeed the GFDL is being handled differently than the GPL and LGPL. Patch below. > I also fixed a minor issue where "VCS" ended with > "." rather than "@." (see (texinfo) Ending a Sentence). I won't spend time on a single instance of this very minor issue. But if you want to submit a patch that fixes all instances of this issue, I'll appreciate it. 2020-05-17 Bruno Haible Clarify intended usage of the license file modules. Reported by Asher Gordon in . * doc/licenses-texi.texi (License Texinfo sources): Mention the GNU AGPL. Explain the intended usage of the modules. * modules/fdl (Notice): Discourage use as a module. * modules/fdl-1.3 (Notice): Likewise. diff --git a/doc/licenses-texi.texi b/doc/licenses-texi.texi index 60110ef..d226bc8 100644 --- a/doc/licenses-texi.texi +++ b/doc/licenses-texi.texi @@ -1,8 +1,8 @@ @node License Texinfo sources @section License Texinfo sources -Gnulib provides copies of the GNU GPL, GNU LGPL, and GNU FDL licenses -in Texinfo form. (The master location is +Gnulib provides copies of the GNU GPL, GNU LGPL, GNU Affero GPL, and +GNU FDL licenses in Texinfo form. (The master location is @url{https://www.gnu.org/licenses/}). These Texinfo documents do not have any node names and structures built into them; for your manual, you should @code{@@include} them in an appropriate @code{@@node}. @@ -12,3 +12,33 @@ The conventional name for the GPL node is @samp{Copying} and for the FDL a conventional node name. Of course the license texts themselves should not be changed at all. + +The recommended way to make use of these license files, consistently +with current practice, is as follows: +@itemize +@item +The code license (GNU GPL, GNU LGPL, or GNU Affero GPL) is usually +present as a file in the top-level directory. This is true not only for +the release tarballs, but also in the VCS repository. The file is +typically named @samp{COPYING} for the GNU GPL, or @samp{COPYING.LIB} or +@samp{COPYING.LESSER} for the GNU LGPL. The presence of this file +fulfills a legal obligation; see +@url{https://www.gnu.org/licenses/gpl-faq.html#WhyMustIInclude}. + +To make use of the code license in your documentation, you may request +one of the modules @code{gpl-3.0}, @code{gpl-2.0}, @code{lgpl-3.0}, +@code{lgpl-2.1}, @code{agpl-3.0}, through a @code{gnulib-tool} invocation. +Or you may copy the relevant Texinfo file directly into your VCS repository. +Both approaches are equally good. The Texinfo file changes very rarely. +@item +The documentation license file (GNU FDL) is usually not present as a +file in the top-level directory, because that would be ambiguous: When +you use the GNU FDL, you need to specify the Invariant Sections, the +Front-Cover Texts, and the Back-Cover Texts. + +To make use of this documentation license, copy the relevant Texinfo +file into your VCS repository. This makes sure that anyone who receives +a copy of your VCS repository has also received a copy of the +documentation license. In the documentation, also state what are the +Invariant Sections, the Front-Cover Texts, and the Back-Cover Texts. +@end itemize diff --git a/modules/fdl b/modules/fdl index 6d6f859..251939a 100644 --- a/modules/fdl +++ b/modules/fdl @@ -1,6 +1,9 @@ Description: Provide the GNU Free Documentation License in Texinfo format. +Notice: +Don't use this module! Instead, copy the referenced license file into your version control repository. + Files: doc/fdl.texi diff --git a/modules/fdl-1.3 b/modules/fdl-1.3 index c4d1dd6..760a707 100644 --- a/modules/fdl-1.3 +++ b/modules/fdl-1.3 @@ -1,6 +1,9 @@ Description: Provide the GNU Free Documentation License version 1.3 in Texinfo format. +Notice: +Don't use this module! Instead, copy the referenced license file into your version control repository. + Files: doc/fdl-1.3.texi