Integrate:
authorNicholas Clark <nick@ccl4.org>
Mon, 17 Nov 2008 22:34:48 +0000 (22:34 +0000)
committerNicholas Clark <nick@ccl4.org>
Mon, 17 Nov 2008 22:34:48 +0000 (22:34 +0000)
[ 34866]
Integrate:
[ 34859]
Add a $VERSION, strict and some documentation to Tie::StdHandle.
p4raw-link: @34866 on //depot/maint-5.10/perl: c0c8dc5dc601849478243a987dd73642f4741b97
p4raw-link: @34859 on //depot/perl: d10ced8a0718a50590450dfb6f8db4eb7511a2e4

p4raw-id: //depot/maint-5.8/perl@34875
p4raw-integrated: from //depot/maint-5.10/perl@34872 'copy in'
lib/Tie/StdHandle.pm (@32694..)

lib/Tie/StdHandle.pm

index 93db289..3a1a3db 100644 (file)
@@ -1,8 +1,39 @@
 package Tie::StdHandle; 
 
+use strict;
+
 use Tie::Handle;
-our @ISA = 'Tie::Handle';
-use Carp;
+use vars qw(@ISA $VERSION);
+@ISA = 'Tie::Handle';
+$VERSION = '4.2';
+
+=head1 NAME
+
+Tie::StdHandle - base class definitions for tied handles
+
+=head1 SYNOPSIS
+
+    package NewHandle;
+    require Tie::Handle;
+
+    @ISA = qw(Tie::Handle);
+
+    sub READ { ... }           # Provide a needed method
+    sub TIEHANDLE { ... }      # Overrides inherited method
+
+
+    package main;
+
+    tie *FH, 'NewHandle';
+
+=head1 DESCRIPTION
+
+The B<Tie::StdHandle> package provide most methods for file handles described
+in L<perltie> (the exceptions are C<UNTIE> and C<DESTROY>).  It causes tied
+file handles to behave exactly like standard file handles and allow for
+selective overwriting of methods.
+
+=cut
 
 sub TIEHANDLE 
 {