added script commute-sentence to commute the prison sentence of a sel…

…ected unit

commute-sentence.lua

@@ -0,0 +1,19 @@
+local utils = require('utils')
+local argparse = require('argparse')
+
+local function commute_sentence(unit)
+    for _,punishment in ipairs(df.global.plotinfo.punishments) do
+        if punishment.criminal == unit.id then
+            punishment.prison_counter = 0
+            return
+        end
+    end
+    qerror('Unit is not currently serving a sentence!')
+end
+
+unit = dfhack.gui.getSelectedUnit(true)
+if not unit then
+    qerror('No unit selected!')
+else
+    commute_sentence(unit)
+end

docs/commute-sentence.rst

@@ -0,0 +1,16 @@
+commute-sentence
+================
+
+.. dfhack-tool::
+    :summary: Commute the prison sentences of convicted criminals.
+    :tags: fort armok units
+
+If a unit is currently serving out their sentence but you want them released
+for whatever reason, this tool can commute their sentence. Just select the unit
+and run the command.
+
+usage
+-----
+
+::
+    commute-sentence