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=-4.0 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,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 72BBC1FA04 for ; Sat, 16 May 2020 18:04:00 +0000 (UTC) Received: from localhost ([::1]:42472 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ja1AF-0001sG-Ah for normalperson@yhbt.net; Sat, 16 May 2020 14:03:59 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:54196) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ja1AB-0001rq-TC for bug-gnulib@gnu.org; Sat, 16 May 2020 14:03:55 -0400 Received: from mout01.posteo.de ([185.67.36.65]:54243) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ja1AA-00040w-1B for bug-gnulib@gnu.org; Sat, 16 May 2020 14:03:55 -0400 Received: from submission (posteo.de [89.146.220.130]) by mout01.posteo.de (Postfix) with ESMTPS id 7B7F6160061 for ; Sat, 16 May 2020 20:03:50 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1589652230; bh=wAhqUzMTUAHEnCx3GwTcK++mLTLFtDNsHXcpP/zImR0=; h=From:To:Cc:Subject:Date:From; b=Z+Vka4oXKJdIgGKLCYnQ+B5SyuAuszz1LmNMjjJ6VpkLgIL6qy1tfvP5kKIuCU4cv 8klbdWYnLLtPypix/sB2CQEvkjkaPt1KUEnIaAtjUclxJ6HhizzOb2Mo/cr9loeQGE zQWGQF6AYpD5YmnDWs309DCBhdtnh7fiIeMhfwoFSt1XrFNP7GqlesG3odL+XOfdC2 aTgRPIXgREQ09Ry/kXfw9e2KjzJFCkveG7OZ6KaF57sttIj/43s5DrUdr4jzojRSmZ 9ScNNefNlUaRAvzFMHw0uHgvcwxNc9hDZO++xairzDh2rHBkxGhCTNotWBsVxh1+pl PwxIyn93VPiQw== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 49PY776h1Nz9rxc; Sat, 16 May 2020 20:03:47 +0200 (CEST) From: Asher Gordon To: Bruno Haible Subject: Re: Remove license modules References: <873685hwin.fsf@posteo.net> <3987483.8Pq7tfHfNr@omega> Date: Sat, 16 May 2020 14:03:41 -0400 In-Reply-To: <3987483.8Pq7tfHfNr@omega> (Bruno Haible's message of "Sat, 16 May 2020 01:17:40 +0200") Message-ID: <87v9kv4v0i.fsf@posteo.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux) MIME-Version: 1.0 Content-Type: multipart/signed; boundary="==-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Received-SPF: pass client-ip=185.67.36.65; envelope-from=AsDaGo@posteo.net; helo=mout01.posteo.de X-detected-operating-system: by eggs.gnu.org: First seen = 2020/05/16 14:03:50 X-ACL-Warn: Detected OS = Linux 3.11 and newer X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 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_MED=-2.3, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_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" --==-=-= Content-Type: multipart/mixed; boundary="=-=-=" --=-=-= Content-Type: text/plain Hi Bruno, Bruno Haible writes: > Now it has completed, and it turned out you were confusing the license > texts in text format (which ought to be added to VCS directly) and the > license texts in Texinfo format (for which gnulib modules are > appropriate). 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. I think the Texinfo format licenses are human readable enough that it is sufficient to just include those. In fact, it seems this is what Gnulib itself does. But as Ineiev points out, the modules are valid for two of the three methods described in (gnulib) VCS Issues. So I think instead that the documentation should be updated. See the patch to update the documentation below. I added an anchor, VCS Omissions, under the VCS Issues node in gnulib-tool.texi. I think that since the relevant material is slightly far down on the page, if I link directly to VCS Issues, it could cause confusion. However, feel free to remove the anchor if you see fit. I also fixed a minor issue where "VCS" ended with "." rather than "@." (see (texinfo) Ending a Sentence). --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=0001-doc-Update-to-indicate-that-license-files-must-alway.patch Content-Transfer-Encoding: quoted-printable Content-Description: doc: Update to indicate that license files must always be included. From=20022bd24bebde0e033a37b6c43770382fed996a39 Mon Sep 17 00:00:00 2001 From: Asher Gordon Date: Sat, 16 May 2020 13:49:02 -0400 Subject: [PATCH] doc: Update to indicate that license files must always be included. * doc/gnulib-tool.texi (VCS Omissions): New anchor under the VCS Issues node. Describe the license issues here. * doc/license-texi.texi: Mention the license issues and link to VCS Omissions. =2D-- ChangeLog | 8 ++++++++ doc/gnulib-tool.texi | 15 +++++++++++---- doc/licenses-texi.texi | 4 ++++ 3 files changed, 23 insertions(+), 4 deletions(-) diff --git a/ChangeLog b/ChangeLog index 889c756eb..75a4c37a5 100644 =2D-- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2020-05-16 Asher Gordon + + doc: Update to indicate that license files must always be included. + * doc/gnulib-tool.texi (VCS Omissions): New anchor under the VCS + Issues node. Describe the license issues here. + * doc/license-texi.texi: Mention the license issues and link to + VCS Omissions. + 2020-05-16 Bruno Haible =20 findprog-lgpl: Fix link error (existing since 2008-09-02). diff --git a/doc/gnulib-tool.texi b/doc/gnulib-tool.texi index 44a393a69..ca9837240 100644 =2D-- a/doc/gnulib-tool.texi +++ b/doc/gnulib-tool.texi @@ -914,12 +914,19 @@ Gnulib also contains files generated by @command{make= } (and removed by into the VCS, but instead added to @file{.gitignore} or equivalent. =20 @item +@anchor{VCS Omissions} In projects which customarily omit from their VCS all files that are generated from other source files, none of these files and directories =2Dare added into the VCS. As described in @ref{Modified imports}, there =2Dare two ways to keep track of options and module names that are passed =2Dto @code{gnulib-tool}. The command for restoring the omitted files =2Ddepends on it: +are added into the VCS@. However, please note: licenses must always be +included in the VCS, whether in plain text format or Texinfo format. +Projects which omit all generated files from their VCS may prefer to +copy the license files directly rather than using the Gnulib modules. +Alternatively, they can include the licenses in plain text format and +use the Gnulib modules for the licenses in Texinfo format. +@xref{License Texinfo sources}. As described in @ref{Modified imports}, +there are two ways to keep track of options and module names that are +passed to @code{gnulib-tool}. The command for restoring the omitted +files depends on it: =20 @itemize @bullet @item diff --git a/doc/licenses-texi.texi b/doc/licenses-texi.texi index 60110ef09..2bcb2bed5 100644 =2D-- a/doc/licenses-texi.texi +++ b/doc/licenses-texi.texi @@ -12,3 +12,7 @@ The conventional name for the GPL node is @samp{Copying} = and for the FDL a conventional node name. =20 Of course the license texts themselves should not be changed at all. + +Please note that if you use these modules, you must still include a copy +of the license in plain text format or Texinfo format in the VCS@. +@xref{VCS Omissions} for more information. =2D-=20 2.26.2 --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Thanks, Asher =2D-=20 One meets his destiny often on the road he takes to avoid it. GPG fingerprint: 38F3 975C D173 4037 B397 8095 D4C9 C4FC 5460 8E68 --=-=-=-- --==-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHUEARYIAB0WIQQ485dc0XNAN7OXgJXUycT8VGCOaAUCXsAq/gAKCRDUycT8VGCO aPljAQC744fI2ncnng26kas4vSvbKTVTXgxEo6U/8hKcDuPkPAD9ElAD5G29jYSk PJOtPzgxpSp9PUz50yI9ensfXkHyngU= =fKhS -----END PGP SIGNATURE----- --==-=-=--