This is the beginnings of a Xerces.pm FAQ

Maintainer: Jason E. Stewart

Version: $Id: FAQ,v 1.3 2001/11/03 05:24:42 jasons Exp $

A. General Info
===============
A.1 Where is the xerces-p-dev mailing list archive

  - A good place for list archives is MARC (http://marc.theaimsgroup.com/). 
    They archive both xerces-p-dev and xerces-c-dev

A.2 Where can I find documentation for Xerces.pm

  - Currently Xerces.pm has little perl-specific documentation, I'm
    sorry to say. Xerces-C has detailed API documentation that is
    automatically generated from its header files using Doxygen. These
    can be found at http://xml.apache.org/xerces-c/apiDocs/index.html
    For more information on using Xerces.pm, look at the examples in
    the samples/ directory, and the tests in the t/ directory, and
    read the section on perl-specific API issues in the
    README. Volunteers are welcome to help improve this flaw.

B. Building Xerces.pm
=====================
B.1 I get an undefined symbol error, __eh_alloc, when I compile
    Xerces.so on NetBSD.

  - This is because libgcc.a, which defines __eh_alloc, is not
    compiled PIC under NetBSD, and when it was statically linked into
    perl, the linker only included the symbols need by perl at link
    time. To solve this, perl needs to be recompiled, specifying the
    -whole-archive linker option for libgcc. For example:

    c++ -Wl,-export-dynamic -Wl,-whole-archive -lgcc -Wl,-no-whole-archive \
        -L/usr/pkg/lib -Wl,-E -Wl,-R/usr/pkg/lib -o perl perlmain.o        \   
        lib/auto/DynaLoader/DynaLoader.a  libperl.a `cat ext.libs`         \   
        -lm -lcrypt

B.2 How do I build Xerces.pm on architecture Foo

  - see PORTS for details on getting Xerces.pm to build for your system 

B.3 I get iostream errors when I compile

  - Some gcc installations need -DHAS_BOOL to compile and others will
    fail if it is defined. Trying adding/removing -DHAS_BOOL from
    $CFLAGS in Makefile.PL.

C. Unicode Support
==================
C.1 Why do a bunch of tests fail in t/IDOM_Document.t?

  - If they are 206..267, try setting your LC_CTYPE environment
    variable to something besides the default value of "C", such as:

C.2 Why do a bunch of tests fail in t/UTF8.t?

    export LC_CTYPE=en_US

  - Otherwise, are you using Perl-5.6.0 or greater?
