neilwatson has asked for the wisdom of the Perl Monks concerning the following question:

I'm using h2sx to create a module. In the Makefile.PL file there is a line ABSTRACT_FROM => 'opcmsg.pm', # retrieve abstract from module. When I issue a perl Makefile.PL I see WARNING: Setting ABSTRACT via file 'opcmsg.pm' failed. What does this mean?

Neil Watson
watson-wilson.ca

Replies are listed 'Best First'.
Re: ABSTRACT_FROM in Makefile.PL
by Fletch (Bishop) on Jan 26, 2006 at 21:02 UTC 
           ABSTRACT_FROM
         Name of the file that contains the package description. MakeM
+aker
         looks for a line in the POD matching /^($package\s-\s)(.*)/. 
+This is
         typically the first line in the "=head1 NAME" section. $2 bec
+omes the
         abstract.

    [download]

    Perhaps your POD, while present, just doesn't match what it's expecting?

    Update: Oop, I should've mentioned that was from the docs for ExtUtils::MakeMaker.

[reply]
[d/l]
      Thanks that information was very helpful. Where did it come from?

      Neil Watson
      watson-wilson.ca

[reply]
Re: ABSTRACT_FROM in Makefile.PL
by lima1 (Curate) on Jan 26, 2006 at 20:06 UTC
    you can just define, from which perl package it should take the abstract *(POD). probably it just can't find any valid POD section in openmsg.pm.

    Btw: I prefer Module::Starter (and conways nice templates Module::Starter::PBP) over h2xs...

[reply]
      There is a POD section in opcmsg.pm. perldoc ./opcmsg.pm renders it correctly.

      Neil Watson
      watson-wilson.ca

[reply]
[d/l]
        The abstract_from command retrieves the abstract from a particular file contained in the distribution package. Most often this is done from the main module, where it will read the POD and use whatever is in the =head1 NAME section (with module name removed as needed)
[reply]

Back to Seekers of Perl Wisdom