source: multimedia/libdriv/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  " ">
  <!ENTITY opus-md5sum        "c40b3a1fbdbb9a7aa178600b88200c76">
  <!ENTITY opus-size          "7.4 MB">
  <!ENTITY opus-buildsize     "33 MB (with tests)">
  <!ENTITY opus-time          "0.5 SBU (with tests)">
]>

<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>

    &lfs121_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <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>
      <listitem>
        <para>
          Download MD5 sum: &opus-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &opus-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &opus-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &opus-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="doxygen"/> and
      <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
    </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  \
            -Ddocdir=/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="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>