updated Cdrom and Event and SDL pods,
[sdlgit/SDL_perl.git] / lib / SDL / Cdrom.pm
index c70608f..9adc3ef 100644 (file)
@@ -1,12 +1,37 @@
-#      Cdrom.pm
+#!/usr/bin/env perl
 #
-#      a SDL cdrom manipluation module
+# Cdrom.pm
 #
-#      Copyright (C) 2000,2002 David J. Goehrig
+# Copyright (C) 2005 David J. Goehrig <dgoehrig@cpan.org>
+#
+# ------------------------------------------------------------------------------
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+# 
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+#
+# ------------------------------------------------------------------------------
+#
+# Please feel free to send questions, suggestions or improvements to:
+#
+#      David J. Goehrig
+#      dgoehrig@cpan.org
 #
 
 package SDL::Cdrom;
 use strict;
+use warnings;
+use Carp;
 
 BEGIN {
        use Exporter();
@@ -21,7 +46,7 @@ sub new {
        my $self;
        my $number = shift;
        $self = \SDL::CDOpen($number);
-       die SDL::GetError() if ( SDL::CD_ERROR() eq SDL::CDStatus($$self));
+       croak SDL::GetError() if ( SDL::CD_ERROR() eq SDL::CDStatus($$self));
        bless $self,$class;
        return $self;
 }
@@ -31,7 +56,7 @@ sub DESTROY {
        SDL::CDClose($$self);
 }
 
-sub CD_NUM_DRIVES {
+sub cd_num_drives {
        return SDL::CDNumDrives();
 }
 
@@ -130,7 +155,7 @@ SDL::Cdrom - a SDL perl extension for managing CD-ROM drives
 
 =item *
 
-C<CD_NUM_DRIVES>.
+C<cd_num_drives>.
 
 =back
 
@@ -144,7 +169,7 @@ whereas 0 is the first drive etc.
 
 =head1 METHODS
 
-=head2 CD_NUM_DRIVES()
+=head2 cd_num_drives()
 
 Returns the number of CD-ROM drives present.