+2021-09-04 Simon Josefsson <simon@josefsson.org>
+
+ doc: Add suggestions on FDL texinfo usage.
+ * doc/licenses-texi.texi (License Texinfo sources): Add texinfo
+ examples.
+
2021-09-03 Simon Josefsson <simon@josefsson.org>
maintainer-makefile: Add indentation syntax-check rule.
you should @code{@@include} them in an appropriate @code{@@node}.
The conventional name for the GPL node is @samp{Copying} and for the FDL
-@samp{GNU Free Documentation License}. The LGPL doesn't seem to have
-a conventional node name.
+@samp{GNU Free Documentation License}. The LGPL doesn't seem to have a
+conventional node name.
Of course the license texts themselves should not be changed at all.
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.
+file (@code{doc/fdl-1.3.texi}) 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
+
+We recommend to place the licenses as appendices at the end of the
+manual, right before any indices. For the FDL, we suggest the following
+@code{@@menu} entry:
+
+@smallexample
+* GNU Free Documentation License:: License for copying this manual
+@end smallexample
+
+For any @code{@@detailmenu} entries, we suggest the following:
+
+@smallexample
+Copying This Manual
+
+* GNU Free Documentation License:: Copying and sharing this manual
+@end smallexample
+
+And for actual inclusion of the FDL itself, we suggest the following:
+
+@smallexample
+@@node GNU Free Documentation License
+@@appendix GNU Free Documentation License
+
+@@include fdl.texi
+@end smallexample