/****************************************************************************+
−
**+
−
** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).+
−
** All rights reserved.+
−
** Contact: Nokia Corporation (qt-info@nokia.com)+
−
**+
−
** This file is part of the tools applications of the Qt Toolkit.+
−
**+
−
** $QT_BEGIN_LICENSE:LGPL$+
−
** No Commercial Usage+
−
** This file contains pre-release code and may not be distributed.+
−
** You may use this file in accordance with the terms and conditions+
−
** contained in the Technology Preview License Agreement accompanying+
−
** this package.+
−
**+
−
** GNU Lesser General Public License Usage+
−
** Alternatively, this file may be used under the terms of the GNU Lesser+
−
** General Public License version 2.1 as published by the Free Software+
−
** Foundation and appearing in the file LICENSE.LGPL included in the+
−
** packaging of this file.  Please review the following information to+
−
** ensure the GNU Lesser General Public License version 2.1 requirements+
−
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.+
−
**+
−
** In addition, as a special exception, Nokia gives you certain additional+
−
** rights.  These rights are described in the Nokia Qt LGPL Exception+
−
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.+
−
**+
−
** If you have questions regarding the use of this file, please contact+
−
** Nokia at qt-info@nokia.com.+
−
**+
−
**+
−
**+
−
**+
−
**+
−
**+
−
**+
−
**+
−
** $QT_END_LICENSE$+
−
**+
−
****************************************************************************/+
−
+
−
#include "feature.h"+
−
#include <QTextStream>+
−
#include <QRegExp>+
−
#include <QLibraryInfo>+
−
#include <QFileInfo>+
−
#include <QApplication>+
−
#include <QPalette>+
−
+
−
QT_BEGIN_NAMESPACE+
−
+
−
QMap<QString, Feature*> Feature::instances;+
−
+
−
Feature* Feature::getInstance(const QString &key)+
−
{+
−
    QString ukey = key.toUpper();+
−
    if (!instances.contains(ukey))+
−
        instances[ukey] = new Feature(ukey);+
−
    return instances[ukey];+
−
}+
−
+
−
Feature::~Feature()+
−
{+
−
    delete d;+
−
}+
−
+
−
void Feature::clear()+
−
{+
−
    foreach (Feature *f, instances.values())+
−
        delete f;+
−
    instances.clear();+
−
}+
−
+
−
static QString listToHtml(const QString &title, const QStringList &list)+
−
{+
−
    if (list.isEmpty())+
−
	return QString();+
−
+
−
    QString str;+
−
    QTextStream stream(&str);+
−
+
−
    stream << "<h3>" << title << ":</h3>";+
−
    stream << "<ul>";+
−
    foreach (QString l, list)+
−
	stream << "<li>" << l << "</li>";+
−
    stream << "</ul>";+
−
+
−
    return str;+
−
}+
−
+
−
static QString listToHtml(const QString &title, const QList<Feature*> &list)+
−
{+
−
    QStringList stringlist;+
−
    foreach (Feature *f, list) {+
−
        QString s("[%3] <a href=\"feature://%1\">%2</a>");+
−
        s = s.arg(f->key()).arg(f->key());+
−
        s = s.arg(f->selectable() && f->enabled() ? "On" : "Off");+
−
        stringlist << s;+
−
    }+
−
    return listToHtml(title, stringlist);+
−
}+
−
+
−
static QString linkify(const QString &src)+
−
{+
−
    static QRegExp classRegexp("\\b(Q[\\w]+)");+
−
    QString docRoot = QLibraryInfo::location(QLibraryInfo::DocumentationPath);+
−
    QString result = src;+
−
    int pos = 0;+
−
    while ((pos = classRegexp.indexIn(result, pos)) != -1) {+
−
        QString className = classRegexp.cap(1);+
−
        QString file = docRoot + "/html/" + className.toLower() + ".html";+
−
        QFileInfo info(file);+
−
        if (info.isFile()) {+
−
            QString link = QString("<a href=\"file://%1\">%2</a>")+
−
                           .arg(file).arg(className);+
−
            result.replace(pos, className.length(), link);+
−
            pos += link.length();+
−
        } else {+
−
            pos += className.length();+
−
        }+
−
    }+
−
+
−
    return result;+
−
}+
−
+
−
QString Feature::toHtml() const+
−
{+
−
    QString str;+
−
    QTextStream stream(&str);+
−
+
−
    const QString linkColor = QApplication::palette().color(QPalette::Link).name();+
−
    stream << "<h2><font size=\"+2\" color=\"" << linkColor << "\">"+
−
           << key() << "</font></h2>"+
−
	   << "<h2><font size=\"+2\">" << title() << "</font></h2>";+
−
    if (!description().isEmpty())+
−
        stream << "<p>" << description() << "</p>";+
−
    stream << listToHtml("Section", QStringList(section()))+
−
	   << listToHtml("Requires", dependencies())+
−
	   << listToHtml("Required for", supports())+
−
	   << listToHtml("See also", relations());+
−
+
−
    return linkify(str);+
−
}+
−
+
−
Feature::Feature(const QString &key) : d(new FeaturePrivate(key)) {}+
−
+
−
void Feature::setTitle(const QString &title)+
−
{+
−
    d->title = title;+
−
}+
−
+
−
void Feature::setSection(const QString &section)+
−
{+
−
    d->section = section;+
−
}+
−
+
−
void Feature::setDescription(const QString &description)+
−
{+
−
    d->description = description;+
−
}+
−
+
−
void Feature::addRelation(const QString &key)+
−
{+
−
    d->relations.insert(getInstance(key));+
−
}+
−
+
−
void Feature::setRelations(const QStringList &keys)+
−
{+
−
    foreach(QString key, keys)+
−
        if (key != "???")+
−
            addRelation(key);+
−
}+
−
+
−
QList<Feature*> Feature::relations() const+
−
{+
−
    return d->relations.toList();+
−
}+
−
+
−
void Feature::addDependency(const QString &key)+
−
{+
−
    Feature *f = getInstance(key);+
−
    d->dependencies.insert(f);+
−
    f->d->supports.insert(this);+
−
}+
−
+
−
void Feature::setDependencies(const QStringList &keys)+
−
{+
−
    foreach(QString key, keys)+
−
        addDependency(key);+
−
}+
−
+
−
QList<Feature*> Feature::dependencies() const+
−
{+
−
    return d->dependencies.toList();+
−
}+
−
+
−
QList<Feature*> Feature::supports() const+
−
{+
−
    return d->supports.toList();+
−
}+
−
+
−
/*+
−
    Returns a html formatted detailed description of this Feature.+
−
*/+
−
QString Feature::getDocumentation() const+
−
{+
−
    return QString() + "<h2>" + d->title + "</h2>";+
−
+
−
}+
−
+
−
void Feature::setEnabled(bool on)+
−
{+
−
    if (on == d->enabled)+
−
        return;+
−
+
−
    d->enabled = on;+
−
    foreach (Feature *f, supports())+
−
	f->updateSelectable();+
−
    emit changed();+
−
}+
−
+
−
/*+
−
  Update whether this feature should be selectable.+
−
  A feature is selectable if all its dependencies are enabled.+
−
*/+
−
void Feature::updateSelectable()+
−
{+
−
    bool selectable = true;+
−
    foreach (Feature *f, dependencies())+
−
        if (!f->selectable() || !f->enabled())+
−
            selectable = false;+
−
    if (selectable != d->selectable) {+
−
        d->selectable = selectable;+
−
        foreach (Feature *f, supports())+
−
            f->updateSelectable();+
−
        emit changed();+
−
    }+
−
}+
−
+
−
QT_END_NAMESPACE+
−