v6.10

    - Use "croak" instead of "die" to show errors from the perspective of the
      caller [RT#20499] (GH#29) (Julien Fiegehenn)
    - Remove the executable bit from a couple of tests (GH#41) (James Raspass)
    - <option>s within select fields without a name no longer get merged into
      the previous select field (GH#2) (Julien Fiegehenn)
    - find_input() can now take a reference to undef to explicitly find inputs
      that have no name (GH#2) (Julien Fiegehenn)

Author: simbabque

Changes

@@ -1,6 +1,6 @@
 Change history for HTML-Form
 
-{{$NEXT}}
+6.10      2022-08-22 13:20:12Z
     - Use "croak" instead of "die" to show errors from the perspective of the
       caller [RT#20499] (GH#29) (Julien Fiegehenn)
     - Remove the executable bit from a couple of tests (GH#41) (James Raspass)

META.json

@@ -80,39 +80,39 @@
    "provides" : {
       "HTML::Form" : {
          "file" : "lib/HTML/Form.pm",
-         "version" : "6.09"
+         "version" : "6.10"
       },
       "HTML::Form::FileInput" : {
          "file" : "lib/HTML/Form.pm",
-         "version" : "6.09"
+         "version" : "6.10"
       },
       "HTML::Form::IgnoreInput" : {
          "file" : "lib/HTML/Form.pm",
-         "version" : "6.09"
+         "version" : "6.10"
       },
       "HTML::Form::ImageInput" : {
          "file" : "lib/HTML/Form.pm",
-         "version" : "6.09"
+         "version" : "6.10"
       },
       "HTML::Form::Input" : {
          "file" : "lib/HTML/Form.pm",
-         "version" : "6.09"
+         "version" : "6.10"
       },
       "HTML::Form::KeygenInput" : {
          "file" : "lib/HTML/Form.pm",
-         "version" : "6.09"
+         "version" : "6.10"
       },
       "HTML::Form::ListInput" : {
          "file" : "lib/HTML/Form.pm",
-         "version" : "6.09"
+         "version" : "6.10"
       },
       "HTML::Form::SubmitInput" : {
          "file" : "lib/HTML/Form.pm",
-         "version" : "6.09"
+         "version" : "6.10"
       },
       "HTML::Form::TextInput" : {
          "file" : "lib/HTML/Form.pm",
-         "version" : "6.09"
+         "version" : "6.10"
       }
    },
    "release_status" : "stable",
@@ -129,7 +129,7 @@
       "x_IRC" : "irc://irc.perl.org/#lwp",
       "x_MailingList" : "mailto:libwww@perl.org"
    },
-   "version" : "6.09",
+   "version" : "6.10",
    "x_Dist_Zilla" : {
       "perl" : {
          "version" : "5.028000"
@@ -339,7 +339,7 @@
                }
             },
             "name" : "Test::Portability",
-            "version" : "2.001000"
+            "version" : "2.001001"
          },
          {
             "class" : "Dist::Zilla::Plugin::Test::EOL",
@@ -668,7 +668,7 @@
                   "branch" : null,
                   "changelog" : "Changes",
                   "signed" : 0,
-                  "tag" : "v6.09",
+                  "tag" : "v6.10",
                   "tag_format" : "v%V",
                   "tag_message" : "v%V"
                },

README.md

@@ -4,7 +4,7 @@ HTML::Form - Class that represents an HTML form element
 
 # VERSION
 
-version 6.09
+version 6.10
 
 # SYNOPSIS
 
@@ -175,18 +175,29 @@ The following methods are available:
     inputs that match the arguments given are returned.  In scalar context
     only the first is returned, or `undef` if none match.
 
-    If $selector is not `undef`, then the input's name, id, class attribute must
-    match.  A selector prefixed with '#' must match the id attribute of the input.
-    A selector prefixed with '.' matches the class attribute.  A selector prefixed
-    with '^' or with no prefix matches the name attribute.
+    If `$selector` is not `undef`, then the input's _name_, _id_ or _class_
+    attribute must match.
+    A selector prefixed with '#' must match the _id_ attribute of the input.
+    A selector prefixed with '.' matches the _class_ attribute. A selector prefixed
+    with '^' or with no prefix matches the _name_ attribute.
 
-    If $type is not `undef`, then the input must have the specified type.
+        my @by_id         = $form->find_input( '#some-id' );
+        my @by_class      = $form->find_input( '.some-class' );
+        my @by_name       = $form->find_input( '^some-name' );
+        my @also_by_name  = $form->find_input( 'some-name' );
+
+    If you want to find an input that has no _name_ at all, pass in a reference
+    to `undef`.
+
+        my @nameless_inputs = $form->find_input( \undef );
+
+    If `$type` is not `undef`, then the input must have the specified type.
     The following type names are used: "text", "password", "hidden",
     "textarea", "file", "image", "submit", "radio", "checkbox" and "option".
 
-    The $index is the sequence number of the input matched where 1 is the
-    first.  If combined with $name and/or $type, then it selects the _n_th
-    input with the given name and/or type.
+    The `$index` is the sequence number of the input matched where 1 is the
+    first.  If combined with `$selector` and/or `$type`, then it selects the
+    _n_th input with the given _name_ and/or type.
 
 - $value = $form->value( $selector )
 - $form->value( $selector, $new\_value )