diff options
Diffstat (limited to 'documentation/content/en/books/porters-handbook/flavors/_index.adoc')
-rw-r--r-- | documentation/content/en/books/porters-handbook/flavors/_index.adoc | 48 |
1 files changed, 30 insertions, 18 deletions
diff --git a/documentation/content/en/books/porters-handbook/flavors/_index.adoc b/documentation/content/en/books/porters-handbook/flavors/_index.adoc index 46bace6d07..ee4aab2e89 100644 --- a/documentation/content/en/books/porters-handbook/flavors/_index.adoc +++ b/documentation/content/en/books/porters-handbook/flavors/_index.adoc @@ -6,7 +6,7 @@ description: Flavors are a way to have multiple variations of a port tags: ["Ports", "Flavors", "introduction", "how-to", "guide"] showBookMenu: true weight: 7 -path: "/books/porters-handbook/" +path: "/books/porters-handbook/flavors/" --- [[flavors]] @@ -164,31 +164,30 @@ To make the [.filename]#Makefile# easier to write, a few flavors helpers exist. This list of helpers will set their variable: -* `_flavor__PKGNAMEPREFIX` -* `_flavor__PKGNAMESUFFIX` -* `_flavor__PLIST` -* `_flavor__DESCR` +* `__flavor___PKGNAMEPREFIX` +* `__flavor___PKGNAMESUFFIX` +* `__flavor___PLIST` +* `__flavor___DESCR` This list of helpers will append to their variable: -* `_flavor__CONFLICTS` -* `_flavor__CONFLICTS_BUILD` -* `_flavor__CONFLICTS_INSTALL` -* `_flavor__PKG_DEPENDS` -* `_flavor__EXTRACT_DEPENDS` -* `_flavor__PATCH_DEPENDS` -* `_flavor__FETCH_DEPENDS` -* `_flavor__BUILD_DEPENDS` -* `_flavor__LIB_DEPENDS` -* `_flavor__RUN_DEPENDS` -* `_flavor__TEST_DEPENDS` - +* `__flavor___CONFLICTS` +* `__flavor___CONFLICTS_BUILD` +* `__flavor___CONFLICTS_INSTALL` +* `__flavor___PKG_DEPENDS` +* `__flavor___EXTRACT_DEPENDS` +* `__flavor___PATCH_DEPENDS` +* `__flavor___FETCH_DEPENDS` +* `__flavor___BUILD_DEPENDS` +* `__flavor___LIB_DEPENDS` +* `__flavor___RUN_DEPENDS` +* `__flavor___TEST_DEPENDS` [[flavors-helpers-ex1]] .Flavor Specific `PKGNAME` [example] ==== -As all packages must have a different package name, flavors must change theirs, using `_flavor__PKGNAMEPREFIX` and `_flavor__PKGNAMESUFFIX` makes this easy: +As all packages must have a different package name, flavors must change theirs, using `__flavor___PKGNAMEPREFIX` and `__flavor___PKGNAMESUFFIX` makes this easy: [.programlisting] .... @@ -363,3 +362,16 @@ most applications that embed or otherwise use Lua should simply use `USES=lua`. `LUA_FLAVOR` is available (and must be used) to depend on the correct version of dependencies regardless of whether the port used the `flavors` or `module` parameters. See crossref:special[using-lua,Using Lua] for further information. + +[[flavors-auto-guile]] +== `USES=guile` and Flavors + +When using crossref:uses[uses-guile,`guile:flavors`], +the port will automatically have `FLAVORS` filled in with the Guile versions it supports. +However, it is not expected that ordinary applications should use this feature; +it is primarily intended for use by libraries and extensions, +such as `guile-lib` or `guile-cairo`. + +`GUILE_FLAVOR` is available (and must be used) to depend on the correct version of flavored dependencies regardless of whether the port used the `flavors` parameter or not. + +See crossref:special[using-guile,Using Guile] for further information. |