[sage-devel] Preparing the Reference Manual for use of Sage as a Python library

2024-01-25 Thread Matthias Koeppe
Here's a proposed next step of making Sage ready for use as a Python library. https://github.com/sagemath/sage/pull/37083 (ready for review) With these changes, users who are not interested in the Sage-specific syntax provided by the preparser can now access all doctest examples in pure Python

[sage-devel] Failure in sage_setup/clean.py

2024-01-25 Thread Kwankyu Lee
Hi, Built & Test is haunted with failure sage -t --long --random-seed=286735480429121101562228604801325644303 sage_setup/clean.py ** File "sage_setup/clean.py", line 104, in sage_setup.clean._find_stale_files Failed example:

[sage-devel] Re: Sphinx directives in upper case?

2024-01-25 Thread Kwankyu Lee
In my humble opinion, except ".. SEEALSO::", "..WARNING::", ".. TODO::", ".. NOTE::", ".. RUBRIC::", ".. PLOT::", "..TOPIC::", which seek for reader's attention, we should use lower case (by default) for all other directives, following Sphinx community's trend. In particular, ".. MATH::" is