source: lxqt/apps/obconf_qt.xml@ 20e1589

<?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 obconf-qt-download-http "&sources-anduin-other-http;/obconf-qt-&obconf-qt-version;.tar.xz">
  <!ENTITY obconf-qt-download-ftp  " ">
  <!ENTITY obconf-qt-md5sum        "dc0b9515fec3cf81cf809192e75daa3f">
  <!ENTITY obconf-qt-size          "344 KB">
  <!ENTITY obconf-qt-buildsize     "3.5 MB">
  <!ENTITY obconf-qt-time          "0.1 SBU">
]>

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

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

  <title>obconf-qt-&obconf-qt-version;</title>

  <indexterm zone="obconf-qt">
    <primary sortas="a-obconf-qt">obconf-qt</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to obconf-qt</title>

    <para>
      The <application>obconf-qt</application> package is an
      <application>OpenBox</application> Qt based configuration tool.</para>

    &lfs77_checked; &gcc5_checked;

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

    <para>
      The source tarball shown above was created by the BLFS team by cloning
      the source code repository, finding the correct version to rename
      accordingly the source code directory and finally making the compressed
      tarball. No other modification has been made.
    </para>

    <bridgehead renderas="sect3">obconf-qt Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="cmake"/>,
      <xref linkend="openbox"/> and
      <xref linkend="qt5"/> or
      <xref linkend="qt4"/>
    </para>

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

  <sect2 role="installation">
    <title>Installation of obconf-qt</title>

    <para>
       For compilation with <application>Qt4</application>, see <quote>Command
       Explanations</quote>, below. Install
       <application>obconf-qt</application>, linked to
       <application>Qt5</application>, by running the following commands:
    </para>

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

cmake -DCMAKE_BUILD_TYPE=Release  \
      -DCMAKE_INSTALL_PREFIX=/usr \
      ..       &amp;&amp;

make</userinput></screen>

    <para>
      The choice of <filename class="directory">/usr</filename> for prefix is
      due to the general characteristics of this program, which can be used
      without <application>LXQt</application>.
    </para>

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

    <para>
      <option>-DUSE_QT4=ON</option>: Use this switch, if you prefer to build
      this application linked to <application>Qt4</application>.
    </para>


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

  </sect2>

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

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

      <seglistitem>
        <seg>
          obconf-qt
        </seg>
        <seg>
          None
        </seg>
        <seg>
          /usr/share/obconf-qt
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="obconf-qt-prog">
        <term><command>obconf-qt</command></term>
        <listitem>
          <para>
            is a GUI Qt based configuraon tool for
            <application>OpenBox</application>. 
          </para>
          <indexterm zone="obconf-qt obconf-qt-prog">
            <primary sortas="b-obconf-qt">obconf-qt</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>