NAME

Business::Travel::OTA::installguide::xerces - Installation Guide for the XML::Xerces

INTRODUCTION

This is the Installation Guide to XML::Xerces.

XML::Xerces is a perl module built on top of the (Apache) Xerces C libraries (Xerces-C). It has full-featured XML parsing, validation, XPath, and construction capabilities.

You can find out more background on the project on the web.

  http://xerces.apache.org/xerces-p/                      # XML::Xerces for Perl
  http://xml.apache.org/xerces-c/                         # Xerces-C overview page
  http://xml.apache.org/xerces-c/install.html             # installation instructions
  http://xml.apache.org/xerces-c/download.cgi             # download page
  http://xml.apache.org/xerces-c/build.html               # build overview
  http://xml.apache.org/xerces-c/build-winunix.html#UNIX  # build from source on Unix
  http://xml.apache.org/xerces-c/apiDocs/index.html       # C/C++ API documentation
  http://xml.apache.org/xerces-c/program.html             # Xerces programming guide

There is not much explicit documentation for the Perl API. However, it follows the C API very closely, and there is good documentation for the C API.

The following are installation notes from specific successful attempts to install the software.

INSTALLATION

Xerces 2.7.0 from Source (gcc-3.3.4) on Linux (Gentoo 3.3.4-r1) (2006-04-19)

Followed instructions at

  http://xerces.apache.org/xerces-p/
  http://xml.apache.org/xerces-c/build-winunix.html#UNIX

Downloaded Xerces C.

  su -   # you must be root for some of the following operations (to install in system places)
  cd /usr/local/src
  mkdir tar
  wget -O tar/xerces-c-current.tar.gz http://www.apache.org/dist/xml/xerces-c/xerces-c-current.tar.gz
  tar xvzf tar/xerces-c-current.tar.gz

Built Xerces C according to the source compilation instructions.

  cd xerces-c-src_2_7_0
  export XERCESCROOT=/usr/local/src/xerces-c-src_2_7_0
  cd $XERCESCROOT/src/xercesc
  autoconf
  ./runConfigure -plinux -cgcc -xg++ -minmem -nsocket -tnative -rpthread
  make
  ls -l $XERCESCROOT/lib
  make install
  ls -l /usr/local/lib/libxerces*
  cp -r $XERCESCROOT/include/xercesc /usr/local/include/xercesc

Built XML::Xerces (perl) according to the compilation instructions, by downloading off of CPAN.

  export XERCES_INCLUDE=/usr/local/include
  export XERCES_LIB=/usr/local/lib
  perl -MCPAN -e "install XML::Xerces"

That's it. It worked. Please note that I have included the exact sequence of commands that worked for me. These represent some slight differences from what is documented on the Xerces website.

ACKNOWLEDGEMENTS

 * Author:  Stephen Adkins <sadkins@therubicongroup.com>
 * Copyright: (c) 2006 Stephen Adkins (for the purpose of making it Free)
 * License: This is free software. It is licensed under the same terms as Perl itself.

SEE ALSO

<Business::Travel::OTA::installguide>