From owner-svn-doc-head@freebsd.org Tue Jul 25 19:55:21 2017 Return-Path: Delivered-To: svn-doc-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 4F5EFD7CDE0; Tue, 25 Jul 2017 19:55:21 +0000 (UTC) (envelope-from ultima@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 2AE6B642BF; Tue, 25 Jul 2017 19:55:21 +0000 (UTC) (envelope-from ultima@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id v6PJtKgj060221; Tue, 25 Jul 2017 19:55:20 GMT (envelope-from ultima@FreeBSD.org) Received: (from ultima@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v6PJtKjf060219; Tue, 25 Jul 2017 19:55:20 GMT (envelope-from ultima@FreeBSD.org) Message-Id: <201707251955.v6PJtKjf060219@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: ultima set sender to ultima@FreeBSD.org using -f From: Richard Gallamore Date: Tue, 25 Jul 2017 19:55:20 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r50564 - head/en_US.ISO8859-1/books/porters-handbook/porting-samplem X-SVN-Group: doc-head X-SVN-Commit-Author: ultima X-SVN-Commit-Paths: head/en_US.ISO8859-1/books/porters-handbook/porting-samplem X-SVN-Commit-Revision: 50564 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 25 Jul 2017 19:55:21 -0000 Author: ultima (ports committer) Date: Tue Jul 25 19:55:20 2017 New Revision: 50564 URL: https://svnweb.freebsd.org/changeset/doc/50564 Log: * Sort sample Makefile to comply with the chapter * Added USE_x examples * Added option section with examples * Created new section block, Standard bsd.port.mk Variables The new section block has always existed, but as a "ghost" section. It is widely accepted and known, mostly used in the USES section which is quite restrictive. This added section block will help clear up possible confusion between the USES section block jumping to the option section and grant the ghost a home. Reviewed by: mat, matthew (mentor), wblock Approved by: mat, matthew (mentor) Differential Revision: https://reviews.freebsd.org/D11523 Modified: head/en_US.ISO8859-1/books/porters-handbook/porting-samplem/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/porting-samplem/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/porting-samplem/chapter.xml Tue Jul 25 17:50:09 2017 (r50563) +++ head/en_US.ISO8859-1/books/porters-handbook/porting-samplem/chapter.xml Tue Jul 25 19:55:20 2017 (r50564) @@ -49,11 +49,14 @@ EXTRACT_SUFX= .tar.Z [section for distributed patches -- can be empty] PATCH_SITES= ftp://ftp.sra.co.jp/pub/X11/japanese/ PATCHFILES= xdvi-18.patch1.gz xdvi-18.patch2.gz +[If the distributed patches were not made relative to ${WRKSRC}, + this may need to be tweaked] +PATCH_DIST_STRIP= -p1 [maintainer; *mandatory*! This is the person who is volunteering to handle port updates, build breakages, and to whom a users can direct questions and bug reports. To keep the quality of the Ports Collection - as high as possible, we no longer accept new ports that are assigned to + as high as possible, we do not accept new ports that are assigned to "ports@FreeBSD.org".] MAINTAINER= asami@FreeBSD.org COMMENT= DVI Previewer for the X Window System @@ -65,23 +68,34 @@ LICENSE_FILE= ${WRKSRC}/LICENSE [dependencies -- can be empty] RUN_DEPENDS= gs:print/ghostscript -[this section is for other standard bsd.port.mk variables that do not +[If it requires GNU make, not /usr/bin/make, to build...] +USES= gmake +[If it is an X application and requires "xmkmf -a" to be run...] +USES= imake +[If the source is obtained from github, remove MASTER_SITE* and...] +USE_GITHUB= yes +GH_ACCOUNT= example + +[this section is for other standard bsd.port.mk variables that do not] belong to any of the above] [If it asks questions during configure, build, install...] IS_INTERACTIVE= yes [If it extracts to a directory other than ${DISTNAME}...] WRKSRC= ${WRKDIR}/xdvi-new -[If the distributed patches were not made relative to ${WRKSRC}, - this may need to be tweaked] -PATCH_DIST_STRIP= -p1 [If it requires a "configure" script generated by GNU autoconf to be run] GNU_CONFIGURE= yes -[If it requires GNU make, not /usr/bin/make, to build...] -USES= gmake -[If it is an X application and requires "xmkmf -a" to be run...] -USES= imake [et cetera.] +[If it requires options, this section is for options] +OPTIONS_DEFINE= DOCS EXAMPLES FOO +OPTIONS_DEFAULT= FOO +[If options will change the files in plist] +OPTIONS_SUB=yes + +FOO_DESC= Enable foo support + +FOO_CONFIGURE_ENABLE= foo + [non-standard variables to be used in the rules below] MY_FAVORITE_RESPONSE= "yeah, right" @@ -472,6 +486,20 @@ pre-install: always put the GH_* variables right after it. + + + + Standard <filename>bsd.port.mk</filename> Variables + + This section block is for variables that can be defined in + bsd.port.mk that do not belong in any + of the previous section blocks. + + Order is not important, however try to keep similar variables together. + For example uid and gid variables USERS and GROUPS. + Configuration variables CONFIGURE_* and + *_CONFIGURE. List of files, and directories + PORTDOCS and PORTEXAMPLES.