PMDESC(1p)						User Contributed Perl Documentation						PMDESC(1p)

NAME

       pmdesc - print out version and whatis description of perl modules

DESCRIPTION

       Given one or more module names, show the version number (if known) and the `whatis' line, that is, the NAME section's description,
       typically used for generation whatis databases.

EXAMPLES

	   $ pmdesc IO::Socket
	   IO::Socket (1.25) - Object interface to socket communications

	   $ oldperl pmdesc IO::Socket
	   IO::Socket (1.1603) - Object interface to socket communications

	   $ pmdesc `pminst -s | perl -lane 'print $F[1] if $F[0] =~ /site/'`
	   XML::Parser::Expat (2.19) - Lowlevel access to James Clark's expat XML parser
	   XML::Parser (2.19) - A perl module for parsing XML documents

RESTRICTIONS

       This only works on modules.  It should also work on filenames, but then it's a bit tricky finding out the package to call the VERSION
       method on.

SEE ALSO

       pmdesc(1) pminst(1) pmpath(1) pmvers(1)

AUTHORS and COPYRIGHTS
       Copyright (C) 1999 Tom Christiansen.

       Copyright (C) 2006-2008 Mark Leighton Fisher.

       This is free software; you can redistribute it and/or modify it under the terms of either: (a) the GNU General Public License as published
       by the Free Software Foundation; either version 1, or (at your option) any later version, or (b) the Perl "Artistic License".  (This is the
       Perl 5 licensing scheme.)

       Please note this is a change from the original pmtools-1.00 (still available on CPAN), as pmtools-1.00 were licensed only under the Perl
       "Artistic License".

perl v5.10.1							    2010-02-22								PMDESC(1p)