LaTeX: let latexpdf implement '-q' and '-Q' sphinx-build options (#12729)

Author: jfbu

CHANGES.rst

@@ -49,6 +49,11 @@ Bugs fixed
   Patch by Hugo van Kemenade.
 * #12645: Correctly support custom gettext output templates.
   Patch by Jeremy Bowman.
+* #12717: LaTeX: let :option:`-q <sphinx-build -q>` (quiet) option for
+  :program:`sphinx-build -M latexpdf` or :program:`make latexpdf` (``O=-q``)
+  get passed to :program:`latexmk`.  Let :option:`-Q <sphinx-build -Q>`
+  (silent) apply as well to the PDF build phase.
+  Patch by Jean-François B.
 
 Testing
 -------

sphinx/cmd/make_mode.py

@@ -106,7 +106,34 @@ def build_latexpdf(self) -> int:
             raise RuntimeError('Invalid $MAKE command: %r' % makecmd)
         try:
             with chdir(self.builddir_join('latex')):
-                return subprocess.call([makecmd, 'all-pdf'])
+                if '-Q' in self.opts:
+                    with open('__LATEXSTDOUT__', 'w') as outfile:
+                        returncode = subprocess.call([makecmd,
+                                                      'all-pdf',
+                                                      'LATEXOPTS=-halt-on-error',
+                                                      ],
+                                                     stdout=outfile,
+                                                     stderr=subprocess.STDOUT,
+                                                     )
+                    if returncode:
+                        print('Latex error: check %s' %
+                              self.builddir_join('latex', '__LATEXSTDOUT__')
+                              )
+                elif '-q' in self.opts:
+                    returncode = subprocess.call(
+                        [makecmd,
+                         'all-pdf',
+                         'LATEXOPTS=-halt-on-error',
+                         'LATEXMKOPTS=-silent',
+                         ],
+                    )
+                    if returncode:
+                        print('Latex error: check .log file in %s' %
+                              self.builddir_join('latex')
+                              )
+                else:
+                    returncode = subprocess.call([makecmd, 'all-pdf'])
+                return returncode
         except OSError:
             print('Error: Failed to run: %s' % makecmd)
             return 1