discuss@mandoc.bsd.lv
 help / color / mirror / Atom feed
From: Ingo Schwarze <schwarze@usta.de>
To: Mark Harris <mark.hsj@gmail.com>
Cc: discuss@mandoc.bsd.lv
Subject: Re: mandoc.css license
Date: Mon, 26 Nov 2018 16:29:45 +0100	[thread overview]
Message-ID: <20181126152945.GC82448@athene.usta.de> (raw)
In-Reply-To: <923c3207-224b-0345-3215-8f457d613cd1@gmail.com>

Hi Mark,

Mark Harris wrote on Sun, Nov 25, 2018 at 10:51:35PM -0800:

> It appears that it is intended that the mandoc.css file included with
> mandoc be served as a static file from any web server that is serving
> mandoc-generated html.

Correct.  Using it as-is is recommended by default, but there may
be valid reasons to modify it or write your own, in particular when
integrating mandoc output into a larger website together with other
content, manpages.debian.org being a prominent example, even if
slightly overengineered for my taste.

> If this file is BSD licensed,

Arguably, it was, according to this sentence in the LICENSE file:

  The mandoc distribution as a whole is distributed by its developers
  under the following license:

> should it have a copyright notice and copy of the BSD license at the
> top so that it can be distributed separately?

In so far as it was ISC licensed, it could already be distributed
separately, at least when distributing the ISC license together
with it.

In general, you are right, files without Copyright and license
information tend to cause confusion, so unless clearly so small
and/or non-creative that there can be no Copyright on them,
clarification is advisable and costs nothing.

> Or does it not require this because CSS is not considered to be code
> or documentation?

That doesn't matter, all creative works fall under Copyright, in
particular any text, and it is clearly a text file.

> Would it be possible to clarify the status of this file in the LICENSE
> file and/or in a comment at the beginning of mandoc.css?

Sure, done, see below.

Yours,
  Ingo


Log Message:
-----------
Place mandoc.css into the public domain.

The reason for doing this rather than using the ISC license 
is that i guess that in some contexts, a requirement to preserve
a Copyright and license header might be inconvenient, and i really
don't care at all how people use it.

What matters is that they do use it, or something similar - attempts
to use mandoc without any CSS are a constant source of grief and
bogus bug reports because HTML without CSS doesn't look very good:
the more structural and semantic and the less presentational and 
old-fashioned the HTML, the more so.

Thanks to Mark Harris <mark dot hsj at gmail dot com> for pointing out
that the permissions on this particular file were unclear.

Modified Files:
--------------
    mandoc:
        mandoc.css

Revision Data
-------------
Index: mandoc.css
===================================================================
RCS file: /home/cvs/mandoc/mandoc/mandoc.css,v
retrieving revision 1.38
retrieving revision 1.39
diff -Lmandoc.css -Lmandoc.css -u -p -r1.38 -r1.39
--- mandoc.css
+++ mandoc.css
@@ -1,6 +1,11 @@
 /* $Id$ */
 /*
  * Standard style sheet for mandoc(1) -Thtml and man.cgi(8).
+ *
+ * Written by Ingo Schwarze <schwarze@openbsd.org>.
+ * I place this file into the public domain.
+ * Permission to use, copy, modify, and distribute it for any purpose
+ * with or without fee is hereby granted, without any conditions.
  */
 
 /* Global defaults. */
--
 To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv

  reply	other threads:[~2018-11-26 15:29 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2018-11-26  6:51 Mark Harris
2018-11-26 15:29 ` Ingo Schwarze [this message]
2018-11-26 16:43   ` Mark Harris
2018-11-26 17:16     ` Ingo Schwarze
2018-11-26 17:31       ` Mark Harris

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20181126152945.GC82448@athene.usta.de \
    --to=schwarze@usta.de \
    --cc=discuss@mandoc.bsd.lv \
    --cc=mark.hsj@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).