<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
[
  <!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
]>
<refentry id="AsRelease">
<refmeta>
<refentrytitle role="top_of_page" id="AsRelease.top_of_page">AsRelease</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>APPSTREAM Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>AsRelease</refname>
<refpurpose>Object representing a single upstream release</refpurpose>
</refnamediv>

<refsect1 id="AsRelease.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_return" colwidth="150px"/>
<colspec colname="functions_name"/>
<tbody>
<row><entry role="function_type">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="as-checksum-kind-to-string">as_checksum_kind_to_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="AsChecksumKind"><returnvalue>AsChecksumKind</returnvalue></link>
</entry><entry role="function_name"><link linkend="as-checksum-kind-from-string">as_checksum_kind_from_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="as-size-kind-to-string">as_size_kind_to_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="AsSizeKind"><returnvalue>AsSizeKind</returnvalue></link>
</entry><entry role="function_name"><link linkend="as-size-kind-from-string">as_size_kind_from_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="AsRelease"><returnvalue>AsRelease</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="as-release-new">as_release_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="as-release-get-version">as_release_get_version</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="as-release-set-version">as_release_set_version</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="guint64"><returnvalue>guint64</returnvalue></link>
</entry><entry role="function_name"><link linkend="as-release-get-timestamp">as_release_get_timestamp</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="as-release-set-timestamp">as_release_set_timestamp</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="as-release-get-description">as_release_get_description</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="as-release-set-description">as_release_set_description</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="as-release-get-active-locale">as_release_get_active_locale</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="as-release-set-active-locale">as_release_set_active_locale</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GPtrArray"><returnvalue>GPtrArray</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="as-release-get-locations">as_release_get_locations</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="as-release-add-location">as_release_add_location</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="as-release-get-checksum">as_release_get_checksum</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="as-release-set-checksum">as_release_set_checksum</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="AsUrgencyKind"><returnvalue>AsUrgencyKind</returnvalue></link>
</entry><entry role="function_name"><link linkend="as-release-get-urgency">as_release_get_urgency</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="as-release-set-urgency">as_release_set_urgency</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="guint64"><returnvalue>guint64</returnvalue></link>
</entry><entry role="function_name"><link linkend="as-release-get-size">as_release_get_size</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="as-release-set-size">as_release_set_size</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="AsRelease.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="name" colwidth="150px"/>
<colspec colname="description"/>
<tbody>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="AS-TYPE-RELEASE:CAPS">AS_TYPE_RELEASE</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="AsReleaseClass">AsReleaseClass</link></entry></row>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="AsChecksumKind">AsChecksumKind</link></entry></row>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="AsSizeKind">AsSizeKind</link></entry></row>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="AsRelease-struct">AsRelease</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="AsRelease.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> AsRelease
</screen>
</refsect1>

<refsect1 id="AsRelease.includes"><title>Includes</title><synopsis>#include &lt;appstream.h&gt;
</synopsis></refsect1>

<refsect1 id="AsRelease.description" role="desc">
<title role="desc.title">Description</title>
<para>This object represents a single upstream release, typically a minor update.
Releases can contain a localized description of paragraph and list elements
and also have a version number and timestamp.</para>
<para>Releases can be automatically generated by parsing upstream ChangeLogs or
.spec files, or can be populated using MetaInfo files.</para>
<para>See also: <link linkend="AsComponent"><type>AsComponent</type></link></para>

</refsect1>
<refsect1 id="AsRelease.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="as-checksum-kind-to-string" role="function">
<title>as_checksum_kind_to_string&#160;()</title>
<indexterm zone="as-checksum-kind-to-string"><primary>as_checksum_kind_to_string</primary></indexterm>
<programlisting language="C">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
as_checksum_kind_to_string (<parameter><link linkend="AsChecksumKind"><type>AsChecksumKind</type></link> kind</parameter>);</programlisting>
<para>Converts the enumerated value to an text representation.</para>
<refsect3 id="as-checksum-kind-to-string.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>kind</para></entry>
<entry role="parameter_description"><para>the <link linkend="AsChecksumKind"><literal>AsChecksumKind</literal></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="as-checksum-kind-to-string.returns" role="returns">
<title>Returns</title>
<para> string version of <parameter>kind</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="as-checksum-kind-from-string" role="function">
<title>as_checksum_kind_from_string&#160;()</title>
<indexterm zone="as-checksum-kind-from-string"><primary>as_checksum_kind_from_string</primary></indexterm>
<programlisting language="C"><link linkend="AsChecksumKind"><returnvalue>AsChecksumKind</returnvalue></link>
as_checksum_kind_from_string (<parameter>const <link linkend="gchar"><type>gchar</type></link> *kind_str</parameter>);</programlisting>
<para>Converts the text representation to an enumerated value.</para>
<refsect3 id="as-checksum-kind-from-string.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>kind_str</para></entry>
<entry role="parameter_description"><para>the string.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="as-checksum-kind-from-string.returns" role="returns">
<title>Returns</title>
<para> a <link linkend="AsChecksumKind"><type>AsChecksumKind</type></link> or <link linkend="AS-CHECKSUM-KIND-NONE:CAPS"><literal>AS_CHECKSUM_KIND_NONE</literal></link> for unknown</para>
</refsect3></refsect2>
<refsect2 id="as-size-kind-to-string" role="function" condition="since:0.8.6">
<title>as_size_kind_to_string&#160;()</title>
<indexterm zone="as-size-kind-to-string" role="0.8.6"><primary>as_size_kind_to_string</primary></indexterm>
<programlisting language="C">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
as_size_kind_to_string (<parameter><link linkend="AsSizeKind"><type>AsSizeKind</type></link> size_kind</parameter>);</programlisting>
<para>Converts the enumerated value to an text representation.</para>
<refsect3 id="as-size-kind-to-string.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>size_kind</para></entry>
<entry role="parameter_description"><para>the <link linkend="AsSizeKind"><type>AsSizeKind</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="as-size-kind-to-string.returns" role="returns">
<title>Returns</title>
<para> string version of <parameter>size_kind</parameter>
</para>
</refsect3><para role="since">Since: <link linkend="api-index-0.8.6">0.8.6</link></para></refsect2>
<refsect2 id="as-size-kind-from-string" role="function" condition="since:0.8.6">
<title>as_size_kind_from_string&#160;()</title>
<indexterm zone="as-size-kind-from-string" role="0.8.6"><primary>as_size_kind_from_string</primary></indexterm>
<programlisting language="C"><link linkend="AsSizeKind"><returnvalue>AsSizeKind</returnvalue></link>
as_size_kind_from_string (<parameter>const <link linkend="gchar"><type>gchar</type></link> *size_kind</parameter>);</programlisting>
<para>Converts the text representation to an enumerated value.</para>
<refsect3 id="as-size-kind-from-string.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>size_kind</para></entry>
<entry role="parameter_description"><para>the string.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="as-size-kind-from-string.returns" role="returns">
<title>Returns</title>
<para> an <link linkend="AsSizeKind"><type>AsSizeKind</type></link> or <link linkend="AS-SIZE-KIND-UNKNOWN:CAPS"><literal>AS_SIZE_KIND_UNKNOWN</literal></link> for unknown</para>
</refsect3><para role="since">Since: <link linkend="api-index-0.8.6">0.8.6</link></para></refsect2>
<refsect2 id="as-release-new" role="function">
<title>as_release_new&#160;()</title>
<indexterm zone="as-release-new"><primary>as_release_new</primary></indexterm>
<programlisting language="C"><link linkend="AsRelease"><returnvalue>AsRelease</returnvalue></link>&#160;*
as_release_new (<parameter><type>void</type></parameter>);</programlisting>
<para>Creates a new <link linkend="AsRelease"><type>AsRelease</type></link>.</para>
<refsect3 id="as-release-new.returns" role="returns">
<title>Returns</title>
<para> a <link linkend="AsRelease"><type>AsRelease</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="as-release-get-version" role="function">
<title>as_release_get_version&#160;()</title>
<indexterm zone="as-release-get-version"><primary>as_release_get_version</primary></indexterm>
<programlisting language="C">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
as_release_get_version (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>);</programlisting>
<para>Gets the release version.</para>
<refsect3 id="as-release-get-version.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>release</para></entry>
<entry role="parameter_description"><para>a <link linkend="AsRelease"><type>AsRelease</type></link> instance.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="as-release-get-version.returns" role="returns">
<title>Returns</title>
<para> string, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> for not set or invalid</para>
</refsect3></refsect2>
<refsect2 id="as-release-set-version" role="function">
<title>as_release_set_version&#160;()</title>
<indexterm zone="as-release-set-version"><primary>as_release_set_version</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
as_release_set_version (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>,
                        <parameter>const <link linkend="gchar"><type>gchar</type></link> *version</parameter>);</programlisting>
<para>Sets the release version.</para>
<refsect3 id="as-release-set-version.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>release</para></entry>
<entry role="parameter_description"><para>a <link linkend="AsRelease"><type>AsRelease</type></link> instance.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>version</para></entry>
<entry role="parameter_description"><para>the version string.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="as-release-get-timestamp" role="function">
<title>as_release_get_timestamp&#160;()</title>
<indexterm zone="as-release-get-timestamp"><primary>as_release_get_timestamp</primary></indexterm>
<programlisting language="C"><link linkend="guint64"><returnvalue>guint64</returnvalue></link>
as_release_get_timestamp (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>);</programlisting>
<para>Gets the release timestamp.</para>
<refsect3 id="as-release-get-timestamp.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>release</para></entry>
<entry role="parameter_description"><para>a <link linkend="AsRelease"><type>AsRelease</type></link> instance.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="as-release-get-timestamp.returns" role="returns">
<title>Returns</title>
<para> timestamp, or 0 for unset</para>
</refsect3></refsect2>
<refsect2 id="as-release-set-timestamp" role="function">
<title>as_release_set_timestamp&#160;()</title>
<indexterm zone="as-release-set-timestamp"><primary>as_release_set_timestamp</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
as_release_set_timestamp (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>,
                          <parameter><link linkend="guint64"><type>guint64</type></link> timestamp</parameter>);</programlisting>
<para>Sets the release timestamp.</para>
<refsect3 id="as-release-set-timestamp.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>release</para></entry>
<entry role="parameter_description"><para>a <link linkend="AsRelease"><type>AsRelease</type></link> instance.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>timestamp</para></entry>
<entry role="parameter_description"><para>the timestamp value.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="as-release-get-description" role="function">
<title>as_release_get_description&#160;()</title>
<indexterm zone="as-release-get-description"><primary>as_release_get_description</primary></indexterm>
<programlisting language="C">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
as_release_get_description (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>);</programlisting>
<para>Gets the release description markup for a given locale.</para>
<refsect3 id="as-release-get-description.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>release</para></entry>
<entry role="parameter_description"><para>a <link linkend="AsRelease"><type>AsRelease</type></link> instance.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="as-release-get-description.returns" role="returns">
<title>Returns</title>
<para> markup, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> for not set or invalid</para>
</refsect3></refsect2>
<refsect2 id="as-release-set-description" role="function">
<title>as_release_set_description&#160;()</title>
<indexterm zone="as-release-set-description"><primary>as_release_set_description</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
as_release_set_description (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>,
                            <parameter>const <link linkend="gchar"><type>gchar</type></link> *description</parameter>,
                            <parameter>const <link linkend="gchar"><type>gchar</type></link> *locale</parameter>);</programlisting>
<para>Sets the description release markup.</para>
<refsect3 id="as-release-set-description.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>release</para></entry>
<entry role="parameter_description"><para>a <link linkend="AsRelease"><type>AsRelease</type></link> instance.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>description</para></entry>
<entry role="parameter_description"><para>the description markup.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="as-release-get-active-locale" role="function">
<title>as_release_get_active_locale&#160;()</title>
<indexterm zone="as-release-get-active-locale"><primary>as_release_get_active_locale</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
as_release_get_active_locale (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>);</programlisting>
<para>Get the current active locale, which
is used to get localized messages.</para>
</refsect2>
<refsect2 id="as-release-set-active-locale" role="function">
<title>as_release_set_active_locale&#160;()</title>
<indexterm zone="as-release-set-active-locale"><primary>as_release_set_active_locale</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
as_release_set_active_locale (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>,
                              <parameter>const <link linkend="gchar"><type>gchar</type></link> *locale</parameter>);</programlisting>
<para>Set the current active locale, which
is used to get localized messages.
If the <link linkend="AsComponent"><type>AsComponent</type></link> linking this <link linkend="AsRelease"><type>AsRelease</type></link> was fetched
from a localized database, usually only
one locale is available.</para>
</refsect2>
<refsect2 id="as-release-get-locations" role="function" condition="since:0.8.1">
<title>as_release_get_locations&#160;()</title>
<indexterm zone="as-release-get-locations" role="0.8.1"><primary>as_release_get_locations</primary></indexterm>
<programlisting language="C"><link linkend="GPtrArray"><returnvalue>GPtrArray</returnvalue></link>&#160;*
as_release_get_locations (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>);</programlisting>
<para>Gets the release locations, typically URLs.</para>
<refsect3 id="as-release-get-locations.returns" role="returns">
<title>Returns</title>
<para> list of locations. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>element-type</acronym> utf8]</emphasis></para>
</refsect3><para role="since">Since: <link linkend="api-index-0.8.1">0.8.1</link></para></refsect2>
<refsect2 id="as-release-add-location" role="function" condition="since:0.8.1">
<title>as_release_add_location&#160;()</title>
<indexterm zone="as-release-add-location" role="0.8.1"><primary>as_release_add_location</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
as_release_add_location (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>,
                         <parameter>const <link linkend="gchar"><type>gchar</type></link> *location</parameter>);</programlisting>
<para>Adds a release location.</para>
<refsect3 id="as-release-add-location.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>location</para></entry>
<entry role="parameter_description"><para>An URL of the download location</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-0.8.1">0.8.1</link></para></refsect2>
<refsect2 id="as-release-get-checksum" role="function" condition="since:0.8.2">
<title>as_release_get_checksum&#160;()</title>
<indexterm zone="as-release-get-checksum" role="0.8.2"><primary>as_release_get_checksum</primary></indexterm>
<programlisting language="C">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
as_release_get_checksum (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>,
                         <parameter><link linkend="AsChecksumKind"><type>AsChecksumKind</type></link> kind</parameter>);</programlisting>
<para>Gets the release checksum</para>
<refsect3 id="as-release-get-checksum.returns" role="returns">
<title>Returns</title>
<para> string, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> for not set or invalid</para>
</refsect3><para role="since">Since: <link linkend="api-index-0.8.2">0.8.2</link></para></refsect2>
<refsect2 id="as-release-set-checksum" role="function" condition="since:0.8.2">
<title>as_release_set_checksum&#160;()</title>
<indexterm zone="as-release-set-checksum" role="0.8.2"><primary>as_release_set_checksum</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
as_release_set_checksum (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>,
                         <parameter>const <link linkend="gchar"><type>gchar</type></link> *checksum</parameter>,
                         <parameter><link linkend="AsChecksumKind"><type>AsChecksumKind</type></link> kind</parameter>);</programlisting>
<para>Set the release checksum.</para>
<refsect3 id="as-release-set-checksum.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>release</para></entry>
<entry role="parameter_description"><para>An instance of <link linkend="AsRelease"><type>AsRelease</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>checksum</para></entry>
<entry role="parameter_description"><para>The checksum as string.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>kind</para></entry>
<entry role="parameter_description"><para>The kind of this checksum, e.g. <link linkend="AS-CHECKSUM-KIND-SHA256:CAPS"><literal>AS_CHECKSUM_KIND_SHA256</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-0.8.2">0.8.2</link></para></refsect2>
<refsect2 id="as-release-get-urgency" role="function" condition="since:0.6.5">
<title>as_release_get_urgency&#160;()</title>
<indexterm zone="as-release-get-urgency" role="0.6.5"><primary>as_release_get_urgency</primary></indexterm>
<programlisting language="C"><link linkend="AsUrgencyKind"><returnvalue>AsUrgencyKind</returnvalue></link>
as_release_get_urgency (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>);</programlisting>
<para>Gets the urgency of the release
(showing how important it is to update to a more recent release)</para>
<refsect3 id="as-release-get-urgency.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>release</para></entry>
<entry role="parameter_description"><para>a <link linkend="AsRelease"><type>AsRelease</type></link> instance.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="as-release-get-urgency.returns" role="returns">
<title>Returns</title>
<para> <link linkend="AsUrgencyKind"><type>AsUrgencyKind</type></link>, or <link linkend="AS-URGENCY-KIND-UNKNOWN:CAPS"><literal>AS_URGENCY_KIND_UNKNOWN</literal></link> for not set</para>
</refsect3><para role="since">Since: <link linkend="api-index-0.6.5">0.6.5</link></para></refsect2>
<refsect2 id="as-release-set-urgency" role="function" condition="since:0.6.5">
<title>as_release_set_urgency&#160;()</title>
<indexterm zone="as-release-set-urgency" role="0.6.5"><primary>as_release_set_urgency</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
as_release_set_urgency (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>,
                        <parameter><link linkend="AsUrgencyKind"><type>AsUrgencyKind</type></link> urgency</parameter>);</programlisting>
<para>Sets the release urgency.</para>
<refsect3 id="as-release-set-urgency.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>release</para></entry>
<entry role="parameter_description"><para>a <link linkend="AsRelease"><type>AsRelease</type></link> instance.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>urgency</para></entry>
<entry role="parameter_description"><para>the urgency of this release/update (as <link linkend="AsUrgencyKind"><type>AsUrgencyKind</type></link>)</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-0.6.5">0.6.5</link></para></refsect2>
<refsect2 id="as-release-get-size" role="function" condition="since:0.8.6">
<title>as_release_get_size&#160;()</title>
<indexterm zone="as-release-get-size" role="0.8.6"><primary>as_release_get_size</primary></indexterm>
<programlisting language="C"><link linkend="guint64"><returnvalue>guint64</returnvalue></link>
as_release_get_size (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>,
                     <parameter><link linkend="AsSizeKind"><type>AsSizeKind</type></link> kind</parameter>);</programlisting>
<para>Gets the release size.</para>
<refsect3 id="as-release-get-size.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>release</para></entry>
<entry role="parameter_description"><para>a <link linkend="AsRelease"><type>AsRelease</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>kind</para></entry>
<entry role="parameter_description"><para>a <link linkend="AsSizeKind"><type>AsSizeKind</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="as-release-get-size.returns" role="returns">
<title>Returns</title>
<para> The size of the given kind of this release.</para>
</refsect3><para role="since">Since: <link linkend="api-index-0.8.6">0.8.6</link></para></refsect2>
<refsect2 id="as-release-set-size" role="function" condition="since:0.8.6">
<title>as_release_set_size&#160;()</title>
<indexterm zone="as-release-set-size" role="0.8.6"><primary>as_release_set_size</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
as_release_set_size (<parameter><link linkend="AsRelease"><type>AsRelease</type></link> *release</parameter>,
                     <parameter><link linkend="guint64"><type>guint64</type></link> size</parameter>,
                     <parameter><link linkend="AsSizeKind"><type>AsSizeKind</type></link> kind</parameter>);</programlisting>
<para>Sets the release size for the given kind.</para>
<refsect3 id="as-release-set-size.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>release</para></entry>
<entry role="parameter_description"><para>a <link linkend="AsRelease"><type>AsRelease</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>size</para></entry>
<entry role="parameter_description"><para>a size in bytes, or 0 for unknown</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>kind</para></entry>
<entry role="parameter_description"><para>a <link linkend="AsSizeKind"><type>AsSizeKind</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-0.8.6">0.8.6</link></para></refsect2>

</refsect1>
<refsect1 id="AsRelease.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="AS-TYPE-RELEASE:CAPS" role="macro">
<title>AS_TYPE_RELEASE</title>
<indexterm zone="AS-TYPE-RELEASE:CAPS"><primary>AS_TYPE_RELEASE</primary></indexterm>
<programlisting language="C">#define AS_TYPE_RELEASE (as_release_get_type ())
</programlisting>
<para>
</para>
</refsect2>
<refsect2 id="AsReleaseClass" role="struct">
<title>struct AsReleaseClass</title>
<indexterm zone="AsReleaseClass"><primary>AsReleaseClass</primary></indexterm>
<programlisting language="C">struct AsReleaseClass {
	GObjectClass		parent_class;
};
</programlisting>
<para>
</para>
</refsect2>
<refsect2 id="AsChecksumKind" role="enum">
<title>enum AsChecksumKind</title>
<indexterm zone="AsChecksumKind"><primary>AsChecksumKind</primary></indexterm>
<para>Checksums supported by <link linkend="AsRelease"><type>AsRelease</type></link></para>
<refsect3 id="AsChecksumKind.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="AS-CHECKSUM-KIND-NONE:CAPS">AS_CHECKSUM_KIND_NONE</para></entry>
<entry role="enum_member_description"><para>No checksum</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="AS-CHECKSUM-KIND-SHA1:CAPS">AS_CHECKSUM_KIND_SHA1</para></entry>
<entry role="enum_member_description"><para>SHA1</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="AS-CHECKSUM-KIND-SHA256:CAPS">AS_CHECKSUM_KIND_SHA256</para></entry>
<entry role="enum_member_description"><para>SHA256</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="AsSizeKind" role="enum" condition="since:0.8.6">
<title>enum AsSizeKind</title>
<indexterm zone="AsSizeKind" role="0.8.6"><primary>AsSizeKind</primary></indexterm>
<para>The release size kind.</para>
<refsect3 id="AsSizeKind.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="AS-SIZE-KIND-UNKNOWN:CAPS">AS_SIZE_KIND_UNKNOWN</para></entry>
<entry role="enum_member_description"><para>Unknown size</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="AS-SIZE-KIND-DOWNLOAD:CAPS">AS_SIZE_KIND_DOWNLOAD</para></entry>
<entry role="enum_member_description"><para>Size of download of component</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="AS-SIZE-KIND-INSTALLED:CAPS">AS_SIZE_KIND_INSTALLED</para></entry>
<entry role="enum_member_description"><para>Size of installed component</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-0.8.6">0.8.6</link></para></refsect2>
<refsect2 id="AsRelease-struct" role="struct">
<title>AsRelease</title>
<indexterm zone="AsRelease-struct"><primary>AsRelease</primary></indexterm>
<programlisting language="C">typedef struct _AsRelease AsRelease;</programlisting>
<para>
</para>
</refsect2>

</refsect1>

</refentry>
