r2921 - in trunk/BOOK: . general/genutils introduction/welcome

randy at linuxfromscratch.org randy at linuxfromscratch.org
Wed Nov 10 12:16:24 PST 2004


Author: randy
Date: 2004-11-10 13:16:22 -0700 (Wed, 10 Nov 2004)
New Revision: 2921

Added:
   trunk/BOOK/general/genutils/desktop-file-utils.xml
Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/genutils/genutils.xml
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/introduction/welcome/credits.xml
Log:
Added new package desktop-file-utils

Added: trunk/BOOK/general/genutils/desktop-file-utils.xml
===================================================================
--- trunk/BOOK/general/genutils/desktop-file-utils.xml	2004-11-10 07:13:43 UTC (rev 2920)
+++ trunk/BOOK/general/genutils/desktop-file-utils.xml	2004-11-10 20:16:22 UTC (rev 2921)
@@ -0,0 +1,135 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY desktop-file-utils-download-http "http://freedesktop.org/Software/desktop-file-utils/releases/desktop-file-utils-&desktop-file-utils-version;.tar.gz">
+  <!ENTITY desktop-file-utils-download-ftp  " ">
+  <!ENTITY desktop-file-utils-md5sum        "N/A">
+  <!ENTITY desktop-file-utils-size          "424 KB">
+  <!ENTITY desktop-file-utils-buildsize     "6.6 MB">
+  <!ENTITY desktop-file-utils-time          "0.15 SBU">
+]>
+
+<sect1 id="desktop-file-utils" xreflabel="desktop-file-utils-&desktop-file-utils-version;">
+<sect1info>
+<othername>$LastChangedBy$</othername>
+<date>$Date$</date>
+</sect1info>
+<?dbhtml filename="desktop-file-utils.html"?>
+<title>desktop-file-utils-&desktop-file-utils-version;</title>
+
+<sect2>
+<title>Introduction to <application>desktop-file-utils</application></title>
+
+<para>The <application>desktop-file-utils</application> package contains 
+command line utilities for working with <ulink 
+url="http://www.freedesktop.org/standards/desktop-entry-spec/">desktop 
+entries</ulink>. These are used by 
+<application><acronym>GNOME</acronym></application>-2 and other applications 
+to adhere to the desktop entries standards specification.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing="compact">
+<listitem><para>Download (HTTP): 
+<ulink url="&desktop-file-utils-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): 
+<ulink url="&desktop-file-utils-download-ftp;"/></para></listitem>
+<listitem><para>MD5 sum: &desktop-file-utils-md5sum;</para></listitem>
+<listitem><para>Download size: &desktop-file-utils-size;</para></listitem>
+<listitem><para>Estimated disk space required: 
+&desktop-file-utils-buildsize;</para></listitem>
+<listitem><para>Estimated build time: 
+&desktop-file-utils-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application>desktop-file-utils</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="GLib2"/> and 
+<xref linkend="popt"/></para>
+</sect4>
+
+<sect4><title>Optional</title>
+<para><xref linkend="gnome-vfs"/> and 
+<xref linkend="postlfs-editors-emacs"/></para>
+</sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>desktop-file-utils</application></title>
+
+<para>Though the <application>desktop-file-utils</application> package is 
+listed here in Chapter 10, the main use of the package will be for the 
+<application><acronym>GNOME</acronym></application>-2 desktop. Therefore, the 
+instructions are geared towards a 
+<application><acronym>GNOME</acronym></application> installation. See the
+<quote>Command explanations</quote> section for information about installing 
+the package for other uses.</para>
+
+<para>Install <application>desktop-file-utils</application> by running the 
+following commands:</para>
+
+<screen><userinput><command>./configure --prefix=$GNOME_PREFIX \
+            --sysconfdir=/etc/gnome &&
+make &&
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Command explanations</title>
+
+<para><parameter>--prefix=$GNOME_PREFIX</parameter>: This forces the programs 
+and libraries to be installed in directories which coincide with a 
+<application><acronym>GNOME</acronym></application>-2 installation. Change
+the directory path to <filename class='directory'>/usr</filename> if the
+package is being installed for a different use.</para>
+
+<para><parameter>--sysconfdir=/etc/gnome</parameter>: This forces the 
+configuration directory to coincide with a 
+<application><acronym>GNOME</acronym></application>-2 installation. Change 
+the directory path to <filename class='directory'>/etc</filename> if the 
+package is being installed for a different use.</para>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application>desktop-file-utils</application> package contains 
+<command>desktop-file-install</command>, 
+<command>desktop-file-validate</command>, 
+<command>desktop-menu-tool</command>, 
+<command>update-desktop-database</command> and optionally, 
+the <application><acronym>GNOME</acronym>-<acronym>VFS</acronym></application> 
+<filename class='libraryfile'>libmenu</filename> library module.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>desktop-file-install</title>
+<para><command>desktop-file-install</command> is used to install a new, or 
+modify an existing desktop file entry. It is also used to rebuild or modify 
+the <acronym>mime</acronym>-types application database.</para></sect3>
+
+<sect3><title>desktop-file-validate</title>
+<para><command>desktop-file-validate</command> is used to verify the integrity 
+of a desktop file.</para></sect3>
+
+<sect3><title>desktop-menu-tool</title>
+<para><command>desktop-menu-tool</command> is used to display a human-readable 
+representation of, or display the set of desktop files used for a given menu
+file.</para></sect3>
+
+<sect3><title>update-desktop-database</title>
+<para><command>update-desktop-database</command> is used to update the 
+<acronym>mime</acronym>-types application database.</para></sect3>
+
+</sect2>
+
+</sect1>
+


Property changes on: trunk/BOOK/general/genutils/desktop-file-utils.xml
___________________________________________________________________
Name: svn:keywords
   + LastChangedBy Date

Modified: trunk/BOOK/general/genutils/genutils.xml
===================================================================
--- trunk/BOOK/general/genutils/genutils.xml	2004-11-10 07:13:43 UTC (rev 2920)
+++ trunk/BOOK/general/genutils/genutils.xml	2004-11-10 20:16:22 UTC (rev 2921)
@@ -18,5 +18,6 @@
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="intltool.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="screen.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="tidy.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="desktop-file-utils.xml"/>
 
 </chapter>

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2004-11-10 07:13:43 UTC (rev 2920)
+++ trunk/BOOK/general.ent	2004-11-10 20:16:22 UTC (rev 2921)
@@ -109,6 +109,7 @@
 <!ENTITY intltool-version             "0.32.1">
 <!ENTITY screen-version               "4.0.2">
 <!ENTITY tidy-version                 "041005">
+<!ENTITY desktop-file-utils-version   "0.9">
                                                                                       
 <!-- Chapter 11 -->                  
 <!ENTITY gpm-version                  "1.20.1">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2004-11-10 07:13:43 UTC (rev 2920)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2004-11-10 20:16:22 UTC (rev 2921)
@@ -22,6 +22,9 @@
 
 <itemizedlist>
 
+<listitem><para>November 10th, 2004 [randy]: Added new package
+desktop-file-utils-0.9.</para></listitem>
+
 <listitem><para>November 10th, 2004 [randy]: Updated to 
 libmikmod-3.1.11.</para></listitem>
 

Modified: trunk/BOOK/introduction/welcome/credits.xml
===================================================================
--- trunk/BOOK/introduction/welcome/credits.xml	2004-11-10 07:13:43 UTC (rev 2920)
+++ trunk/BOOK/introduction/welcome/credits.xml	2004-11-10 20:16:22 UTC (rev 2921)
@@ -149,9 +149,9 @@
 <listitem><para>ESP Ghostscript: <emphasis>Matt Rogers</emphasis></para>
 </listitem>
 
-<listitem><para>Cyrus-SASL, DejaGnu, DocBook-utils, Ethereal, Expect, Heimdal, 
-HTML Tidy, JadeTeX, SGMLSpm Perl module, SLIB, Stunnel and Sysstat: 
-<emphasis>Randy McMurchy</emphasis></para></listitem>
+<listitem><para>Cyrus-SASL, DejaGnu, desktop-file-utils, DocBook-utils, 
+Ethereal, Expect, Heimdal, HTML Tidy, JadeTeX, SGMLSpm Perl module, SLIB, 
+Stunnel and Sysstat: <emphasis>Randy McMurchy</emphasis></para></listitem>
 
 <listitem><para>Screen: <emphasis>Andreas Pedersen</emphasis></para></listitem>
 




More information about the blfs-book mailing list