sagemath · vbraun · Mar 25, 2024 · Feb 13, 2024 · Feb 13, 2024 · Feb 13, 2024
diff --git a/build/pkgs/4ti2/math b/build/pkgs/4ti2/math
diff --git a/build/pkgs/admcycles/math b/build/pkgs/admcycles/math
diff --git a/build/pkgs/awali/math b/build/pkgs/awali/math
diff --git a/build/pkgs/barvinok/math b/build/pkgs/barvinok/math
diff --git a/build/pkgs/benzene/math b/build/pkgs/benzene/math
diff --git a/build/pkgs/bliss/math b/build/pkgs/bliss/math
diff --git a/build/pkgs/brial/math b/build/pkgs/brial/math
diff --git a/build/pkgs/buckygen/math b/build/pkgs/buckygen/math
diff --git a/build/pkgs/cbc/math b/build/pkgs/cbc/math
diff --git a/build/pkgs/cddlib/math b/build/pkgs/cddlib/math
diff --git a/build/pkgs/clarabel/math b/build/pkgs/clarabel/math
diff --git a/build/pkgs/cliquer/math b/build/pkgs/cliquer/math
diff --git a/build/pkgs/cocoalib/math b/build/pkgs/cocoalib/math
diff --git a/build/pkgs/combinatorial_designs/math b/build/pkgs/combinatorial_designs/math
diff --git a/build/pkgs/conway_polynomials/math b/build/pkgs/conway_polynomials/math
diff --git a/build/pkgs/coxeter3/math b/build/pkgs/coxeter3/math
diff --git a/build/pkgs/cryptominisat/math b/build/pkgs/cryptominisat/math
diff --git a/build/pkgs/csdp/math b/build/pkgs/csdp/math
diff --git a/build/pkgs/cunningham_tables/math b/build/pkgs/cunningham_tables/math
diff --git a/build/pkgs/cvxopt/math b/build/pkgs/cvxopt/math
diff --git a/build/pkgs/cvxpy/math b/build/pkgs/cvxpy/math
diff --git a/build/pkgs/cylp/math b/build/pkgs/cylp/math
diff --git a/build/pkgs/cypari/math b/build/pkgs/cypari/math
diff --git a/build/pkgs/database_cremona_ellcurve/math b/build/pkgs/database_cremona_ellcurve/math
diff --git a/build/pkgs/database_cubic_hecke/math b/build/pkgs/database_cubic_hecke/math
diff --git a/build/pkgs/database_jones_numfield/math b/build/pkgs/database_jones_numfield/math
diff --git a/build/pkgs/database_knotinfo/math b/build/pkgs/database_knotinfo/math
diff --git a/build/pkgs/database_kohel/math b/build/pkgs/database_kohel/math
diff --git a/build/pkgs/database_mutation_class/math b/build/pkgs/database_mutation_class/math
diff --git a/build/pkgs/database_odlyzko_zeta/math b/build/pkgs/database_odlyzko_zeta/math
diff --git a/build/pkgs/database_stein_watkins/math b/build/pkgs/database_stein_watkins/math
diff --git a/build/pkgs/database_stein_watkins_mini/math b/build/pkgs/database_stein_watkins_mini/math
diff --git a/build/pkgs/database_symbolic_data/math b/build/pkgs/database_symbolic_data/math
diff --git a/build/pkgs/deformation/math b/build/pkgs/deformation/math
diff --git a/build/pkgs/dot2tex/front-end b/build/pkgs/dot2tex/front-end
diff --git a/build/pkgs/dsdp/math b/build/pkgs/dsdp/math
diff --git a/build/pkgs/e_antic/math b/build/pkgs/e_antic/math
diff --git a/build/pkgs/eclib/math b/build/pkgs/eclib/math
diff --git a/build/pkgs/ecm/math b/build/pkgs/ecm/math
diff --git a/build/pkgs/ecos_python/math b/build/pkgs/ecos_python/math
diff --git a/build/pkgs/elliptic_curves/math b/build/pkgs/elliptic_curves/math
diff --git a/build/pkgs/fflas_ffpack/math b/build/pkgs/fflas_ffpack/math
diff --git a/build/pkgs/flint/math b/build/pkgs/flint/math
diff --git a/build/pkgs/fplll/math b/build/pkgs/fplll/math
diff --git a/build/pkgs/fpylll/math b/build/pkgs/fpylll/math
diff --git a/build/pkgs/fricas/math b/build/pkgs/fricas/math
diff --git a/build/pkgs/frobby/math b/build/pkgs/frobby/math
diff --git a/build/pkgs/gambit/math b/build/pkgs/gambit/math
diff --git a/build/pkgs/gap/math b/build/pkgs/gap/math
diff --git a/build/pkgs/gap3/math b/build/pkgs/gap3/math
diff --git a/build/pkgs/gap_jupyter/math b/build/pkgs/gap_jupyter/math
diff --git a/build/pkgs/gap_packages/math b/build/pkgs/gap_packages/math
diff --git a/build/pkgs/gf2x/math b/build/pkgs/gf2x/math
diff --git a/build/pkgs/gfan/math b/build/pkgs/gfan/math
diff --git a/build/pkgs/giac/math b/build/pkgs/giac/math
diff --git a/build/pkgs/givaro/math b/build/pkgs/givaro/math
diff --git a/build/pkgs/glpk/math b/build/pkgs/glpk/math
diff --git a/build/pkgs/glucose/math b/build/pkgs/glucose/math
diff --git a/build/pkgs/gmp/math b/build/pkgs/gmp/math
diff --git a/build/pkgs/gmpy2/math b/build/pkgs/gmpy2/math
diff --git a/build/pkgs/gp2c/math b/build/pkgs/gp2c/math
diff --git a/build/pkgs/graphs/math b/build/pkgs/graphs/math
diff --git a/build/pkgs/graphviz/front-end b/build/pkgs/graphviz/front-end
diff --git a/build/pkgs/gsl/math b/build/pkgs/gsl/math
diff --git a/build/pkgs/igraph/math b/build/pkgs/igraph/math
diff --git a/build/pkgs/imagemagick/SPKG.rst b/build/pkgs/imagemagick/SPKG.rst
@@ -1,4 +1,4 @@
-ImageMagick: A collection of tools and libraries for many image file formats
+imagemagick: A collection of tools and libraries for many image file formats
 ============================================================================
 
 Description

diff --git a/build/pkgs/iml/math b/build/pkgs/iml/math
diff --git a/build/pkgs/ipympl/front-end b/build/pkgs/ipympl/front-end
diff --git a/build/pkgs/ipython/front-end b/build/pkgs/ipython/front-end
diff --git a/build/pkgs/ipywidgets/front-end b/build/pkgs/ipywidgets/front-end
diff --git a/build/pkgs/isl/math b/build/pkgs/isl/math
diff --git a/build/pkgs/jmol/front-end b/build/pkgs/jmol/front-end
diff --git a/build/pkgs/jupymake/math b/build/pkgs/jupymake/math
diff --git a/build/pkgs/jupyter_jsmol/front-end b/build/pkgs/jupyter_jsmol/front-end
diff --git a/build/pkgs/jupyterlab/front-end b/build/pkgs/jupyterlab/front-end
diff --git a/build/pkgs/jupyterlab_widgets/front-end b/build/pkgs/jupyterlab_widgets/front-end
diff --git a/build/pkgs/kenzo/math b/build/pkgs/kenzo/math
diff --git a/build/pkgs/kissat/math b/build/pkgs/kissat/math
diff --git a/build/pkgs/latte_int/math b/build/pkgs/latte_int/math
diff --git a/build/pkgs/lcalc/math b/build/pkgs/lcalc/math
diff --git a/build/pkgs/libbraiding/math b/build/pkgs/libbraiding/math
diff --git a/build/pkgs/libhomfly/math b/build/pkgs/libhomfly/math
diff --git a/build/pkgs/libnauty/math b/build/pkgs/libnauty/math
diff --git a/build/pkgs/libsemigroups/math b/build/pkgs/libsemigroups/math
diff --git a/build/pkgs/lidia/math b/build/pkgs/lidia/math
diff --git a/build/pkgs/lie/math b/build/pkgs/lie/math
diff --git a/build/pkgs/linbox/math b/build/pkgs/linbox/math
diff --git a/build/pkgs/lrcalc/math b/build/pkgs/lrcalc/math
diff --git a/build/pkgs/lrcalc_python/math b/build/pkgs/lrcalc_python/math
diff --git a/build/pkgs/lrslib/math b/build/pkgs/lrslib/math
diff --git a/build/pkgs/m4ri/math b/build/pkgs/m4ri/math
diff --git a/build/pkgs/m4rie/math b/build/pkgs/m4rie/math
diff --git a/build/pkgs/mathics/math b/build/pkgs/mathics/math
diff --git a/build/pkgs/mathics_scanner/math b/build/pkgs/mathics_scanner/math
diff --git a/build/pkgs/matplotlib/front-end b/build/pkgs/matplotlib/front-end
diff --git a/build/pkgs/matplotlib_inline/front-end b/build/pkgs/matplotlib_inline/front-end
diff --git a/build/pkgs/maxima/math b/build/pkgs/maxima/math
diff --git a/build/pkgs/mcqd/math b/build/pkgs/mcqd/math
diff --git a/build/pkgs/meataxe/math b/build/pkgs/meataxe/math
diff --git a/build/pkgs/modular_decomposition/math b/build/pkgs/modular_decomposition/math
diff --git a/build/pkgs/modular_resolution/SPKG.rst b/build/pkgs/modular_resolution/SPKG.rst
@@ -1,4 +1,4 @@
-p_group_cohomology: Modular cohomology rings of finite groups
+modular_resolution: Modular cohomology rings of finite groups
 =============================================================
 
 Description

diff --git a/build/pkgs/modular_resolution/math b/build/pkgs/modular_resolution/math
diff --git a/build/pkgs/mpc/math b/build/pkgs/mpc/math
diff --git a/build/pkgs/mpfi/math b/build/pkgs/mpfi/math
diff --git a/build/pkgs/mpfr/math b/build/pkgs/mpfr/math
diff --git a/build/pkgs/mpfrcx/math b/build/pkgs/mpfrcx/math
diff --git a/build/pkgs/mpmath/math b/build/pkgs/mpmath/math
diff --git a/build/pkgs/msolve/math b/build/pkgs/msolve/math
diff --git a/build/pkgs/nauty/math b/build/pkgs/nauty/math
diff --git a/build/pkgs/nbconvert/front-end b/build/pkgs/nbconvert/front-end
diff --git a/build/pkgs/networkx/math b/build/pkgs/networkx/math
diff --git a/build/pkgs/normaliz/math b/build/pkgs/normaliz/math
diff --git a/build/pkgs/notebook/front-end b/build/pkgs/notebook/front-end
diff --git a/build/pkgs/ntl/math b/build/pkgs/ntl/math
diff --git a/build/pkgs/numpy/math b/build/pkgs/numpy/math
diff --git a/build/pkgs/openblas/math b/build/pkgs/openblas/math
diff --git a/build/pkgs/ore_algebra/math b/build/pkgs/ore_algebra/math
diff --git a/build/pkgs/osqp_python/math b/build/pkgs/osqp_python/math
diff --git a/build/pkgs/p_group_cohomology/math b/build/pkgs/p_group_cohomology/math
diff --git a/build/pkgs/palp/math b/build/pkgs/palp/math
diff --git a/build/pkgs/pandoc/front-end b/build/pkgs/pandoc/front-end
diff --git a/build/pkgs/papilo/math b/build/pkgs/papilo/math
diff --git a/build/pkgs/pari/math b/build/pkgs/pari/math
diff --git a/build/pkgs/pari_elldata/math b/build/pkgs/pari_elldata/math
diff --git a/build/pkgs/pari_galdata/math b/build/pkgs/pari_galdata/math
diff --git a/build/pkgs/pari_galpol/math b/build/pkgs/pari_galpol/math
diff --git a/build/pkgs/pari_jupyter/math b/build/pkgs/pari_jupyter/math
diff --git a/build/pkgs/pari_nftables/math b/build/pkgs/pari_nftables/math
diff --git a/build/pkgs/pari_seadata/math b/build/pkgs/pari_seadata/math
diff --git a/build/pkgs/pari_seadata_small/math b/build/pkgs/pari_seadata_small/math
diff --git a/build/pkgs/pdf2svg/SPKG.rst b/build/pkgs/pdf2svg/SPKG.rst
@@ -1,5 +1,5 @@
-pdf2svg - PDF to SVG convertor
-==============================
+pdf2svg: PDF to SVG convertor
+=============================
 
 Description
 -----------

diff --git a/build/pkgs/pdf2svg/front-end b/build/pkgs/pdf2svg/front-end
diff --git a/build/pkgs/phitigra/math b/build/pkgs/phitigra/math
diff --git a/build/pkgs/planarity/math b/build/pkgs/planarity/math
diff --git a/build/pkgs/plantri/math b/build/pkgs/plantri/math
diff --git a/build/pkgs/polylib/math b/build/pkgs/polylib/math
diff --git a/build/pkgs/polymake/math b/build/pkgs/polymake/math
diff --git a/build/pkgs/polytopes_db/math b/build/pkgs/polytopes_db/math
diff --git a/build/pkgs/polytopes_db_4d/math b/build/pkgs/polytopes_db_4d/math
diff --git a/build/pkgs/ppl/math b/build/pkgs/ppl/math
diff --git a/build/pkgs/pplpy/math b/build/pkgs/pplpy/math
diff --git a/build/pkgs/primecount/math b/build/pkgs/primecount/math
diff --git a/build/pkgs/primecountpy/math b/build/pkgs/primecountpy/math
diff --git a/build/pkgs/primesieve/math b/build/pkgs/primesieve/math
diff --git a/build/pkgs/pycosat/math b/build/pkgs/pycosat/math
diff --git a/build/pkgs/pycryptosat/math b/build/pkgs/pycryptosat/math
diff --git a/build/pkgs/pygraphviz/front-end b/build/pkgs/pygraphviz/front-end
diff --git a/build/pkgs/pynormaliz/math b/build/pkgs/pynormaliz/math
diff --git a/build/pkgs/pyscipopt/math b/build/pkgs/pyscipopt/math
diff --git a/build/pkgs/pysingular/math b/build/pkgs/pysingular/math
diff --git a/build/pkgs/python_igraph/math b/build/pkgs/python_igraph/math
diff --git a/build/pkgs/qdldl_python/math b/build/pkgs/qdldl_python/math
diff --git a/build/pkgs/qepcad/math b/build/pkgs/qepcad/math
diff --git a/build/pkgs/qhull/math b/build/pkgs/qhull/math
diff --git a/build/pkgs/r/math b/build/pkgs/r/math
diff --git a/build/pkgs/r_jupyter/math b/build/pkgs/r_jupyter/math
diff --git a/build/pkgs/rpy2/math b/build/pkgs/rpy2/math
diff --git a/build/pkgs/rst2ipynb/front-end b/build/pkgs/rst2ipynb/front-end
diff --git a/build/pkgs/rubiks/math b/build/pkgs/rubiks/math
diff --git a/build/pkgs/rw/math b/build/pkgs/rw/math
diff --git a/build/pkgs/saclib/math b/build/pkgs/saclib/math
diff --git a/build/pkgs/sage_flatsurf/math b/build/pkgs/sage_flatsurf/math
diff --git a/build/pkgs/sage_numerical_backends_coin/math b/build/pkgs/sage_numerical_backends_coin/math
diff --git a/build/pkgs/sage_numerical_backends_cplex/math b/build/pkgs/sage_numerical_backends_cplex/math
diff --git a/build/pkgs/sage_numerical_backends_gurobi/math b/build/pkgs/sage_numerical_backends_gurobi/math
diff --git a/build/pkgs/sage_sws2rst/front-end b/build/pkgs/sage_sws2rst/front-end
diff --git a/build/pkgs/sagenb_export/front-end b/build/pkgs/sagenb_export/front-end
diff --git a/build/pkgs/sagetex/front-end b/build/pkgs/sagetex/front-end
diff --git a/build/pkgs/scip/math b/build/pkgs/scip/math
diff --git a/build/pkgs/scip_sdp/math b/build/pkgs/scip_sdp/math
diff --git a/build/pkgs/scipy/math b/build/pkgs/scipy/math
diff --git a/build/pkgs/scs/math b/build/pkgs/scs/math
diff --git a/build/pkgs/singular/math b/build/pkgs/singular/math
diff --git a/build/pkgs/singular_jupyter/math b/build/pkgs/singular_jupyter/math
diff --git a/build/pkgs/sirocco/math b/build/pkgs/sirocco/math
diff --git a/build/pkgs/slabbe/math b/build/pkgs/slabbe/math
diff --git a/build/pkgs/snappy/math b/build/pkgs/snappy/math
diff --git a/build/pkgs/soplex/math b/build/pkgs/soplex/math
diff --git a/build/pkgs/suitesparse/math b/build/pkgs/suitesparse/math
diff --git a/build/pkgs/surf/math b/build/pkgs/surf/math
diff --git a/build/pkgs/surface_dynamics/math b/build/pkgs/surface_dynamics/math
diff --git a/build/pkgs/symengine/math b/build/pkgs/symengine/math
diff --git a/build/pkgs/symengine_py/math b/build/pkgs/symengine_py/math
diff --git a/build/pkgs/symmetrica/math b/build/pkgs/symmetrica/math
diff --git a/build/pkgs/sympow/math b/build/pkgs/sympow/math
diff --git a/build/pkgs/sympy/math b/build/pkgs/sympy/math
diff --git a/build/pkgs/tachyon/front-end b/build/pkgs/tachyon/front-end
diff --git a/build/pkgs/tdlib/math b/build/pkgs/tdlib/math
diff --git a/build/pkgs/texlive/front-end b/build/pkgs/texlive/front-end
diff --git a/build/pkgs/threejs/front-end b/build/pkgs/threejs/front-end
diff --git a/build/pkgs/tides/math b/build/pkgs/tides/math
diff --git a/build/pkgs/topcom/math b/build/pkgs/topcom/math
diff --git a/src/doc/bootstrap b/src/doc/bootstrap
@@ -86,6 +86,7 @@ if [ "${BOOTSTRAP_QUIET}" = "no" ]; then
 fi
 OUTPUT_INDEX="$OUTPUT_DIR"/index.rst
 cat > "$OUTPUT_INDEX" <<EOF
+.. _spkg:
 
 Packages and Features
 =====================
@@ -97,24 +98,68 @@ The Sage distribution includes most programs and libraries on which
 Sage depends.  It installs them automatically if it does not find
 equivalent system packages.
 
+Mathematics
+~~~~~~~~~~~
+
+EOF
+for PKG_BASE in $(sage-package list --has-file SPKG.rst --has-file math :standard: | grep -v '^sagemath_'); do
+    echo "* :ref:\`spkg_$PKG_BASE\`"
+done >> "$OUTPUT_INDEX"
+cat >> "$OUTPUT_INDEX" <<EOF
+
+Front-end, graphics, document preparation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 EOF
-for PKG_BASE in $(sage-package list --has-file SPKG.rst :standard: | grep -v '^sagemath_'); do
+for PKG_BASE in $(sage-package list --has-file SPKG.rst --no-file math --has-file front-end :standard: | grep -v '^sagemath_'); do
     echo "* :ref:\`spkg_$PKG_BASE\`"
 done >> "$OUTPUT_INDEX"
 cat >> "$OUTPUT_INDEX" <<EOF
 
+Other dependencies
+~~~~~~~~~~~~~~~~~~
+
+EOF
+for PKG_BASE in $(sage-package list --has-file SPKG.rst --no-file math --no-file front-end :standard: | grep -v '^sagemath_'); do
+    echo "* :ref:\`spkg_$PKG_BASE\`"
+done >> "$OUTPUT_INDEX"
+cat >> "$OUTPUT_INDEX" <<EOF
+
+
 Optional Packages
 -----------------
 
 For additional functionality, you can install some of the following
 optional packages.
 
+Mathematics
+~~~~~~~~~~~
+
 EOF
-for PKG_BASE in $(sage-package list --has-file SPKG.rst :optional: | grep -v '^sagemath_'); do
+for PKG_BASE in $(sage-package list --has-file SPKG.rst --has-file math :optional: | grep -v '^sagemath_'); do
     echo "* :ref:\`spkg_$PKG_BASE\`"
 done >> "$OUTPUT_INDEX"
 cat >> "$OUTPUT_INDEX" <<EOF
 
+Front-end, graphics, document preparation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+EOF
+for PKG_BASE in $(sage-package list --has-file SPKG.rst --no-file math --has-file front-end :optional: | grep -v '^sagemath_'); do
+    echo "* :ref:\`spkg_$PKG_BASE\`"
+done >> "$OUTPUT_INDEX"
+cat >> "$OUTPUT_INDEX" <<EOF
+
+Other dependencies
+~~~~~~~~~~~~~~~~~~
+
+EOF
+for PKG_BASE in $(sage-package list --has-file SPKG.rst --no-file math --no-file front-end :optional: | grep -v '^sagemath_'); do
+    echo "* :ref:\`spkg_$PKG_BASE\`"
+done >> "$OUTPUT_INDEX"
+cat >> "$OUTPUT_INDEX" <<EOF
+
+
 Features
 --------
 
@@ -170,13 +215,27 @@ Some packages that provide additional functionality are marked as
 "experimental".  Developers are needed in order to improve the
 integration of these packages into the Sage distribution.
 
+Mathematics
+~~~~~~~~~~~
+
 EOF
-for PKG_BASE in $(sage-package list --has-file SPKG.rst :experimental: | grep -v '^sagemath_'); do
+for PKG_BASE in $(sage-package list --has-file SPKG.rst --has-file math :experimental: | grep -v '^sagemath_'); do
     echo "* :ref:\`spkg_$PKG_BASE\`"
 done >> "$OUTPUT_INDEX"
 
 cat >> "$OUTPUT_INDEX" <<EOF
 
+Other dependencies
+~~~~~~~~~~~~~~~~~~
+
+EOF
+for PKG_BASE in $(sage-package list --has-file SPKG.rst --no-file math :experimental: | grep -v '^sagemath_'); do
+    echo "* :ref:\`spkg_$PKG_BASE\`"
+done >> "$OUTPUT_INDEX"
+
+cat >> "$OUTPUT_INDEX" <<EOF
+
+
 All External Packages
 ---------------------
 

diff --git a/src/doc/en/developer/coding_basics.rst b/src/doc/en/developer/coding_basics.rst
@@ -7,10 +7,10 @@ General Conventions
 ===================
 
 
-There are many ways to contribute to Sage including sharing scripts
-and Sage worksheets that implement new functionality using Sage,
+There are many ways to contribute to Sage, including sharing scripts
+and Jupyter notebooks that implement new functionality using Sage,
 improving to the Sage library, or to working on the many underlying
-libraries distributed with Sage [1]_.
+libraries distributed with Sage, see :ref:`spkg`.
 This guide focuses on editing the Sage library itself.
 
 Sage is not just about gathering together functionality. It is about
@@ -20,10 +20,6 @@ mathematically. In the design of Sage, the semantics of objects, the
 definitions, etc., are informed by how the corresponding objects are
 used in everyday mathematics.
 
-.. [1]
-   See https://www.sagemath.org/links-components.html for a full list
-   of packages shipped with every copy of Sage
-
 To meet the goal of making Sage easy to read, maintain, and improve,
 all Python/Cython code that is included with Sage should adhere to the
 style conventions discussed in this chapter.

diff --git a/src/doc/en/developer/coding_in_other.rst b/src/doc/en/developer/coding_in_other.rst
@@ -8,9 +8,9 @@ When writing code for Sage, use Python for the basic structure and
 interface. For speed, efficiency, or convenience, you can implement
 parts of the code using any of the following languages: :ref:`Cython
 <chapter-cython>`, C/C++, Fortran 95, GAP, Common Lisp, Singular, and
-PARI/GP. You can also use all C/C++ libraries included with Sage
-[SageComponents]_. And if you are okay with your code depending on
-optional Sage packages, you can use Octave, or even Magma,
+PARI/GP. You can also use all C/C++ libraries included with Sage,
+see :ref:`spkg`. And if you are okay with your code depending on
+external programs, you can use Octave, or even Magma,
 Mathematica, or Maple.
 
 In this chapter, we discuss interfaces between Sage and :ref:`PARI
@@ -753,7 +753,3 @@ These are only excerpts from ``octave.py``; check that file for more
 definitions and examples. Look at other files in the directory
 ``SAGE_ROOT/src/sage/interfaces/`` for examples of interfaces to other
 software packages.
-
-
-.. [SageComponents] See http://www.sagemath.org/links-components.html
-   for a list
diff --git a/src/doc/en/developer/packaging.rst b/src/doc/en/developer/packaging.rst
@@ -776,20 +776,33 @@ optional packages.
 Package tags
 ------------
 
-You can mark a package as "huge" by placing an empty file named
-``huge`` in the package directory.  For example, the package
-``polytopes_db_4d`` is a large database whose compressed tarball has a
-size of 9 GB.
-
-For some other packages, we have placed an empty file named
-``has_nonfree_dependencies`` in the package directory. This is to
-indicate that Sage with this package installed cannot be
-redistributed, and also that the package can only be installed after
-installing some other, non-free package.
-
-We use these tags in our continuous integration scripts to filter
+We use the following "tags" to organize our :ref:`index of packages in the
+Reference Manual <spkg>`.
+
+- Place an empty file named ``math`` in the package directory to make the
+  package appear in the "Mathematics" subsections of the index of standard,
+  optional, and experimental packages.
+
+- Place an empty file name ``front-end`` in the package directory to make
+  the package appear in the "Front-end, graphics, document preparation"
+  subsections.
+
+- Packages without these tags appear in the "Other dependencies" subsections.
+
+We use the following tags in our continuous integration scripts to filter
 out packages that we cannot or should not test automatically.
 
+- You can mark a package as "huge" by placing an empty file named
+  ``huge`` in the package directory.  For example, the package
+  ``polytopes_db_4d`` is a large database whose compressed tarball has a
+  size of 9 GB.
+
+- For some other packages, we have placed an empty file named
+  ``has_nonfree_dependencies`` in the package directory. This is to
+  indicate that Sage with this package installed cannot be
+  redistributed, and also that the package can only be installed after
+  installing some other, non-free package.
+
 
 .. _section-trees: