From 97d7ac3956775f763cd1e7c37a5d8de8cb396c65 Mon Sep 17 00:00:00 2001
From: Richard Jarvis <jarvisteach@gmail.com>
Date: Thu, 20 Apr 2017 22:05:26 +0100
Subject: [PATCH] Doc updates

---
 docs/mkdocs/custom_united/nav.html   |  2 ++
 docs/mkdocs/docs/extra.css           | 19 +++++++++++++++++++
 docs/mkdocs/docs/pythonDevWidgets.md | 26 +++++++++++++++++++++-----
 examples/issues/issue151.py          |  2 ++
 4 files changed, 44 insertions(+), 5 deletions(-)

diff --git a/docs/mkdocs/custom_united/nav.html b/docs/mkdocs/custom_united/nav.html
index 10b1764..51de67c 100644
--- a/docs/mkdocs/custom_united/nav.html
+++ b/docs/mkdocs/custom_united/nav.html
@@ -1,3 +1,5 @@
+<div class="corner-ribbon"><a href="https://pypi.python.org/pypi/appJar/">Version 0.06 out now!</a></div>
+
 <div class="navbar {% if config.extra.theme_inverse %}navbar-inverse{% else %}navbar-default{% endif %} navbar-fixed-top" role="navigation">
     <div class="container">
 
diff --git a/docs/mkdocs/docs/extra.css b/docs/mkdocs/docs/extra.css
index e69de29..ffd02c2 100644
--- a/docs/mkdocs/docs/extra.css
+++ b/docs/mkdocs/docs/extra.css
@@ -0,0 +1,19 @@
+@import url('http://fonts.googleapis.com/css?family=Noto+Sans:400,700');
+
+.corner-ribbon{
+    width: 225px;
+    background: #ec0;
+    position: absolute;
+    text-align: center;
+    line-height: 50px;
+    letter-spacing: 1px;
+    color: #f0f0f0;
+    z-index: 20;
+    top: 88px;
+    right: -50px;
+    left: auto;
+    transform: rotate(45deg);
+    -webkit-transform: rotate(45deg);
+    position: fixed;
+    box-shadow: 0 0 3px rgba(0,0,0,.3);
+}
diff --git a/docs/mkdocs/docs/pythonDevWidgets.md b/docs/mkdocs/docs/pythonDevWidgets.md
index 8ecfd30..ca3b008 100644
--- a/docs/mkdocs/docs/pythonDevWidgets.md
+++ b/docs/mkdocs/docs/pythonDevWidgets.md
@@ -135,13 +135,21 @@ It is possible to include buttons at the end of each row, and an additional row
 
 * `.addGrid(title, data, action=None, addRow=False)`  
     Receives a (jagged) 2D list of values. The first list should be the headers for the grid, the rest will contain each row of values.  
-    If action is set, a button will be created, at the end of each row,  calling the specified function.  
-    If addRow is True, then an additional row will appear at the end, with entry boxes and an additional button.  
+
+    If `action` is set, a button will be created, at the end of each row,  calling the specified function.  
+    If `addRow` is True, then an additional row will appear at the end, with entry boxes and an additional button.  
+
+    The **Press** button at the end of each data row will pass the values of that row to the function as a list.  
+    The **Press** button at the end of the entry row will call the function, passing its name as a parameter.  
+
+    NB. you shouldn't set `addRow` to be True, unless `action` has been set with a function.  
 
 ####Get Grids  
+
 * `.getGridEntries(title)`  
-    Get the contents of the entry boxes, if present.  
-    Returned as a list, in the same order as the entry boxes.  
+    If `addRow` was set when the *Grid* was created, this function will get the contents of the entry boxes.  
+    They will be returned as a list, in the same order as the entry boxes.  
+
 * `.getGridSelectedCells(title)`  
     Gets a dictionary of booleans, indicating the status of each cell.  
     True indicates the cell is selected, False indicates the cell is not selected.  
@@ -150,9 +158,17 @@ It is possible to include buttons at the end of each row, and an additional row
 ####Set Grids  
 
 * `.addGridRow(title, data)`  
-    Add a single row of data to the existing grid.  
+    Adds a new row of data to the end of the existing grid.  
     It will be positioned at the bottom of the grid, above the entry boxes if present.  
 
+To have the **Press** button on the entries row, add a new row of data, try the following:  
+```python
+    def press(btn):
+        if btn == "Press":     # the button on the entries row
+            data = app.getGridEntries("g1")
+            app.addGridRow("g1", data)
+``` 
+
 ###MatPlotLib
 ---
 
diff --git a/examples/issues/issue151.py b/examples/issues/issue151.py
index 02c4c52..8312f78 100644
--- a/examples/issues/issue151.py
+++ b/examples/issues/issue151.py
@@ -5,6 +5,8 @@
 def press(*args):
     if args[0]=="newRow":
         app.addGridRow('airflow_data_raw', app.getGridEntries('airflow_data_raw'))
+    else:
+        print(args)
 
 app=gui("GridTest", "800x500")