summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--dev/packaging/tutorials/basic.mdwn86
1 files changed, 86 insertions, 0 deletions
diff --git a/dev/packaging/tutorials/basic.mdwn b/dev/packaging/tutorials/basic.mdwn
index 4852908..537b597 100644
--- a/dev/packaging/tutorials/basic.mdwn
+++ b/dev/packaging/tutorials/basic.mdwn
@@ -580,6 +580,90 @@ And here's `libexpat.1-dev.pkg/control`:
.
This package provides development files for Expat.
+Copyright and License Information
+---------------------------------
+
+We're almost done; we just have one more important thing to do. We need to
+document the copyright information for the upstream software and our own
+packaging work.
+
+This is done in the `copyright` file. There is currently no standard format for
+this file.
+
+We need to collect the copyright and license information from the upstream
+source code (usually in comments at the tops of source files).
+
+There are some resources available to assist us with this. First, we can look
+at the work already done by package maintainers in the Debian Project. Find the
+[copyright file][deb-expat-copyright] for Debian's `expat` source package.
+
+We see the following copyright information:
+
+ Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center Ltd
+ and Clark Cooper
+ Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006 Expat maintainers.
+
+We also see that Expat can be dealt in under the terms of, unsurprisingly, the
+Expat (a.k.a. "MIT") license.
+
+Another resource we can use is the [**licensecheck**(1) tool][licensecheck],
+maintained in Debian's `devscripts` package and originally based on a script
+from the KDE SDK. Recursively run **licensecheck**(1) to report copyright and
+license information.
+
+ $ licensecheck -r --copyright tmp/src/
+
+We see that some source files have publication dates in their copyright notices
+that are newer than those that Debian's copyright file lists:
+
+ tmp/src/amiga/expat_lib.c: MIT/X11 (BSD like)
+ [Copyright: 2001-2009 Expat maintainers / HOLDERS BE LIABLE FOR ANY]
+
+So collect some representative copyright notice, e.g. from
+`tmp/src/lib/xmlparse.c`, `tmp/src/examples/outline.c`,
+`tmp/src/vms/expat_config.h`, and `tmp/src/amiga/expat_lib.c` and add them to
+the `copyright` file.
+
+Then describe the license under which the software may be used. `Expat` is a
+"common license" included under `/usr/share/common-licenses/` in this
+distribution, so you can refer to it there.
+
+You should also document the location from which the source was obtained.
+
+Finally, add your own copyright notice and license information. You should
+allow your work to be used under the terms of a license that is equivalent to or
+compatible with the terms of the upstream software's copyright license.
+
+Your resulting `copyright` file might look something like this:
+
+ Upstream Source
+ ===============
+
+ Location: <http://sourceforge.net/projects/expat/files/expat/>
+
+ Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center Ltd
+ Copyright 1999, Clark Cooper
+ Copyright 2000, Clark Cooper
+ Copyright (c) 2001-2009 Expat maintainers.
+
+ These files may be reproduced, distributed, modified, and otherwise dealt in
+ under the terms of the Expat License.
+
+ On this system, a copy of the Expat License may be found at
+ <file:///usr/share/common-licenses/Expat>.
+
+
+ Distribution Packaging
+ ======================
+
+ Copyright (C) 2012 J. Random Hacker
+
+ These files may be reproduced, distributed, modified, and otherwise dealt in
+ under the terms of the Expat License.
+
+ On this system, a copy of the Expat License may be found at
+ <file:///usr/share/common-licenses/Expat>.
+
TODO: Finish.
@@ -604,3 +688,5 @@ TODO: Finish.
[spf-fields-bin]: http://specs.os.libiquity.com/spf-2.0/fields.html#fields-src
[spf-docs]: http://specs.os.libiquity.com/spf-2.0/metadata.html#docs
[spf-substvars]: http://specs.os.libiquity.com/spf-2.0/substvars.html
+[deb-expat-copyright]: http://packages.debian.org/changelogs/pool/main/e/expat/current/copyright
+[licensecheck]: http://anonscm.debian.org/gitweb/?p=devscripts/devscripts.git;a=blob;f=scripts/licensecheck.pl;hb=HEAD