lazarus/tools/install

Installation tools
==================

This document describes how to create the various packages for lazarus
including the required freepascal packages (fpc and fpcsrc).

--------------------------------------------------------------------------------
TGZ

Creating the fpcsrc tgz:

  There are two ways to do it and so there are two scripts. The first downloads
  the fpc cvs and packs it. The second uses an existing fpc cvs directory,
  copies it, remove unnecessary files and packs it. The second script is
  therefore much faster, but it may miss removing every old, unnecessary files.
  
  The download and pack script:
  The script create_fpc_export_tgz.sh makes a cvs export of the fpc.
  
  For 1.0.7: ./create_fpc_export_tgz.sh stable 03/01/03

  For 1.1: ./create_fpc_export_tgz.sh devel 12/25/02

  The copy and pack script:
  The script create_fpc_tgz_from_local_dir.sh needs as parameter the fpc cvs
  directory and compress it to a tgz. For example
  ./create_fpc_tgz_from_local_dir.sh ~/pascal/fpc fpc-1.0.7.tgz


Creating the lazarus tgz:

  There are two ways to do it and so there are two scripts. The first downloads
  the fpc cvs and packs it. The second uses an existing fpc cvs directory,
  copies it, remove unnecessary files and packs it. The second script is
  therefore much faster, but it may miss removing all old, unnecessary files.

  The download and pack script:
  The script create_lazarus_export_tgz.sh makes a cvs export of lazarus and
  compress it. For example:
  ./create_lazarus_export_tgz.sh lazarus-20030316.tgz
  
  The copy and pack script:
  The script create_lazarus_tgz_from_local_dir.sh needs as parameter the
  lazarus cvs directory and compress it to lazarus-0.8.5.tgz.

--------------------------------------------------------------------------------

RPM:

Creating the fpc and the fpcsrc rpm:

  There are two versions of the compiler: the stable 1.0.7 and the unstable
  developer version 1.1. To build them, you must install fpc first. Install the
  latest fpc package you can get. Note: The 1.0.7 can not be built with a 1.1
  compiler.
  The create_fpc_rpm.sh works nearly automatically. Become root and execute it.
  For 1.0.7: ./create_fpc_rpm.sh stable
  For 1.1:   ./create_fpc_rpm.sh devel

  What it does: First it checks if the fpc source tgz is already created and
  if not, it automatically downloads it. The script does not use the current
  version, but the latest known to work with lazarus. Then it unpacks the
  source, compiles it and builds the rpm. Normally you can find the rpms under
  /usr/src/redhat/RPMS/i386/ and /usr/src/redhat/SRPMS/.


Creating the lazarus rpm:

  Important:
  If you have created a new fpc RPM, then you should install it, *before* you
  build the lazarus RPM. Otherwise the compiled lazarus RPM is not compatible
  to the fpc RPM.

  As root:
  Execute create_lazarus_rpm.sh.


Creating other system specific rpms:

  rpm --rebuild lazarus-0.8.5-1.src.rpm


--------------------------------------------------------------------------------

Debian:

Creating the debian fpc and fpcsrc packages:

  There are two versions of the compiler: the stable 1.0.7 and the unstable
  developer version 1.1. To build them, you must install fpc first. Install the
  latest fpc package you can get. Note: The 1.0.7 can not be built with a 1.1
  compiler.
  The create_fpc_deb.sh works nearly automatically. Become root and execute it.
  For 1.0.7: ./create_fpc_deb.sh stable
  For 1.1:   ./create_fpc_deb.sh devel

  What it does: First it checks if the fpc source tgz is already created and
  if not, it automatically downloads it. The script does not use the current
  version, but the latest known to work with lazarus. Then it unpacks the
  source, compiles it and builds the debs. Normally you can find the debs under
  /usr/src/ and the current directory.


Creating the debian lazarus package:

  Important:
  If you have created new fpc debs, then you should install them, *before* you
  build the lazarus deb. Otherwise the compiled lazarus deb is not compatible
  to the fpc debs.

  As root:
  Execute create_lazarus_deb.sh.