/usr/include/qapt/changelog.h is in libqapt-dev 3.0.4-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 | /***************************************************************************
* Copyright © 2011 Jonathan Thomas <echidnaman@kubuntu.org> *
* *
* This program is free software; you can redistribute it and/or *
* modify it under the terms of the GNU General Public License as *
* published by the Free Software Foundation; either version 2 of *
* the License or (at your option) version 3 or any later version *
* accepted by the membership of KDE e.V. (or its successor approved *
* by the membership of KDE e.V.), which shall act as a proxy *
* defined in Section 14 of version 3 of the license. *
* *
* This program 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 General Public License for more details. *
* *
* You should have received a copy of the GNU General Public License *
* along with this program. If not, see <http://www.gnu.org/licenses/>. *
***************************************************************************/
#ifndef QAPT_CHANGELOG_H
#define QAPT_CHANGELOG_H
#include <QtCore/QDateTime>
#include <QtCore/QList>
#include <QtCore/QString>
#include <QtCore/QSharedDataPointer>
namespace QApt {
class ChangelogEntryPrivate;
class ChangelogPrivate;
/**
* The ChangelogEntry class represents a single entry in a Debian changelog file
*
* @author Jonathan Thomas
* @since 1.3
*/
class Q_DECL_EXPORT ChangelogEntry
{
public:
/**
* Constructs a Debian changelog entry with the provided entry data for
* the specified source package
*
* @param entryData The raw changelog entry
* @param sourcePackage The source package the changelog entry is for
*/
ChangelogEntry(const QString &entryData, const QString &sourcePackage);
/// Copy constructor
ChangelogEntry(const ChangelogEntry &other);
/// Destructor
~ChangelogEntry();
/// Assignment operator
ChangelogEntry &operator=(const ChangelogEntry &rhs);
/// Returns the raw text that makes up the changelog entry
QString entryText() const;
/// Returns the version of the source package that this changelog entry is for.
QString version() const;
/// Returns the timestamp of the changelog entry.
QDateTime issueDateTime() const;
/**
* Returns the description portion of the changelog entry, minus any formatting
* data such as source package, version, issue time, etc.
*/
QString description() const;
/**
* Returns a list of URLs to webpages providing descriptions of Common
* Vulnerabilities and Exposures that the version of a package that this
* changelog entry describes fixes.
*/
QStringList CVEUrls() const;
private:
QSharedDataPointer<ChangelogEntryPrivate> d;
};
typedef QList<ChangelogEntry> ChangelogEntryList;
/**
* The Changelog class is an interface for retreiving information from a Debian
* changelog file
*
* @author Jonathan Thomas
* @since 1.3
*/
class Q_DECL_EXPORT Changelog
{
public:
/**
* Constructor
*
* @param data The full contents of a Debian changelog file
* @param sourcePackage The source package the changelog file is for
*/
Changelog(const QString &data, const QString &sourcePackage);
/// Copy constructor
Changelog(const Changelog &other);
/// Destructor
~Changelog();
/// Assignment operator
Changelog &operator=(const Changelog &rhs);
/// Returns the full changelog as a string
QString text() const;
/// Returns a list of parsed individual changelog entries
ChangelogEntryList entries() const;
/**
* Returns a list of parsed individual changelog entries that have been
* made since the specified version.
*/
ChangelogEntryList newEntriesSince(const QString &version) const;
private:
QSharedDataPointer<ChangelogPrivate> d;
};
}
Q_DECLARE_TYPEINFO(QApt::ChangelogEntry, Q_MOVABLE_TYPE);
Q_DECLARE_TYPEINFO(QApt::Changelog, Q_MOVABLE_TYPE);
#endif
|