Re: HeaderDoc 8.0 issue
Re: HeaderDoc 8.0 issue
- Subject: Re: HeaderDoc 8.0 issue
- From: Prachi Gauriar <email@hidden>
- Date: Fri, 9 Jul 2004 12:02:09 -0500
On Jul 9, 2004, at 6:18 AM, Bill Cheeseman wrote:
When I run my shell script phase to generate documentation using 8.0,
I see this message logged:
Old LibXML2 version. XML Output may not work correctly.
This surprises me, because my /usr folder contains a version of
LibXML2dated May 11, 2004. I suspect that this error message is
spurious -- or that, perhaps, Apple built HeaderDoc 8.0 using a future
version of Mac OS X.
First of all, I got this email three times. While I might have
understood two (Xcode and HeaderDoc), three is a bit much. Please
don't cross-post.
The version of libxml2 on Mac OS X is 2.6.7. If you look at line 81 of
Utilities.pm in the HeaderDoc source (in headerdoc-8.0/Modules),
you'll notice that it checks the version of libxml2 that xmllint is
using. If xmllint says it uses 2.6.7, HeaderDoc gives a warning
message and produces bad HTML/XML.
To solve this, you need to install a newer version libxml2 (the latest
is 2.6.11). I recommend installing using DarwinPorts
<http://darwinports.opendarwin.org>. You can always build it from
source <http://www.xmlsoft.org> manually, but I think DarwinPorts is
better.
If you do install it from DarwinPorts, you will need that library to
take precedence over the other one on your system. To do this, you
need to set the LD_LIBRARY_PATH and DYLD_LIBRARY_PATH environment
variables. If you use bash, the following lines need to go in your
.bashrc file:
LD_LIBRARY_PATH="/opt/local/lib:/usr/lib"
DYLD_LIBRARY_PATH=$LD_LIBRARY_PATH
For tcsh, the following lines need to go into your .tcshrc file:
setenv LD_LIBRARY_PATH "/opt/local/lib:/usr/lib"
setenv DYLD_LIBRARY_PATH $LD_LIBRARY_PATH
If you install libxml2 from source, you need to change opt to usr.
After making these changes, close and reopen your shell and you should
be good to go.
Anyway, that should fix the issue with the warning message and make
your HTML valid and XML well-formed. This should probably be
documented somewhere. I guess the archives will have to do for now.
-Prachi
_______________________________________________
xcode-users mailing list | email@hidden
Help/Unsubscribe/Archives: http://www.lists.apple.com/mailman/listinfo/xcode-users
Do not post admin requests to the list. They will be ignored.