Commits

P_W999  committed 2a255f4

Edited online

  • Participants
  • Parent commits 40684eb

Comments (0)

Files changed (1)

 
 
 == Licensing ==
-J-ExifTool is release under [[License|Apache 2.0]] license. 
+J-ExifTool is released under [[License|Apache 2.0]] license. 
 
 == Technology == 
 === Libraries used ===
 J-ExifTool doesn't use Ant of Maven, you can simply clone the source code and import into Eclipse or IntelliJ. Some people might argue that using Ant or Maven is much better, but for a simple, single module project with only a few dependencies it's too expensive (in terms of maintenance, built time, complexity) to use a built tool.
 
 == How to use ==
-J-ExifTool uses ExifTool 8.91 or later, you can grab it [[http://www.sno.phy.queensu.ca/~phil/exiftool/|here]]. J-ExifTool will look at system property //exiftool.path// to determine where ExifTool is installed. \\ 
-For a more comprehensive example you can take a look at DemoApp.java.
+J-ExifTool uses ExifTool 8.91 or later, you can grab it [[http://www.sno.phy.queensu.ca/~phil/exiftool/|here]]. J-ExifTool will look at system property //exiftool.path// to determine where ExifTool is installed. For a more comprehensive example you can take a look at DemoApp.java.
+
+Under normal circumstances you should only need to use the classes in the be.pw.jexif package, everything stored under be.pw.jexif.internal is for //internal// use only (duh !). 
 
 ==== Read a tag ====
 The following code is a simple example of how to read the ISO tag from a file "read01.JPG". 
 JExifTool tool = new JExifTool();
 JExifInfo write1 = tool.getInfo(new File("tmp.jpg"));
 LOG.info("Writing 5 to FOCAL_LENGTH for write 1 -> {}", write1.setTag(ExifIFD.FOCALLENGTH, "5.0"));
-}}}
+}}}
+
+=== Troubleshooting ===
+==== Deadlocked after iteration of x ====
+This error indicates that J-ExifTool waited too long for the ExifTool output to finish. This happens if
+* ExifTool isn't running
+* You computer is too slow or too busy
+
+The current timeout is set to 4000ms, but you can always override this by setting the //exiftool.deadlock// system property.