Made --list work, added readme.

Author: NathanSweet

README.md

@@ -0,0 +1,18 @@
+
+## Unlock
+
+This utility for Windows uses `handle` from [Sysinternals](https://learn.microsoft.com/en-us/sysinternals/downloads/handle) to unlock a file. All open handles to the file by all processes are closed. This may cause the processes to malfunction, but sometimes freeing up the damn file is more important.
+
+Usage:
+```
+java -jar unlock.jar [--list|-l] [path]
+```
+
+### handle
+
+`handle` is difficult to use directly because it lists the handles and expects you to assemble further commands to do the unlocking, which is tedious. Also `handle` uses substring matching, eg `abc` will match both `abc` and `abcd`. Checking for an exact match via shell scripts is cryptic and difficult to get right.
+
+If substring matching is sufficient, `handle` can be used with Cygwin like this:
+```
+handle -nobanner -v "$1" | sed '1d' | cut -f2,4 -d, | tr ',' '\n' | xargs -r sh -c "handle -nobanner -p $1 -c $2 -y" sh
+```

src/com/esotericsoftware/unlock/Unlock.java

@@ -44,16 +44,20 @@ private Unlock (String path, boolean list) throws Exception {
 			String[] columns = entry.split(",", 5);
 			if (columns.length != 5) throw error("Error getting handles (invalid response): " + String.join(" ", command));
 			if (!columns[4].trim().equals(path)) continue;
-			command.add(columns[1]);
-			command.add("-c");
-			command.add(columns[3]);
-			command.add("-y");
-			run(command, null, true);
-			command.remove(6);
-			command.remove(5);
-			command.remove(4);
-			command.remove(3);
-			System.out.println("Unlocked: " + columns[0]);
+			if (list)
+				System.out.println(columns[0]);
+			else {
+				command.add(columns[1]);
+				command.add("-c");
+				command.add(columns[3]);
+				command.add("-y");
+				run(command, null, true);
+				command.remove(6);
+				command.remove(5);
+				command.remove(4);
+				command.remove(3);
+				System.out.println("Unlocked: " + columns[0]);
+			}
 		}
 	}
 
@@ -87,7 +91,7 @@ static public void main (String[] args) throws Exception {
 		String path = null;
 		boolean list = false;
 		for (String arg : args) {
-			if (arg.equals("--list"))
+			if (arg.equals("-l") || arg.equals("--list"))
 				list = true;
 			else
 				path = arg;