18c2ecf20Sopenharmony_ci# SPDX-License-Identifier: GPL-2.0
28c2ecf20Sopenharmony_ci#
38c2ecf20Sopenharmony_ci# Sphinx has deprecated its older logging interface, but the replacement
48c2ecf20Sopenharmony_ci# only goes back to 1.6.  So here's a wrapper layer to keep around for
58c2ecf20Sopenharmony_ci# as long as we support 1.4.
68c2ecf20Sopenharmony_ci#
78c2ecf20Sopenharmony_ciimport sphinx
88c2ecf20Sopenharmony_ci
98c2ecf20Sopenharmony_ciif sphinx.__version__[:3] >= '1.6':
108c2ecf20Sopenharmony_ci    UseLogging = True
118c2ecf20Sopenharmony_ci    from sphinx.util import logging
128c2ecf20Sopenharmony_ci    logger = logging.getLogger('kerneldoc')
138c2ecf20Sopenharmony_cielse:
148c2ecf20Sopenharmony_ci    UseLogging = False
158c2ecf20Sopenharmony_ci
168c2ecf20Sopenharmony_cidef warn(app, message):
178c2ecf20Sopenharmony_ci    if UseLogging:
188c2ecf20Sopenharmony_ci        logger.warning(message)
198c2ecf20Sopenharmony_ci    else:
208c2ecf20Sopenharmony_ci        app.warn(message)
218c2ecf20Sopenharmony_ci
228c2ecf20Sopenharmony_cidef verbose(app, message):
238c2ecf20Sopenharmony_ci    if UseLogging:
248c2ecf20Sopenharmony_ci        logger.verbose(message)
258c2ecf20Sopenharmony_ci    else:
268c2ecf20Sopenharmony_ci        app.verbose(message)
278c2ecf20Sopenharmony_ci
288c2ecf20Sopenharmony_cidef info(app, message):
298c2ecf20Sopenharmony_ci    if UseLogging:
308c2ecf20Sopenharmony_ci        logger.info(message)
318c2ecf20Sopenharmony_ci    else:
328c2ecf20Sopenharmony_ci        app.info(message)
33