Clarification on popups.
[mkws-moved-to-github.git] / doc / mkws-manual.markdown
index 95ade13..62ab625 100644 (file)
@@ -542,7 +542,7 @@ its own User Access record.
 
 When credential-based authentication is in use (username and
 password), it's necessary to pass these credentials into the Service
-Proxy when establishing the session. This is done 
+Proxy when establishing the session. This is done
 by providing the `sp_auth_credentials` configuration setting as a string
 containing the username and password separated by a slash:
 
@@ -1172,17 +1172,18 @@ from that toolkit. The relevant lines are:
          <div class="mkws-stat"></div>
        </div>
 
+Popup windows can contain any HTML, not just MKWS widgets.
+
+The properties of the `popup` widget are as follows:
+
 ----
 Element         Type    Default             Description
 --------        -----   -------             ------------
-popup_width     string  880                 Width of the popup window (if used), in
-                                            pixels.
+popup_width     string  880                 Width of the popup window, in pixels.
 
-popup_height    string  760                 Height of the popup window (if used), in
-                                            pixels.
+popup_height    string  760                 Height of the popup window, in pixels.
 
-popup_button    string  `input.mkwsButton`  A click on this selector will trigger the
-                                           popup to open
+popup_button    string  `input.mkwsButton`  A click on this selector will trigger the popup to open
 
 popup_modal     string  0                   Modal confirmation mode. Valid values are 0 or 1
 
@@ -1190,8 +1191,8 @@ popup_autoOpen  string  1                   Open popup window on load. Valid val
 
 ----
 
-You can have more than one mkws-popup widgets on a page. Please use a different 
-popup_button value to address the right ones.
+Multiple `popup` widgets can co-exist on a page. In this case, different
+`popup_button` values must be used for each.
 
 The structure of the HTML generated by the MKWS widgets
 -------------------------------------------------------
@@ -1208,18 +1209,18 @@ and .CLASS indicates an instance of a class.
 
        #mkwsSwitch
          a*
-       
+
        #mkwsLang
          ( a | span )*
-       
+
        #mkwsSearch
          form
            input#mkwsQuery type=text
            input#mkwsButton type=submit
-       
+
        #mkwsBlanket
          (no contents -- used only for masking)
-       
+
        #mkwsResults
          table
            tbody
@@ -1257,7 +1258,7 @@ and .CLASS indicates an instance of a class.
              tbody
                tr*
                  td*
-       
+
        #mkwsStat
          span.head
          span.clients