17189: upon the first pass of the documentation compilation, warnings…

… don't trigger an exception

src/doc/common/custom-sphinx-build.py

@@ -48,15 +48,17 @@ def term_width_line(text):
 
 # warnings: regular expressions (or strings) indicating a problem with
 # docbuilding. Raise an exception if any of these occur.
-
 warnings = (re.compile('Segmentation fault'),
             re.compile('SEVERE'),
             re.compile('ERROR'),
             re.compile('^make.*Error'),
             re.compile('Exception occurred'),
             re.compile('Sphinx error'))
 
-if 'latex' not in sys.argv:
+# Unless this is the first pass of the compilation (where some cross
+# links may not be resolvable yet), or we are compiling the latex
+# documentation, we want all warnings to raise an exception.
+if 'multidoc_first_pass=1' not in sys.argv and 'latex' not in sys.argv:
     warnings += (re.compile('WARNING'),)
 
 

src/doc/en/reference/dynamics/index.rst

@@ -7,4 +7,8 @@ Discrete dynamics
    interval_exchanges
    flat_surfaces
 
+.. SEEALSO::
+
+    - :ref:`sage.combinat.e_one_star`
+
 .. include:: ../footer.txt