source: multimedia/libdriv/libcanberra.xml@ f87fa82b

10.0 10.1 11.0 9.1 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f87fa82b was f87fa82b, checked in by Douglas R. Reno <renodr@…>, 2 years ago

gconf, libcanberra: mark the gtk-doc support as obsolete because gtkdoc-mktmpl commands isn't available.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22593 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.1 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY libcanberra-download-http
8 "http://0pointer.de/lennart/projects/libcanberra/libcanberra-&libcanberra-version;.tar.xz">
9 <!ENTITY libcanberra-download-ftp " ">
10 <!ENTITY libcanberra-md5sum "34cb7e4430afaf6f447c4ebdb9b42072">
11 <!ENTITY libcanberra-size "312 KB">
12 <!ENTITY libcanberra-buildsize "7.5 MB">
13 <!ENTITY libcanberra-time "0.1 SBU">
14]>
15
16<sect1 id="libcanberra" xreflabel="libcanberra-&libcanberra-version;">
17 <?dbhtml filename="libcanberra.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>libcanberra-&libcanberra-version;</title>
25
26 <indexterm zone="libcanberra">
27 <primary sortas="a-libcanberra">libcanberra</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to libcanberra</title>
32
33 <para>
34 <application>libcanberra</application> is an implementation of the XDG Sound
35 Theme and Name Specifications, for generating event sounds on free desktops,
36 such as <application>GNOME</application>.
37 </para>
38
39 &lfs90_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&libcanberra-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&libcanberra-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &libcanberra-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &libcanberra-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &libcanberra-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &libcanberra-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">libcanberra Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Required</bridgehead>
78 <para role="required">
79 <xref linkend="libvorbis"/>
80 </para>
81
82 <bridgehead renderas="sect4">Recommended</bridgehead>
83 <para role="recommended">
84 <xref linkend="alsa-lib"/>,
85 <xref linkend="gstreamer10"/> and
86 <xref linkend="gtk3"/>
87 </para>
88
89 <bridgehead renderas="sect4">Optional</bridgehead>
90 <para role="optional">
91 <xref linkend="gtk2"/>,
92 <!--<xref linkend="gtk-doc"/>,-->
93 <xref linkend='pulseaudio'/> and
94 <ulink url="http://tdb.samba.org/">tdb</ulink>
95 </para>
96
97 <para condition="html" role="usernotes">User Notes:
98 <ulink url="&blfs-wiki;/libcanberra"/>
99 </para>
100 </sect2>
101
102 <sect2 role="installation">
103 <title>Installation of libcanberra</title>
104
105 <para>
106 Install <application>libcanberra</application> by running the following
107 commands:
108 </para>
109
110<screen><userinput>./configure --prefix=/usr --disable-oss &amp;&amp;
111make</userinput></screen>
112
113 <para>
114 This package does not come with a test suite.
115 </para>
116
117 <para>
118 Now, as the <systemitem class="username">root</systemitem> user:
119 </para>
120
121<screen role="root"><userinput>make docdir=/usr/share/doc/libcanberra-&libcanberra-version; install</userinput></screen>
122
123 </sect2>
124
125 <sect2 role="commands">
126 <title>Command Explanations</title>
127
128 <para><parameter>--disable-oss</parameter>: disable optional deprecated OSS
129 support</para>
130
131 <para><option>--disable-gtk</option>: disable optional GTK+ 2 support</para>
132
133 <para><option>--disable-gtk3</option>: disable optional GTK+ 3
134 support</para>
135 <!-- gtk-doc support is broken due to an obsolete command "gtkdoc-mktmpl"
136 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
137 href="../../xincludes/gtk-doc-rebuild.xml"/>-->
138
139 </sect2>
140
141 <sect2 role="content">
142 <title>Contents</title>
143
144 <segmentedlist>
145 <segtitle>Installed Programs</segtitle>
146 <segtitle>Installed Libraries</segtitle>
147 <segtitle>Installed Directories</segtitle>
148
149 <seglistitem>
150 <seg>
151 canberra-boot and canberra-gtk-play
152 </seg>
153 <seg>
154 libcanberra-gtk.so, libcanberra-gtk3.so and
155 libcanberra.so
156 </seg>
157 <seg>
158 /usr/lib/libcanberra-&libcanberra-version;,
159 /usr/share/doc/libcanberra-&libcanberra-version; and
160 /usr/share/gtk-doc/html/libcanberra
161 </seg>
162 </seglistitem>
163 </segmentedlist>
164
165 <variablelist>
166 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
167 <?dbfo list-presentation="list"?>
168 <?dbhtml list-presentation="table"?>
169
170<!--
171 <varlistentry id="canberra-boot">
172 <term><command>canberra-boot</command></term>
173 <listitem>
174 <para>
175
176 </para>
177 <indexterm zone="libcanberra canberra-boot">
178 <primary sortas="b-canberra-boot">canberra-boot</primary>
179 </indexterm>
180 </listitem>
181 </varlistentry>
182-->
183
184 <varlistentry id="canberra-gtk-play">
185 <term><command>canberra-gtk-play</command></term>
186 <listitem>
187 <para>
188 is an application used for playing sound events.
189 </para>
190 <indexterm zone="libcanberra canberra-gtk-play">
191 <primary sortas="b-canberra-gtk-play">canberra-gtk-play</primary>
192 </indexterm>
193 </listitem>
194 </varlistentry>
195
196 <varlistentry id="libcanberra-gtk">
197 <term><filename class="libraryfile">libcanberra-gtk.so</filename></term>
198 <listitem>
199 <para>
200 contains the <application>libcanberra</application> bindings
201 for <application>GTK+ 2</application>.
202 </para>
203 <indexterm zone="libcanberra libcanberra-gtk">
204 <primary sortas="c-libcanberra-gtk">libcanberra-gtk.so</primary>
205 </indexterm>
206 </listitem>
207 </varlistentry>
208
209 <varlistentry id="libcanberra-gtk3">
210 <term><filename class="libraryfile">libcanberra-gtk3.so</filename></term>
211 <listitem>
212 <para>
213 contains the <application>libcanberra</application> bindings
214 for <application>GTK+ 3</application>.
215 </para>
216 <indexterm zone="libcanberra libcanberra-gtk3">
217 <primary sortas="c-libcanberra-gtk3">libcanberra-gtk3.so</primary>
218 </indexterm>
219 </listitem>
220 </varlistentry>
221
222 <varlistentry id="libcanberra-lib">
223 <term><filename class='libraryfile'>libcanberra.so</filename></term>
224 <listitem>
225 <para>
226 contains the <application>libcanberra</application> API functions.
227 </para>
228 <indexterm zone="libcanberra libcanberra-lib">
229 <primary sortas="c-libcanberra">libcanberra.so</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 </variablelist>
235
236 </sect2>
237
238</sect1>
Note: See TracBrowser for help on using the repository browser.