added debian/clscan/README; updated debian/changelog

diff --git a/debian/changelog b/debian/changelog
index e15991c..251835d 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,8 +1,10 @@
 gnulib (20090915+f32c9d0-1) unstable; urgency=low
 
   * New upstream snapshot 20090915+f32c9d0.
+  * Full license/copyright audit.
+    See debian/clscan/README for info on updating debian/copyright.
 
- -- Ian Beckwith <ianb@debian.org>  Tue, 15 Sep 2009 23:27:10 +0100
+ -- Ian Beckwith <ianb@debian.org>  Wed, 16 Sep 2009 03:01:32 +0100
 
 gnulib (20090908+c5c46dc-1) unstable; urgency=low
 

diff --git a/debian/clscan/README b/debian/clscan/README
new file mode 100644 (file)
index 0000000..d46747a
--- /dev/null
+++ b/debian/clscan/README
@@ -0,0 +1,44 @@
+Updating debian/copyright after importing a new upstream
+--------------------------------------------------------
+
+From the root of the gnulib source tree:
+
+1. Run debian/clscan/clscan --scan
+
+2. Edit debian/clscan/new.txt and review/correct licensing and
+   copyright info.
+
+3. Run debian/clscan/clscan --merge
+
+4. Check debian/copyright is ok.
+
+
+new.txt format
+--------------
+
+Lines beginning with '#' are ignored.
+
+Lines beginning 'File:' and 'Hash:' should be left undisturbed.
+'Hash:' is used to record the (SHA-256) checksum of the first 15 lines
+of the file, to detect changed copyright/license headers.
+
+Lines beginning 'License:' and 'Copyright:' should be corrected where
+appropriate to contain the correct info. Indented lines following the
+'License:' line should contain the license boilerplate.
+
+overrides in modules/
+---------------------
+
+Files in modules/ contain the true license of some files. These
+overrides are applied during 'clscan --merge'. See modules/README
+and modules/COPYING for more info.
+
+clscan dependencies
+-------------------
+
+clscan depends on the perl modules Getopt::Long, Digest::SHA,
+File::Find, File::Copy, and YAML::Any (which loads any YAML module
+found on the system).
+
+
+ -- Ian Beckwith <ianb@debian.org>  Wed, 16 Sep 2009 03:01:32 +0100