Differential D28582 Diff 83861 documentation/content/en/books/porters-handbook/makefiles/chapter.adoc

Changeset View

Standalone View

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

	Show First 20 Lines • Show All 4,602 Lines • ▼ Show 20 Lines

	[.programlisting]			[.programlisting]
	....			....
	CONFLICTS_INSTALL= bind99			CONFLICTS_INSTALL= bind99
	....			....

	====			====

	Sometime, only some version of another port is incompatible, in this case, use the full package name, with the version, and use shell globs, like `*` and `?` to make sure all possible versions are matched.			Sometimes, only certain versions of another port are incompatible. When this is the case, use the full package name including the version. If necessary, use shell globs like `*` and `?` so that all necessary versions are matched.
				creesUnsubmitted Not Done Inline Actions some versions of another port are crees: some versions of another port are
				jrmAuthorUnsubmitted Done Inline Actions Oh sorry. I just read your suggestion more carefully and I now see you that said `Some versions`...`are`. That makes sense. jrm: Oh sorry. I just read your suggestion more carefully and I now see you that said `Some…

	[[conflicts-ex2]]			[[conflicts-ex2]]
	.Using `CONFLICTS*` With Globs.			.Using `CONFLICTS*` With Globs.
	[example]			[example]
	====			====

	From versions from 2.0 and up-to 2.4.1_2, package:deskutils/gnotime[] used to install a bundled version of package:databases/qof[].			From versions from 2.0 and up-to 2.4.1_2, package:deskutils/gnotime[] used to install a bundled version of package:databases/qof[].

	To reflect this past, the [.filename]#Makefile# of package:databases/qof[] contains:			To reflect this past, the [.filename]#Makefile# of package:databases/qof[] contains:

	[.programlisting]			[.programlisting]
	....			....
	CONFLICTS_INSTALL= gnotime-2.[0-3]* \			CONFLICTS_INSTALL= gnotime-2.[0-3]* \
	gnotime-2.4.0* gnotime-2.4.1 \			gnotime-2.4.0* gnotime-2.4.1 \
	gnotime-2.4.1_[12]			gnotime-2.4.1_[12]
	....			....

	The first entry match versions `2.0` through `2.3`, the second all the revisions of `2.4.0`, the third the exact `2.4.1` version, and the last the first and second revisions of the `2.4.1` version.			The first entry match versions `2.0` through `2.3`, the second all the revisions of `2.4.0`, the third the exact `2.4.1` version, and the last the first and second revisions of the `2.4.1` version.

	package:deskutils/gnotime[] does not have any conflicts line because its current version does not conflict with anything else.			package:deskutils/gnotime[] does not have any conflicts line because its current version does not conflict with anything else.
	====			====

				The variable `DISABLE_CONFLICTS` may be temporarily set when making targets that are not affected by conflicts. The variable is not to be set in port Makefiles.

				[source,bash]
				....
				% make -DDISABLE_CONFLICTS patch
				....

	[[install]]			[[install]]
	== Installing Files			== Installing Files

	[IMPORTANT]			[IMPORTANT]
	====			====
	The `install` phase is very important to the end user because it adds files to their system. All the additional commands run in the port [.filename]#Makefile#'s `*-install` targets should be echoed to the screen. _Do not_ silence these commands with `@` or `.SILENT`.			The `install` phase is very important to the end user because it adds files to their system. All the additional commands run in the port [.filename]#Makefile#'s `*-install` targets should be echoed to the screen. _Do not_ silence these commands with `@` or `.SILENT`.
	====			====
	▲ Show 20 Lines • Show All 198 Lines • Show Last 20 Lines