docs: def icon(theme_name='', path='', qta_name='', qta_options=None, use_qta=None):
      """
      Creates an icon from qtawesome, from theme or from path.
  
      :param theme_name: icon name in the current theme (GNU/Linux only)
      :param path: path of the icon (from file system or qrc)
      :param qta_name: icon name in qtawesome
      :param qta_options: the qtawesome options to use for controlling icon
                          rendering. If None, QTA_OPTIONS are used.
      :param use_qta: True to use qtawesome, False to use icon from theme/path.
                      None to use the global setting: USE_QTAWESOME.
  
      :returns: QtGui.QIcon
      """
      ret_val = None
      if use_qta is None:
          use_qta = USE_QTAWESOME
      if qta_options is None:
          qta_options = QTA_OPTIONS
      if qta is not None and use_qta is True:
          ret_val = qta.icon(qta_name, **qta_options)
      else:
          if theme_name and path:
              ret_val = QtGui.QIcon.fromTheme(theme_name, QtGui.QIcon(path))
          elif theme_name:
              ret_val = QtGui.QIcon.fromTheme(theme_name)
          elif path:
              ret_val = QtGui.QIcon(path)
      return ret_val