]> Savannah Git Hosting - gnulib.git/commitdiff
Clarify intended usage of the license file modules.
authorBruno Haible <bruno@clisp.org>
Sun, 17 May 2020 17:27:08 +0000 (19:27 +0200)
committerBruno Haible <bruno@clisp.org>
Sun, 17 May 2020 17:27:08 +0000 (19:27 +0200)
Reported by Asher Gordon <AsDaGo@posteo.net> in
<https://lists.gnu.org/archive/html/bug-gnulib/2020-05/msg00126.html>.

* 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.

ChangeLog
doc/licenses-texi.texi
modules/fdl
modules/fdl-1.3

index 65abbb55982b2b52362cd4e234e63c2cbf0285fe..9551d9934d98d9ddd58cc10e2d232c2b634f8259 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2020-05-17  Bruno Haible  <bruno@clisp.org>
+
+       Clarify intended usage of the license file modules.
+       Reported by Asher Gordon <AsDaGo@posteo.net> in
+       <https://lists.gnu.org/archive/html/bug-gnulib/2020-05/msg00126.html>.
+       * 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.
+
 2020-05-17  Akim Demaille  <akim@lrde.epita.fr>
 
        hash: add hash_xinsert
index 60110ef0969d9fd24998b28916f7ee0c921932a1..d226bc8d02abddd7b89898185fb3786993cd4456 100644 (file)
@@ -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
index 6d6f85996a765cd8c9e53312fa54e00847f4840a..251939af9b061565a3e9fb1a47d685bd65840ac2 100644 (file)
@@ -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
 
index c4d1dd6a74711eeb5decfa6c6c3b8ac1e972ef3b..760a707b155d9ef97f30907dd7effed0ead317d5 100644 (file)
@@ -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