Split sage_setup.docbuild out to a separate distribution sage_docbuild

[mkoeppe]

sage_setup.docbuild, created in #19127, has very different dependencies compared to sage_setup:

It depends on sagelib and sphinx,
whereas the rest of sage_setup is for building sagelib.

We remove the nesting within sage_setup, creating a new top-level package sage_docbuild.

We split it out as a separate pip-installable distribution package sage_docbuild.

Using the spkg-src script, a pip-installable tarball can be generated, which could be uploaded to PyPI -- for the use by external packages that want to build documentation.

This is preparation for #29868 (pip-installable packages sagemath-doc-src, sagemath-doc-inventory, sagemath-doc-html, sagemath-doc-pdf)

Depends on #31344
Depends on #31353

CC: @kiwifb @jhpalmieri @isuruf @mwageringel @haraldschilly @mezzarobba

Component: refactoring

Keywords: sd111

Author: Matthias Koeppe

Branch/Commit: aaab1d3

Reviewer: John Palmieri

Issue created by migration from https://trac.sagemath.org/ticket/30010

[mkoeppe]

Dependencies: #29847

[mkoeppe]

Changed dependencies from #29847 to none

[mkoeppe]

Description changed:

--- 
+++ 
@@ -3,5 +3,7 @@
 It depends on `sagelib` and `sphinx`, 
 whereas the rest of `sage_setup` is for building `sagelib`.
 
-We split it out.
+We split it out as a separate distutils package `sage_setup-docbuild`.
 
+Because some external packages use `sage_setup.docbuild` to build their own documentation, we do not change the package hierarchy. Instead we turn `sage_setup` into a native namespace package.
+

[mkoeppe]

Dependencies: #29950

[mkoeppe]

Description changed:

--- 
+++ 
@@ -3,7 +3,7 @@
 It depends on `sagelib` and `sphinx`, 
 whereas the rest of `sage_setup` is for building `sagelib`.
 
-We split it out as a separate distutils package `sage_setup-docbuild`.
+We split it out as a separate distutils package `sage_setup.docbuild`.
 
 Because some external packages use `sage_setup.docbuild` to build their own documentation, we do not change the package hierarchy. Instead we turn `sage_setup` into a native namespace package.
 

[mkoeppe]

Branch: u/mkoeppe/split_sage_setup_docbuild_out_to_a_separate_package

[mkoeppe]

Last 10 new commits:

b8e366e	build/pkgs/sagelib/spkg-src: chmod +x
0473ef3	Merge branch 't/21559/change-src-bin-installation' into t/29950/build_sagelib_using_installed_sage_setup
06a3609	sage_setup.find.find_python_sources: Add benchmark doctest
174626c	Merge branch 't/29786/move_extension_options_from_src_module_list_py_to__distutils___directives_in_the_individual_files__part_4__sage_rings_' into t/29701/replace_use_of_module_list_optionalextension
034a7f7	Merge branch 'public/move_all_code_from_src_setup_py__src_fpickle_setup_py_to_sage_setup' of git://trac.sagemath.org/sage into t/29701/replace_use_of_module_list_optionalextension
d3c608b	Merge tag '9.2.beta3' into t/29701/replace_use_of_module_list_optionalextension
7244371	Merge branch 't/29701/replace_use_of_module_list_optionalextension' into t/29950/build_sagelib_using_installed_sage_setup
4344f89	Merge branch 't/21559/change-src-bin-installation' into t/29950/build_sagelib_using_installed_sage_setup
72c5040	Merge branch 't/29950/build_sagelib_using_installed_sage_setup' into t/30010/split_sage_setup_docbuild_out_to_a_separate_package
ce79954	build/pkgs/sage_setup_docbuild: New

[mkoeppe]

Author: Matthias Koeppe

[mkoeppe]

Commit: ce79954

[mkoeppe]

Description changed:

--- 
+++ 
@@ -3,7 +3,10 @@
 It depends on `sagelib` and `sphinx`, 
 whereas the rest of `sage_setup` is for building `sagelib`.
 
-We split it out as a separate distutils package `sage_setup.docbuild`.
+We split it out as a separate distutils package `sage_setup.docbuild`.  
 
 Because some external packages use `sage_setup.docbuild` to build their own documentation, we do not change the package hierarchy. Instead we turn `sage_setup` into a native namespace package.
 
+
+Using the `spkg-src` script, a pip-installable tarball can be generated, which could be uploaded to PyPI -- for the use by external packages that want to build documentation.
+

[sagetrac-git]

Changed commit from ce79954 to e6b5f75

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

e6b5f75

build/pkgs/sagelib/src/MANIFEST.in: Prune sage_setup/docbuild

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

cbfe485

build/pkgs/sage_setup_docbuild: Set version

[sagetrac-git]

Changed commit from e6b5f75 to cbfe485

[jhpalmieri]

comment:13

In the new spkg-install file, why

. sage-dist-helpers

Why do this at all, and if you're going to do it, why not use source instead of ., to be consistent with how sage-spkg does things?