Page MenuHomeFreeBSD
Files F152110635

D48989.id151352.diff
No OneTemporary
Actions

D48989.id151352.diff
View Options

diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc
--- a/documentation/content/en/books/porters-handbook/uses/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc
@@ -588,7 +588,6 @@
====
[.programlisting]
....
-USES= elfctl
ELF_FEATURES= featurelist:path/to/file1 \
featurelist:path/to/file2
....
@@ -597,7 +596,74 @@
The format of `featurelist` is described in man:elfctl[1].
-[[uses-erlang]]
+[[uses-emacs]]
+== `emacs`
+
+Possible arguments: (none)(default), `build`, `run`, `noflavors`
+Provides support for ports requiring Emacs.
+
+The `build` argument creates a build dependency on Emacs.
+
+The `run` argument creates a run dependency on Emacs.
+
+If both the `build` and `run` arguments are absent, create build and run
+dependencies on Emacs.
+
+The `noflavors` argument prevents flavors.
+This is implied if there is no run dependency on Emacs.
+
+The following variable can be set in [.filename]#make.conf#:
+
+`DEFAULT_VERSIONS`::
+The default Emacs flavor for ports with `USES=emacs` can be defined.
+For example: `DEFAULT_VERSIONS+= emacs=nox`
+
+Valid flavors: `full`, `canna`, `nox`, `wayland`, `devel_full`, `devel_nox`
+
+Variables, which can be set by ports:
+
+`EMACS_FLAVORS_EXCLUDE`::
+Do NOT build these Emacs flavors. If `EMACS_FLAVORS_EXCLUDE` is not defined and
+
+* there is a run dependency on Emacs
+* the noflavors argument is not specified
+
+then all valid Emacs flavors are assumed.
+
+`EMACS_NO_DEPENDS`::
+Do NOT add build or run dependencies on Emacs.
+This will prevent flavors, and no byte code files will be generated as part of
+the package.
+
+Variables which can be read by ports:
+
+`EMACS_CMD`::
+Emacs command with full path (e.g. [.filename]#/usr/local/bin/emacs-30.1#)
+
+`EMACS_FLAVOR`::
+Used for dependencies (e.g. `BUILD_DEPENDS= dash.el${EMACS_PKGNAMESUFFIX}>0:devel/dash@${EMACS_FLAVOR}`)
+
+`EMACS_LIBDIR`::
+Emacs Library directory without `${PREFIX}` (e.g. [.filename]#share/emacs#)
+
+`EMACS_LIBDIR_WITH_VER`::
+Library directory without `${PREFIX}` including version (e.g. [.filename]#share/emacs/30.1#)
+
+`EMACS_MAJOR_VER`::
+Emacs major version (e.g. 30)
+
+`EMACS_PKGNAMESUFFIX`::
+`PKGNAMESUFFIX` to distinguish Emacs flavors
+
+`EMACS_SITE_LISPDIR`::
+Emacs site-lisp directory without `${PREFIX}` (e.g. [.filename]#share/emacs/site-lisp#)
+
+`EMACS_VER`::
+Emacs version (e.g. 30.1)
+
+`EMACS_VERSION_SITE_LISPDIR`::
+Include version (e.g. [.filename]#share/emacs/30.1/site-lisp#)
+
== `erlang`
Possible arguments: (none), `enc`, `rebar`, `rebar3`

File Metadata

Mime Type
text/plain
Expires
Mon, Apr 13, 7:21 PM (20 h, 26 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
31423027
Default Alt Text
D48989.id151352.diff (2 KB)

Event Timeline