autodoc: Include embed.fnc line number in output comments

The generated perlapi and perlintern will now include in their comments
the position in embed.fn that the signature was found.  This makes
finding things a bit easier.

Author: khwilliamson

autodoc.pl

@@ -2513,13 +2513,9 @@ ($destpod)
     my $embed= $_->{embed}
         or next;
     my $file = $_->{source};
-    my ($flags, $ret_type, $func, $args) =
-                                 @{$embed}{qw(flags return_type name args)};
-    check_and_add_proto_defn($func, $file,
-                             # embed.fnc data doesn't currently furnish the
-                             # line number
-                             undef,
-
+    my ($flags, $ret_type, $func, $args, $line_num) =
+                    @{$embed}{qw(flags return_type name args start_line_num)};
+    check_and_add_proto_defn($func, $file, $line_num,
                              $flags, $ret_type, $args,
 
                              # This is like an 'apidoc_defn' line, in that it

regen/HeaderParser.pm

@@ -790,10 +790,10 @@ sub tidy_embed_fnc_entry {
     ($line)= unexpand($line);
 
     $line_data->{embed}= EmbedLine->new(
-        flags       => $flags,
-        return_type => $ret,
-        name        => $name,
-        args        => \@args,
+        flags          => $flags,
+        return_type    => $ret,
+        name           => $name,
+        args           => \@args,
         start_line_num => $line_data->{start_line_num},
     );
     $line =~ s/\s+\z/\n/;