summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--NEWS1
-rw-r--r--README.packaging38
2 files changed, 39 insertions, 0 deletions
diff --git a/NEWS b/NEWS
index b5b768f94..776672a85 100644
--- a/NEWS
+++ b/NEWS
@@ -10,6 +10,7 @@ Bindings:
* Preliminary work on Python bindings.
Package / System integration:
+ * Add README.packaging file.
* Add new permission setup script doing class based matching for
PTP class cameras not listed explicitly by USB IDs.
This script (check_ptp_camera) is used by the generated UDEV rules.
diff --git a/README.packaging b/README.packaging
new file mode 100644
index 000000000..0274c9bdd
--- /dev/null
+++ b/README.packaging
@@ -0,0 +1,38 @@
+========================================================================
+libgphoto2 README.packaging
+========================================================================
+
+This file describes a number of things you should know when building
+packages (.debs, .rpms, ports, emerges, etc. pp.)
+
+
+========================================================================
+Permission setup
+================
+
+You will want to create HAL or UDEV rules by running this utility:
+
+ print-camera-list
+
+This utility requires libgphoto2 and its camlibs being installed,
+either
+ * at package building time by doing a DESTDIR based temporary
+ install somewhere and setting LD_LIBRARY_PATH and CAMLIBS before
+ running print-camera-list
+ * at package installation time as a post installation hook
+
+The UDEV rules require two helper scripts/binaries, which obviously
+need to be installed by the package:
+
+ check_mtp_device
+ check_ptp_camera
+
+You can either use fixed permissions in the generated rules, or call
+your own permission setup script to dynamically decide what to do.
+
+(Contemporary example scripts are not being shipped yet.)
+
+
+========================================================================
+End of file.
+========================================================================