+ $input->select('name', ['option'], 'default');
+
+Provides C<< <select><option> >> dropdown by default, but can also output
+multiple C<< <input> >> tags if a I<type> is provided:
+
+ $input->select('name', ['1'], {type => 'checkbox'});
+
+In scalar context, options are joined together by C<$,> (C<$OUTPUT_FIELD_SEPARATOR>).
+Otherwise a list of tags is returned.
+
+Each option can be given as either a simple string containing its I<value>,
+or a hash ref with custom attributes.
+When there's no parent tag (only C<< <input> >>s), a fourth parameter can
+provide common options which will be inherited by each element. Otherwise,
+options will apply to either the C<< <select> >> or an C<< <option> >>.
+
+The default value (either as a third scalar parameter, or with the general
+I<value> option) will be matched to the value of each option, and if equal,
+its I<selected> or I<checked> attribute will be set as appropriate.
+
+=item C<radio>
+
+In fact just a shorthand to L<select> with a preset type of I<radio>, but takes
+an additional third argument to easily set the label for each option:
+
+ $input->radio('name', ['option'], ['option label'], 'default');
+
+This would be the same as saying:
+
+ $input->radio(
+ 'name',
+ [ {label => 'option label', value => 'option'} ],
+ {value => 'default'}
+ );
+
+=item C<check>
+
+Also a L<select> shorthand, but with a I<checkbox> type.
+Instead of values, the second argument specifies option I<label>s.
+The values by default are set to an auto-incrementing number starting with 1.
+
+Furthermore, the I<checked> status for each option can be specified by a third
+argument. Either a single boolean value defining all rows, or an array ref
+with the value for each row in order.
+
+ $input->check('name', ['label', 'second option'], [0, 1]);
+
+Or more descriptive but identical:
+
+ $input->check('name', [
+ {label => 'label', value => 1, checked => 0},
+ {label => 'second option', value => 2, checked => 1},
+ ]);
+
+=back
+
+=head1 TODO
+
+=over