source: general/prog/lazarus.xml@ a722d59

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

  <!--
      NOTE:
      Whenever upgrading to another version of Lazarus,
      update qt5pas.xml, too!
  -->
  <!ENTITY lazarus-download-http "https://downloads.sourceforge.net/project/lazarus/Lazarus Zip _ GZip/Lazarus &lazarus-version;/lazarus-&lazarus-version;-0.tar.gz">
  <!ENTITY lazarus-md5sum        "&lazarus-chksum;">
  <!ENTITY lazarus-size          "&lazarus-pkgsize;">
  <!ENTITY lazarus-buildsize     "817.2 MB">
  <!ENTITY lazarus-time          "1.5 SBU">
]>

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

  <title>Lazarus-&lazarus-version;</title>

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

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

    <para><!-- copied from https://www.lazarus-ide.org/ -->
      Lazarus is a Delphi compatible cross-platform IDE for Rapid
      Application Development. It has variety of components ready
      for use and a graphical form designer to easily create complex
      graphical user interfaces.
    </para>

    &lfs121_checked;

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

    <bridgehead renderas="sect3">Lazarus Dependencies</bridgehead>
    <para role="required">
      <xref linkend="fpc"/>, and one of 
      <xref linkend="qt5"/> and <xref linkend="qt5pas"/> for QT5 based IDE,
      <xref linkend="qt6"/> and <xref linkend="qt6pas"/> for QT6 based IDE,
      or
      <xref linkend="gtk3"/> for Gtk3 based IDE
    </para>
<!--
    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/lazarus"/></para>
-->
  </sect2>

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

    <para>
      Ensure that the source tree is in proper state:
    </para>

<screen><userinput>make -j1 FPC=/usr/bin/fpc clean</userinput></screen>

<!--
  Looks like that even both versions (gtk3, qt5) can be on one machine
  when the binaries 'lazarus' and 'startlazarus' are moved to
    lazarus      -> lazarus-gtk3
    startlazarus -> startlazarus-gtk3
  and after building the QT5 variant
    lazarus      -> lazarus-qt5
    startlazarus -> startlazarus-qt5
  and than symlink lazarus/startlazarus to the desired ones.
  (it needs to be analyzed more deeply)

  Instructions are taken from ArchLinux and adopted to LFS
-->
    <para>
      If you want to build <application>Lazarus</application> with
      the gtk3 toolkit, build the package by running the following
      commands, otherwise skip the following instructions and proceed
      to the instructions to build the QT5 based variant below.
    </para>

<screen><userinput>make -j1 FPC=/usr/bin/fpc LCL_PLATFORM=gtk3 bigide</userinput></screen>

    <para>
      If the gtk3 variant has bee built, skip the QT5 and QT6 section and
      proceed to the installation.
      Otherwise <application>Lazarus</application> is to be built using
      the QT5 library by running the following commands:
    </para>

<screen><userinput>make -j1 FPC=/usr/bin/fpc LCL_PLATFORM=qt5 bigide</userinput></screen>

    <para>
      Now proceed to the installation.
    </para>
    
    <para>
      <application>Lazarus</application> can also be built using the
      QT6 library. Build it in similar way:
    </para>
<screen><userinput>make -j1 FPC=/usr/bin/fpc LCL_PLATFORM=qt6 bigide</userinput></screen>

    <para>
      Likewise, a gtk2 variant can be built in similar way - just use
      LCL_PLATFORM=gtk2 in the <code>make ... bigide</code> command. It
      is not included here as gtk2 is quite outdated and no longer included
      in the BLFS book.
    </para>

    <para>
      This package does not come with a test suite.
    </para>

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

<screen role="root"><userinput>make INSTALL_PREFIX=/usr distinstall

mv /usr/share/lazarus/docs /usr/share/doc/lazarus

mv /usr/share/lazarus /usr/lib/
for L in $(find /usr/bin -type l); do
    ln -svf "$(readlink $L | sed 's@/share/@/lib/@')" "$L"
done

sed -e 's|\(Categories\).*|\1=IDE;Development;|' \
    -i /usr/share/applications/lazarus.desktop

install -Dm644 images/ide_icon48x48.png \
       /usr/share/pixmaps/lazarus.png</userinput></screen>

  </sect2>

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

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

      <seglistitem>
        <seg>startlazarus, lazarus-ide, lrstolfm, updatepofiles, lazbuild, lazres</seg>
        <seg>None</seg>
        <seg>/usr/lib/lazarus</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="lazarus-pgm">
        <term><filename class="libraryfile">startlazarus</filename></term>
        <listitem>
          <para>
            Starting the Delphi-like IDE
          </para>
          <indexterm zone="lazarus lazarus-pgm">
            <primary sortas="b-lazarus">startlazarus</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>