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