source: archive/qscintilla.xml@ d63fed6

<?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 qscintilla-download-http "&sourceforge-dl;/pyqt/QScintilla_gpl-&qscintilla-version;.tar.gz">
  <!ENTITY qscintilla-download-ftp  " ">
  <!ENTITY qscintilla-md5sum        "48ef316ff1e2a4d45a65d42be146ca39">
  <!ENTITY qscintilla-size          "2.6 MB">
  <!ENTITY qscintilla-buildsize     "28 MB (with documentation)">
  <!ENTITY qscintilla-time          "0.4 SBU (using parallelism=4; with documentation)">
]>

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

  <sect1info>
    <date>$Date$</date>
  </sect1info>

  <title>QScintilla-gpl-&qscintilla-version;</title>

  <indexterm zone="qscintilla">
    <primary sortas="a-qscintilla">qscintilla</primary>
  </indexterm>

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

    <para>
      <application>QScintilla</application> is a port to
      <application>Qt</application> of <ulink
      url="http://www.scintilla.org/">Scintilla</ulink>. As well as features
      found in standard text editing components, it includes features
      especially useful when editing and debugging source code: language
      syntax styling, error indicators, code completion, call tips, code
      folding, margins can contain markers like those used in debuggers to
      indicate breakpoints and the current line, recordable macros, multiple
      views and, of course, printing.
    </para>

    &lfs82_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>

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

    <bridgehead renderas="sect3">QScintilla Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="chrpath"/> and
      <xref linkend="qt5"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <ulink
      url="http://riverbankcomputing.co.uk/software/pyqt/intro">PyQt</ulink>
      (for <application>Python</application> <application>Qt</application>
      bindings)
    </para>

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

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

    <note>
      <para>
        The instructions in this page are just for the
        <application>QScintilla</application> application. Code is included in
        the tarball for  <application>QScintilla Qt Designer</application>
        plugin and <application>Python</application> bindings.
      </para>
    </note>

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

<screen><userinput>cd Qt4Qt5             &amp;&amp;
qmake qscintilla.pro  &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>

<!-- For "DESTDIR" install, use: make INSTALL_ROOT=<destination> install -->
<screen role="root"><userinput>make install &amp;&amp;
ln -sfv $(readlink $QT5DIR/lib/libqscintilla2_qt5.so) $QT5DIR/lib/libqt5scintilla2.so</userinput></screen>

    <para>
      If you wish to install the documentation, issue, as the <systemitem
      class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>install -v -m755 -d $QT5DIR/share/doc/QScintilla-&qscintilla-version;/html &amp;&amp;
install -v -m644    ../doc/html-Qt4Qt5/* \
                    $QT5DIR/share/doc/QScintilla-&qscintilla-version;/html</userinput></screen>

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

    <para>
      <command>ln -sfv ...</command>: This command creates a compatibility 
      symlink needed by some programs.
    </para>

  </sect2>

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

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

      <seglistitem>
        <seg>
          None
        </seg>
        <seg>
          $QT5DIR/lib/libqt5scintilla2.so (link to libqscintilla2_qt5.so) and
          $QT5DIR/lib/libqscintilla2_qt5.so
        </seg>
        <seg>
          $QT5DIR/{include/Qsci,qsci,share/doc/QScintilla-&qscintilla-version;}
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="libqscintilla2_qt5">
        <term><filename class="libraryfile">libqscintilla2_qt5.so</filename></term>
        <listitem>
          <para>
            contains the <application>QScintilla</application>
            <application>Qt5</application> API functions.
          </para>
          <indexterm zone="qscintilla libqscintilla2_qt5">
            <primary sortas="c-libqscintilla2_qt5.so">libqscintilla2_qt5.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>