Tutorial() won't work

13 views
Skip to first unread message

OHappyDay

unread,
Dec 23, 2025, 10:17:41 AM (2 days ago) Dec 23
to sage-support
Hi,

I tried to run tutorial() from sage command prompt and got an error message

OSError: The document 'tutorial' does not exist.  Please build it
with 'sage -docbuild tutorial html' and try again.

Then I tried to build it via the recommended way above but I got another error message

'tutorial' is not a recognized document. Type 'sage --docbuild -D' for a list
of documents, or 'sage --docbuild --help' for more help.

Running sage --docbuild -D resulted in yet another error message
Traceback (most recent call last):
 File "<frozen runpy>", line 198, in _run_module_as_main
 File "<frozen runpy>", line 88, in _run_code
 File "/datadisk/apps/sage-10.8/src/sage_docbuild/__main__.py", line 552, in <module>
   sys.exit(main())
            ^^^^^^
 File "/datadisk/apps/sage-10.8/src/sage_docbuild/__main__.py", line 454, in main
   args: BuildOptions = parser.parse_args() # type: ignore
                        ^^^^^^^^^^^^^^^^^^^
 File "/usr/lib/python3.12/argparse.py", line 1908, in parse_args
   args, argv = self.parse_known_args(args, namespace)
                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 File "/usr/lib/python3.12/argparse.py", line 1941, in parse_known_args
   namespace, args = self._parse_known_args(args, namespace)
                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 File "/usr/lib/python3.12/argparse.py", line 2162, in _parse_known_args
   start_index = consume_optional(start_index)
                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 File "/usr/lib/python3.12/argparse.py", line 2102, in consume_optional
   take_action(action, args, option_string)
 File "/usr/lib/python3.12/argparse.py", line 2017, in take_action
   action(self, namespace, argument_values, option_string)
 File "/datadisk/apps/sage-10.8/src/sage_docbuild/__main__.py", line 256, in __call__
   print(help_documents(), end="")
         ^^^^^^^^^^^^^^^^
 File "/datadisk/apps/sage-10.8/src/sage_docbuild/__main__.py", line 165, in help_documents
   docs = get_documents()
          ^^^^^^^^^^^^^
NameError: name 'get_documents' is not defined. Did you mean: 'help_documents'?


What is wrong?

I built sage 10.8 from the sources and sage works just fine (the same happens in 10.7)

Thanks for any hints

Dima Pasechnik

unread,
Dec 23, 2025, 3:48:14 PM (2 days ago) Dec 23
to sage-s...@googlegroups.com
"sage -docbuild" has been broken for some time.

"make doc-html" will build all the html documentation.

Reply all
Reply to author
Forward
0 new messages