From: Nicholas Clark <nick@ccl4.org>
Date: Sun, 16 Nov 2008 23:05:35 +0000 (+0000)
Subject: Add a $VERSION, strict and some documentation to Tie::StdHandle.
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=d10ced8a0718a50590450dfb6f8db4eb7511a2e4;p=p5sagit%2Fp5-mst-13.2.git

Add a $VERSION, strict and some documentation to Tie::StdHandle.

p4raw-id: //depot/perl@34859
---

diff --git a/lib/Tie/StdHandle.pm b/lib/Tie/StdHandle.pm
index 93db289..3a1a3db 100644
--- a/lib/Tie/StdHandle.pm
+++ b/lib/Tie/StdHandle.pm
@@ -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 
 {