/
README
64 lines (45 loc) · 2.37 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
Rcs::Parser - Parse and analyze RCS files - vVERSIONTAG
================================================================================
SYNOPSIS
================================================================================
A basic RCS parser. This file does not rely upon any external utilities
to parse RCS files. Currently it functions with RCS files generated by
GNU CVS and as documented by the rcsfile(5) man page.
================================================================================
MODULE INSTALLATION
================================================================================
To install this module type the following:
perl Makefile.PL
make
make test
make install
================================================================================
USAGE
================================================================================
Refer to the module's POD for detailed usage.
================================================================================
KNOWN ISSUES
================================================================================
Beta Code:
This code is beta. It has yet to fully understand binary formats stored
in RCS and will treat them as text. Consquently, you'll see warnings.
That being said, there shouldn't be any large scale bugs that will cause
segfaulting or crashing. Only warnings.
The RCS file format:
There is an astounding lack of good documentation of the RCS format.
About the only thing that can be found is the rcsfile(5) man page. The
layout is mostly reverse engineered in this module. I have yet to have
the time, or the skill and patience to disassemble the RCS portions of
the code for GNU CVS.
================================================================================
ERATTA
================================================================================
Q: Why 'Rcs' and not 'RCS'
A: Because the any directory named 'RCS' is usually ignored by most
versioning software and some developer tools.
================================================================================
AUTHORSHIP
================================================================================
Rcs::Parser vVERSIONTAG (DATETAG)
(c) 2001-YEARTAG, Phillip Pollard <bennie@cpan.org>
Released under the Perl Artistic License