Difference between revisions of "Free Pascal package guidelines"

From ArchWiki
Jump to: navigation, search
(Packaging)
(Packaging)
(One intermediate revision by the same user not shown)
Line 28: Line 28:
 
=== Packaging ===
 
=== Packaging ===
 
Please adhere to the following when making an FPC-based package:
 
Please adhere to the following when making an FPC-based package:
* always add {{Pkg|fpc}} to {{ic|makedepends}}
+
* always add {{Pkg|fpc}} to either {{ic|makedepends}} or {{ic|depends}}
* always put all compiled units (*.a, *.compiled, *.o, *.ppu, *.res, *.rst) under {{ic|/usr/lib/fpc/''$_fpcvers''/units/''$arch''-linux}}
+
* always put all compiled units (*.a, *.compiled, *.o, *.ppu, *.res, *.rst) under {{ic|/usr/lib/fpc/''$_fpcver''/units/''$arch''-linux}}
 
* add {{ic|staticlibs}} to {{ic|options}} if installing an import library
 
* add {{ic|staticlibs}} to {{ic|options}} if installing an import library
 
==== Cross compiling ====
 
==== Cross compiling ====
 
* always add the corresponding cross compiler package mentioned above ({{Ic|fpc-''cpu''-''system''-rtl}} or {{AUR|fpc-multilib}} for multilib) to {{ic|depends}}
 
* always add the corresponding cross compiler package mentioned above ({{Ic|fpc-''cpu''-''system''-rtl}} or {{AUR|fpc-multilib}} for multilib) to {{ic|depends}}
 
* always add {{ic|!strip}} to {{ic|options}} for non-Unix-based systems
 
* always add {{ic|!strip}} to {{ic|options}} for non-Unix-based systems
* always put all compiled units (*.a, *.compiled, *.o, *.ppu, *.res, *.rst) under {{ic|/usr/lib/fpc/''$_fpcvers''/units/''$_unittgt''}} (or if multilib, {{ic|/usr/lib/fpc/''$_fpcvers''/units/i386-linux}})
+
* always put all compiled units (*.a, *.compiled, *.o, *.ppu, *.res, *.rst) under {{ic|/usr/lib/fpc/''$_fpcver''/units/''$_unitdir''}} (or if multilib, {{ic|/usr/lib/fpc/''$_fpcver''/units/i386-linux}})
 
* always use {{ic|any}} ({{ic|x86_64}} if multilib) as the architecture
 
* always use {{ic|any}} ({{ic|x86_64}} if multilib) as the architecture
 
* add {{ic|staticlibs}} to {{ic|options}} if installing an import library
 
* add {{ic|staticlibs}} to {{ic|options}} if installing an import library

Revision as of 09:49, 4 November 2013

Template:Package Guidelines

This page explains on how to write PKGBUILDs for software built with the Free Pascal Compiler (FPC). There currently exists two options for building software of Linux, as well as a handful of options for building software on other targets using FPC cross compilers:

Arch Linux

  • fpc is available in the official Arch community repository and provides a compiler targetting only your host CPU (i686 or x86_64).
  • fpc-multilibAUR is available from the Arch User Repository which provides an x86_64 host compiler targetting both i686 and x86_64 CPU Linuxes. This will also provide the ppcross386AUR FPC compiler driver package.

Cross compilers

Free Pascal

Package naming

The project name alone is usually sufficient. However, in the case of cross-compiling, the package should be prefixed with fpc32- when targetting i686 Linux from multilib and named in the format of fpc-cpu-system-pkgname when targetting non-Arch Linux systems.

Helpful snippets

  • Determine FPC's version and the CPU and OS of the units to output:
_unitdir=`fpc -iSP`-`fpc -iSO`
_fpcver=`fpc -iV`

Packaging

Please adhere to the following when making an FPC-based package:

  • always add fpc to either makedepends or depends
  • always put all compiled units (*.a, *.compiled, *.o, *.ppu, *.res, *.rst) under /usr/lib/fpc/$_fpcver/units/$arch-linux
  • add staticlibs to options if installing an import library

Cross compiling

  • always add the corresponding cross compiler package mentioned above (fpc-cpu-system-rtl or fpc-multilibAUR for multilib) to depends
  • always add !strip to options for non-Unix-based systems
  • always put all compiled units (*.a, *.compiled, *.o, *.ppu, *.res, *.rst) under /usr/lib/fpc/$_fpcver/units/$_unitdir (or if multilib, /usr/lib/fpc/$_fpcver/units/i386-linux)
  • always use any (x86_64 if multilib) as the architecture
  • add staticlibs to options if installing an import library