1 files changed, 36 insertions, 0 deletions
diff --git a/debian/file.README.Debian b/debian/file.README.Debian
new file mode 100644
index 0000000..2d44ae3
--- /dev/null
+++ b/debian/file.README.Debian
@@ -0,0 +1,36 @@
+file for Debian
+===============
+
+additional magic files
+----------------------
+
+How users can inject their own magics for fun:
+
+  1. open /etc/magic and /etc/magic.mime with a text editor, as root,
+     and add your own magics.
+
+  2. have fun.
+
+
+How package maintainers can inject their own magics for profit:
+
+  1. place your magics as plain text files in
+     /usr/share/file/${binary_package_name}.
+
+  2. call 'file --compile ${binary_package_name}' from /usr/share/file
+     in your postinst script (maybe we should have a trigger for that
+     at some point). this will produce the binary magics
+     /usr/share/file/${binary_package_name}.mgc.
+
+  3. remove the binary magics in your postrm script.
+
+  4. profit.
+
+
+seccomp support
+---------------
+
+Starting with version 1:5.37-1, file is built using libseccomp. This
+will introduce a regression if applications call the program with the
+--uncompress option, and file(1) needs the help of external programs
+for uncompression.