Install gimp-user-manual fails

[Baz]

Chatting to Raim tonight on #macports about a similar failure in
installing gtkspell2 I discovered another gotcha.

If you previously set XML_CATALOG_FILES and decided to get rid of it
by doing something like:
export XML_CATALOG_FILES=

... your builds will break. When libxml2 reads this with getenv it
doesnt get a null - it gets an empty string and tries to use that as
your list of catalogs to use. You actually have to unset
XML_CATALOG_FILES in your environment to get  things working again.

Might not be the problem for you David, but seems worth mentioning.

Also the way I diagnosed this may help you figure out whats going
wrong. libxml2 never prints out what catalog its going to use, so you
have to use ktrace to find out what it tried to access. In the case of
gtkspell2, I needed to cd into the docs dir and run:

ktrace -di -t cn /opt/local/bin/xsltproc --nonet --xinclude
--stringparam gtkdoc.bookname gtkspell --stringparam gtkdoc.version
1.8 /opt/local/share/gtk-doc/data/gtk-doc.xsl ../gtkspell-docs.sgmlset
; kdump 2>&1

After a bunch of junk, this prints out a name translation (NAMI) for
http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl
beside a stat() call. You'll see this happen twice in quick
succession. Immediately afterwards it should do another name
translatopm and stat on your default catalog. If instead you see a
third lookup for
http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl
then you have the empty catalog list problem I described above.

And for completeness: I found out what command it was running by
watching a verbose make fail on:
gtkdoc-mkhtml gtkspell ../gtkspell-docs.sgml

Then cd'ing to the same dir and running:
 sh -x `which gtkdoc-mkhtml` gtkspell ../gtkspell-docs.sgml

Hope this helps,
-Baz

On 13/06/07, David Rowe <david.rowe at freeuk.com> wrote:
> Boey Maun Suang wrote:
> > Hi David,
> >
> > It's possible that setting XML_CATALOG_FILES in your environment
> > wasn't working because of some environment sanitation somewhere along
> > the line in the installation of gimp-user-manual.
> >
> > This workaround, however, should no longer be necessary as of the
> > latest update to libxml2 (2.6.28, revision 1).  Try updating libxml2
> > _and_ libxslt (the latter seems to take its default catalog location
> > from the former), make sure that docbook-xsl is also up to date
> > (1.72.0), and let us know how you go.  Good luck!
> Thanks again for your help - but we don't seem to be there yet.
>
> I have tried updating libxml2 and this is now at 2.6.28_1
> I have tried updating libxslt and this is now at 1.1.20_0
> I have tried updating docbook-xsl and this is now at 1.72.0_0
>
> However I still can't install gimp-user-manual. Here is a typical attempt:
>
> <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
> $ sudo port clean --all gimp-user-manual
> --->  Cleaning gimp-user-manual
> $ sudo port install -dv gimp-user-manual
> --->  Fetching gimp-user-manual
> --->  Attempting to fetch gimp-help-2-0.12.tar.gz from
> ftp://ftp.gimp.org/pub/gimp/help/
> --->  Verifying checksum(s) for gimp-user-manual
> --->  Extracting gimp-user-manual
> --->  Configuring gimp-user-manual
> --->  Building gimp-user-manual with target all
> Error: Target com.apple.build returned: shell command " cd
> "/opt/local/var/db/dports/build/_opt_local_var_db_dports_sources_rsync.rsync.darwinports.org_dpupdate_dports_graphics_gimp-user-manual/work/gimp-help-2-0.12"
> && make all " returned error 2
> Command output: I/O error : Attempt to load network entity
> http://docbook.sourceforge.net/release/xsl/current/profiling/profile.xsl
> warning: failed to load external entity
> "http://docbook.sourceforge.net/release/xsl/current/profiling/profile.xsl"
> compilation error: file ../stylesheets/profile.xsl line 5 element import
> xsl:import : unable to load
> http://docbook.sourceforge.net/release/xsl/current/profiling/profile.xsl
> -- Validating XML for zh_CN     number of errors:        0
> *** Validating profiled XML ***
> Log files of the validation process have been generated in the xml
> directory.
> Please correct any errors before writing new content.
> *** Copying images ***
> Copying common images.
> Copying images for cs
> Copying images for de
> Copying images for en
> Copying images for es
> Copying images for fr
> Copying images for hr
> Copying images for it
> Copying images for ko
> Copying images for nl
> Copying images for no
> Copying images for ru
> Copying images for sv
> Copying images for zh_CN
> *** Copying stylesheets ***
> -- Building HTML for cs
> I/O error : Attempt to load network entity
> http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl
> warning: failed to load external entity
> "http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl"
> compilation error: file
> /opt/local/var/db/dports/build/_opt_local_var_db_dports_sources_rsync.rsync.darwinports.org_dpupdate_dports_graphics_gimp-user-manual/work/gimp-help-2-0.12/stylesheets/plainhtml.xsl
> line 7 element import
> xsl:import : unable to load
> http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl
> make: *** [stamps/html.cs.stamp] Error 5
>
> Error: Status 1 encountered during processing.
> $
>  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>
> Now, the above said on Line 19: "Log files of the validation process
> have been generated in the xml directory."
>
> I am not sure exactly what is meant by 'the xml directory' but there are
> a whole lot of relevant log entries in:
> /opt/local/var/db/dports/build/_opt_local_var_db_dports_sources_rsync.rsync.darwinports.org_dpupdate_dports_graphics_gimp-user-manual/work/gimp-help-2-0.12/xml
> such as file en-validity-errors.log (created at the right time)
>
> This says:
> <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
> xml/en.xml:1: parser error : Document is empty
>
> ^
> xml/en.xml:1: parser error : Start tag expected, '<' not found
>
> ^
>  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>
> Regards
>
> David Rowe
> _______________________________________________
> macports-users mailing list
> macports-users at lists.macosforge.org
> http://lists.macosforge.org/mailman/listinfo/macports-users
>