glfs/gnome/add/sound-juicer.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY sound-juicer-download-http 
          "&gnome-download-http;/sound-juicer/3.4/sound-juicer-&sound-juicer-version;.tar.xz">
  <!ENTITY sound-juicer-download-ftp  
           "&gnome-download-ftp;/sound-juicer/3.4/sound-juicer-&sound-juicer-version;.tar.xz">
  <!ENTITY sound-juicer-md5sum        "a913b246260ccf3843ea779ae9cdb5e7">
  <!ENTITY sound-juicer-size          "1.9 MB">
  <!ENTITY sound-juicer-buildsize     "22 MB">
  <!ENTITY sound-juicer-time          "0.6 SBU">
]>

<sect1 id="sound-juicer" xreflabel="Sound-Juicer-&sound-juicer-version;">
  <?dbhtml filename="sound-juicer.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>Sound-Juicer-&sound-juicer-version;</title>

  <indexterm zone="sound-juicer">
    <primary sortas="a-sound-juicer">sound-juicer</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Sound Juicer</title>

    <para>The <application>Sound Juicer</application> package contains the
    simple CD ripping tool which is useful for extracting the audio tracks 
    from audio compact discs and converting them into audio files. It can
    also play the audio tracks directly from the CD, allowing you to preview
    the CD before ripping it.</para>

    &lfs70_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&sound-juicer-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&sound-juicer-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &sound-juicer-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &sound-juicer-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &sound-juicer-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &sound-juicer-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Sound Juicer Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="GConf"/>,
      <xref linkend="gnome-doc-utils"/>,
      <xref linkend="gst-plugins-base"/>,
      <xref linkend="gtk3"/>,
      <xref linkend="libcanberra"/> and
      <xref linkend="libmusicbrainz3"/>
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="rarian"/>
    </para>

    <bridgehead renderas="sect4">Recommended (Runtime)</bridgehead>
    <para role="recommended">
      <xref linkend="gst-plugins-good"/>
      (for the flacenc and wavenc plugins) and
      <xref linkend="gst-plugins-ugly"/>
      (for the lame plugin)
    </para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/sound-juicer"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of Sound Juicer</title>

    <para>Install <application>Sound Juicer</application> by running the following
    commands:</para>

<screen><userinput>./configure --prefix=/usr \
            --sysconfdir=/etc &amp;&amp;
make</userinput></screen>

    <para>This package does not come with a test suite.</para>

    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>make install</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

<!--    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../xincludes/gnome-prefix.xml"/>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../xincludes/gnome-sysconfdir.xml"/> -->

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../xincludes/without-scrollkeeper.xml"/>

  </sect2>

  <sect2 role="configuration">
    <title>Configuring Sound Juicer</title>

    <sect3 id="sound-juicer-config">
      <title>Configuration Information</title>

      <para>Configuration is accomplished by using the
      <quote>Preferences</quote> drop-down menu option. For information on how
      to configure <command>sound-juicer</command> to use
      <application>LAME</application> as the default encoding method (creating
      MP3 files as the default) see the <application>Sound Juicer</application>
      Help section.</para>

    </sect3>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Program</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>
          sound-juicer
        </seg>
        <seg>
          /usr/share/gnome/help/sound-juicer,
          /usr/share/omf/sound-juicer and
          /usr/share/sound-juicer
        </seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="sound-juicer-prog">
        <term><command>sound-juicer</command></term>
        <listitem>
          <para>is a graphical CD extraction (ripping) tool based on
          GTK+ and GStreamer.</para>
          <indexterm zone="sound-juicer sound-juicer-prog">
            <primary sortas="b-sound-juicer">sound-juicer</primary>
          </indexterm>
        </listitem>
      </varlistentry>
    </variablelist>

  </sect2>

</sect1>