git: 5cf139c708 - main - books/porters-handbook: Add USES=tex macro

The branch main has been updated by bofh:

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

commit 5cf139c70862c11a610e3cdbb506536edbef29e7
Author:     Muhammad Moinur Rahman <bofh@FreeBSD.org>
AuthorDate: 2023-02-20 13:27:44 +0000
Commit:     Muhammad Moinur Rahman <bofh@FreeBSD.org>
CommitDate: 2023-02-20 13:27:44 +0000

    books/porters-handbook: Add USES=tex macro
    
    In a recent commit I have changed USE_TEX macros to USES=tex in the
    ports tree. Till now there were in fact no descriptions of TEX macros at
    all. So introduce the new macros here in the porters-handbook.
    
    While I am here remove EOL spaces.
    
    Approved by:    bcr (mentor)
    Differential Revision:  https://reviews.freebsd.org/D37745
---
 .../en/books/porters-handbook/uses/_index.adoc     | 49 +++++++++++++++++++++-
 1 file changed, 48 insertions(+), 1 deletion(-)

diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc
index e348d7d3ac..58bfeedff5 100644
--- a/documentation/content/en/books/porters-handbook/uses/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc
@@ -1322,7 +1322,7 @@ Uses ninja to build the port.
 Possible arguments: (none), `build`, `run`, `current`, `lts`, `10`, `14`, `16`,
  `17`.
 
-Uses nodejs. Adds a dependency on package:www/node*[]. If a supported version is 
+Uses nodejs. Adds a dependency on package:www/node*[]. If a supported version is
 specified then `run` and/or `build` must be specified too.
 
 [[uses-objc]]
@@ -2053,6 +2053,53 @@ Possible arguments: (none)
 Adds crossref:plist[plist-keywords-terminfo,`@terminfo`] to the [.filename]#plist#.
 Use when the port installs [.filename]#*.terminfo# files in [.filename]#${PREFIX}/share/misc#.
 
+[[uses-tex]]
+== `tex`
+
+Possible arguments: (none)
+
+Provide support for tex.
+Loads all the default variables for TEX related ports and does not add any dependency on any ports.
+
+Variables are used to specify which TEX modules are required.
+
+`USE_TEX`::
+The list of required TEX extensions at run-time.
+Add `:build` to the extension name to add a build-time dependency, `:run` to add runtime dependency, `:test` for test time dependency, `:extract` for extract time dependency.
+Example: `base texmf:build source:run`
+
+Current possible arguments are as follows:
+
+* `base`
+* `texmf`
+* `source`
+* `docs`
+* `web2c`
+* `kpathsea`
+* `ptexenc`
+* `basic`
+* `tlmgr`
+* `texlua`
+* `texluajit`
+* `synctex`
+* `xpdfopen`
+* `dvipsk`
+* `dvipdfmx`
+* `xdvik`
+* `gbklatex`
+* `formats`
+* `tex`
+* `latex`
+* `pdftex`
+* `jadetex`
+* `luatex`
+* `ptex`
+* `xetex`
+* `xmltex`
+* `texhash`
+* `updmap`
+* `fmtutil`
+
 [[uses-tk]]
 == `tk`