glfs/archive/appstream-glib.xml
Fernando de Oliveira f34293095b • mupdf-1.8: minor reformat.
• removing spaces from EOL, from Denis Mugnier.
• BLFS/trunk/BOOK/kde/add/kdepim-runtime.xml: needed to fix to validate
  the book. One chunck had been removed. Bruce, please check if it is
  OK, now.


git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@16645 af4574ff-66df-0310-9fd7-8a98e5e911e0
2015-11-13 14:24:57 +00:00

267 lines
8.5 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!-- Place this in the packages.ent file
<!ENTITY TEMPLATE-version "">
-->
<!ENTITY appstream-glib-download-http
"http://people.freedesktop.org/~hughsient/appstream-glib/releases/appstream-glib-&appstream-glib-version;.tar.xz">
<!ENTITY appstream-glib-download-ftp " ">
<!ENTITY appstream-glib-md5sum "25f261265b71a4a9944028d4304ebc0d">
<!ENTITY appstream-glib-size "1.8 MB">
<!ENTITY appstream-glib-buildsize "17 MB (with tests)">
<!ENTITY appstream-glib-time "0.1 SBU (with tests)">
]>
<!-- Try to keep the indentation used in this file-->
<sect1 id="appstream-glib" xreflabel="appstream-glib-&appstream-glib-version;">
<?dbhtml filename="appstream-glib.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<!-- No other tags inside any title.
Use Title Case in All Titles -->
<title>appstream-glib-&appstream-glib-version;</title>
<indexterm zone="appstream-glib">
<primary sortas="a-appstream-glib">appstream-glib</primary>
</indexterm>
<!--Required section-->
<sect2 role="package">
<title>Introduction to appstream-glib</title>
<para>
The <application>appstream-glib</application> provides GObjects and
helper methods to make it easy to read and write AppStream metadata.
It also provides a simple DOM implementation that makes it easy to
edit nodes and convert to and from the standardized XML representation.
</para>
&lfs77_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&appstream-glib-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&appstream-glib-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &appstream-glib-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &appstream-glib-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &appstream-glib-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &appstream-glib-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">appstream-glib Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="gdk-pixbuf"/>,
<xref linkend="libarchive"/>
<xref linkend="libsoup"/>, and
<xref linkend="pango"/>
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="gobject-introspection"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="DocBook"/>,
<xref linkend="docbook-xsl"/>,
<xref linkend="gtk-doc"/>,
<xref linkend="libxslt"/>,
<ulink url="http://ftp.gnome.org/pub/GNOME/sources/gcab/">gcab</ulink>, and
<ulink url="http://pyyaml.org/download/libyaml/">yaml</ulink>
</para>
<para condition="html" role="usernotes">
User Notes: <ulink url="&blfs-wiki;/appstream-glib"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of appstream-glib</title>
<para>
Install <application>appstream-glib</application> by running the following
commands:
</para>
<screen><userinput>./configure --prefix=/usr \
--disable-dep11 \
--disable-builder \
--disable-static &amp;&amp;
make</userinput></screen>
<para>
To test the results, issue: <command>make -k check</command>. One test
fails, if <ulink url="http://pyyaml.org/download/libyaml/">yaml</ulink>
is not installed.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<!--Optional section-->
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/static-libraries.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gtk-doc-rebuild.xml"/>
<para>
<parameter>--disable-builder</parameter>: Remove this switch, if you have
<ulink url="http://ftp.gnome.org/pub/GNOME/sources/gcab/">gcab</ulink> installed.
</para>
<para>
<parameter>--disable-dep11</parameter>: Remove this switch, if you have
<ulink url="http://pyyaml.org/download/libyaml/">yaml</ulink> installed.
</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<!-- If there were no programs, libraries, or directories created, then
we would list the section as "None". However, a decision must have
been made to change the "None" to just removing the whole section
because I've noticed that many packages have had the "None"
removed and the section completely removed as well. The reasoning
was that by putting "None", it appears as we know there are none.
Without anything it appears as we are not sure. -->
<seglistitem>
<seg>
appdata-validate and appstream-util
</seg>
<seg>
libappstream-glib.so
</seg>
<seg>
/usr/include/libappstream-glib,
/usr/share/gtk-doc/html/appstream-glib and
/usr/share/installed-tests/appstream-glib
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<!-- If the program or library name conflicts (is the same) as the
package name, add -prog or -lib to the varlistentry entity id
and the 2nd entry of the indexterm zone entity -->
<!-- <varlistentry id="appstream-builder">
<term><command>appstream-builder</command></term>
<listitem>
<para>
Is a developers tool to build metadata.
</para>
<indexterm zone="appstream-glib appstream-builder">
<primary sortas="b-appstream-builder">appstream-builder</primary>
</indexterm>
</listitem>
</varlistentry>-->
<varlistentry id="appdata-validate">
<term><command>appdata-validate</command></term>
<listitem>
<para>
validates AppData metadata.
</para>
<indexterm zone="appstream-glib appdata-validate">
<primary sortas="b-appdata-validate">appdata-validate</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="appstream-util">
<term><command>appstream-util</command></term>
<listitem>
<para>
Is a management tool for appstream-builder.
</para>
<indexterm zone="appstream-glib appstream-util">
<primary sortas="b-appstream-util">appstream-util</primary>
</indexterm>
</listitem>
</varlistentry>
<!-- <varlistentry id="libappstream-builder">
<term><filename class="libraryfile">libappstream-builder.so</filename></term>
<listitem>
<para>
contains functions that aid the developers tool appstream-builder.
</para>
<indexterm zone="appstream-glib libappstream-builder">
<primary sortas="c-libappstream-builder">libappstream-builder.so</primary>
</indexterm>
</listitem>
</varlistentry>-->
<varlistentry id="libappstream-glib">
<term><filename class="libraryfile">libappstream-glib.so</filename></term>
<listitem>
<para>
contains the api functions.
</para>
<indexterm zone="appstream-glib libappstream-glib">
<primary sortas="c-libappstream-glib">libappstream-glib.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>