From ebffa3fa3865abd342ba9b261a9bdb924d396a06 Mon Sep 17 00:00:00 2001
From: Julien Fiegehenn <simbabque@cpan.org>
Date: Sun, 3 Jul 2022 22:36:58 +0100
Subject: [PATCH] POD changes related to form_action()

---
 lib/WWW/Mechanize.pm | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/lib/WWW/Mechanize.pm b/lib/WWW/Mechanize.pm
index f7279ffd..382c6f63 100644
--- a/lib/WWW/Mechanize.pm
+++ b/lib/WWW/Mechanize.pm
@@ -1606,13 +1606,14 @@ sub form_number {
 
 =head2 $mech->form_action( $action )
 
-Selects a form by action, using a regex containing $action.
+Selects a form by action, using a regex containing C<$action>.
 If there is more than one form on the page matching that action,
 then the first one is used, and a warning is generated.
 
 If it is found, the form is returned as an L<HTML::Form> object and
 set internally for later use with Mech's form methods such as
-C<L</field()>> and C<L</click()>>.
+C<L<< field()|/"$mech->field( $name, $value, $number )" >>> and
+C<L<< click()|/"$mech->click( $button [, $x, $y] )" >>>.
 
 Returns C<undef> if no form is found.
 
@@ -1764,7 +1765,8 @@ sub all_forms_with {
 Searches for forms with arbitrary attribute/value pairs within the E<lt>formE<gt>
 tag.
 (Currently does not work for attribute C<action> due to implementation details
-of L<HTML::Form>.)
+of L<HTML::Form>. Use C<L<< form_action()|/"$mech->form_action( $action )" >>>
+instead.)
 When given more than one pair, all criteria must match.
 Using C<undef> as value means that the attribute in question must not be present.