debian/README.source: Document how the list of devices in debian/libfprint0.postinst is generated

debian/README.source

@@ -0,0 +1,19 @@
+The libfprint0 postinst script calls udevadmin trigger for all the supported
+USB readers. The list of readers used in that file is generated by calling the
+following awk script:
+
+  /plugdev/ {
+          printf ("\tudevadm trigger --action=add " )
+          for (i=1;i<=NF; i++){
+                  if (match($i,/idVendor/)>0) {
+                          match($i, /"[^"]*"/); printf ("--attr-match=idVendor=%s ",substr($i,RSTART+1,RLENGTH-2))
+                  }
+                  if (match($i,/idProduct/)>0) {
+                          match($i, /"[^"]*"/); printf ("--attr-match=idProduct=%s",substr($i,RSTART+1,RLENGTH-2))
+                  }
+          };
+          printf("\n")
+  }
+
+When preparing a new upstream release, this script should be called against the
+udev .rules file generated during the build of the package

debian/changelog

@@ -16,8 +16,10 @@ libfprint (1:0.99.0-1) UNRELEASED; urgency=medium
   * debian/control: Add libglib2.0-doc to Build-Depends-Indep, this allows
     gtk-doc to properly resolve all the links in the documentation
   * debian/rules: Install the NEWS file as the upstream changelog
+  * debian/README.source: Document how the list of devices in
+    debian/libfprint0.postinst is generated
 
- -- Laurent Bigonville <bigon@debian.org>  Fri, 12 Jul 2019 01:02:47 +0200
+ -- Laurent Bigonville <bigon@debian.org>  Fri, 12 Jul 2019 02:12:33 +0200
 
 libfprint (1:0.8.2-3) unstable; urgency=medium