package.h   package.h 
/************************************************************************** * /************************************************************************** *
* Copyright © 2010 Jonathan Thomas <echidnaman@kubuntu.org> * * Copyright © 2010-2011 Jonathan Thomas <echidnaman@kubuntu.org> *
* Heavily inspired by Synaptic library code ;-) * * Heavily inspired by Synaptic library code ;-) *
* * * *
* This program is free software; you can redistribute it and/or * * This program is free software; you can redistribute it and/or *
* modify it under the terms of the GNU General Public License as * * modify it under the terms of the GNU General Public License as *
* published by the Free Software Foundation; either version 2 of * * published by the Free Software Foundation; either version 2 of *
* the License or (at your option) version 3 or any later version * * the License or (at your option) version 3 or any later version *
* accepted by the membership of KDE e.V. (or its successor approved * * 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 * * by the membership of KDE e.V.), which shall act as a proxy *
* defined in Section 14 of version 3 of the license. * * defined in Section 14 of version 3 of the license. *
* * * *
skipping to change at line 259 skipping to change at line 259
// TODO QApt2: Return a QDateTime so that KDE apps can localize // TODO QApt2: Return a QDateTime so that KDE apps can localize
/** /**
* Returns the date when Canonical's support of the package ends. * Returns the date when Canonical's support of the package ends.
* *
* \return The date that the package is supported until. If it is not * \return The date that the package is supported until. If it is not
* supported now, then it will return an empty QString. The date * supported now, then it will return an empty QString. The date
* will be localized in the "month year" format. * will be localized in the "month year" format.
*/ */
QString supportedUntil() const; QString supportedUntil() const;
/**
* Returns the specified field of the package's debian/control file
*
* This function can be used to return data from custom control fields
* which do not have an official function inside APT to retrieve them.
*
* For example, the supportedUntil() function uses this function to
* retrieve the value of the "Supported" field, which is Ubuntu-specific
* and does not have an APT function with which to obtain it.
*
* Another usecase is the GStreamer metadata fields for GStreamer packag
es,
* which are used to give information on what mimetypes/GStreamer versio
n
* the package supports.
*
* @since 1.1
*/
QString controlField(const QLatin1String &name) const; QString controlField(const QLatin1String &name) const;
/** Overload for QString controlField(const QLatin1String &name) const;
**/
QString controlField(const QString &name) const;
/** /**
* Returns the amount of hard drive space that the currently-installed * Returns the amount of hard drive space that the currently-installed
* version of this package takes up. * version of this package takes up.
* This is human-unreadable, so KDE applications may wish to run this * This is human-unreadable, so KDE applications may wish to run this
* through the KGlobal::locale()->formatByteSize() function to get a * through the KGlobal::locale()->formatByteSize() function to get a
* localized, human-readable number. * localized, human-readable number.
* *
* Returns -1 on error. * Returns -1 on error.
* *
* \return The installed size of the package * \return The installed size of the package
 End of changes. 3 change blocks. 
1 lines changed or deleted 23 lines changed or added

This html diff was produced by rfcdiff 1.41. The latest version is available from http://tools.ietf.org/tools/rfcdiff/