Date: Fri, 5 Nov 2010 09:32:41 +0800 (CST) From: Sunpoet Po-Chuan Hsieh <sunpoet@sunpoet.net> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/151953: [PATCH] Porter's Handbook: document INSTALL_LIB and minor fixes Message-ID: <20101105013241.548B22AEC8F5@sunpoet.net> Resent-Message-ID: <201011050140.oA51e9fw009221@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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 @@
</listitem>
<listitem>
+ <para><makevar>INSTALL_LIB</makevar> is a command to install
+ shared libraries.</para>
+ </listitem>
+
+ <listitem>
<para><makevar>INSTALL_KLD</makevar> 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 @@
</sect2>
<sect2 id="install-strip">
- <title>Stripping Binaries</title>
+ <title>Stripping binaries and shared libraries</title>
<para>Do not strip binaries manually unless you have to. All binaries
- should be stripped, but the <maketarget>INSTALL_PROGRAM</maketarget>
- macro will install and strip a binary at the same time (see the next
- section).</para>
-
- <para>If you need to strip a file, but do not wish to use the
- <makevar>INSTALL_PROGRAM</makevar> macro,
- <makevar>${STRIP_CMD}</makevar> will strip your program. This is
- typically done within the <literal>post-install</literal>
- target. For example:</para>
+ should be stripped, but the <makevar>INSTALL_PROGRAM</makevar> macro
+ will install and strip a binary at the same time (see the next
+ section). The <makevar>INSTALL_LIB</makevar> macro does the same thing
+ to shared libraries.</para>
+
+ <para>If you need to strip a file, but wish to use neither
+ <makevar>INSTALL_PROGRAM</makevar> nor <makevar>INSTALL_LIB</makevar>
+ macros, <makevar>${STRIP_CMD}</makevar> will strip your program or
+ shared library. This is typically done within the
+ <maketarget>post-install</maketarget> target. For example:</para>
<programlisting>post-install:
${STRIP_CMD} ${PREFIX}/bin/xdl</programlisting>
--- book.sgml.patch ends here ---
>Release-Note:
>Audit-Trail:
>Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20101105013241.548B22AEC8F5>