Update branch to 1.5b

Author: Exairnous

.gitignore

@@ -1 +1,2 @@
-__pycache__/ 
+__pycache__
+nbproject

.kdev4/Advanced_UI_Menus.kdev4

@@ -4,18 +4,18 @@ Description:
 
 Installation Instructions:
 
-    Download the script then unpack and copy the folder advanced_ui_menus into your addons folder.
-    Open Blender and go to the addons tab in User Preferences.
-    Enable the script. 
+    • Download the script then unpack and copy the folder advanced_ui_menus into your addons folder.
+    • Open Blender and go to the addons tab in User Preferences.
+    • Enable the script. 
 
 Shortcuts:
 
     Brush menu = V (works in: Sculpt mode, Vertex Paint mode, Weight Paint mode, Texture Paint Mode, Particle Edit Mode)
     Curve menu = W (works in: Sculpt mode, Vertex Paint mode, Weight Paint mode, Texture Paint Mode)
     Custom menu = Alt-MiddleMouse
     Delete menu = X
-    Dyntopo menu = Ctrl-D Tap for toggle(on/off), hold for menu
-    Layers window = M - Tap for set visible layers, hold for move objects to layers
+    Dyntopo menu = Ctrl-D - Tap for toggle(on/off), hold for menu
+    Layers window = M
     Manipulator = Ctrl-Space - Tap for toggle(on/off), hold for menu
     Mesh Selection menu = Ctrl-Tab
     Mesh Extrude = E - Tap for extrude, hold for menu
@@ -32,18 +32,49 @@ Shortcuts:
 
 Custom Menu Tutorial:
 
-    The Custom Menu is a menu that you can customize with Operators, Separators, Labels, and other
-    menus as you see fit. This is a alpha release and as such is not the easiest to use or the most
-    feature complete, but should still be useful to people. Also if it is to reach it's true potential
-    I will probably need to work closely with the blender UI team. Now onto the tutorial.
-    To add an Operator open the menu and go down to Add Custom Item, select Operator. A window will
-    come up, type the path to the operator(you can find it by turning on python tooltips and then
-    hovering your mouse over a button or menu entry in the ui) in the Path field,
-    e.g. bpy.ops.mesh.vertices_smooth(). Type something into the Name field if you want the item to
-    have a custom name. If you want the item to have an Icon simply select it from the Icon list. The
-    last field on the window controls where the item is placed in the menu; the item will be placed
-    directly under the item you specify from the list. Finally press the OK button to add the item.
-    The rest of the items are added in a similar fashion, however as far as I know there is no easy
-    way to find the path for menus if you want to add them(tooltips only show up for them in some cases).
-    If you want to remove an item simply go to Add Custom Item, select Remove Item, and then select
-    the item you wish removed and press OK.
+    The Custom Menu is a menu that you can customize with Operators, Separators, Labels, Properties, and other Menus as you see fit. Custom Menus can be created for any mode in the 3D View as well as for other editors like the node editor, dopesheet, console, etc..
+    
+    To Add An Item:
+
+        • open the menu (Alt-MiddleMouse), and click Edit Custom Menu.
+
+        • (Required)
+          Select what type of item you would like to add from the drop down list at the top of the window.
+
+        • (Required for Operators, Menus, Properties)
+          Click on the button to the right of the path field, this will bring up a searchable menu with a list of all paths, click on a path and the path field will be filled in.
+
+        • (Optional, Operators Only)
+          The Args field will autofill with all possible arguments with their default values. Warning - If you want to modify them make sure to leave a space between the comma and the next argument.
+
+        • (Optional)
+          Fill in the Name field if you want a custom name, otherwise the default name (for the operator/menu/property) will be used.
+
+        • (Optional)
+          Select an icon from the list.
+
+        • (Optional, Properties Only)
+          There are a number of checkboxes that control how the property is displayed in the menu, e.g. if you check the slider checkbox the item in the menu will appear (and work) as a slider and allow you to click and drag to change the value or if you just click on it you can type in a value.
+
+        • (Required)
+          The last field on the window controls where the item is placed in the menu; the item will be placed directly under the item you specify from the list.
+
+        • (Required)
+          Click the Add Item button to add the item.
+
+    *Note - clicking the OK button does nothing and just closes the window
+
+
+    If you make a mistake the item will still show up in the menu, but it will be greyed out and have a warning icon. To fix this remove the item and re-add it.
+
+    If you make a mistake with Operator arguments a submenu will appear at the bottom of the menu with a list of the items that have invalid arguments.
+
+    To Remove An Item:
+
+        • open the menu and click Edit Custom Menu. 
+
+        • Select Remove An Item from the drop down list at the top of the window. 
+
+        • Select which item to remove from the list. 
+
+        • Click the Remove Item button to remove the item.