diff --git a/docs/xml/Book_Info.xml b/docs/xml/Book_Info.xml index 1af5ff9b..5f605e3b 100644 --- a/docs/xml/Book_Info.xml +++ b/docs/xml/Book_Info.xml @@ -17,7 +17,7 @@ AppStream provides the foundation to build software-center applications. - It additionally provides specifications for things like an unified software metadata database, + It additionally provides specifications for things like a unified software metadata database, screenshot services and various other things needed to create user-friendly application-centers for software distributions. diff --git a/docs/xml/collection-yamldata.xml b/docs/xml/collection-yamldata.xml index b3624190..df4ded70 100644 --- a/docs/xml/collection-yamldata.xml +++ b/docs/xml/collection-yamldata.xml @@ -969,9 +969,9 @@ == - Equal to != - Not equal to - << - Lesser than + << - Less than >> - Greater than - <= - Lesser than or equal to + <= - Less than or equal to >= - Greater than or equal to diff --git a/docs/xml/man/appstreamcli.1.xml b/docs/xml/man/appstreamcli.1.xml index 7d110c46..21daed1e 100644 --- a/docs/xml/man/appstreamcli.1.xml +++ b/docs/xml/man/appstreamcli.1.xml @@ -223,9 +223,9 @@ eq - Equal to ne - Not equal to - lt - Lesser than + lt - Less than gt - Greater than - le - Lesser than or equal to + le - Less than or equal to ge - Greater than or equal to diff --git a/docs/xml/metainfo-component.xml b/docs/xml/metainfo-component.xml index 7b043baf..be3d5872 100644 --- a/docs/xml/metainfo-component.xml +++ b/docs/xml/metainfo-component.xml @@ -259,7 +259,7 @@ <categories/> - This tag can contain one or more <category>> entries, describing the categories this software component + This tag can contain one or more <category> entries, describing the categories this software component is associated with. This tag is usually applied to components of type desktop-application, but can be used with any component. A list of valid category names can be found in the @@ -349,7 +349,7 @@ URLs of this type should allow the user to contact the developer. - This could for example be a HTTPS URL to an online form or a page describing how to contact the developer. + This could for example be an HTTPS URL to an online form or a page describing how to contact the developer. Deprecation @@ -375,7 +375,7 @@ - The <launchable/> tag has a essential type property indicating the system that is used to launch the component. The following types are allowed: + The <launchable/> tag has an essential type property indicating the system that is used to launch the component. The following types are allowed: @@ -509,10 +509,10 @@ - A release may also have an url tag as child. + A release may also have a url tag as child. The release url should point to detailed release notes that explain the changes made in this particular release. The url tag may have a type property with details as the only currently - allowed value. If the type is missing, an URL type of details is implicitly assumed. + allowed value. If the type is missing, a URL type of details is implicitly assumed. @@ -640,7 +640,7 @@ This includes binaries and libraries. Private interfaces should never be added to a provides tag. - A provides tag contain a number of children describing the type and name of the provided public interface items. + A provides tag contains a number of children describing the type and name of the provided public interface items. It is suggested that the build system auto-generates this tag and its children. Currently allowed item types are listed below. If you miss something, file a bug against AppStream so we can add the new type. @@ -710,7 +710,7 @@ <firmware/> - This provided element is described in details for the firmware component type, where it is mandatory. + This provided element is described in detail for the firmware component type, where it is mandatory. Please see for more information. @@ -806,9 +806,9 @@ eq - Equal to ne - Not equal to - lt - Lesser than + lt - Less than gt - Greater than - le - Lesser than or equal to + le - Less than or equal to ge - Greater than or equal to @@ -834,7 +834,7 @@ <modalias/> - Check for a specific hardware to be present via its modalias. The modalias may contain a wildcard expression. + Check for specific hardware to be present via its modalias. The modalias may contain a wildcard expression. Example: @@ -1122,7 +1122,7 @@ The <project_license/> tag is indicating the license of the component (application/library/addon/font/etc.) described in the metadata document. - It should be a SPDX license expression. Please note the SPDX license IDs are case-sensitive in AppStream. + It should be an SPDX license expression. Please note the SPDX license IDs are case-sensitive in AppStream. Possible values include: GPL-2.0 @@ -1167,7 +1167,7 @@ Values might be for example "The GNOME Foundation" or "The KDE Community". - You must not include hyperlinks or emails in this field, if you want to link to the developer's homepage, use the -tag instead. + You must not include hyperlinks or emails in this field; if you want to link to the developer's homepage, use the -tag instead. This tag is translatable. @@ -1193,7 +1193,7 @@ The value of the <image/> tag is a direct HTTP/HTTPS URL to a screenshot uploaded to a public location on the web. - Images should ideally be provided in the PNG format, using JPEG or WebP is also permitted for images in metainfo files. + Images should ideally be provided in the PNG format; using JPEG or WebP is also permitted for images in metainfo files. The <image/> tag may have the following properties: @@ -1508,7 +1508,7 @@ The tag must have value children which must have a key property. The value of the value tag denotes a user-defined value, while the key string set for the key property denotes a user-specified key string. - The key must be unique, multiple keys with the same name are not allowed. + The key must be unique; multiple keys with the same name are not allowed. To avoid name conflicts, it is recommended to prefix keys with a vendor prefix, like GNOME:: or KDE::.