On Thu, Apr 21, 2011 at 11:44:35PM +0900, Intransition wrote:
summarizing the general license picture of the software.
Interesting. So you advocate splitting copyright information and the
actual license text and naming the license file so it is recognizable
by name. I notice some doing the later with a
MIT-LICENSE file. And
really I’ve always wondered if it is really necessary to distribute the
entire license text. Would it not be good enough to just reference an
official online copy, and only include the minimum copyright notice
required? In which case, wouldn’t a clause in the README file be enough
and we can just dispose of any COPYING or LICENSE files?
Whether just referencing the license location online, et cetera, would
“better” largely depends on what generation of redistribution is going
and what license you are using, as well as the intended audience. In
general, it’s “safer” to just include the license text, especially
because most open source licenses require the license text to be
distributed with the materials in question. Obviously, if you’re the
sole copyright holder, you can distribute it with nothing but notice
recipients who redistribute must do so under the terms of the license
without actually including the license text yourself, but then – again,
for most open source licenses – the person to whom you distribute it
then has to find the license text and include it with any
redistributions. Including the license text yourself saves such
recipients the trouble.
A brief mention of copyright information is generally better than a
COPYING file as I’ve described it, but in some cases the copyright
circumstances of a given project that collects a lot of components that
may be subject to varying copyright conditions could involve enough
explanation that separating a description of that legal minefield should
be separated from the README file itself. After all, one doesn’t want
installation and usage information in the README file to get completely
drowned out by a copyright circumstances wall-o-text, generally
So, in short . . .
You should have a README file and a LICENSE file for most cases. In
cases – if copyright circumstances for the project warrant enough
explanation to have a separate file – you may want a README file, a
COPYING file, and (perhaps) a separate license text file of some sort.
In those circumstances, you may not want to call it LICENSE, so that
people will be drawn to the explanatory text in the COPYING file first,
especially since there may be need to include several different licenses
with the project.
Also, as to the former, for awhile I seriously considered having a file
(c)2011 (or whatever year it is).
That’s probably okay-ish for proprietary code, but potentially confusing
for open source projects.
file systems don’t support file type attributes. But clearly that’s not
something that will be changing anytime soon, so I’ve come to accept
the extensions b/c they are useful to document renderers such as
GitHub. As for the letter case, I felt the same way about not standing
out and not a common practice. More recently however I started to think
the standing out was rather relative. When every file is all caps none
of them standout either. So now I am thinking the titlecase filenames
are a bit easier on the eyes.
Look – if you want to call your license file LICENSE.txt, go for it.
That’s close enough for government work, and fits in with the
README.markdown idea, where you specify the file’s purpose with LICENSE
and its content format with the .txt extension. This can be handy as a
cue to the reader as well as to any parsing scripts. My biggest
complaint about License.txt as a departure from the way it’s generally
done is not the file extension; it’s the fact it doesn’t stand out from
the pile of other files the way LICENSE(.txt) does.
As for “when every file is all caps” . . . don’t name all your files
all-caps letters. Use all-lower-case or title-case for files, depending
on the purpose and type of file, except for special files like README
COPYING/LICENSE files. Note, for instance, that when I use a COPYING
file, my license text is in owl.txt, not in OWL.TXT, and that I do not
use all-caps letters for my source files either.
I don’t see how pointing out that someone using a braindead approach to
file naming means that we have to de-emphasize the README and
COPYING/LICENSE file names even when we use more reasonable file naming
conventions for the rest of the files. That seems a bit like saying
we shouldn’t kill the harmful bacteria in dental plaque on the teeth of
otherwise healthy people because, for people with ebola, dental plaque
the least of their worries. I don’t have ebola, so I take the time to
brush my teeth, floss occasionally, and use mouthwash. What about you?
Similarly, I don’t name all my files with all capital letters, so naming
(on average) two files per project using all-caps doesn’t suffer the
problem you identify for projects with filenaming convention ebola.