Differential D29450 Diff 86573 documentation/content/en/books/porters-handbook/order/chapter.adoc

Changeset View

Standalone View

documentation/content/en/books/porters-handbook/order/chapter.adoc

	Show All 24 Lines
	include::shared/releases.adoc[]			include::shared/releases.adoc[]
	include::shared/en/mailing-lists.adoc[]			include::shared/en/mailing-lists.adoc[]
	include::shared/en/teams.adoc[]			include::shared/en/teams.adoc[]
	include::shared/en/urls.adoc[]			include::shared/en/urls.adoc[]

	toc::[]			toc::[]

	The first sections of the [.filename]#Makefile# must always come in the same order. This standard makes it so everyone can easily read any port without having to search for variables in a random order.			The first sections of the [.filename]#Makefile# must always come in the same order. This standard makes it so everyone can easily read any port without having to search for variables in a random order.

	The first line of a [.filename]#Makefile# is always a comment containing the Subversion version control ID, followed by an empty line. In new ports, it looks like this:

	[.programlisting]
	....
	# $FreeBSD$
	....

	In existing ports, Subversion has expanded it to look like this:

	[.programlisting]
	....
	# $FreeBSD: head/ports-mgmt/pkg/Makefile 437007 2017-03-26 21:25:47Z bapt $
	....

	[NOTE]			[NOTE]
				emasteUnsubmitted Done Inline Actions Do we generally do this today (as the first line after the $FreeBSD$)? emaste: Do we generally do this today (as the first line after the $FreeBSD$)?
				matUnsubmitted Done Inline Actions No, we don't, I think we should remove this, and finally be done with having a comment at the start of the Makefile documented as a thing. mat: No, we don't, I think we should remove this, and finally be done with having a comment at the…
				reneAuthorUnsubmitted Done Inline Actions Ah, you're right, the "Created by:" line is legacy. rene: Ah, you're right, the "Created by:" line is legacy.
	====			====
	The sections and variables described here are mandatory in a ordinary port. In a slave port, many sections and variables can be skipped.			The sections and variables described here are mandatory in a ordinary port. In a slave port, many sections and variables can be skipped.
	====			====

	[IMPORTANT]			[IMPORTANT]
	====			====
	Each following block must be separated from the previous block by a single blank line.			Each following block must be separated from the previous block by a single blank line.

	▲ Show 20 Lines • Show All 202 Lines • Show Last 20 Lines