Imported Upstream version 1.5
[platform/upstream/shared-mime-info.git] / HACKING
diff --git a/HACKING b/HACKING
index 260025b..d63931f 100644 (file)
--- a/HACKING
+++ b/HACKING
@@ -10,6 +10,9 @@ A few ground rules for people interested in adding new mime-types.
 * Mime-types/file formats proprietary to one application should only
   be added to a private .xml file and be bundled with the application
   itself
+* Magic offset must be as small as possible. For example, the worst case
+  scenario for ISO images is 32k inside the file. This is too big for a sniff
+  buffer, especially on remote locations. Avoid those.
 * No commits should be done that break the test suite, or the test suite
   test in question should be amended, and reason for the changes clearly
   documented in the commit message
@@ -44,7 +47,7 @@ Bugs for new mime-types should include:
 Test suite
 ----------
 
-You need to have xdgmime checked out [1] and compile at the same level as
+You need to have xdgmime checked out [1] and compiled at the same level as
 shared-mime-info. ../xdgmime/src/test-mime-data will be run against
 tests/list.