commit c935bf2aa3d2ff427f5ed2be0d353bf09843769a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Sep 13 14:54:04 2024 -0500
Commit: Fabian Greffrath <fabian@greffrath.com>
CommitDate: Wed Jul 2 08:24:12 2025 +0200
man/*.template: Break paragraph after copyright
It looks better, and is more conventional, to have a paragraph break
between a list of copyright notices and license texts.
See, for example:
https://spdx.org/licenses/BSD-3-Clause.html
https://spdx.org/licenses/MIT.html
https://spdx.org/licenses/Artistic-2.0.html
Longer licenses, like the GNU GPL and Apache 2, tend to separate the
full texts of their licenses into separate files or sections of a
document, but where the copyright notices are placed, they too are
followed by a paragraph break.
See, for example, the "Standard License Header", the final sections of
both those licenses
https://spdx.org/licenses/GPL-3.0-or-later.html
https://spdx.org/licenses/Apache-2.0.html
Finally, I observe that having the copyright and license notice in the
rendered text of a man page, while sometimes seen, is not common
practice. Putting this information in *roff comments in the man(7)
source document (in *roff comments) suffices. It is installed on
systems (if sometimes in compressed form), so there is no risk of the
notices getting separated from the text to which they apply--not by mere
neglect or accident. Only deliberate action can efface the notices.
---
man/doom.template | 2 +-
man/heretic.template | 2 +-
man/hexen.template | 2 +-
man/server.template | 2 +-
man/setup.template | 2 +-
man/strife.template | 2 +-
6 files changed, 6 insertions(+), 6 deletions(-)
diff --git a/man/doom.template b/man/doom.template
index f057ee10..787ff96a 100644
--- a/man/doom.template
+++ b/man/doom.template
@@ -35,7 +35,7 @@ the LinuxDoom source code, released by Id Software.
.SH COPYRIGHT
Copyright \(co id Software Inc.
Copyright \(co 2005-2016 Simon Howard.
-.br
+.PP
This is free software. You may redistribute copies of it under the terms of
the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
diff --git a/man/heretic.template b/man/heretic.template
index 743a4187..a928fa2d 100644
--- a/man/heretic.template
+++ b/man/heretic.template
@@ -37,7 +37,7 @@ released by Raven Software.
Copyright \(co id Software Inc.
Copyright \(co Raven Software Inc.
Copyright \(co 2005-2013 Simon Howard.
-.br
+.PP
This is free software. You may redistribute copies of it under the terms of
the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
diff --git a/man/hexen.template b/man/hexen.template
index 98d08473..b0a32b0a 100644
--- a/man/hexen.template
+++ b/man/hexen.template
@@ -37,7 +37,7 @@ released by Raven Software.
Copyright \(co id Software Inc.
Copyright \(co Raven Software Inc.
Copyright \(co 2005-2013 Simon Howard.
-.br
+.PP
This is free software. You may redistribute copies of it under the terms of
the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
diff --git a/man/server.template b/man/server.template
index 87ea6731..33226154 100644
--- a/man/server.template
+++ b/man/server.template
@@ -44,7 +44,7 @@ This manual was written by Jonathan Dowland.
.SH COPYRIGHT
Copyright \(co id Software Inc.
Copyright \(co 2005-8 Simon Howard.
-.br
+.PP
This is free software. You may redistribute copies of it under the terms of
the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
diff --git a/man/setup.template b/man/setup.template
index 61059117..e28e310e 100644
--- a/man/setup.template
+++ b/man/setup.template
@@ -35,7 +35,7 @@ This manual was written by Jonathan Dowland.
.SH COPYRIGHT
Copyright \(co id Software Inc.
Copyright \(co 2005-8 Simon Howard.
-.br
+.PP
This is free software. You may redistribute copies of it under the terms of
the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
diff --git a/man/strife.template b/man/strife.template
index 952a28c9..4e329bd4 100644
--- a/man/strife.template
+++ b/man/strife.template
@@ -71,7 +71,7 @@ on the LinuxDoom source code released by Id Software.
.SH COPYRIGHT
Copyright \(co id Software Inc.
Copyright \(co 2005-2013 Simon Howard, James Haley, Samuel Villarreal.
-.br
+.PP
This is free software. You may redistribute copies of it under the terms of
the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.