[blfs-book] r12927 - in trunk/BOOK: . general/genutils introduction/welcome

fernando at higgs.linuxfromscratch.org fernando at higgs.linuxfromscratch.org
Thu Apr 3 12:28:38 PDT 2014


Author: fernando
Date: Thu Apr  3 12:28:38 2014
New Revision: 12927

Log:
Add new package appdata-tools-0.1.7.

Added:
   trunk/BOOK/general/genutils/appdata-tools.xml
      - copied, changed from r12926, trunk/BOOK/general/genutils/intltool.xml
Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/genutils/genutils.xml
   trunk/BOOK/introduction/welcome/changelog.xml

Modified: trunk/BOOK/general.ent
==============================================================================
--- trunk/BOOK/general.ent	Wed Apr  2 08:18:10 2014	(r12926)
+++ trunk/BOOK/general.ent	Thu Apr  3 12:28:38 2014	(r12927)
@@ -1,12 +1,12 @@
 <!-- $LastChangedBy$ $Date$ -->
 
-<!ENTITY day          "02">                   <!-- Always 2 digits -->
+<!ENTITY day          "03">                   <!-- Always 2 digits -->
 <!ENTITY month        "04">                   <!-- Always 2 digits -->
 <!ENTITY year         "2014">
 <!ENTITY copyrightdate "2001-&year;">
 <!ENTITY copyholder   "The BLFS Development Team">
 <!ENTITY version      "&year;-&month;-&day;">
-<!ENTITY releasedate  "April 2nd, &year;">
+<!ENTITY releasedate  "April 3rd, &year;">
 <!ENTITY pubdate      "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
 <!ENTITY blfs-version "svn">                  <!-- svn|[release #] -->
 <!ENTITY lfs-version  "development">          <!-- x.y|development] -->
@@ -308,6 +308,7 @@
 <!ENTITY qpdf-version                 "5.1.1">
 
 <!-- Chapter 11 -->
+<!ENTITY appdata-tools-version        "0.1.7">
 <!ENTITY compface-version             "1.5.2">
 <!ENTITY desktop-file-utils-version   "0.22">
 <!ENTITY gperf-version                "3.0.4">

Copied and modified: trunk/BOOK/general/genutils/appdata-tools.xml (from r12926, trunk/BOOK/general/genutils/intltool.xml)
==============================================================================
--- trunk/BOOK/general/genutils/intltool.xml	Wed Apr  2 08:18:10 2014	(r12926, copy source)
+++ trunk/BOOK/general/genutils/appdata-tools.xml	Thu Apr  3 12:28:38 2014	(r12927)
@@ -4,39 +4,34 @@
   <!ENTITY % general-entities SYSTEM "../../general.ent">
   %general-entities;
 
-  <!ENTITY intltool-download-http "http://launchpad.net/intltool/trunk/&intltool-version;/+download/intltool-&intltool-version;.tar.gz">
-  <!ENTITY intltool-download-ftp  " ">
-  <!ENTITY intltool-md5sum        "23fbd879118253cb99aeac067da5f591">
-  <!ENTITY intltool-size          "188 KB">
-  <!ENTITY intltool-buildsize     "1.4 MB">
-  <!ENTITY intltool-time          "less than 0.1 SBU">
+  <!ENTITY appdata-tools-download-http "http://people.freedesktop.org/~hughsient/releases/appdata-tools-&appdata-tools-version;.tar.xz">
+  <!ENTITY appdata-tools-download-ftp  " ">
+  <!ENTITY appdata-tools-md5sum        "adc82ce1d396c45203a842a508114ead">
+  <!ENTITY appdata-tools-size          "260 KB">
+  <!ENTITY appdata-tools-buildsize     "2.7 MB (additional 0.3 MB for the tests)">
+  <!ENTITY appdata-tools-time          "less than 0.1 SBU">
 ]>
 
-<sect1 id="intltool" xreflabel="Intltool-&intltool-version;">
-  <?dbhtml filename="intltool.html"?>
+<sect1 id="appdata-tools" xreflabel="appdata-tools-&appdata-tools-version;">
+  <?dbhtml filename="appdata-tools.html"?>
 
   <sect1info>
     <othername>$LastChangedBy$</othername>
     <date>$Date$</date>
   </sect1info>
 
-  <title>Intltool-&intltool-version;</title>
+  <title>appdata-tools-&appdata-tools-version;</title>
 
-  <indexterm zone="intltool">
-    <primary sortas="a-Intltool">Intltool</primary>
+  <indexterm zone="appdata-tools">
+    <primary sortas="a-appdata-tools">appdata-tools</primary>
   </indexterm>
 
   <sect2 role="package">
-    <title>Introduction to Intltool</title>
+    <title>Introduction to appdata-tools</title>
 
     <para>
-      The <application>Intltool</application> is an internationalization
-      tool used for extracting translatable strings from source files,
-      collecting the extracted strings with messages from traditional
-      source files (<filename class="directory"><source
-      directory>/<package>/po</filename>) and merging the
-      translations into <filename>.xml</filename>,
-      <filename>.desktop</filename> and <filename>.oaf</filename> files.
+      The <application>appdata-tools</application> is used to validate AppData
+      files to conform to standard specification.
     </para>
 
     &lfs75_checked;
@@ -45,53 +40,70 @@
     <itemizedlist spacing="compact">
       <listitem>
         <para>
-          Download (HTTP): <ulink url="&intltool-download-http;"/>
+          Download (HTTP): <ulink url="&appdata-tools-download-http;"/>
         </para>
       </listitem>
       <listitem>
         <para>
-          Download (FTP): <ulink url="&intltool-download-ftp;"/>
+          Download (FTP): <ulink url="&appdata-tools-download-ftp;"/>
         </para>
       </listitem>
       <listitem>
         <para>
-          Download MD5 sum: &intltool-md5sum;
+          Download MD5 sum: &appdata-tools-md5sum;
         </para>
       </listitem>
       <listitem>
         <para>
-          Download size: &intltool-size;
+          Download size: &appdata-tools-size;
         </para>
       </listitem>
       <listitem>
         <para>
-          Estimated disk space required: &intltool-buildsize;
+          Estimated disk space required: &appdata-tools-buildsize;
         </para>
       </listitem>
       <listitem>
         <para>
-          Estimated build time: &intltool-time;
+          Estimated build time: &appdata-tools-time;
         </para>
       </listitem>
     </itemizedlist>
 
-    <bridgehead renderas="sect3">Intltool Dependencies</bridgehead>
+    <bridgehead renderas="sect3">appdata-tools Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Required</bridgehead>
     <para role="required">
-      <xref linkend="perl-xml-parser"/>
+      <xref linkend="gdk-pixbuf"/>,
+      <xref linkend="intltool"/>, and
+      <xref linkend="libsoup"/>
+    </para>
+
+    <bridgehead renderas="sect4">Recommended</bridgehead>
+    <para role="recommended">
+      <xref linkend="gobject-introspection"/>
+    </para>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional">
+      <xref linkend="libxml2"/>,
+      <xref linkend="libxslt"/>,
+      <xref linkend="DocBook"/>,
+      <xref linkend="docbook-xsl"/>,
+      <ulink url="http://www.thaiopensource.com/download/old/relaxng/20030619/trang.html">trang</ulink>, and
+      <ulink url="http://lxml.de/index.html">lxml</ulink>
     </para>
 
     <para condition="html" role="usernotes">User Notes:
-      <ulink url="&blfs-wiki;/intltool"/>
+      <ulink url="&blfs-wiki;/appdata-tools"/>
     </para>
   </sect2>
 
   <sect2 role="installation">
-    <title>Installation of Intltool</title>
+    <title>Installation of appdata-tools</title>
 
     <para>
-      Install <application>Intltool</application> by running the following
+      Install <application>appdata-tools</application> by running the following
       commands:
     </para>
 
@@ -106,9 +118,7 @@
       Now, as the <systemitem class="username">root</systemitem> user:
     </para>
 
-<screen role="root"><userinput>make install &&
-install -v -m644 -D doc/I18N-HOWTO \
-    /usr/share/doc/intltool-&intltool-version;/I18N-HOWTO</userinput></screen>
+<screen role="root"><userinput>make install</userinput></screen>
 
   </sect2>
 
@@ -122,15 +132,13 @@
 
       <seglistitem>
         <seg>
-          intltool-extract, intltool-merge, intltool-prepare,
-          intltool-update and intltoolize
+          appdata-validate
         </seg>
         <seg>
           None
         </seg>
         <seg>
-          /usr/share/doc/intltool-&intltool-version; and
-          /usr/share/intltool
+          None
         </seg>
       </seglistitem>
     </segmentedlist>
@@ -140,65 +148,14 @@
       <?dbfo list-presentation="list"?>
       <?dbhtml list-presentation="table"?>
 
-      <varlistentry id="intltoolize">
-        <term><command>intltoolize</command></term>
-        <listitem>
-          <para>
-            prepares a package to use
-            <application>intltool</application>.
-          </para>
-          <indexterm zone="intltool intltoolize">
-            <primary sortas="b-intltoolize">intltoolize</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry id="intltool-extract">
-        <term><command>intltool-extract</command></term>
-        <listitem>
-          <para>
-            generates header files that can be read by
-            <command>gettext</command>.
-          </para>
-          <indexterm zone="intltool intltool-extract">
-            <primary sortas="b-intltool-extract">intltool-extract</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry id="intltool-merge">
-        <term><command>intltool-merge</command></term>
-        <listitem>
-          <para>
-            merges translated strings into various file types.
-          </para>
-          <indexterm zone="intltool intltool-merge">
-            <primary sortas="b-intltool-merge">intltool-merge</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry id="intltool-prepare">
-        <term><command>intltool-prepare</command></term>
-        <listitem>
-          <para>
-            updates pot files and merges them with translation files.
-          </para>
-          <indexterm zone="intltool intltool-prepare">
-            <primary sortas="b-intltool-prepare">intltool-prepare</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry id="intltool-update">
-        <term><command>intltool-update</command></term>
+      <varlistentry id="appdata-validate">
+        <term><command>appdata-validate</command></term>
         <listitem>
           <para>
-            updates the <filename>po</filename> template files and merges
-            them with the translations.
+            validates AppData metadata.
           </para>
-          <indexterm zone="intltool intltool-update">
-            <primary sortas="b-intltool-update">intltool-update</primary>
+          <indexterm zone="appdata-tools appdata-validate">
+            <primary sortas="b-appdata-validate">appdata-validate</primary>
           </indexterm>
         </listitem>
       </varlistentry>

Modified: trunk/BOOK/general/genutils/genutils.xml
==============================================================================
--- trunk/BOOK/general/genutils/genutils.xml	Wed Apr  2 08:18:10 2014	(r12926)
+++ trunk/BOOK/general/genutils/genutils.xml	Thu Apr  3 12:28:38 2014	(r12927)
@@ -20,6 +20,7 @@
   text and graphics, a program to interface with a palm-pilot, a program for entering
   PIN numbers and pass-phrases, and a hash generator.</para>
 
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="appdata-tools.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="compface.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="desktop-file-utils.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gperf.xml"/>

Modified: trunk/BOOK/introduction/welcome/changelog.xml
==============================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	Wed Apr  2 08:18:10 2014	(r12926)
+++ trunk/BOOK/introduction/welcome/changelog.xml	Thu Apr  3 12:28:38 2014	(r12927)
@@ -45,6 +45,16 @@
 -->
 
     <listitem>
+      <para>April 3rd, 2014</para>
+      <itemizedlist>
+        <listitem>
+          <para>[fernando] - Add new package appdata-tools-0.1.7. Fixes
+          <ulink url="&blfs-ticket-root;4887">#4887</ulink>.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>April 2nd, 2014</para>
       <itemizedlist>
         <listitem>



More information about the blfs-book mailing list