foxygit / doom Log in
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.