Update popup tag

Author: Bloke

tags/popup.md

@@ -3,7 +3,7 @@ layout: document
 category: Tags
 published: true
 title: Popup
-description: Textpattern will replace this tag with a popup selector for browsing by section or category.
+description: Textpattern will replace this tag with a selector for browsing by section or category.
 tags:
   - Navigation tags
 ---
@@ -21,53 +21,43 @@ tags:
 <txp:popup />
 ~~~
 
-The **popup** tag is a *single* tag. Textpattern will replace this tag with a popup selector for browsing by section or category.
+The **popup** tag is a *single* tag. Textpattern will replace this tag with a select list for browsing by section or category, wrapped in an HTML `<form>`. Selecting an entry will automatically submit the form unless scripting is disabled, in which case a 'submit' button will be displayed too.
 
 ## Attributes
 
 Tag will accept the following attributes (**case-sensitive**) as well as the {% include atts-global-link.html %}:
 
 `section="section_name"`
-: Jump to the selected category for the named section.
+: Filter the selected category by the named section, instead of listing all articles that match the category. Only of use if `type="category"`.
 : **Default:** unset.
 
 `this_section="boolean"`
-: Jump to the selected category for the currently active section.
+: Filter the selected category by the currently active section, instead of listing all articles that match the category. Only of use if `type="category"`.
 : **Values:** `0` (no) or `1` (yes).
 : **Default:** `0`.
 
 `type="type"`
 : **Values:** `section`, `category`.
 : **Default:** `category`.
 
-### Common presentational attributes
-
-These attributes, which affect presentation, are shared by many tags. Note that default values can vary among tags.
-
-`class="class name"` <span class="footnote warning">v4.3.0+</span>
-: HTML `class` to apply to the `wraptag` attribute value.
-: **Default:** tag name or unset (see [class cross-reference](/tags/tag-attributes-cross-reference#class)).
-
-`label="text"`
-: Label prepended to item.
-: **Default:** unset (but see [label cross-reference](/tags/tag-attributes-cross-reference#label) for exceptions).
-
-`wraptag="element"`
-: HTML element to wrap (markup) list block, specified without brackets (e.g. `wraptag="ul"`).
-: **Default:** unset (but see [wraptag cross-reference](/tags/tag-attributes-cross-reference#wraptag) for exceptions).
-
 ## Examples
 
 ### Example 1: Browse by category popup selector
 
 ~~~ html
-<txp:popup type="category" wraptag="p" />
+<txp:popup type="category" wraptag="div" />
+~~~
+
+### Example 2: Browse by section popup selector
+
+~~~ html
+<txp:popup type="section" wraptag="div" class="site_browse" />
 ~~~
 
-### Example 2: Popup selector with custom label
+### Example 3: Popup selector with custom label that filters by current section
 
 ~~~ html
-<txp:popup label="Browse this site" type="category" wraptag="p" />
+<txp:popup label="Browse by category" type="category" this_section />
 ~~~
 
 ## Genealogy