From sunpoet@sunpoet.net Fri Nov 5 01:33:09 2010 Return-Path: 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 Reply-To: Sunpoet Po-Chuan Hsieh To: FreeBSD-gnats-submit@freebsd.org Cc: Subject: [PATCH] Porter's Handbook: document INSTALL_LIB and minor fixes X-Send-Pr-Version: 3.113 X-GNATS-Notify: >Number: 151953 >Category: docs >Synopsis: [PATCH] Porter's Handbook: document INSTALL_LIB and minor fixes >Confidential: no >Severity: non-critical >Priority: low >Responsible: jkois >State: closed >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Fri Nov 05 01:40:08 UTC 2010 >Closed-Date: Wed Nov 24 22:24:09 UTC 2010 >Last-Modified: Wed Nov 24 22:24:09 UTC 2010 >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: Responsible-Changed-From-To: freebsd-doc->jkois Responsible-Changed-By: jkois Responsible-Changed-When: Mon Nov 22 13:22:24 UTC 2010 Responsible-Changed-Why: Take. http://www.freebsd.org/cgi/query-pr.cgi?pr=151953 From: dfilter@FreeBSD.ORG (dfilter service) To: bug-followup@FreeBSD.org Cc: Subject: Re: docs/151953: commit references a PR Date: Mon, 22 Nov 2010 18:31:02 +0000 (UTC) jkois 2010-11-22 18:30:50 UTC FreeBSD doc repository Modified files: en_US.ISO8859-1/books/porters-handbook book.sgml Log: PR: docs/151953 Changes for Porter's Handbook: - Document INSTALL_LIB - Use proper tags for INSTALL_PROGRAM and post-install Patch provided by: Sunpoet Po-Chuan Hsieh (sunpoet att sunpoet dott net) Discussed with: decke@ Revision Changes Path 1.1082 +16 -10 doc/en_US.ISO8859-1/books/porters-handbook/book.sgml _______________________________________________ cvs-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/cvs-all To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org" State-Changed-From-To: open->closed State-Changed-By: jkois State-Changed-When: Wed Nov 24 22:23:02 UTC 2010 State-Changed-Why: Porters-handbook has been modified. Close this PR. http://www.freebsd.org/cgi/query-pr.cgi?pr=151953 >Unformatted: