Finish and document hotkey-notes

All working correctly - thus ends the long story of the needs_porting
folder.

NEWS

@@ -1,4 +1,8 @@
 DFHack Future
+    New Scripts
+		hotkey-notes:  print key, name, and jump position of hotkeys
+    Removed
+		needs_porting/*
 
 
 

Readme.rst

@@ -2394,6 +2394,10 @@ is "hfs-pit 1 0 0", ie single-tile wide with no walls or stairs.
 First example is a four-across pit with stairs but no walls; second is a
 two-across pit with stairs but no walls.
 
+hotkey-notes
+============
+Lists the key, name, and jump position of your hotkeys.
+
 lever
 =====
 Allow manipulation of in-game levers from the dfhack console.

scripts/hotkey-notes.lua

@@ -1,20 +1,12 @@
 -- prints info on assigned hotkeys to the console
 
--- A work in progress, hoping for some help!
+local h_list = {'F1', 'F2', 'F3', 'F4', 'F5', 'F6', 'F7', 'F8',
--- A different approach might be needed depending on internal structures, 
+                'Shift+F1', 'Shift+F2', 'Shift+F3', 'Shift+F4',
---    but this gets the idea across.
+				'Shift+F5', 'Shift+F6', 'Shift+F7', 'Shift+F8'}
-
+
-local hotkeys = {'F1 ', 'F2 ', 'F3 ', 'F4 ', 'F5 ', 'F6 ',
+for i=1, #df.global.ui.main.hotkeys do
-                 'F7 ', 'F8 ', 'F9 ', 'F10', 'F11', 'F12'}
+    local hk = df.global.ui.main.hotkeys[i-1]
-
+	if hk.cmd ~= -1 then
-for i=1, #hotkeys do
+		print(h_list[i]..': '..hk.name..':  x='..hk.x..'  y='..hk.y..'  z='..hk.z)
-    local hk = hotkeys[i]
+	end
-    hk = {id=hk}
+end
-    -- PLACEHOLDER PROPERTIES ONLY!
-    hk.name = '_name'
-    hk.x = df.global.window_x
-    hk.y = df.global.window_y
-    hk.z = df.global.window_z
-
-    print(hk.id..'  '..hk.name..'    X= '..hk.x..',  Y= '..hk.y..',  Z= '..hk.z)
-end