Debian Codegraph @

README

raw
1 FileHandle::Unget - A FileHandle which supports ungetting of multiple bytes
2
3 FileHandle::Unget is a drop-in replacement for FileHandle which allows more
4 than one byte to be placed back on the input. It supports an ungetc(ORD) which
5 can be called more than once in a row, and an ungets(SCALAR) which places a
6 string of bytes back on the input.
7
8
9 MODULE DEPENDENCIES
10
11 To use this module, you will need to install:
12
13 - Scalar::Util
14
15 To test this module, you will need to install:
16
17 - Test::More
18 - File::Spec
19
20
21 INSTALLATION
22
23 To install this package, change to the directory where you unarchived this
24 distribution and type the following:
25
26 perl Makefile.PL
27 make
28 make test
29 make install
30
31 You can install this package into a non-default location by appending one of
32 the following to the "perl Makefile.PL" command:
33
34 - "PREFIX=/installation/path" (for installation into a custom location),
35 - "INSTALLDIRS=site" (for installation into site-specific Perl directories)
36 - "INSTALLDIRS=perl" (for installation into standard Perl directories).
37
38 If you make the installation into your own directory, then remember that you
39 must tell perl where to search for modules before trying to 'use' them. For
40 example:
41
42 use lib '/home/userid/lib';
43 use FileHandle::Unget;
44
45 If make test fails, please see the INSTALLATION PROBLEMS section below.
46
47
48 INSTALLATION PROBLEMS
49
50 If you get warnings about weak references not being implemented in your
51 version of Perl, try upgrading your installation of Scalar::Util.
52
53 If "make test" fails, run
54
55 make test TEST_VERBOSE=1
56
57 and see which test(s) are failing. Please email the results to the address
58 below, or submit a bug report on the project website as described in the
59 section REPORTING BUGS below.
60
61 For other bugs, see the section REPORTING BUGS below.
62
63
64 SECURITY NOTE
65
66 On Windows, this module will use a temporary file to decompress a file handle
67 when necessary. This could pose a security risk.
68
69
70 DOCUMENTATION
71
72 Just "perldoc FileHandle::Unget". After installation on Unix systems,
73 you can also do "man FileHandle::Unget".
74
75
76 RESOURCES
77
78 The CPAN Page:
79 http://search.cpan.org/dist/FileHandle-Unget/
80
81 The GitHub page:
82 https://github.com/coppit/filehandle-unget/
83
84 Bug and feature tracking:
85 http://rt.cpan.org/Public/Dist/Display.html?Name=FileHandle-Unget
86
87
88 COPYRIGHT
89
90 Copyright (c) 1998-Sep 1 2000 Broc Seib. Copyright (c) Sep 1 2000-2015 David
91 Coppit. All rights reserved, save those granted by the license. See the file
92 LICENSE for licensing terms.
93
94
95 AUTHOR
96
97 David Coppit <[email protected]>