git: ee08121ef1 - main - [phb]: Document Uses=ebur128

The branch main has been updated by fernape:

URL: https://cgit.FreeBSD.org/doc/commit/?id=ee08121ef177489c031870601de1cc728de646e5

commit ee08121ef177489c031870601de1cc728de646e5
Author:     Fernando Apesteguía <[email protected]>
AuthorDate: 2023-08-22 10:18:35 +0000
Commit:     Fernando Apesteguía <[email protected]>
CommitDate: 2023-08-22 10:19:29 +0000

    [phb]: Document Uses=ebur128
    
    Follow up the inclusion of the new Uses in ports:
    
    https://cgit.freebsd.org/ports/commit/?id=3b2ff2ef194c83835fe7dc6618427b8fd50ea31d
---
 .../content/en/books/porters-handbook/uses/_index.adoc     | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc
index 1387cb6254..55f6752144 100644
--- a/documentation/content/en/books/porters-handbook/uses/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc
@@ -404,6 +404,20 @@ Use with the version of Drupal that the port is expecting.
 For example, `USES=drupal:7,module` says that this port creates a Drupal 7 module.
 A Drupal 7 theme can be specified with `USES=drupal:7,theme`.
 
+[[uses-ebur128]]
+== `ebur128`
+
+Possible arguments: (none), `build`, `lib`, `run`, `test`
+
+Adds a dependency on package:audio/ebur128[].
+It allows to transparently depend on the `rust` or `legacy` variants by using
+`DEFAULT_VERSIONS` in [.filename]#make.conf#.
+For instance, to use the legacy version, use `DEFAULT_VERSIONS+=ebur128=legacy`
+
+When no arguments are used, the behavior is the same as if the `lib` argument
+was provided.
+The rest of the arguments provide the corresponding category of dependency.
+
 [[uses-eigen]]
 == `eigen`