From 3e8097994f23436d5f1793ad45f7e6df858842e9 Mon Sep 17 00:00:00 2001
From: P. J. McDermott <pehjota>
Date: Mon, 19 Nov 2012 12:30:37 -0500
Subject: Add copyright/licence section to packaging tut.

---
(limited to 'dev/packaging')

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
--
cgit v0.9.1