1README for SVG.pm
2
3SVG.pm is  a  perl  extension  to  generate  standalone  or inline SVG (short for
4"Scalable Vector Graphics") images using the W3C's SVG XML recommendation.
5
6Refer to the POD documentation for full documentation and an example script or to
7the following mirror:
8
9    https://metacpan.org/module/SVG
10
11The complete  POD  documentation  for SVG resides in the SVG module itself - type
12"perldoc SVG" on the command line.
13
14(c) 2001-2008  Ronan Oger, RO IT Systems,
15GmbH homepage: http://www.roitsystems.com
16
17CONTACT POINT
18-------------
19
20szabgab@cpan.org
21
22This software  is  provided  as is and without warranty. It is freely distributed
23under the general perl license.
24
25LICENSE
26-------
27
28This software is provided under the terms of the Perl license
29
30OVERVIEW
31--------
32
33SVG.pm makes it possible to generate fully-functional SVG images in perl. 100% of
34the SVG tags  are  supported,  and  any new arbitrary element tag can be added by
35users by declaring it.
36
37DOCUMENTATION
38-------------
39
40The following documentation is available:
41
42* POD in perldoc format (type "perldoc SVG" on the command line.)
43
44RESOURCES
45---------
46
47The following URLs offer additional resources for users of SVG.pm:
48
49* Perl SVG tutorials http://www.roitsystems.com/tutorial/
50* Perl SVG Zone homepage http://www.roitsystems.com/
51* gallery of the use of SVG.pm on the web http://roitsystems.com/gallery/svg/index.html
52* W3 Consortium http://www.w3.org/Graphics/SVG/
53* Sams Publishing, "SVG Unleashed", September 2002. There is a Perl chapter
54* SVG Open Conference proceedings http://www.svgopen.org/
55
56INSTALLATION INSTRUCTIONS
57-------------------------
58
59***THERE ARE FOUR WAYS TO INSTALL THE SVG MODULE IN PERL***
60
611) Systems with CPAN support (all Windows/Unix/Linux/BSD/Mac):
62   -----------------------------------------------------------
63
64   Install the new distribution via the Perl CPAN module:
65   In a shell:
66
67   /home/somewhere% cpan install SVG
68
69   You can alternatively use CPANPLUS or cpanm.
70
712) (Windows) install Perl from ActiveState:
72   ----------------------------------------
73
74   Make sure you already have perl or get it here: http://www.activestate.com
75   On the command line:
76
77   C:\> ppm install SVG
78
79
803) Use RPMs:
81   ---------
82
83   Download the source RPM of your choice.
84   In a shell:
85
86   /hom/somewhere/% rpm -ihv SVG-source-rpm-name
87   You may be prompted for the root password
88
894) The hard way (requires make, dmake or nmake, tar, gunzip, and gcc):
90   -------------------------------------------------------------------
91
92   This method was tested in DOS, Windows, AS400, Linux, Unix, BSD, Mac.
93   Hard-headed users can directly get the distribution from a CPAN mirror.
94   First download the source.
95   Then, in a shell:
96
97   /home/somewhere% gunzip SVG-2.27.tar.gz
98   /home/somewhere% tar-xvf SVG-2.27.tar
99   cd SVG-2.1
100   make
101   make test
102   make install
103
104KNOWN BUGS & ISSUES
105-------------------
106
107Comments tags before the <svg> element are toxic. This is being worked on but I
108can not promise anything.
109
110Please submit bug reports to http://rt.cpan.org
111
112SEE ALSO
113--------
114
115SVG::Parser
116SVG::DOM
117SVG::XML
118SVG::Element
119
120CHANGE LOG
121----------
122
123You can find details about the changes over time in the change log file: Changes
124
125COMMENTS/FEEDBACK
126-----------------
127
128Please email your feedback, comments, questions to the email address at the top
129of this document. I will do my best to answer promptly. To date, I have not
130knowingly failed to answer any emails.
131