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://search.cpan.org/perldoc?SVG
2/ http://search.cpan.org/~ronan

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

(c) 2001-2008  Ronan Oger, RO IT Systems, GmbH  
homepage: http://www.roitsystems.com

CONTACT POINT
-------------

ronan@cpan.org

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

LICENSE
-------

This software is provided under the terms of the Perl license

OVERVIEW
--------
SVG.pm makes it possible to generate fully-functional SVG images in perl.
100% of the SVG tags are supported, and any new arbitrary element tag can be
added by users by declaring it.

VERSION
-------
2.33 Sunday, 2005.05.15

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:
* Serverside Perl Forum: http://www.roitsystems.com/serverside/
* SVG.pm on-line manual http://www.roitsystems.com/man/SVG.html
* Perl SVG tutorials http://www.roitsystems.com/tutorial/
* Perl SVG Zone homepage http://www.roitsystems.com/
* gallery of the use of SVG.pm on the web http://roitsystems.com/gallery/svg/index.html 
* SVG Foundation http://www.svgfoundation.org
* SVG Developers mailing list http://www.yahoogroups.com/svg-developers/
* W3 Consortium http://www.w3.org
* Sams Publishing, "SVG Unleashed", September 2002. There is a Perl chapter
* SVG Open Conference proceedings http://www.svgopen.org
* SVG foundation http://www.svgfoundation.org
* SVG dot org http://www.svg.org
INSTALLATION INSTRUCTIONS
-------------------------
***THERE ARE FIVE 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://roitsystems.com/PPM/SVG/
	 PPM> install SVG
	 PPM> quit
	 C:\>

	3/ Use Source RPMs.
	Download the source RPM of your choice.
	In a shell:
	/hom/somewhere/% rpm -ihv SVG-source-rpm-name
	You may be prompted for the root password

	4/ 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 
	http://www.roitsystems.com/PPM/SVG/SVG-2.27.tar.gz or 
	http://www.roitsystems.com/PPM/SVG/ .
	First download the source.
	Then, in a shell:
	/home/somewhere% gunzip SVG-2.27.tar.gz
	/home/somewhere% tar-xvf SVG-2.27.tar
	cd SVG-2.1
	make
	make test
	make install


	5/ 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.


KNOWN BUGS & ISSUES
-------------------
Comments tags before the <svg> element are toxic. This is being worked on but I can not promise anything.

Please submit bug reports to http://rt.cpan.org

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

CHANGE LOG
----------
You can find details about the changes over time in the change log file: Changes

COMMENTS/FEEDBACK
-----------------
Please email your feedback, comments, questions to the email address at the top
of this document. I will do my best to answer promptly. To date, I have not
knowingly failed to answer any emails.
