diff options
| -rw-r--r-- | dev/packaging/tutorials/basic.mdwn | 86 |
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 |