doc/licenses-texi.texi

   1 @node License Texinfo sources
   2 @section License Texinfo sources
   3
   4 Gnulib provides copies of the GNU GPL, GNU LGPL, GNU Affero GPL, and
   5 GNU FDL licenses in Texinfo form.  (The master location is
   6 @url{https://www.gnu.org/licenses/}).  These Texinfo documents do not
   7 have any node names and structures built into them; for your manual,
   8 you should @code{@@include} them in an appropriate @code{@@node}.
   9
  10 The conventional name for the GPL node is @samp{Copying} and for the FDL
  11 @samp{GNU Free Documentation License}.  The LGPL doesn't seem to have a
  12 conventional node name.
  13
  14 Of course the license texts themselves should not be changed at all.
  15
  16 The recommended way to make use of these license files, consistently
  17 with current practice, is as follows:
  18 @itemize
  19 @item
  20 The code license (GNU GPL, GNU LGPL, or GNU Affero GPL) is usually
  21 present as a file in the top-level directory.  This is true not only for
  22 the release tarballs, but also in the VCS repository.  The file is
  23 typically named @samp{COPYING} for the GNU GPL, or @samp{COPYING.LIB} or
  24 @samp{COPYING.LESSER} for the GNU LGPL@.  The presence of this file
  25 fulfills a legal obligation; see
  26 @url{https://www.gnu.org/licenses/gpl-faq.html#WhyMustIInclude}.
  27
  28 To make use of the code license in your documentation, you may request
  29 one of the modules @code{gpl-3.0}, @code{gpl-2.0}, @code{lgpl-3.0},
  30 @code{lgpl-2.1}, @code{agpl-3.0}, through a @code{gnulib-tool} invocation.
  31 Or you may copy the relevant Texinfo file directly into your VCS repository.
  32 Both approaches are equally good.  The Texinfo file changes very rarely.
  33 @item
  34 The documentation license file (GNU FDL) is usually not present as a
  35 file in the top-level directory, because that would be ambiguous: When
  36 you use the GNU FDL, you need to specify the Invariant Sections, the
  37 Front-Cover Texts, and the Back-Cover Texts.
  38
  39 To make use of this documentation license, copy the relevant Texinfo
  40 file (@code{doc/fdl-1.3.texi}) into your VCS repository.  This makes
  41 sure that anyone who receives a copy of your VCS repository has also
  42 received a copy of the documentation license.  In the documentation,
  43 also state what are the Invariant Sections, the Front-Cover Texts, and
  44 the Back-Cover Texts.
  45 @end itemize
  46
  47 We recommend to place the licenses as appendices at the end of the
  48 manual, right before any indices.  For the FDL, we suggest the following
  49 @code{@@menu} entry:
  50
  51 @smallexample
  52 * GNU Free Documentation License::  License for copying this manual
  53 @end smallexample
  54
  55 For any @code{@@detailmenu} entries, we suggest the following:
  56
  57 @smallexample
  58 Copying This Manual
  59
  60 * GNU Free Documentation License::     Copying and sharing this manual
  61 @end smallexample
  62
  63 And for actual inclusion of the FDL itself, we suggest the following:
  64
  65 @smallexample
  66 @@node GNU Free Documentation License
  67 @@appendix GNU Free Documentation License
  68
  69 @@include fdl.texi
  70 @end smallexample