Error when using sage --doucbuild -D

[Dong YUAN]

Dear all,

I build

SageMath version 10.8.beta0, Release Date: 2025-08-16

on my Macbook Air M2, with macOS 15.6.

I try to use

% sage --doucbuild -D 

to see the valid document names. 

But I got 

Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/Users/imwy/Dev/SageDev/src/sage_docbuild/__main__.py", line 552, in <module>
    sys.exit(main())
             ~~~~^^
  File "/Users/imwy/Dev/SageDev/src/sage_docbuild/__main__.py", line 454, in main
    args: BuildOptions = parser.parse_args() # type: ignore
                         ~~~~~~~~~~~~~~~~~^^
  File "/opt/homebrew/Cellar/pyt...@3.13/3.13.7/Frameworks/Python.framework/Versions/3.13/lib/python3.13/argparse.py", line 1898, in parse_args
    args, argv = self.parse_known_args(args, namespace)
                 ~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^
  File "/opt/homebrew/Cellar/pyt...@3.13/3.13.7/Frameworks/Python.framework/Versions/3.13/lib/python3.13/argparse.py", line 1908, in parse_known_args
    return self._parse_known_args2(args, namespace, intermixed=False)
           ~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/homebrew/Cellar/pyt...@3.13/3.13.7/Frameworks/Python.framework/Versions/3.13/lib/python3.13/argparse.py", line 1937, in _parse_known_args2
    namespace, args = self._parse_known_args(args, namespace, intermixed)
                      ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/homebrew/Cellar/pyt...@3.13/3.13.7/Frameworks/Python.framework/Versions/3.13/lib/python3.13/argparse.py", line 2188, in _parse_known_args
    start_index = consume_optional(start_index)
  File "/opt/homebrew/Cellar/pyt...@3.13/3.13.7/Frameworks/Python.framework/Versions/3.13/lib/python3.13/argparse.py", line 2112, in consume_optional
    take_action(action, args, option_string)
    ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/homebrew/Cellar/pyt...@3.13/3.13.7/Frameworks/Python.framework/Versions/3.13/lib/python3.13/argparse.py", line 2013, in take_action
    action(self, namespace, argument_values, option_string)
    ~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/imwy/Dev/SageDev/src/sage_docbuild/__main__.py", line 256, in __call__
    print(help_documents(), end="")
          ~~~~~~~~~~~~~~^^
  File "/Users/imwy/Dev/SageDev/src/sage_docbuild/__main__.py", line 165, in help_documents
    docs = get_documents()
           ^^^^^^^^^^^^^

I wonder whether anyone else met this problem. If it is I will create a issue on GitHub.

Dong

[John H Palmieri]

This was broken in PR #39973. I don't what motivated that change, but it needs to be fixed.

[Dima Pasechnik]

with #39030 this should be obsolete, so let's not dwell on fixing stuff which is about to be gone for good.

[Kwankyu Lee]

There is https://github.com/sagemath/sage/pull/40588 for the issue.