From b756b21970026a2ccf88013e85053a0145828839 Mon Sep 17 00:00:00 2001
From: joey <joey>
Date: Fri, 27 Sep 2002 23:55:35 +0000
Subject: r552:    * The "reverse hangover" release.    * dh_strip: better
 documentation, removed extraneous "item" from SYNOPSIS.      Closes: #162493 
   * dh_strip: detect and don't strip debug/*.so files.    * Note that 4.1.11
 changelog entry was incorrect, dh_perl worked fine      without that change,
 but the new behavior is less likely to break things      if dpkg-gencontrol
 changes.    * Various improvements to debhelper(1).

---
 dh_strip | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

(limited to 'dh_strip')

diff --git a/dh_strip b/dh_strip
index ac51cd5e..7e04d749 100755
--- a/dh_strip
+++ b/dh_strip
@@ -12,7 +12,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-B<dh_strip> [S<I<debhelper options>>] [B<-X>I<item>] [item]
+B<dh_strip> [S<I<debhelper options>>] [B<-X>I<item>]
 
 =head1 DESCRIPTION
 
@@ -20,8 +20,17 @@ dh_strip is a debhelper program that is responsible for stripping
 executables, shared libraries, and static libraries that are not used for
 debugging.
 
-It assumes that files that have names like lib*_g.a are static libraries
-used in debugging, and will not strip them.
+This program examines your package build directories and works out what
+to strip on its own. It uses L<file(1)> and file permisions and filenames
+to figure out what files are shared libraries (*.so), executable binaries,
+and static (lib*.a) and debugging libraries (lib*_g.a, debug/*.so), and
+strips each as much as is possible. (Which is not at all for debugging
+libraries.) In general it seems to make very good guesses, and will do the
+right thing in almost all cases.
+
+Since it is very hard to automatically guess if a file is a
+module, and hard to determine how to strip a module, dh_strip does not
+currently deal with stripping binary modules such as .o files.
 
 =head1 OPTIONS
 
@@ -78,6 +87,9 @@ sub testfile {
 		return if ($fn=~m/\Q$f\E/);
 	}
 
+	# Is it a debug library in a debug subdir?
+	return if $fn=~m/debug\/.*\.so/;
+
 	# Does its filename look like a shared library?
 	if (m/.*\.so.*?/) {
 		# Ok, do the expensive test.
-- 
cgit v1.2.3