source: multimedia/cdwriteutils/cdrdao.xml@ bb221892

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

  <!ENTITY cdrdao-download-http "http://prdownloads.sourceforge.net/cdrdao/cdrdao-&cdrdao-version;.tar.bz2">
  <!ENTITY cdrdao-download-ftp  " ">
  <!ENTITY cdrdao-md5sum        "f93f3e68ec5b53ec1a776df73a1def60">
  <!ENTITY cdrdao-size          "1.3 MB">
  <!ENTITY cdrdao-buildsize     "60.8 MB">
  <!ENTITY cdrdao-time          "1.4 SBU (includes building <command>gcdmaster</command>)">
]>

<sect1 id="cdrdao" xreflabel="Cdrdao-&cdrdao-version;">
  <?dbhtml filename="cdrdao.html"?>

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

  <title>Cdrdao-&cdrdao-version;</title>

  <indexterm zone="cdrdao">
    <primary sortas="a-Cdrdao">Cdrdao</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Cdrdao</title>

    <para>The <application>Cdrdao</application> package contains
    CD recording utilities. These are useful for burning a
    CD in disk-at-once mode.</para>

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

    <bridgehead renderas="sect3"><application>Cdrdao</application> Dependencies</bridgehead>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended"><xref linkend="libao"/>,
    <xref linkend="libvorbis"/>,
    <xref linkend="libmad"/> and
    <xref linkend="lame"/> (required to build
    <command>toc2mp3</command>)</para>

    <bridgehead renderas="sect4">Optional (Required to Build the
    <command>gcdmaster</command> Program)</bridgehead>

    <para><emphasis>Note: the following packages must be built in
    the order listed. Use the current <quote>stable</quote> version of
    each package.</emphasis></para>

    <!-- The following is really old. pkgconfig has been updated
         two or three times since this was written. It probably
         isn't applicable any longer. Delete this comment and
         the entire note if next time during an update things
         haven't changed. I can't see this being required any
         longer. -Randy

    <note>
      <para>Changes in <application>pkgconfig</application>-0.17.x may cause
      linking errors in <application>gtkmm</application> applications.  Either
      upgrade to <application>pkgconfig</application>-0.18, or after installing
      <application>gtkmm</application>-2.6.3, issue this command as the
      <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>sed -i.bak \
    's:-lgtkmm-2.4:&amp; -lgdkmm-2.4 -lpangomm-1.4 -latkmm-1.6:' \
    /usr/lib/pkgconfig/gtkmm-2.4.pc</userinput></screen>

      <para>A backup (<filename class='extension'>.bak</filename>) is created,
      you can revert if desired.</para>
    </note>

    -->

    <para role="optional"><xref linkend="libgnomeui"/>,
    <ulink url="http://libsigc.sourceforge.net/">libsigc++</ulink>,
    <ulink url="http://www.gtkmm.org/">glibmm</ulink>,
    <ulink url="http://www.gtkmm.org/">gtkmm</ulink>,
    <ulink url="http://www.gtkmm.org/">libglademm</ulink>,
    <ulink url="http://www.gtkmm.org/">libgnomecanvasmm</ulink>,
    <ulink url="http://www.gtkmm.org/">gconfmm</ulink>,
    <ulink url="http://www.gtkmm.org/">gnome-vfsmm</ulink>,
    <ulink url="http://www.gtkmm.org/">libgnomemm</ulink>, and
    <ulink url="http://www.gtkmm.org/">libgnomeuimm</ulink></para>

    <note>
      <para>There are two additional optional dependencies that can be used by
      the <application>Cdrdao</application> build: <xref linkend="cdrtools"/>
      and <ulink url="http://www.polhode.com/pccts133mr.html">PCCTS</ulink>.
      The pieces of these two packages required to build
      <application>Cdrdao</application> are also included in the source tree
      and are used by default.</para>
    </note>

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

  </sect2>

  <sect2 role="installation">
    <title>Installation of Cdrdao</title>

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

<screen><userinput>./configure --prefix=/usr &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 &amp;&amp;
install -v -m755 -d /usr/share/doc/cdrdao-&cdrdao-version; &amp;&amp;
install -v -m644 README* /usr/share/doc/cdrdao-&cdrdao-version;</userinput></screen>

  </sect2>

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

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directory</segtitle>

      <seglistitem>
        <seg>cdrdao, cue2toc, toc2cddb, toc2cue and optionally, gcdmaster and
        toc2mp3</seg>
        <seg>None</seg>
        <seg>/usr/share/cdrdao, /usr/share/doc/cdrdao-&cdrdao-version;
        and /usr/share/gcdmaster</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="cdrdao-prog">
        <term><command>cdrdao</command></term>
        <listitem>
          <para>records audio or data CD-Rs in disk-at-once (DAO) mode
          based on a textual description of the CD contents.</para>
          <indexterm zone="cdrdao cdrdao-prog">
            <primary sortas="b-cdrdao">cdrdao</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="cue2toc">
        <term><command>cue2toc</command></term>
        <listitem>
          <para>converts CUE to TOC format for audio CDs.</para>
          <indexterm zone="cdrdao cue2toc">
            <primary sortas="b-cue2toc">cue2toc</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gcdmaster">
        <term><command>gcdmaster</command></term>
        <listitem>
          <para>is a graphical front end to <command>cdrdao</command> for
          composing audio CDs.</para>
          <indexterm zone="cdrdao gcdmaster">
            <primary sortas="b-gcdmaster">gcdmaster</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="toc2cddb">
        <term><command>toc2cddb</command></term>
        <listitem>
        <para>converts a <application>Cdrdao</application>
          TOC file into a cddb file and prints it to stdout.</para>
          <indexterm zone="cdrdao toc2cddb">
            <primary sortas="b-toc2cddb">toc2cddb</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="toc2cue">
        <term><command>toc2cue</command></term>
        <listitem>
          <para>converts TOC to CUE format for audio CDs.</para>
          <indexterm zone="cdrdao toc2cue">
            <primary sortas="b-toc2cue">toc2cue</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="toc2mp3">
        <term><command>toc2mp3</command></term>
        <listitem>
          <para>converts an audio CD disk image (<filename>.toc</filename> file)
          to MP3 files.</para>
          <indexterm zone="cdrdao toc2mp3">
            <primary sortas="b-toc2mp3">toc2mp3</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>