Subject: | something very amiss or (most likely) documentation bug |
Summary: XML::LibXML::Document cannot be 'use'd because it's not a .pm =]
XML-LibXML-1.40.tar.gz
Linux finster 2.4.7-10 #1 Thu Sep 6 17:27:27 EDT 2001 i686 unknown
Summary of my perl5 (revision 5.0 version 6 subversion 1) configuration:
Platform:
osname=linux, osvers=2.4.17-0.13smp, archname=i386-linux
uname='linux daffy.perf.redhat.com 2.4.17-0.13smp #1 smp fri feb 1 10:30:48 est 2002 i686 unknown '
config_args='-des -Doptimize=-O2 -march=i386 -mcpu=i686 -Dcc=gcc -Dcf_by=Red Hat, Inc. -Dcccdlflags=-fPIC -Dinstallprefix=/usr -Dprefix=/usr -Darchname=i386-linux -Uusethreads -Uuseithreads -Uuselargefiles -Dd_dosuid -Dd_semctl_semun -Di_db -Di_ndbm -Di_gdbm -Di_shadow -Di_syslog -Dman3ext=3pm -Dlocincpth='
hint=recommended, useposix=true, d_sigaction=define
usethreads=undef use5005threads=undef useithreads=undef usemultiplicity=undef
useperlio=undef d_sfio=undef uselargefiles=undef usesocks=undef
use64bitint=undef use64bitall=undef uselongdouble=undef
Compiler:
cc='gcc', ccflags ='-fno-strict-aliasing -I/usr/local/include',
optimize='-O2 -march=i386 -mcpu=i686',
cppflags='-fno-strict-aliasing -I/usr/local/include'
ccversion='', gccversion='2.96 20000731 (Red Hat Linux 7.1 2.96-98)', gccosandvers=''
intsize=4, longsize=4, ptrsize=4, doublesize=8, byteorder=1234
d_longlong=define, longlongsize=8, d_longdbl=define, longdblsize=12
ivtype='long', ivsize=4, nvtype='double', nvsize=8, Off_t='off_t', lseeksize=4
alignbytes=4, usemymalloc=n, prototype=define
Linker and Libraries:
ld='gcc', ldflags =' -L/usr/local/lib'
libpth=/usr/local/lib /lib /usr/lib
libs=-lnsl -ldl -lm -lc -lcrypt -lutil
perllibs=-lnsl -ldl -lm -lc -lcrypt -lutil
libc=/lib/libc-2.2.4.so, so=so, useshrplib=false, libperl=libperl.a
Dynamic Linking:
dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef, ccdlflags='-rdynamic'
cccdlflags='-fPIC', lddlflags='-shared -L/usr/local/lib'
Characteristics of this binary (from libperl):
Compile-time options:
Built under linux
Compiled at Feb 20 2002 15:01:16
@INC:
/usr/lib/perl5/5.6.1/i386-linux
/usr/lib/perl5/5.6.1
/usr/lib/perl5/site_perl/5.6.1/i386-linux
/usr/lib/perl5/site_perl/5.6.1
/usr/lib/perl5/site_perl/5.6.0/i386-linux
/usr/lib/perl5/site_perl/5.6.0
/usr/lib/perl5/site_perl
.
Name : libxml2-devel Relocations: /usr
Version : 2.4.10 Vendor: Red Hat, Inc.
Release : 0.7x.2 Build Date: Tue 13 Nov 2001 11:27:18 AM EST
Install date: Sun 17 Mar 2002 06:36:10 PM EST Build Host: stripples.devel.redhat.com
Group : Development/Libraries Source RPM: libxml2-2.4.10-0.7x.2.src.rpm
Size : 3164586 License: LGPL
Packager : Red Hat, Inc. <http://bugzilla.redhat.com/bugzilla>
URL : http://xmlsoft.org/
Summary : Libraries, includes, etc. to develop XML and HTML applications
=================Now to the bug
=================
perldoc XML::LibXML::Document
NAME
XML::LibXML::Document - DOM Document Class
SYNOPSIS
use XML::LibXML::Document;
$dom = XML::LibXML::Document->new( $version, $encoding );
$dom = XML::LibXML::Document->createDocument( $version, $encoding );
$strEncoding = $doc->getEncoding();
$strVersion = $doc->getVersion();
$docstring = $dom->toString([$format]);
$document->toStringHTML();
$bool = $dom->is_valid();
$dom->validate();
$root = $dom->getDocumentElement($name, $namespace );
$root = $dom->documentElement;
$dom->setDocumentElement( $root );
$element = $dom->createElement( $nodename );
$element = $dom->createElementNS( $namespaceURI, $qname );
$text = $dom->createTextNode( $content_text );
$comment = $dom->createComment( $comment_text );
$attrnode = $doc->createAttribute($name [,$value]);
$fragment = $doc->createDocumentFragment()
$attrnode = $doc->createAttributeNS( namespaceURI, $name [,$value] );
$cdata = $dom->create( $cdata_content );
$document->importNode( $node [, $move] );
As far as I know it is not possible to 'use' a module that does not exist =]. So, to reproduce this "bug":
% perl -mXML::LibXML::Document
Can't locate XML/LibXML/Document.pm in @INC (@INC contains: /usr/lib/perl5/5.6.1/i386-linux /usr/lib/perl5/5.6.1 /usr/lib/perl5/site_perl/5.6.1/i386-linux /usr/lib/perl5/site_perl/5.6.1 /usr/lib/perl5/site_perl/5.6.0/i386-linux /usr/lib/perl5/site_perl/5.6.0 /usr/lib/perl5/site_perl .).
BEGIN failed--compilation aborted.
What you really mean is:
$ perl -mXML::LibXML -MData::Dumper -e 'print Dumper(XML::LibXML::Document->new())'
$VAR1 = bless( do{\(my $o = 135844216)}, 'XML::LibXML::Document' );
So, we have a documentation bug, a fuckup, or I'm missing something ;p