src/doc/en/developer/packaging_sage_library.rst: Explain build/pkgs

sagemath · Nov 28, 2021 · d2c3a93 · d2c3a93
1 parent c23ffa0
commit d2c3a93
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/src/doc/en/developer/packaging_sage_library.rst b/src/doc/en/developer/packaging_sage_library.rst
@@ -168,6 +168,12 @@ and will not change where Sage developers find the source files.
 Some of these files may actually be generated from source files with suffix ``.m4`` by the
 ``SAGE_ROOT/bootstrap`` script via the ``m4`` macro processor.
 
+For every distribution package, there is also a subdirectory of ``SAGE_ROOT/build/pkgs/``,
+which contains the build infrastructure that is specific to Sage-the-distribution.
+Note that these subdirectories follows a different naming convention,
+using underscores instead of dashes, see :ref:`section-directory-structure`.
+Because the distribution packages are included in the source tree, we set them
+up as "script packages" instead of "normal packages", see :ref:`section-package-source-types`.