I am not sure if i completely understand the spec. Here is my shot at this. I have put the data at the end so you can see if it is structured in that way. 

#!/usr/bin/perl -w

use strict;

# open(DATA,"file.txt") or die $!;  # I am using DATA handle but you c
+an open a file to read contents too.

my %functions;
while (<DATA>) {
    chomp;
    my @functxt = ();
    my $desc = ();
    if (/STANDARD/)    {
        @functxt = split /\s+/;
        $desc = <DATA>;
        $functions{pop(@functxt)} = $desc;    # assuming last word is 
+function name
    }
}

print +($_, " : ", $functions{$_}, $/) for (keys %functions); 
__DATA__
# STANDARD func1 
func1 does something funny
blah
blah
ok
junk text
# STANDARD func2 
func2 does something useful

# STANDARD func3 
func3 is a math function

[download]

output

func1 : func1 does something funny        
func3 : func3 is a math function                                
func2 : func2 does something useful

[download]

In reply to Re: Newbie question, advice appreciated by sk
in thread Newbie question, advice appreciated by Seventh

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.