[Bioperl-l] which version is installed

[Allen Day]

There could be a functionless .pm file that just has general bioperl
documentation.  I like they way "perldoc perl" works, to direct the reader
to the other perl documentation.  Are we to the point yet that we have
several readme and install docs yet?  I know Peter Schattner is working 
on a tutorial, and... aren't there some people at the Pasteur Institute 
doing some work along these lines as well?

Anyway, this dummy .pm could be generated during the make, with the
version encoded in a configuration file (possibly generated by
Makefile.PL.  You can set source files to be grokked into install files
using the PL_FILES hashref, like:

WriteMakefile(
  PL_FILES => { 'bioperl.PLS' => 'bioperl.pm' }
)

Inside bioperl.PLS you do something like this:

#!perl
use LocalConf; #a module i wrote for generating pl/pm files from PLS 
               #files, it exports a hash, similar to Config, see 
               #L<Config>.

print OUT <<"!GROK!THIS!";
=pod

=head2 Bioperl v$Local{version} - blah blah blah

blah blah blah
!GROK!THIS!


I can do this if people feel it's worthwhile.

-Allen


On Tue, 10 Dec 2002, Hilmar Lapp wrote:

> I think what jason was also referring to is who do you tell which version you are running if all you have is an installed bioperl. Would configuring the makefile help here? -hilmar
> 
> > -----Original Message-----
> > From: Allen Day [mailto:allenday@ucla.edu]
> > Sent: Tuesday, December 10, 2002 9:35 PM
> > To: Jason Stajich
> > Cc: Bioperl
> > Subject: Re: [Bioperl-l] which version is installed
> > 
> > 
> > You can set the value of VERSION in WriteMakefile(), or set 
> > VERSION_FROM 
> > to the filename where the version can be found.  This is all 
> > documented in 
> > ExtUtils::MakeMaker.
> > 
> > I think it makes sense to set the release version in 
> > Makefile.PL, and to 
> > let individual modules have their own versions.
> > 
> > -Allen
> > 
> > 
> > On Tue, 10 Dec 2002, Jason Stajich wrote:
> > 
> > > This is a common question:
> > > 
> > > > it (I do not know what Version of bioperl it is. Is
> > > > there a way to find out the bioperl version easily?).
> > > 
> > > At one point we were tagging the Bio::Seq module with the 
> > correct version.
> > > Another option is to globally apply a VERSION tag through 
> > CVS magic in
> > > either all the $Id$ or through some finagling and actually setting a
> > > $VERSION variable in all modules and have the value set through cvs
> > > tagging magic.
> > > 
> > > What is the best and most CPAN friendly way this should be done?
> > > 
> > > -jason
> > > _______________________________________________
> > > Bioperl-l mailing list
> > > Bioperl-l@bioperl.org
> > > http://bioperl.org/mailman/listinfo/bioperl-l
> > > 
> > 
> > _______________________________________________
> > Bioperl-l mailing list
> > Bioperl-l@bioperl.org
> > http://bioperl.org/mailman/listinfo/bioperl-l
> > 
>