gtk-doc stable port information

Package: gtk-doc
Version: 1.18
Revision: 1
BuildDepends: <<
gettext-tools,
gnome-doc-utils (>= 0.20.0-1),
libxml2 (>= 2.7.8-1),
libxslt (>= 1.1.26-1),
pkgconfig (>= 0.25)
<<
Depends: <<
docbook-dtd (>= 4.2.0-2),
docbook-xsl (>= 1.62.4-2),
docbook-dsssl-nwalsh (>= 1.78-2),
dpkg-base-files,
libxml2-bin (>= 2.7.8-1),
libxslt-bin (>= 1.1.16-1),
openjade (>= 1.3.2-1029),
rarian-compat
<<
Conflicts: liboil-0.3 (<< 0.3.16-2), libcamel-1.2.14-dev (<< 2.26.3-2)
Replaces: liboil-0.3 (<< 0.3.16-2), libcamel-1.2.14-dev (<< 2.26.3-2)
InfoTest: <<
TestDepends: <<
coreutils,
glib2-dev (>= 2.22.0-1),
libgettext8-dev
<<
TestScript: make check || exit 2
<<
Source: mirror:gnome:sources/%n/%v/%n-%v.tar.bz2
Source-MD5: ff878f315c3187c81adaf67d690c19aa
Source2: mirror:debian:pool/main/g/gtk-doc/%n_1.18-1.debian.tar.gz
Source2-MD5: 1c45610b215c1f6152559d351d981c51
PatchFile: %n.patch
PatchFile-MD5: 58f1ba7d4e0b84815d7a37dd8d7799ba
PatchScript: <<
#!/bin/sh -ev
%{default_script}
perl -pi -e 's,/usr/share/doc/gtk-doc-tools,%p/share/doc/%n,g' ../debian/*.1
perl -pi -e 's/`date/`gdate/g' tests/*/*/Makefile.in
<<
ConfigureParams: --with-xml-catalog=%p/etc/xml/catalog --disable-dependency-tracking --disable-scrollkeeper --disable-static PERL=/usr/bin/perl PYTHON=/usr/bin/python ac_cv_path_DBLATEX="" ac_cv_path_FOP="" --with-highlight=vim HIGHLIGHT=/usr/bin/vim
CompileScript: <<
./configure %c
make
<<
InstallScript: <<
make install DESTDIR=%d
install -d -m 755 %i/share/doc/%n/doc
install -d -m 755 %i/share/doc/%n/examples
install -c -m 644 doc/* %i/share/doc/%n/doc/
install -c -m 644 examples/* %i/share/doc/%n/examples/
mkdir -p %i/share/man/man1
cp ../debian/*.1 %i/share/man/man1
<<
PostInstScript: <<
if [ configure = "$1" ]; then
scrollkeeper-update -q
fi
<<
PostRmScript: <<
if [ remove != "$1" ]; then
scrollkeeper-update -q
fi
<<
DocFiles: AUTHORS COPYING COPYING-DOCS ChangeLog MAINTAINERS NEWS README TODO
Description: GTK+ - API documentation generator
DescDetail: <<
gtk-doc is a set of perl scripts that generate API reference documention in
DocBook format. It can extract documentation from source code comments in a
manner similar to java-doc. It is used to generate the documentation for
GLib, Gtk+, and GNOME.
<<
License: GPL
Maintainer: The Gnome Core Team
DescPackaging: <<
Formerly maintained by Masanori Sekino and Michele Garoche.
Added libxslt-bin to Depends in order to get xsltproc, otherwise some
packages fail to build.
Customized docbook-to-man, and tools not installed
Apple's perl and python are sufficient, so make sure they are used
Patch programs to avoid needing glib2-dev at runtime

Install manpages for command-line programs (from debian)

glib is used for self-tests only. Good thing, since gtk-doc is
a BDep of glib2, gotta avoid dep-cycle!

Disable PDF generator (avoid tetex dependency pile)

Use OS X vim--sufficient for syntax-highlighting format
without pile of dependencies. May get built-in eventually. See
https://bugzilla.gnome.org/show_bug.cgi?id=567135

Hardcode glib's prefix rather than querying glib via
pkg-config (otherwise need Requires:glib2-dev)

liboil-0.3 prior to 0.3.16-2 installed a gtk-doc doc file that
published the NULL token. Any gtk-doc doc file built with this
old liboil installed will have its NULL symbol linked to
liboil's gtk-doc doc file instead of leaving it alone as a
external entity. This was fixed in liboil-0.3 0.3.16-2 and now
gtk-doc >= 1.13-4 conflicts/replaces the buggy old liboil so
that everything Just works.
Likewise had libcamel-1.2.14-dev published gettext symbols
prior to 2.26.3-2, so gtk-doc >= 1.13-5 does the same game
with that old one.
Packages can
BDep: gtk-doc (>= 1.13-5)
and know that these packages' incorrectly-public items will
not contaminate gtk-doc documentation: gtk-doc will
automatically uninstall those old things, and if user needs
those packages, the more recent versions can be installed with
no problem as usual.

NOTE: some warnings during self-tests and/or doc generation
perhaps at least in part because don't have latest glib
available yet (would be circular dependency to require it)

testing uses gnu extensions of `date`. See:
https://bugzilla.gnome.org/show_bug.cgi?id=671519
<<
Homepage: http://www.gtk.org/gtk-doc/

gtk-doc stable port .patch

diff -Nurd -x'*~' gtk-doc-1.18.orig/gtkdoc-depscan.in gtk-doc-1.18/gtkdoc-depscan.in
--- gtk-doc-1.18.orig/gtkdoc-depscan.in 2011-08-03 08:25:53.000000000 -0400
+++ gtk-doc-1.18/gtkdoc-depscan.in 2012-01-09 14:39:43.000000000 -0500
@@ -262,7 +262,7 @@
path = path and path.split(':') or []

prefix = popen(
- 'pkg-config --variable=prefix glib-2.0'
+ '@prefix@'
).readline().rstrip()

path.insert(0, prefix)
diff -Nurd -x'*~' gtk-doc-1.18.orig/gtkdoc-fixxref.in gtk-doc-1.18/gtkdoc-fixxref.in
--- gtk-doc-1.18.orig/gtkdoc-fixxref.in 2011-08-19 09:10:14.000000000 -0400
+++ gtk-doc-1.18/gtkdoc-fixxref.in 2012-01-09 14:39:43.000000000 -0500
@@ -109,7 +109,7 @@

# We scan the directory containing GLib and any directories in GNOME2_PATH
# first, but these will be overriden by any later scans.
-$dir = `pkg-config --variable=prefix glib-2.0`;
+$dir = '@prefix@';
$dir =~ s/\s+$//;
$dir = $dir . "/share/gtk-doc/html";
if (-d $dir && $dir ne $HTML_DIR) {
diff -Nurd -x'*~' gtk-doc-1.18.orig/gtkdoc-rebase.in gtk-doc-1.18/gtkdoc-rebase.in
--- gtk-doc-1.18.orig/gtkdoc-rebase.in 2011-06-17 04:39:37.000000000 -0400
+++ gtk-doc-1.18/gtkdoc-rebase.in 2012-01-09 14:39:43.000000000 -0500
@@ -108,7 +108,7 @@
}
}

-$dir = `pkg-config --variable=prefix glib-2.0`;
+$dir = '@prefix@';
$dir =~ s/^\s*(\S*)\s*$/$1/;
$dir = $dir . "/share/gtk-doc/html";
print "Prepending GLib directory $dir\n" if $VERBOSE;

gtk-doc _unstable_ port .patch