source: archive/esound.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 9.6 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 esound-download-http "&gnome-download-http;/esound/0.2/esound-&esound-version;.tar.bz2">
8 <!ENTITY esound-download-ftp "&gnome-download-ftp;/esound/0.2/esound-&esound-version;.tar.bz2">
9 <!ENTITY esound-md5sum "8d9aad3d94d15e0d59ba9dc0ea990c6c">
10 <!ENTITY esound-size "392 KB">
11 <!ENTITY esound-buildsize "5.3 MB">
12 <!ENTITY esound-time "0.3 SBU">
13]>
14
15<sect1 id="esound" xreflabel="EsounD-&esound-version;">
16 <?dbhtml filename="esound.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>EsounD-&esound-version;</title>
23
24 <indexterm zone="esound">
25 <primary sortas="a-EsounD">EsounD</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to EsounD</title>
30
31 <para>The <application>EsounD</application> package contains
32 the Enlightened Sound Daemon. This is useful for mixing together
33 several digitized audio streams for playback by a single device.</para>
34
35 &lfs74_checked;
36
37 <bridgehead renderas="sect3">Package Information</bridgehead>
38 <itemizedlist spacing="compact">
39 <listitem>
40 <para>Download (HTTP): <ulink url="&esound-download-http;"/></para>
41 </listitem>
42 <listitem>
43 <para>Download (FTP): <ulink url="&esound-download-ftp;"/></para>
44 </listitem>
45 <listitem>
46 <para>Download MD5 sum: &esound-md5sum;</para>
47 </listitem>
48 <listitem>
49 <para>Download size: &esound-size;</para>
50 </listitem>
51 <listitem>
52 <para>Estimated disk space required: &esound-buildsize;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated build time: &esound-time;</para>
56 </listitem>
57 </itemizedlist>
58
59 <bridgehead renderas="sect3">EsounD Dependencies</bridgehead>
60
61 <bridgehead renderas="sect4">Required</bridgehead>
62 <para role="required"><xref linkend="audiofile"/></para>
63
64 <bridgehead renderas="sect4">Optional</bridgehead>
65 <para role="optional"><xref linkend="alsa-lib"/> and
66 <xref linkend="docbook-utils"/> (Required for building the html documentation)</para>
67
68 <para condition="html" role="usernotes">User Notes:
69 <ulink url="&blfs-wiki;/esound"/></para>
70
71 </sect2>
72
73 <sect2 role="installation">
74 <title>Installation of EsounD</title>
75
76 <para>Install <application>EsounD</application> by running the following
77 commands:</para>
78
79<screen><userinput>LIBS=-lm ./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
80make</userinput></screen>
81
82 <para>This package does not come with a test suite.</para>
83
84 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
85
86<screen role="root"><userinput>make install docdir=/usr/share/doc/esound-&esound-version;</userinput></screen>
87
88 <para>If you have <application>DocBook-utils</application> installed, still
89 as the <systemitem class="username">root</systemitem> user:</para>
90
91<screen role="root"><userinput>chown -v root:root /usr/share/doc/esound-&esound-version;/*</userinput></screen>
92
93 </sect2>
94
95 <sect2 role="commands">
96 <title>Command Explanations</title>
97
98 <para><parameter>LIBS=-lm</parameter>: Make sure the linker uses the math
99 library.</para>
100
101 <para><parameter>--sysconfdir=/etc</parameter>: This switch puts
102 configuration files in <filename class="directory">/etc</filename> instead
103 of <filename class="directory">/usr/etc</filename>.</para>
104
105 <para><parameter>--disable-static</parameter>: Prevent the static libraries
106 being built.</para>
107
108 </sect2>
109
110 <sect2 role="configuration">
111 <title>Configuring EsounD</title>
112
113 <sect3 id="esound-config">
114 <title>Config Files</title>
115
116 <para><filename>/etc/esd.conf</filename></para>
117
118 <indexterm zone="esound esound-config">
119 <primary sortas="e-etc-esd.conf">/etc/esd.conf</primary>
120 </indexterm>
121
122 </sect3>
123
124 <sect3>
125 <title>Configuration Information</title>
126
127 <para>Instructions and information about the configuration file is
128 located in the <filename>TIPS</filename> file in the
129 <application>EsounD</application> source directory.</para>
130
131 </sect3>
132
133 </sect2>
134
135 <sect2 role="content">
136 <title>Contents</title>
137
138 <segmentedlist>
139 <segtitle>Installed Programs</segtitle>
140 <segtitle>Installed Libraries</segtitle>
141 <segtitle>Installed Directory</segtitle>
142
143 <seglistitem>
144 <seg>esd, esdcat, esd-config, esdctl, esddsp, esdfilt, esdloop, esdmon,
145 esdplay, esdrec, and esdsample</seg>
146 <seg>libesd.{so,a} and libesddsp.{so,a}</seg>
147 <seg>/usr/share/doc/esound</seg>
148 </seglistitem>
149 </segmentedlist>
150
151 <variablelist>
152 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
153 <?dbfo list-presentation="list"?>
154 <?dbhtml list-presentation="table"?>
155
156 <varlistentry id="esd">
157 <term><command>esd</command></term>
158 <listitem>
159 <para>is the Enlightened Sound Daemon.</para>
160 <indexterm zone="esound esd">
161 <primary sortas="b-esd">esd</primary>
162 </indexterm>
163 </listitem>
164 </varlistentry>
165
166 <varlistentry id="esdcat">
167 <term><command>esdcat</command></term>
168 <listitem>
169 <para>plays a RAW audio stream through the daemon.</para>
170 <indexterm zone="esound esdcat">
171 <primary sortas="b-esdcat">esdcat</primary>
172 </indexterm>
173 </listitem>
174 </varlistentry>
175
176 <varlistentry id="esd-config">
177 <term><command>esd-config</command></term>
178 <listitem>
179 <para>is used by <command>configure</command> to determine the
180 compiler and linker flags that should be used to compile and link programs
181 that use <application>EsounD</application>.</para>
182 <indexterm zone="esound esd-config">
183 <primary sortas="b-esd-config">esd-config</primary>
184 </indexterm>
185 </listitem>
186 </varlistentry>
187
188 <varlistentry id="esdctl">
189 <term><command>esdctl</command></term>
190 <listitem>
191 <para> controls certain aspects of the sound daemon.</para>
192 <indexterm zone="esound esdctl">
193 <primary sortas="b-esdctl">esdctl</primary>
194 </indexterm>
195 </listitem>
196 </varlistentry>
197
198 <varlistentry id="esddsp">
199 <term><command>esddsp</command></term>
200 <listitem>
201 <para>can allow non-esd applications to be routed through esd.</para>
202 <indexterm zone="esound esddsp">
203 <primary sortas="b-esddsp">esddsp</primary>
204 </indexterm>
205 </listitem>
206 </varlistentry>
207
208 <varlistentry id="esdfilt">
209 <term><command>esdfilt</command></term>
210 <listitem>
211 <para>is an <application>EsoundD</application> filter.</para>
212 <indexterm zone="esound esdfilt">
213 <primary sortas="b-esdfilt">esdfilt</primary>
214 </indexterm>
215 </listitem>
216 </varlistentry>
217
218 <varlistentry id="esdloop">
219 <term><command>esdloop</command></term>
220 <listitem>
221 <para>is test scaffolding for sample cache, loop and free.</para>
222 <indexterm zone="esound esdloop">
223 <primary sortas="b-esdloop">esdloop</primary>
224 </indexterm>
225 </listitem>
226 </varlistentry>
227
228 <varlistentry id="esdmon">
229 <term><command>esdmon</command></term>
230 <listitem>
231 <para>outputs the mixed stream from the daemon.</para>
232 <indexterm zone="esound esdmon">
233 <primary sortas="b-esdmon">esdmon</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 <varlistentry id="esdplay">
239 <term><command>esdplay</command></term>
240 <listitem>
241 <para>plays the named file on
242 <application>EsoundD</application>.</para>
243 <indexterm zone="esound esdplay">
244 <primary sortas="b-esdplay">esdplay</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="esdrec">
250 <term><command>esdrec</command></term>
251 <listitem>
252 <para>outputs from the sound device's current input.</para>
253 <indexterm zone="esound esdrec">
254 <primary sortas="b-esdrec">esdrec</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 <varlistentry id="esdsample">
260 <term><command>esdsample</command></term>
261 <listitem>
262 <para>is test scaffolding for sample cache, playback, and free.</para>
263 <indexterm zone="esound esdsample">
264 <primary sortas="b-esdsample">esdsample</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268
269 <varlistentry id="libesd">
270 <term><filename class='libraryfile'>libesd.{so,a}</filename></term>
271 <listitem>
272 <para>contains functions used by the <application>EsounD</application>
273 programs to read, write and play various sound format files.</para>
274 <indexterm zone="esound libesd">
275 <primary sortas="c-libesd">libesd.{so,a}</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="libesddsp">
281 <term><filename class='libraryfile'>libesddsp.{so,a}</filename></term>
282 <listitem>
283 <para>contains functions used by other programs to read, write and
284 play various sound format files.</para>
285 <indexterm zone="esound libesddsp">
286 <primary sortas="c-libesddsp">libesddsp.{so,a}</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 </variablelist>
292
293 </sect2>
294
295</sect1>
Note: See TracBrowser for help on using the repository browser.