Method initialize_index

src/lay/lay/layHelpSource.cc:268–333

}

void
HelpSource::initialize_index ()
{
  try {

    tl::SelfTimer timer (tl::verbosity () >= 21, tl::to_string (QObject::tr ("Initializing help index")));

    bool ok = false;

    int qt = int (QT_VERSION >> 16);
    QString help_index_cache_file = tl::to_qstring (tl::sprintf ("help-index-%s-qt%d.xml.gz", lay::Version::version (), qt));

    std::string per_user_cache_file;
    if (! lay::ApplicationBase::instance ()->appdata_path ().empty ()) {
      per_user_cache_file = tl::to_string (QDir (tl::to_qstring (lay::ApplicationBase::instance ()->appdata_path ())).absoluteFilePath (help_index_cache_file));
    }

    //  Try to obtain the help index from the installation or application path

    std::vector<std::string> cache_files;
    cache_files.push_back (tl::to_string (QDir (tl::to_qstring (lay::ApplicationBase::instance ()->inst_path ())).absoluteFilePath (help_index_cache_file)));
    if (! per_user_cache_file.empty ()) {
      cache_files.push_back (per_user_cache_file);
    }

    for (std::vector<std::string>::const_iterator c = cache_files.begin (); ! ok && c != cache_files.end (); ++c) {

      try {
        tl::XMLFileSource in (*c);
        help_index_structure.parse (in, *this);
        if (m_klayout_version == lay::ApplicationBase::version ()) {
          if (tl::verbosity () >= 10) {
            tl::info << tl::to_string (tr ("Help index initialized from ")) << *c;
          }
          ok = true;
        } else {
          if (tl::verbosity () >= 10) {
            tl::warn << tl::to_string (tr ("Help index ignored (wrong version) from ")) << *c;
          }
        }
      } catch (tl::Exception &ex) {
        tl::warn << ex.msg ();
      } catch (std::runtime_error &ex) {
        tl::warn << ex.what ();
      } catch (...) {
        tl::warn << "unknown error.";
      }

    }

    if (! ok && ! per_user_cache_file.empty ()) {
      //  If no index is found, create one in "per_user_cache_file"
      produce_index_file (per_user_cache_file);
    }

  } catch (tl::Exception &ex) {

    m_index.clear ();