README
1DTDParse v2.00
2==============
3
4DTDParse is a tool for processing SGML and XML DTDs. The primary
5motivation for writing DTDParse was to provide a framework for
6building documentation for DTDs, but other applications are easy
7to imagine.
8
9Using DTDParse is a two-step process. First the DTD is parsed
10with 'dtdparse'. This produces an XML version of the DTD.
11Subsequent processing is performed against this XML version.
12
13More information about DTDParse is available in the SGML::DTDParse
14manual page.
15
16
17INSTALLATION
18
19To install this package type the following:
20
21 perl Makefile.PL
22 make
23 make test
24 make install
25
26You may need administrative priviledges to do the above.
27
28If you want to install in a separate location from perl's default,
29you can do something like the following:
30
31 perl Makefile.PL PREFIX=/path/to/install
32
33
34DOCUMENTATION
35
36Manpages are included in the DTDParse installation. They can
37be accessed like any other Perl module or command. For example,
38
39 perldoc SGML::DTDParse
40
41If you want to read the documentation before installation, you
42can generate HTML documentation by typing the following after
43running 'perl Makefile.PL' described above:
44
45 make htmldoc
46
47HTML documentation will be available in doc/html.
48
49
50DEPENDENCIES
51
52DTDParse modules and scripts require these other modules and libraries:
53
54Getopt::Long
55Text::DelimMatch
56XML::Parser
57XML::DOM
58
59For prerequisites that apply for a specific script or module,
60see the individual scripts' and modules' reference pages.
61
62
63COPYRIGHT AND LICENSE
64
65Copyright (C) 1999-2001, 2003 Norman Walsh
66 2005, Earl Hood
67
68DTDParse may be copied only under the terms of either the Artistic
69License or the GNU General Public License, which may be found in the
70DTDParse distribution.
71