README for SVG.pm

SVG.pm is a perl extention to generate stand-alone or inline SVG 
(scaleable vector graphics) images using the W3C SVG xml recommendation.

Refer to the pod for full documentation and an example script, 
or to the following mirrors:

1/ http://roasp.com/man/SVG.html
2/ http://www.perlsvg.net/man/SVG.html
3/ http://www.roitsystems.com/man/SVG.html

The complete pod for SVG resides in SVG::Manual 
type perldoc SVG::Manual on the command line

(c) 2001,2002 Ronan Oger, RO IT Systems, GmbH 
homepage: http://www.roitsystems.com
ronan@cpan.org

This software is provided as is and without warranty. 
It is freely distributed under the general perl license.

OVERVIEW
--------
SVG.pm makes it possible to generate fully-functional SVG images in perl.
100% of the SVG tags are supported.

VERSION
-------
2.22 (24.06.02)

DOCUMENTATION
-------------
The following documentation is available:
POD in HTML format
pod in perldoc format (type perldoc SVG on command line)

RESOURCES
---------
The following URLs offer additional resources for users of SVG.pm:
* SVG.pm on-line manual http://roasp.com/man/SVG.html
* Perl SVG tutorials http://roasp.com/tutorial/
* Perl SVG Zone homepage http://roasp.com/
* example scripts using SVG.pm ftp://roasp.com/pub/SVG-2.1/examples/
* gallery of the use of SVG.pm on the web http://roasp.com/gallery/svg/index.html 

INSTALLATION INSTRUCTIONS
-------------------------
***THERE ARE FOUR WAYS TO IMPLEMENT SVG MODULE IN PERL***

	1/ Systems with CPAN support (all Unix/Linux/BSD/Mac):
	-----------------------------------------------------
	Install the new distribution via the Perl CPAN module:
	In a shell:
	/home/somewhere% perl -MCPAN -e"install SVG"

	2/ (WIN) install Perl from Active State or equivalent:
	-----------------------------------------------------
	Make sure you already have perl or get it here: http://www.activestate.com
	On the command line:
	 C:\> ppm
	 PPM> set repository tmp http://roasp.com/PPM/SVG/
	 PPM> install SVG
	 PPM> quit
	 C:\>

	3/ The hard way (requires make or nmake, tar, gunzip, and gcc):
	---------------------------------------------------------------
	This method was tested in DOS, Windows, AS400, Linux, Unix, BSD, Mac
	Hard-headed users can directly get the distribution from 
	ftp:/roasp.com/pub/SVG-2.1/
	First download the source.
	Then, in a shell:
	/home/somewhere% gunzip SVG-2.1.tar.gz
	/home/somewhere% tar-xvf SVG-2.1.tar
	cd SVG-2.1
	make
	make test
	make install


	4/ If all the above fail, there is still a (cumbersome) way:
	-----------------------------------------------------------
	You have to install to a local dirctory and explicitly call the module 
	by using one of the following line in your calling program:

	#using use lib
	use lib 'path/where/the/release/is/located';

	-or-

	#using BEGIN block at the beginning of the file
	BEGIN {
		push @INC 'path/to/svg.pm-file'; #where the SVG.pm file lives
		push @INC 'path/to/svg.pm-file/SVG'; # where the Utils.pm file lives
	}
	#Refer to the Perl manual for more details.

EXAMPLES:
--------
A set of examples is included in the distribution in directory ./examples.
Further examples are available from:
ftp://roasp.com/pub/SVG-2.1/examples/

KNOWN BUGS & ISSUES
-------------------
24.06.02
SVG
There are some issues with cdata() when the text string contains newline 
characters.
SVG::DOM is really a beta release.

SEE ALSO:
SVG::Parser
SVG::DOM
SVG::XML
SVG::Element

CHANGE LOG
----------
A poor version of the change history is available in the CHANGES file.