From owner-svn-doc-all@FreeBSD.ORG Fri Mar 21 14:15:52 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id BDA4BD40; Fri, 21 Mar 2014 14:15:52 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id A71CDEE7; Fri, 21 Mar 2014 14:15:52 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s2LEFqfr040636; Fri, 21 Mar 2014 14:15:52 GMT (envelope-from mat@svn.freebsd.org) Received: (from mat@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s2LEFqPX040635; Fri, 21 Mar 2014 14:15:52 GMT (envelope-from mat@svn.freebsd.org) Message-Id: <201403211415.s2LEFqPX040635@svn.freebsd.org> From: Mathieu Arnold Date: Fri, 21 Mar 2014 14:15:52 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44308 - head/en_US.ISO8859-1/books/porters-handbook/makefiles X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 21 Mar 2014 14:15:52 -0000 Author: mat (ports committer) Date: Fri Mar 21 14:15:52 2014 New Revision: 44308 URL: http://svnweb.freebsd.org/changeset/doc/44308 Log: Replaces abuses of by . Add where applicable. Sponsored by: Absolight Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Fri Mar 21 13:44:50 2014 (r44307) +++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Fri Mar 21 14:15:52 2014 (r44308) @@ -1492,7 +1492,7 @@ PORTEPOCH= 1 only if necessary. DISTNAME is only used in two places. First, the distribution file list (DISTFILES) defaults to - ${DISTNAME}${EXTRACT_SUFX}. + ${DISTNAME}${EXTRACT_SUFX}. Second, the distribution file is expected to extract into a subdirectory named WRKSRC, which defaults to work/${DISTNAME}. @@ -1561,7 +1561,7 @@ PORTEPOCH= 1 WRKSRC is equal to work/${DISTNAME} while the original source archive is named something other than - ${PORTNAME}-${PORTVERSION}${EXTRACT_SUFX}, + ${PORTNAME}-${PORTVERSION}${EXTRACT_SUFX}, you should probably leave DISTNAME alone— you are better off defining DISTFILES than having to set both @@ -1642,92 +1642,92 @@ MASTER_SITE_SUBDIR= stardict/WyabdcRealP APACHE_JAKARTA - /dist/jakarta/${PORTNAME:S,-,,/,}/source + /dist/jakarta/${PORTNAME:S,-,,/,}/source BERLIOS - /${PORTNAME:L} + /${PORTNAME:L} CHEESESHOP - /packages/source/source/${DISTNAME:C/(.).*/\1/}/${DISTNAME:C/(.*)-[0-9].*/\1/} + /packages/source/source/${DISTNAME:C/(.).*/\1/}/${DISTNAME:C/(.*)-[0-9].*/\1/} DEBIAN - /debian/pool/main/${PORTNAME:C/^((lib)?.).*$/\1/}/${PORTNAME} + /debian/pool/main/${PORTNAME:C/^((lib)?.).*$/\1/}/${PORTNAME} GCC - /pub/gcc/releases/${DISTNAME} + /pub/gcc/releases/${DISTNAME} GH - /${GH_ACCOUNT}/${GH_PROJECT}/legacy.tar.gz/${GH_TAGNAME}?dummy=/ + /${GH_ACCOUNT}/${GH_PROJECT}/legacy.tar.gz/${GH_TAGNAME}?dummy=/ GHC - /downloads/${GH_ACCOUNT}/${GH_PROJECT}/ + /downloads/${GH_ACCOUNT}/${GH_PROJECT}/ GNOME - /pub/GNOME/sources/${PORTNAME}/${PORTVERSION:C/^([0-9]+\.[0-9]+).*/\1/} + /pub/GNOME/sources/${PORTNAME}/${PORTVERSION:C/^([0-9]+\.[0-9]+).*/\1/} GNU - /gnu/${PORTNAME} + /gnu/${PORTNAME} HORDE - /pub/${PORTNAME} + /pub/${PORTNAME} LOGILAB - /pub/${PORTNAME} + /pub/${PORTNAME} MATE - /releases/${PORTVERSION:C/^([0-9]+\.[0-9]+).*/\1/} + /releases/${PORTVERSION:C/^([0-9]+\.[0-9]+).*/\1/} MOZDEV - /pub/mozdev/${PORTNAME:L} + /pub/mozdev/${PORTNAME:L} CPAN - /pub/CPAN/modules/by-module/${PORTNAME:C/-.*//} + /pub/CPAN/modules/by-module/${PORTNAME:C/-.*//} PYTHON - /ftp/python/${PYTHON_PORTVERSION:C/rc[0-9]//} + /ftp/python/${PYTHON_PORTVERSION:C/rc[0-9]//} RUBYFORGE - /${PORTNAME:L} + /${PORTNAME:L} SAVANNAH - /${PORTNAME:L} + /${PORTNAME:L} SF - /project/${PORTNAME:L}/${PORTNAME:L}/${PORTVERSION} + /project/${PORTNAME:L}/${PORTNAME:L}/${PORTVERSION} @@ -2350,13 +2350,15 @@ DISTFILES= something.tar.gz:sourceforge< - How do I use this with PATCH* + How do I use this with + PATCH* variables? All examples were done with - MASTER* variables but they work - exactly the same for PATCH* ones as - can be seen in MASTER* + variables but they work exactly the same for + PATCH* + ones as can be seen in . Minimal Version of a Dependency A minimal version of a dependency can be specified in any - *_DEPENDS variable except - LIB_DEPENDS using the following - syntax: + *_DEPENDS + variable except LIB_DEPENDS using the + following syntax: p5-Spiffy>=0.26:${PORTSDIR}/devel/p5-Spiffy @@ -3055,7 +3057,8 @@ ALWAYS_KEEP_DISTFILES= yes never defined in a port's Makefile. If your port needs a special way to handle a dependency, use the :target part of the - *_DEPENDS variables instead of redefining + *_DEPENDS + variables instead of redefining DEPENDS_TARGET. When you type make clean, its @@ -3067,7 +3070,7 @@ ALWAYS_KEEP_DISTFILES= yes KDE, GNOME or Mozilla. To depend on another port unconditionally, use the - variable ${NONEXISTENT} as the first field + variable ${NONEXISTENT} as the first field of BUILD_DEPENDS or RUN_DEPENDS. Use this only when you need to get the source of the other port. You can often save @@ -3693,11 +3696,16 @@ PLIST_SUB+= OPT1="@comment " NO_OPT1="" <varname><replaceable>X</replaceable>_CONFIGURE_ENABLE</varname> - If X_CONFIGURE_ENABLE is set then - --enable-${X_CONFIGURE_ENABLE} or - --disable-${X_CONFIGURE_ENABLE} will be - added to CONFIGURE_ARGS depending on the - value of the optionX, for example: + If + X_CONFIGURE_ENABLE + is set then + --enable-${X_CONFIGURE_ENABLE} + or + --disable-${X_CONFIGURE_ENABLE} + will be added to CONFIGURE_ARGS depending + on the value of the + option X, for + example: OPTIONS_DEFINE= OPT1 OPT1_CONFIGURE_ENABLE= test @@ -3718,11 +3726,15 @@ CONFIGURE_ARGS+= --disable-test <varname><replaceable>X</replaceable>_CONFIGURE_WITH</varname> - If X_CONFIGURE_WITH is set then - --with-${X_CONFIGURE_WITH} or - --without-${X_CONFIGURE_WITH} will be - added to CONFIGURE_ARGS depending on the - status of the option X, for + If + X_CONFIGURE_WITH + is set then + --with-${X_CONFIGURE_WITH} + or + --without-${X_CONFIGURE_WITH} + will be added to CONFIGURE_ARGS depending + on the status of the option + X, for example: OPTIONS_DEFINE= OPT1 @@ -3744,9 +3756,11 @@ CONFIGURE_ARGS+= --without-test <varname><replaceable>X</replaceable>_CONFIGURE_ON</varname> - If X_CONFIGURE_ON is set then its - value will be appended to CONFIGURE_ARGS - depending on the status of the option X, + If + X_CONFIGURE_ON + is set then its value will be appended to + CONFIGURE_ARGS depending on the status of + the option X, for example: OPTIONS_DEFINE= OPT1 @@ -3766,9 +3780,11 @@ CONFIGURE_ARGS+= --add-test <varname><replaceable>X</replaceable>_CONFIGURE_OFF</varname> - If X_CONFIGURE_OFF is set then its - value will be appended to CONFIGURE_ARGS - depending on the status of the option X, + If + X_CONFIGURE_OFF + is set then its value will be appended to + CONFIGURE_ARGS depending on the status of + the option X, for example: OPTIONS_DEFINE= OPT1 @@ -3788,9 +3804,11 @@ CONFIGURE_ARGS+= --no-test <varname><replaceable>X</replaceable>_CMAKE_ON</varname> - If X_CMAKE_ON is set then its value - will be appended to CMAKE_ARGS depending - on the status of the option X, for + If + X_CMAKE_ON is + set then its value will be appended to + CMAKE_ARGS depending on the status of the + option X, for example: OPTIONS_DEFINE= OPT1 @@ -3810,9 +3828,11 @@ CMAKE_ARGS+= -DTEST:BOOL=true <varname><replaceable>X</replaceable>_CMAKE_OFF</varname> - If X_CMAKE_OFF is set then its value - will be appended to CMAKE_ARGS depending - on the status of the option X, for + If + X_CMAKE_OFF is + set then its value will be appended to + CMAKE_ARGS depending on the status of the + option X, for example: OPTIONS_DEFINE= OPT1 @@ -3867,10 +3887,13 @@ CMAKE_ARGS+= -DTEST:BOOL=false <varname><replaceable>X</replaceable>_<replaceable>ABOVEVARIABLE</replaceable></varname> - If X_ABOVEVARIABLE is defined then - its value will be appended to - ABOVEVARIABLE depending on the status - of the option X, for example: + If + X_ABOVEVARIABLE + is defined then its value will be appended to + ABOVEVARIABLE + depending on the status of the option + X, for + example: OPTIONS_DEFINE= OPT1 OPT1_LIB_DEPENDS= liba.so:${PORTSDIR}/devel/a @@ -3890,10 +3913,13 @@ LIB_DEPENDS+= liba.so:${PORTSDIR}/devel/ <varname><replaceable>X</replaceable>_<replaceable>ABOVEVARIABLE</replaceable>_OFF</varname> - If X_ABOVEVARIABLE_OFF is set then - a dependency of type ABOVEVARIABLE will - be added when option X is not selected. - For example: + If + X_ABOVEVARIABLE_OFF + is set then a dependency of type + ABOVEVARIABLE + will be added when option + X is not + selected. For example: OPTIONS_DEFINE= OPT1 OPT1_LIB_DEPENDS_OFF= liba.so:${PORTSDIR}/devel/a @@ -4004,10 +4030,13 @@ LIB_DEPENDS+= liba.so:${PORTSDIR}/devel/ <varname><replaceable>X</replaceable>_<replaceable>ABOVEVARIABLE</replaceable></varname> - If X_ABOVEVARIABLE is defined then - its value will be appended to - ABOVEVARIABLE depending on the status - of the option X, for example: + If + X_ABOVEVARIABLE + is defined then its value will be appended to + ABOVEVARIABLE + depending on the status of the option + X, for + example: OPTIONS_DEFINE= OPT1 OPT1_USES= gmake @@ -4028,9 +4057,12 @@ CFLAGS+= -DTEST <varname><replaceable>X</replaceable>_<replaceable>ABOVEVARIABLE</replaceable>_OFF</varname> - If X_ABOVEVARIABLE_OFF is set then - a flag ABOVEVARIABLE will be - automatically set when option X is not + If + X_ABOVEVARIABLE_OFF + is set then a flag + ABOVEVARIABLE + will be automatically set when option + X is not selected. For example: OPTIONS_DEFINE= OPT1 @@ -4236,7 +4268,7 @@ PORTVERSION= 1.0 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 + ${STRIP_CMD} will strip your program or shared library. This is typically done within the post-install target. For example: