Issue #41161: Update sage -b to use ninja and deprecate sage -br

Author: Hapsa21

src/bin/sage

@@ -191,43 +191,29 @@ fi
 # build/bin/sage-site. See #29111; but OTOH #34627.
 
 build_sage() {
-    ( cd "$SAGE_ROOT" && make sagelib-no-deps ) || exit $?
+    # Checking for the editable meson-build directory
+    if [ -f "build/build.ninja" ]; then
+        echo "Building Sage with ninja..."
+        ( cd "$SAGE_ROOT" && ninja -C build ) || exit $?
+    else
+        #Handling non-editable installs or other non-standard setups here.
+        echo "Error: 'sage -b' is for editable meson-based developer builds." >&2
+        echo "Please use 'make' or 'meson' directly for other builds." >&2
+        exit 1
+    fi
 }
 
-# Check for '-i' etc. before sourcing sage-env: running "make"
-# should be run outside of the Sage shell.
 case "$1" in
-    -i|-f|-p)
-        # Delegate further option handling to the non-installed sage-site script.
-        # (These options become unavailable if the directory $SAGE_ROOT is removed.)
-        if [ -d "$SAGE_ROOT" ]; then
-            exec "$SAGE_ROOT/build/bin/sage-site" "$@"
-            # fallthrough if there is no sage-site script
-        fi
-        echo >&2 "Error: unknown option: $1"
-        exit 1
-        ;;
+
     -b)
         build_sage
         exit 0
         ;;
     -br|--br)
+        echo "Warning: 'sage -br' is deprecated." >&2
+        echo "In an editable install, just run './sage' to use the latest built code." >&2
         build_sage
-        shift; set -- -r "$@"  # delegate to handling of "-r" below, after sourcing sage-env
-        ;;
-    -bn|--build-and-notebook)
-        build_sage
-        shift; set -- -n "$@"  # delegate to handling of "-n" below, after sourcing sage-env
-        ;;
-    -ba)
-        ( cd "$SAGE_ROOT" && make sagelib-clean )
-        build_sage
-        exit 0
-        ;;
-    -bt*)
-        build_sage
-        switch_without_b=-${1#-b}
-        shift; set -- $switch_without_b "$@"  # delegate to handling of "-t...." below, after sourcing sage-env
+        shift; set -- -r "$@"
         ;;
 esac
 

src/doc/en/reference/repl/startup.rst

@@ -42,3 +42,22 @@ in this file.
 
 The default location of this file can be changed using the
 environment variable :envvar:`SAGE_STARTUP_FILE`.
+
+.. _sage_subcommands:
+
+Sage Subcommands
+----------------
+
+The ``sage`` script can be used to invoke several subcommands, including:
+
+* ``sage -b``: Rebuilds the Sage library. This is intended for developer-only
+  editable Meson builds. It runs ``ninja -C build`` to recompile. If a
+  non-Meson build is detected, it will error out with a message.
+
+* ``sage -br``: **Deprecated.** This command is no longer supported and
+  will be removed in a future release. Use ``sage -b`` to build and
+  ``./sage`` to run.
+
+* ``sage --python``: Runs the Python interpreter included with Sage.
+
+* ``sage -i <package>``: Installs a Sage package.