From 6ae887383cae3c0248e3f22eacdfe0aa86416c17 Mon Sep 17 00:00:00 2001
From: David Adam <zanchey@ucc.gu.uwa.edu.au>
Date: Wed, 11 Dec 2024 08:04:00 +0800
Subject: [PATCH] README: improve instructions on building from source

Closes #10894.
---
 README.rst | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/README.rst b/README.rst
index a663130f5..971b9f041 100644
--- a/README.rst
+++ b/README.rst
@@ -137,14 +137,19 @@ Additionally, running the full test suite requires Python 3, tmux, and the pexpe
 Building from source with CMake
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+Rather than building from source, consider using a packaged build for your platform. Using the
+steps below makes fish difficult to uninstall or upgrade. Release packages are available from the
+links above, and up-to-date `development builds of fish are available for many platforms
+<https://github.com/fish-shell/fish-shell/wiki/Development-builds>`__
+
 To install into ``/usr/local``, run:
 
 .. code:: bash
 
    mkdir build; cd build
    cmake ..
-   make
-   sudo make install
+   cmake --build .
+   sudo cmake --install .
 
 The install directory can be changed using the
 ``-DCMAKE_INSTALL_PREFIX`` parameter for ``cmake``.