/usr/include/knewstuff3/entry.h is in kdelibs5-dev 4:4.8.2-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 | /*
Copyright (c) 2002 Cornelius Schumacher <schumacher@kde.org>
Copyright (c) 2003 - 2007 Josef Spillner <spillner@kde.org>
Copyright (c) 2009 Jeremy Whiting <jpwhiting@kde.org>
Copyright (C) 2009 Frederik Gladhorn <gladhorn@kde.org>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef KNEWSTUFF3_KNEWSTUFFENTRY_H
#define KNEWSTUFF3_KNEWSTUFFENTRY_H
#include <QtCore/QStringList>
#include <QtCore/QSharedDataPointer>
#include <kurl.h>
#include <knewstuff3/knewstuff_export.h>
namespace KNS3
{
/**
* @short KNewStuff information about changed entries
*
* This class provides information about the entries that
* have been installed while the new stuff dialog was shown.
* It is a minimal version that only gives applications what they need
* to know.
*
* @since 4.4
*/
class KNEWSTUFF_EXPORT Entry
{
public:
typedef QList<Entry> List;
/**
* Status of the entry. An entry will be downloadable from the provider's
* site prior to the download. Once downloaded and installed, it will
* be either installed or updateable, implying an out-of-date
* installation. Finally, the entry can be deleted and hence show up as
* downloadable again.
* Entries not taking part in this cycle, for example those in upload,
* have an invalid status.
*/
enum Status {
Invalid,
Downloadable,
Installed,
Updateable,
Deleted,
Installing,
Updating
};
~Entry();
Entry(const Entry& other);
Entry& operator=(const Entry& other);
/**
* Retrieve the name of the data object.
*
* @return object name
*/
QString name() const;
/**
* Retrieve the category of the data object.
*
* @return object category
*/
QString category() const;
/**
* Retrieve the locally installed files.
* @return file names
*/
QStringList installedFiles() const;
/**
* Retrieve the locally uninstalled files.
* @return file names
*/
QStringList uninstalledFiles() const;
/**
* Retrieves the entry's status.
*
* @return Current status of the entry
*/
Status status() const;
/**
* Retrieve the license name of the object.
*
* @return object license
*/
QString license() const;
/**
* Retrieve a short description about the object.
*
* @return object description
*/
QString summary() const;
/**
* Retrieve the version string of the object.
*
* @return object version
*/
QString version() const;
/**
* Id of this Entry. It is guaranteed to be unique for one provider.
* Id and ProviderId together identifiy this entry.
* @return the id
* @since 4.5
*/
QString id() const;
/**
* The Provider which is the source of the Entry.
* @return the Id of the Provider
* @since 4.5
*/
QString providerId() const;
private:
Entry();
class Private;
QExplicitlySharedDataPointer<Private> d;
friend class EntryInternal;
};
}
#endif
|