source: multimedia/libdriv/flac.xml@ 086d326

10.0 10.1 11.0 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 086d326 was 086d326, checked in by Randy McMurchy <randy@…>, 15 years ago

Updated to FLAC-1.1.4

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

  • Property mode set to 100644
File size: 7.2 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 flac-download-http "http://downloads.sourceforge.net/flac/flac-&flac-version;.tar.gz">
8 <!ENTITY flac-download-ftp " ">
9 <!ENTITY flac-md5sum "3958cbd5b6ed8c14966792538e44223b">
10 <!ENTITY flac-size "1.8 MB">
11 <!ENTITY flac-buildsize "136 MB (includes running the test suite)">
12 <!ENTITY flac-time "0.6 SBU (additional 1.8 SBU to run the test suite)">
13]>
14
15<sect1 id="flac" xreflabel="FLAC-&flac-version;">
16 <?dbhtml filename="flac.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>FLAC-&flac-version;</title>
24
25 <indexterm zone="flac">
26 <primary sortas="a-FLAC">FLAC</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to FLAC</title>
31
32 <para><application>FLAC</application> is an audio CODEC similar to
33 MP3, but lossless, meaning that audio is compressed without losing any
34 information.</para>
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>Download (HTTP): <ulink url="&flac-download-http;"/></para>
40 </listitem>
41 <listitem>
42 <para>Download (FTP): <ulink url="&flac-download-ftp;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download MD5 sum: &flac-md5sum;</para>
46 </listitem>
47 <listitem>
48 <para>Download size: &flac-size;</para>
49 </listitem>
50 <listitem>
51 <para>Estimated disk space required: &flac-buildsize;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated build time: &flac-time;</para>
55 </listitem>
56 </itemizedlist>
57
58 <!-- <bridgehead renderas="sect3">Additional Downloads</bridgehead>
59 <itemizedlist spacing="compact">
60 <listitem>
61 <para>Required patch: <ulink
62 url="&patch-root;/flac-&flac-version;-xmms_plugin_fix-1.patch"/></para>
63 </listitem>
64 </itemizedlist> -->
65
66 <bridgehead renderas="sect3">FLAC Dependencies</bridgehead>
67
68 <bridgehead renderas="sect4">Optional</bridgehead>
69 <para role="optional"><xref linkend="libogg"/>,
70 <xref linkend="xmms"/>,
71 <xref linkend="NASM"/>,
72 <xref linkend="docbook-utils"/>,
73 <xref linkend="doxygen"/> and
74 <ulink url="http://valgrind.kde.org/">Valgrind</ulink></para>
75
76 <para condition="html" role="usernotes">User Notes:
77 <ulink url="&blfs-wiki;/flac"/></para>
78
79 </sect2>
80
81 <sect2 role="installation">
82 <title>Installation of FLAC</title>
83
84 <para>Install <application>FLAC</application> by running the
85 following commands:</para>
86
87<screen><userinput>sed -i 's/^FLaC__INLINE/static\n&amp;/' src/libFLAC/md5.c &amp;&amp;
88./configure --prefix=/usr --disable-thorough-tests &amp;&amp;
89make</userinput></screen>
90
91 <para>If you have <application>Valgrind</application> version 3.0.0 or
92 higher installed and you plan on running the test suites after passing the
93 <option>--enable-valgrind-testing</option> parameter to
94 <command>configure</command>, you need to issue the following command to
95 change some test scripts:</para>
96
97<screen><userinput>sed -i -e "s/logfile-fd/log-fd/" `grep -lr logfile-fd test/*sh`</userinput></screen>
98
99 <para>To test the results, issue: <command>make check</command>. Note that
100 if you passed the <option>--enable-exhaustive-tests</option> and
101 <option>--enable-valgrind-testing</option> parameters to
102 <command>configure</command> and then run the test suite, it will take a
103 <emphasis>very</emphasis> long time (up to 300 SBUs) and use about 375 MB
104 of disk space.</para>
105
106 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
107
108<screen role="root"><userinput>make install</userinput></screen>
109
110 </sect2>
111
112 <sect2 role="commands">
113 <title>Command Explanations</title>
114
115 <!-- <para><command>LIBS=-lm ./configure -prefix=/usr</command>:
116 <filename class="libraryfile">libFLAC</filename> uses a function from the math
117 library but is not linked with <filename class="libraryfile">libm</filename>.
118 Passing the environment variable to <command>configure</command> satisfies
119 this dependency.</para> -->
120
121 <para><command>sed -i 's/.../' src/libFLAC/md5.c</command>: This command
122 is used so that the byteswap symbol is not global.</para>
123
124 <para><parameter>--disable-thorough-tests</parameter>: This parameter is
125 used so that the test suite will complete in a reasonable amount of time.
126 Remove it if you desire more extensive tests.</para>
127
128 <para><option>--enable-sse</option>: This option is off by default and
129 should be set on if your machine has SSE capability. One way to find out if
130 you have SSE is to issue <command>cat /proc/cpuinfo</command> and see if
131 <computeroutput>sse</computeroutput> is listed in the flags.</para>
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 Directories</segtitle>
142
143 <seglistitem>
144 <seg>flac and metaflac</seg>
145 <seg>libFLAC.{so,a}, libFLAC++.{so,a} and libxmms-flac.{so,a}</seg>
146 <seg>/usr/include/FLAC, /usr/include/FLAC++ and
147 /usr/share/doc/flac-&flac-version;</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="flac-prog">
157 <term><command>flac</command></term>
158 <listitem>
159 <para>is a command-line utility for encoding, decoding and
160 converting FLAC files.</para>
161 <indexterm zone="flac flac-prog">
162 <primary sortas="b-flac">flac</primary>
163 </indexterm>
164 </listitem>
165 </varlistentry>
166
167 <varlistentry id="metaflac">
168 <term><command>metaflac</command></term>
169 <listitem>
170 <para>is a program for listing, adding, removing, or editing
171 metadata in one or more FLAC files.</para>
172 <indexterm zone="flac metaflac">
173 <primary sortas="b-metaflac">metaflac</primary>
174 </indexterm>
175 </listitem>
176 </varlistentry>
177
178 <varlistentry id="libflac">
179 <term><filename class='libraryfile'>libFLAC{,++}.{so,a}</filename></term>
180 <listitem>
181 <para>these libraries provide native FLAC and Ogg FLAC C/C++ APIs
182 for programs utilizing FLAC.</para>
183 <indexterm zone="flac libflac">
184 <primary sortas="c-libFLAC">lib{,Ogg}FLAC{,++}.{so,a}</primary>
185 </indexterm>
186 </listitem>
187 </varlistentry>
188
189 <varlistentry id="libxmms-flac">
190 <term><filename class='libraryfile'>libxmms-flac.{so,a}</filename></term>
191 <listitem>
192 <para>is a plugin for <application>XMMS</application>.</para>
193 <indexterm zone="flac libxmms-flac">
194 <primary sortas="c-libxmms-flac">libxmms-flac.{so,a}</primary>
195 </indexterm>
196 </listitem>
197 </varlistentry>
198
199 </variablelist>
200
201 </sect2>
202
203</sect1>
Note: See TracBrowser for help on using the repository browser.