Package component provides naming

=================================

This document describes how the "provides"-strings for packages should

be formatted for the given PK_PROVIDES types.

This is needed to ensure cross-distro compatibility on package provides

naming (the naming of components packages provide), which is used for

example in pk_client_what_provides_async().

Valid types of provided components are defined in PkProvidesEnum.

In general, the component naming should be "type(component-name)".

Component naming

----------------

MODALIAS:               A string with the modalias, for example

                        "pci:v00008086d00003B64sv000017AAsd0000215Fbc07sc80i00"

                        or "usb:v09DAp000Ad0014dc00dsc00dp00ic03isc01ip02".

                        Returns packages which provide a driver for this

                        device.

CODEC:                  A string in the format of gstreamer<version>(type-format)

                        where <version> is the GStreamer API version (e. g.

                        0.10), "type" is a GStreamer element type ("encoder",

                        "decoder", "urisource", ""urisink", "element"), and

                        "format" is the type specific search string.

                        Example: "gstreamer0.10(decoder-audio/ac3)"

MIMETYPE:               Mimetypes are (valid) mimetypes strings,

                        for example "application/x-catalog" or "text/plain".

FONT:                   A font name, e.g. "Cantarell".

HARDWARE_DRIVER:

POSTSCRIPT_DRIVER:

                        A string in the format of "postscriptdriver(mfg;mdl;)"

                        where mfg and mdl are the corresponding

                        IEEE 1284 Device ID keys for the printer model,

                        converted to lower-case and with spaces converted

                        to underscores.

                        Example: "postscriptdriver(epson;stylus_d92;)"

PLASMA_SERVICE:         A string in the format of

                        "plasma<version>(servicetype-name)" (where <version> is

                        currently expected to be 4 or 5), e.g.

                        "plasma4(dataengine-weather)". For backwards

                        compatibility, "servicetype-name" will be treated the

                        same as "plasma4(servicetype-name)".

SHARED_LIB:             Name of a shared library

                        Example: "libpackagekit-glib2.so.14"

PYTHON:                 A string in the format of "python<version>(module-name)",

                        or just the name of the Python module.

                        If the Python-Version is omitted, the backend will

                        choose the current default Python version.

                        Example: "python2(packagekit)"

LANGUAGE_SUPPORT:       A string in the format of language(ll_CC) or

                        language(ll), which should correspond to a

                        language/country pair or just a language, as in

                        /usr/share/i18n/SUPPORTED. Returns all packages

                        which provide language support (dictionaries,

                        translated help, ibus modules, etc.) for all packages

                        that are currently installed in the system.

                        Example: "language(zh_CN)" might suggest ibus-pinyin and

                        libreoffice-l10n-zh-cn if you have ibus and LibreOffice

                        installed.