Error building documentation

[jhonrubia6]

Hi,

I've just checkout the branch ticket #16804, and I get an error building the documentation I can not clean (tried $make doc-clean unsuccesfully). some clue?

[reference] loading pickled environment... not yet created

[reference] Compiling the master document

[reference] WARNING: intersphinx inventory '/Users/J_Honrubia/Sage/sage/local/share/doc/sage/inventory/en/reference/objects.inv' not fetchable due to <type 'exceptions.IOError'>: [Errno 2] No such file or directory: '/Users/J_Honrubia/Sage/sage/local/share/doc/sage/inventory/en/reference/objects.inv'

Error building the documentation.

Traceback (most recent call last):

  File "/Users/J_Honrubia/Sage/sage/local/lib/python/runpy.py", line 162, in _run_module_as_main

    "__main__", fname, loader, pkg_name)

  File "/Users/J_Honrubia/Sage/sage/local/lib/python/runpy.py", line 72, in _run_code

    exec code in run_globals

  File "/Users/J_Honrubia/Sage/sage/local/lib/python2.7/site-packages/sage_setup/docbuild/__main__.py", line 2, in <module>

    main()

  File "/Users/J_Honrubia/Sage/sage/local/lib/python2.7/site-packages/sage_setup/docbuild/__init__.py", line 1629, in main

    builder()

  File "/Users/J_Honrubia/Sage/sage/local/lib/python2.7/site-packages/sage_setup/docbuild/__init__.py", line 284, in _wrapper

    getattr(get_builder(document), 'inventory')(*args, **kwds)

  File "/Users/J_Honrubia/Sage/sage/local/lib/python2.7/site-packages/sage_setup/docbuild/__init__.py", line 508, in _wrapper

    getattr(DocBuilder(self.name, lang), format)(*args, **kwds)

  File "/Users/J_Honrubia/Sage/sage/local/lib/python2.7/site-packages/sage_setup/docbuild/__init__.py", line 103, in f

    runsphinx()

  File "/Users/J_Honrubia/Sage/sage/local/lib/python2.7/site-packages/sage_setup/docbuild/sphinxbuild.py", line 213, in runsphinx

    raise exception

OSError: [reference] WARNING: intersphinx inventory '/Users/J_Honrubia/Sage/sage/local/share/doc/sage/inventory/en/reference/objects.inv' not fetchable due to <type 'exceptions.IOError'>: [Errno 2] No such file or directory: '/Users/J_Honrubia/Sage/sage/local/share/doc/sage/inventory/en/reference/objects.inv'

Note: incremental documentation builds sometimes cause spurious

error messages. To be certain that these are real errors, run

"make doc-clean" first and try again.

make[2]: *** [doc-html] Error 1

make[1]: *** [all] Error 2

real 16m35.335s

user 15m28.780s

sys 0m40.856s

***************************************************************

Error building Sage.

[Dima Pasechnik]

there is no git branch on #16804. Which ticket did you mean?

[John H Palmieri]

Whichever ticket it is, after checking it out, you might try "git merge develop" (assuming your "develop" branch is reasonably up to date). There have been some recent changes in docbuilding, for example the location of the built documentation, that could be causing problems when you use branches from old tickets.

  John

[Linden Disney]

Was a solution to this ever found? I am working on trac ticket 30698, which I have used recently and had the documentation be fine, but since going to another ticket (31996) I have now run into this error:

[reference] building [html]: targets for 1 source files that are out of date

[reference] updating environment: [new config] 1 added, 0 changed, 0 removed

[reference] loading cross citations... looking for now-outdated files... none found

[reference] writing additional pages...  searchdone

[reference] dumping search index in English (code: en)... done

[reference] The HTML pages are in local/share/doc/sage/html/en/reference/references.

[reference] Extension error:

[reference] Handler <function on_build_finished at 0x7fe8c3d70b80> for event 'build-finished' threw an exception

Build finished. The built documents can be found in /home/s1504632/sage/local/share/doc/sage/html/en/reference/references

[spkg     ] WARNING: failed to reach any of the inventories with the following issues:

[spkg     ] intersphinx inventory '/home/s1504632/sage/local/share/doc/sage/inventory/en/reference/objects.inv' not fetchable due to <class 'FileNotFoundError'>: [Errno 2] No such file or directory: '/home/s1504632/sage/local/share/doc/sage/inventory/en/reference/objects.inv'

[spkg     ] WARNING: failed to reach any of the inventories with the following issues:

[spkg     ] intersphinx inventory '/home/s1504632/sage/local/share/doc/sage/inventory/en/reference/references/objects.inv' not fetchable due to <class 'FileNotFoundError'>: [Errno 2] No such file or directory: '/home/s1504632/sage/local/share/doc/sage/inventory/en/reference/references/objects.inv'

[spkg     ] building [html]: targets for 314 source files that are out of date

[spkg     ] updating environment: [new config] 314 added, 0 changed, 0 removed

[spkg     ] loading cross citations... looking for now-outdated files... none found

[spkg     ] writing additional pages...  searchdone

[spkg     ] dumping search index in English (code: en)... done

[spkg     ] The HTML pages are in local/share/doc/sage/html/en/reference/spkg.

[spkg     ] Extension error:

[spkg     ] Handler <function on_build_finished at 0x7fe8c3e05160> for event 'build-finished' threw an exception

Error building the documentation.

Traceback (most recent call last):

  File "/home/s1504632/sage/local/lib/python3.9/runpy.py", line 197, in _run_module_as_main

    return _run_code(code, main_globals, None,

  File "/home/s1504632/sage/local/lib/python3.9/runpy.py", line 87, in _run_code

    exec(code, run_globals)

  File "/home/s1504632/sage/local/lib/python3.9/site-packages/sage_docbuild/__main__.py", line 2, in <module>

    main()

  File "/home/s1504632/sage/local/lib/python3.9/site-packages/sage_docbuild/__init__.py", line 1762, in main

    builder()

  File "/home/s1504632/sage/local/lib/python3.9/site-packages/sage_docbuild/__init__.py", line 577, in _wrapper

    self._build_everything_except_bibliography(lang, format, *args, **kwds)

  File "/home/s1504632/sage/local/lib/python3.9/site-packages/sage_docbuild/__init__.py", line 563, in _build_everything_except_bibliography

    build_many(build_ref_doc, non_references)

  File "/home/s1504632/sage/local/lib/python3.9/site-packages/sage_docbuild/__init__.py", line 297, in build_many

    _build_many(target, args, processes=processes)

  File "/home/s1504632/sage/local/lib/python3.9/site-packages/sage_docbuild/utils.py", line 289, in build_many

    raise worker_exc.original_exception

OSError: WARNING: failed to reach any of the inventories with the following issues:

Also tried git merge develop and make doc-clean with no success. This is sage 9.3 with python 3.9.2 on a linux machine running ubunutu 18.04. The error seems to be that sage/local/share/doc/sage/inventory/en/reference/references/objects.inv is missing. I have the directory local/share/doc/sage/inventory/en/reference/references/ but it is empty 

[Linden Disney]

I might add that the problem started to occur after I had edited src/doc/en/reference/references/index.rst to include a new reference. 

[Linden Disney]

In order to fix this I had to make sage again from the source, which was obviously an time-expensive solution. I have just run into this error again working on ticket #31996, where I ran "sage --docbuild reference html", and got duplicate citation warnings where the citation was being found in references/index.rst as well as references/../references/index.rst (sadly I didn't capture the error log). I then ran make doc-clean thinking this might be a spurious error and re-encountered the error printed above. This is despite not making any changes to src/doc/en/reference/references/index.rst (indeed the changes I made can be seen via the commits to ticket #31996). As before, if I then ran "git trac checkout ..." to go to another branch I cannot build the documentation there either. Note that whatever this error is it isn't preventing sage from building and running on this branch.