<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "AppStream.ent">
%BOOK_ENTITIES;
]>
<chapter id="chap-Metadata">
	<title>Upstream Metadata</title>
	<para>
		AppStream allows upstream projects to define metadata about the components they provide using small XML files,
		metainfo files,	which get installed into locations on the client system and are used by distribuors to enhance their
		metadata.
	</para>
	<para>
		A "component" is a piece of software, like an application, a library, a font or a codec. For several components, especially
		those which are shown in software-centers, we provide specialized metainfo files to define specific properties and data of these components.
		For example, applications and fonts support screenshots, while codecs don't.
	</para>
	<para>
		All metainfo files need to contain a minimal amount of information, defined in the "Generic Component" section, which also describes some optional
		elements which can be used.
		Specialized components might require more information to be complete and valid.
	</para>

	<xi:include href="component.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
	<xi:include href="appdata.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
	<xi:include href="addondata.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
	<xi:include href="fontdata.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
	<xi:include href="codecdata.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
	<xi:include href="inputmethoddata.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
	<xi:include href="firmwaredata.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />

</chapter>
