From 2f2b1c9914e0c5f0cba7af1889820ef6eace5732 Mon Sep 17 00:00:00 2001
From: Robert Alessi <alessi@robertalessi.net>
Date: Fri, 22 Mar 2024 17:33:53 +0100
Subject: mksymlinks: updated README

---
 README.md  | 36 ++++++++++++++++++++++++++++++++++++
 mksymlinks |  6 ++++++
 2 files changed, 42 insertions(+)

diff --git a/README.md b/README.md
index f2a3098..70ead84 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,7 @@ Contents
   - [TeX Live for OpenBSD at Utah](#tex-live-for-openbsd-at-utah)
 - [Installing TeX Live on OpenBSD With Ready-to-Use Binaries](#installing-tex-live-on-openbsd-with-ready-to-use-binaries)
 - [Updating the Binaries Over the Course of the Year](#updating-the-binaries-over-the-course-of-the-year)
+- [Package installation and updates](#package-installation-and-updates)
 - [Building the Sources](#building-the-sources)
 - [Acknowledgements](#acknowledgements)
 
@@ -158,6 +159,14 @@ Please read first the reference page on this matter:
 	   fc-cache -fsv
 	   ```
 
+	4. Symlink `/usr/local/texlive/<yyyy>/bin/custom` to
+       `/usr/local/texlive/<yyyy>/bin/amd64-openbsd`:
+	   
+	   ```sh
+	   cd /usr/local/texlive/<yyyy>/bin/custom
+	   ln -s custom amd64-openbsd
+	   ```
+
 7. Reboot and enjoy TeX Live on OpenBSD!
 
 ### All by hand
@@ -182,6 +191,33 @@ imported the public key used to sign the archives.)
 Alternatively, the direct link to the binaries provided above can be
 used.
 
+Package installation and updates
+--------------------------------
+
+To install new packages and to update already existing ones, do:
+
+```sh
+tlmgr update --all
+```
+
+More information can be found [on this
+page](https://tug.org/texlive/pkginstall.html) or in the [full `tlmgr`
+documentation](https://tug.org/texlive/doc/tlmgr.html).
+
+A number of scripts that are shipped within TeX Live are found in the
+`texmf-dist/scripts/`.  Most of them can be invoked by users from
+symlinks installed along with the usual TeX Live binaries.  
+As OpenBSD is not officially supported by TeX Live, it is important to
+note that `tlmgr update --all` *does not update these links,*
+especially in the case of scripts that come with new packages.  To
+update all existing links and install new links after using `tlmgr`, do:
+
+```sh
+mktexobsdsymlinks
+```
+
+This command requires the `subversion` package and must be rerun as needed.
+
 Building the sources
 --------------------
 
diff --git a/mksymlinks b/mksymlinks
index 6817fbd..efcb780 100644
--- a/mksymlinks
+++ b/mksymlinks
@@ -12,6 +12,12 @@ if [[ ! -w ${TLBINDIR} ]]; then
     exit 1
 fi
 
+which svn 2>&- > /dev/null
+if [[ $? -ne 0 ]];then
+    echo "Please install the subversion package."
+    exit 1
+fi
+
 svn --force export svn://tug.org/texlive/trunk/Build/source/texk/texlive/linked_scripts/scripts.lst \
     ${LSTFILE} || exit 1
 
-- 
cgit v1.2.3