From owner-freebsd-doc@FreeBSD.ORG Fri Nov 5 01:40:09 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 96D991065672 for ; Fri, 5 Nov 2010 01:40:09 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 539E08FC13 for ; Fri, 5 Nov 2010 01:40:09 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id oA51e9Um009222 for ; Fri, 5 Nov 2010 01:40:09 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id oA51e9fw009221; Fri, 5 Nov 2010 01:40:09 GMT (envelope-from gnats) Resent-Date: Fri, 5 Nov 2010 01:40:09 GMT Resent-Message-Id: <201011050140.oA51e9fw009221@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Sunpoet Po-Chuan Hsieh Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BAE01106566B for ; Fri, 5 Nov 2010 01:33:09 +0000 (UTC) (envelope-from sunpoet@sunpoet.net) Received: from mail-gx0-f182.google.com (mail-gx0-f182.google.com [209.85.161.182]) by mx1.freebsd.org (Postfix) with ESMTP id 7F1B38FC1F for ; Fri, 5 Nov 2010 01:33:09 +0000 (UTC) Received: by gxk9 with SMTP id 9so1977186gxk.13 for ; Thu, 04 Nov 2010 18:33:08 -0700 (PDT) Received: by 10.150.158.16 with SMTP id g16mr2439892ybe.242.1288920787897; Thu, 04 Nov 2010 18:33:07 -0700 (PDT) Received: from sunpoet.net (sunpoet.net [220.133.12.240]) by mx.google.com with ESMTPS id q4sm2060737yba.2.2010.11.04.18.33.05 (version=TLSv1/SSLv3 cipher=RC4-MD5); Thu, 04 Nov 2010 18:33:06 -0700 (PDT) Received: by sunpoet.net (Postfix, from userid 1000) id 548B22AEC8F5; Fri, 5 Nov 2010 09:32:41 +0800 (CST) Message-Id: <20101105013241.548B22AEC8F5@sunpoet.net> Date: Fri, 5 Nov 2010 09:32:41 +0800 (CST) From: Sunpoet Po-Chuan Hsieh To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/151953: [PATCH] Porter's Handbook: document INSTALL_LIB and minor fixes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Sunpoet Po-Chuan Hsieh List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 05 Nov 2010 01:40:09 -0000 >Number: 151953 >Category: docs >Synopsis: [PATCH] Porter's Handbook: document INSTALL_LIB and minor fixes >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Fri Nov 05 01:40:08 UTC 2010 >Closed-Date: >Last-Modified: >Originator: Sunpoet Po-Chuan Hsieh >Release: FreeBSD 8.1-STABLE amd64 >Organization: SUNPOET.net >Environment: System: FreeBSD bonjour.sunpoet.net 8.1-STABLE FreeBSD 8.1-STABLE #0: Sat Oct 23 16:01:16 CST 2010 sunpoet@bonjour.sunpoet.net:/usr/obj/usr/src/sys/bonjour amd64 >Description: Changes for Porter's Handbook: - Document INSTALL_LIB - Use proper tags for INSTALL_PROGRAM and post-install >How-To-Repeat: >Fix: --- book.sgml.patch begins here --- Index: book.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v retrieving revision 1.1077 diff -u -r1.1077 book.sgml --- book.sgml 4 Oct 2010 01:23:59 -0000 1.1077 +++ book.sgml 4 Nov 2010 16:49:35 -0000 @@ -4106,6 +4106,11 @@ + INSTALL_LIB is a command to install + shared libraries. + + + INSTALL_KLD is a command to install kernel loadable modules. Some architectures don't like it when the modules are stripped, therefor use this command instead @@ -4129,18 +4134,19 @@ - Stripping Binaries + Stripping binaries and shared libraries Do not strip binaries manually unless you have to. All binaries - should be stripped, but the INSTALL_PROGRAM - macro will install and strip a binary at the same time (see the next - section). - - If you need to strip a file, but do not wish to use the - INSTALL_PROGRAM macro, - ${STRIP_CMD} will strip your program. This is - typically done within the post-install - target. For example: + should be stripped, but the INSTALL_PROGRAM macro + will install and strip a binary at the same time (see the next + section). The INSTALL_LIB macro does the same thing + to shared libraries. + + If you need to strip a file, but wish to use neither + INSTALL_PROGRAM nor INSTALL_LIB + macros, ${STRIP_CMD} will strip your program or + shared library. This is typically done within the + post-install target. For example: post-install: ${STRIP_CMD} ${PREFIX}/bin/xdl --- book.sgml.patch ends here --- >Release-Note: >Audit-Trail: >Unformatted: