From 8de13aed8707112c944d9546106bf5b0ec1f97ef Mon Sep 17 00:00:00 2001 From: Havoc Pennington Date: Sun, 22 Oct 2006 00:31:08 +0000 Subject: 2006-10-21 Havoc Pennington * Makefile.am (EXTRA_DIST): dist cleanup-man-pages.sh so it's in the tarball if packagers want to run it * cleanup-man-pages.sh: Add a script which munges all the internal API man pages out of the Doxygen output. This reduces the size of the installed man pages from 7 to 2 megs, and avoids namespace-polluting pages. Right now (like Doxygen) this script isn't in the build, it's something packagers can do manually. --- ChangeLog | 11 +++++++ Makefile.am | 3 +- cleanup-man-pages.sh | 86 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 99 insertions(+), 1 deletion(-) create mode 100755 cleanup-man-pages.sh diff --git a/ChangeLog b/ChangeLog index d8ccca0b..e86ec772 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,14 @@ +2006-10-21 Havoc Pennington + + * Makefile.am (EXTRA_DIST): dist cleanup-man-pages.sh so it's in + the tarball if packagers want to run it + + * cleanup-man-pages.sh: Add a script which munges all the internal + API man pages out of the Doxygen output. This reduces the size of + the installed man pages from 7 to 2 megs, and avoids + namespace-polluting pages. Right now (like Doxygen) this script + isn't in the build, it's something packagers can do manually. + 2006-10-21 Havoc Pennington * dbus/dbus-connection.h: don't include the watch/timeout diff --git a/Makefile.am b/Makefile.am index 118cbeea..f1101ed7 100644 --- a/Makefile.am +++ b/Makefile.am @@ -9,7 +9,8 @@ DISTCLEANFILES = \ EXTRA_DIST = \ HACKING \ - dbus-1.pc.in + dbus-1.pc.in \ + cleanup-man-pages.sh all-local: Doxyfile diff --git a/cleanup-man-pages.sh b/cleanup-man-pages.sh new file mode 100755 index 00000000..23e98a66 --- /dev/null +++ b/cleanup-man-pages.sh @@ -0,0 +1,86 @@ +#! /bin/sh + +## This script cleans up private/internal API from the man pages +## generated by Doxygen. This brings the man pages down from 7 megs +## to 2 megs and avoids namespace-polluting man pages. It's probably +## pretty specific to GNU utilities. Patches gladly accepted to make +## it work without them. + +## You would run this after building dbus and after running "doxygen +## Doxyfile" + +die() { + echo "$*" 1>&2 + exit 1 +} + +MANDIR=$1 +if test x"$MANDIR" = x ; then + MANDIR=doc/api/man/man3dbus +fi + +cd "$MANDIR" || die "Could not cd to $MANDIR" + +test -d keep || mkdir keep || die "Could not create $MANDIR/keep directory" +test -d nuke || mkdir nuke || die "Could not create $MANDIR/nuke directory" + +## blacklist +(find . -maxdepth 1 -name "_*" | xargs -I ITEMS /bin/mv ITEMS nuke) || die "could not move all underscore-prefixed items" +(find . -maxdepth 1 -name "DBus*Internal*" | xargs -I ITEMS /bin/mv ITEMS nuke) || die "could not move all internal-containing items" +(find . -maxdepth 1 -name "dbus_*_internal_*" | xargs -I ITEMS /bin/mv ITEMS nuke) || die "could not move all internal-containing items" + +## this is kind of unmaintainable, but I guess it's no huge disaster if we miss something. +## this list should only contain man pages with >1 line, i.e. with real content; the +## one-line cross-references get cleaned up next. +for I in DBusCounter.* DBusCredentials.* DBusDataSlot.* DBusDataSlotAllocator.* DBusDataSlotList.* \ + DBusDirIter.* DBusFakeMutex.* DBusFreedElement.* DBusGroupInfo.* DBusGUID.* DBusHashEntry.* \ + DBusHashIter.* DBusHashTable.* DBusHeader.* DBusHeaderField.* DBusKey.* DBusKeyring.* DBusList.* \ + DBusMarshal.* DBusMD5* DBusMemBlock.* DBusMemPool.* DBusMessageGenerator.* DBusMessageLoader.* \ + DBusMessageRealIter.* DBusObjectSubtree.* DBusObjectTree.* DBusPollFD.* DBusReal* \ + DBusResources.* DBusServerDebugPipe.* DBusServerSocket.* DBusServerUnix.* \ + DBusServerVTable.* DBusSHA.* DBusSHAContext.* DBusSignatureRealIter.* DBusStat.* DBusString.* \ + DBusSysdeps.* DBusSysdepsUnix.* DBusTimeoutList.* DBusTransport* DBusTypeReader* DBusTypeWriter* \ + DBusUserInfo.* DBusWatchList.* ; do + if test -f "$I" ; then + /bin/mv "$I" nuke || die "could not move $I to $MANDIR/nuke" + fi +done + +## many files just contain ".so man3dbus/DBusStringInternals.3dbus" or the like, +## if these point to something we nuked, we want to also nuke the pointer. +for I in * ; do + if test -f "$I" ; then + LINES=`wc -l "$I" | cut -d ' ' -f 1` + if test x"$LINES" = x1 ; then + REF_TO=`cat "$I" | sed -e 's/\.so man3dbus\///g'` + ## echo "$I points to $REF_TO" + if ! test -f "$REF_TO" ; then + /bin/mv "$I" nuke || die "could not move $I to $MANDIR/nuke" + fi + fi + fi +done + +## whitelist +(find . -maxdepth 1 -name "dbus_*" | xargs -I ITEMS /bin/mv ITEMS keep) || die "could not move all dbus-prefixed items" +(find . -maxdepth 1 -name "DBUS_*" | xargs -I ITEMS /bin/mv ITEMS keep) || die "could not move all DBUS_-prefixed items" +(find . -maxdepth 1 -name "DBus*" | xargs -I ITEMS /bin/mv ITEMS keep) || die "could not move all DBus-prefixed items" + +## everything else is assumed irrelevant, this is mostly struct fields +## from the public headers +(find . -maxdepth 1 -type f | xargs -I ITEMS /bin/mv ITEMS nuke) || die "could not move remaining items" + +NUKE_COUNT=`find nuke -type f -name "*" | wc -l` +KEEP_COUNT=`find keep -type f -name "*" | wc -l` +MISSING_COUNT=`find . -maxdepth 1 -type f -name "*" | wc -l` + +echo "$KEEP_COUNT man pages kept and $NUKE_COUNT man pages to remove" +echo "$MISSING_COUNT not handled" + +(find keep -type f -name "*" | xargs -I ITEMS /bin/mv ITEMS .) || die "could not move kept items back" + +rmdir keep || die "could not remove $MANDIR/keep" + +echo "Man pages to be installed are in $MANDIR and man pages to ignore are in $MANDIR/nuke" + +exit 0 -- cgit