glfs/shareddeps/audio/opus.xml

<?xml version="1.0" encoding="UTF-8"?>
<!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 opus-download-http "https://downloads.xiph.org/releases/opus/opus-&opus-version;.tar.gz">
  <!ENTITY opus-download-ftp  " ">
]>

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


  <title>Opus-&opus-version;</title>

  <indexterm zone="opus">
    <primary sortas="a-Opus">Opus</primary>
  </indexterm>

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

    <para>
      <application>Opus</application> is a lossy audio compression format
      developed by the Internet Engineering Task Force (IETF) that is
      particularly suitable for interactive speech and audio transmission over
      the Internet. This package provides the Opus development library and
      headers.
    </para>

    

    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&opus-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&opus-download-ftp;"/>
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <ulink url="&blfs-svn;/general/doxygen.html">doxygen</ulink> and
      <ulink url="&blfs-svn;/general/texlive.html">texlive</ulink>
      (or <ulink url="&blfs-svn;/general/tl-installer.html">
      install-tl-unx</ulink>)
    </para>

  </sect2>

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

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

<screen><userinput>mkdir build &amp;&amp;
cd    build &amp;&amp;

meson setup --prefix=/usr        \
            --buildtype=release  \
            -D docdir=/usr/share/doc/opus-&opus-version; &amp;&amp;
ninja</userinput></screen>

    <para>
      To test the results, issue: <command>ninja test</command>.
    </para>

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

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

  </sect2>

  <sect2 role="installation">
    <title>32-bit Installation of Opus</title>

    <para>
      First clean the build directory:
    </para>

    <screen><userinput>rm -rf *</userinput></screen>

    <para>
      Install lib32-<application>Opus</application> by running the following
      commands:
    </para>

<screen><userinput>CC="gcc -m32" CXX="g++ -m32"         \
PKG_CONFIG_PATH=/usr/lib32/pkgconfig \
meson setup --prefix=/usr            \
	    --libdir=/usr/lib32      \
            --buildtype=release

ninja</userinput></screen>

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

<screen role="root"><userinput>DESTDIR=$PWD/DESTDIR ninja install
cp -vr DESTDIR/usr/lib32/* /usr/lib32
rm -rf DESTDIR
ldconfig</userinput></screen>

  </sect2>

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

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

  </sect2>

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

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

      <seglistitem>
        <seg>
          None
        </seg>
        <seg>
          libopus.so
        </seg>
        <seg>
          /usr/include/opus and /usr/share/doc/opus-&opus-version;
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="libopus">
        <term><filename class="libraryfile">libopus.so</filename></term>
        <listitem>
          <para>
            provides the functions used to read and write Opus format
          </para>
          <indexterm zone="opus libopus">
            <primary sortas="c-libopus">libopus.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>