Differential D31926 Diff 97856 documentation/content/en/books/porters-handbook/porting-dads/_index.adoc

Changeset View

Standalone View

documentation/content/en/books/porters-handbook/porting-dads/_index.adoc

Context not available.
	:icons: font	:icons: font
	:sectnums:	:sectnums:
	:sectnumlevels: 6	:sectnumlevels: 6
		:sectnumoffset: 13
		:partnums:
	:source-highlighter: rouge	:source-highlighter: rouge
	:experimental:	:experimental:
	:skip-front-matter:
	:xrefstyle: basic
	:relfileprefix: ../
	:outfilesuffix:
	:sectnumoffset: 13
	:freebsd-version: __FreeBSD_version	:freebsd-version: __FreeBSD_version
	:freebsd: __FreeBSD__	:freebsd: __FreeBSD__
		:images-path: books/porters-handbook/

	include::shared/mirrors.adoc[]	ifdef::env-beastie[]
		ifdef::backend-html5[]
		:imagesdir: ../../../../images/{images-path}
		endif::[]
		ifndef::book[]
	include::shared/authors.adoc[]	include::shared/authors.adoc[]
		include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]	include::shared/releases.adoc[]
	include::shared/en/mailing-lists.adoc[]	include::shared/attributes/attributes-{{% lang %}}.adoc[]
	include::shared/en/teams.adoc[]	include::shared/{{% lang %}}/teams.adoc[]
	include::shared/en/urls.adoc[]	include::shared/{{% lang %}}/mailing-lists.adoc[]
		include::shared/{{% lang %}}/urls.adoc[]
		toc::[]
		endif::[]
		ifdef::backend-pdf,backend-epub3[]
		include::../../../../../shared/asciidoctor.adoc[]
		endif::[]
		endif::[]

		ifndef::env-beastie[]
	toc::[]	toc::[]
		include::../../../../../shared/asciidoctor.adoc[]
		endif::[]

	[[dads-intro]]	[[dads-intro]]
	== Introduction	== Introduction

	Here is a list of common dos and don'ts that are encountered during the porting process.	Here is a list of common dos and don'ts that are encountered during the porting process.
	Check the port against this list, but also check ports in the https://bugs.FreeBSD.org/search/[PR database] that others have submitted.	Check the port against this list, but also check ports in the https://bugs.FreeBSD.org/search/[PR database] that others have submitted.
	Submit any comments on ports as described in link:{contributing}#CONTRIB-GENERAL[Bug Reports and General Commentary].	Submit any comments on ports as described in extref:{contributing}[Bug Reports and General Commentary, CONTRIB-GENERAL].
	Checking ports in the PR database will both make it faster for us to commit them, and prove that you know what you are doing.	Checking ports in the PR database will both make it faster for us to commit them, and prove that you know what you are doing.

	[[porting-wrkdir]]	[[porting-wrkdir]]
	== `WRKDIR`	== `WRKDIR`

	Do not write anything to files outside `WRKDIR`. `WRKDIR` is the only place that is guaranteed to be writable during the port build (see link:{handbook}#PORTS-CD[ installing ports from a CDROM] for an example of building ports from a read-only tree).	Do not write anything to files outside `WRKDIR`. `WRKDIR` is the only place that is guaranteed to be writable during the port build (see extref:{handbook}[ installing ports from a CDROM, PORTS-CD] for an example of building ports from a read-only tree).
	The [.filename]##pkg-*## files can be modified by crossref:pkg-files[pkg-names,redefining a variable] rather than overwriting the file.	The [.filename]##pkg-*## files can be modified by crossref:pkg-files[pkg-names,redefining a variable] rather than overwriting the file.

	[[porting-wrkdirprefix]]	[[porting-wrkdirprefix]]
Context not available.