Difference between revisions of "fppkg"

From Lazarus wiki
(Update fppkg -h output (to what 2.4.0 produces), replaced showavail/all with list, fppkg path with .../ (no windowsisms))
(Start of quick-start guide)
Line 6: Line 6:
  
 
== Basics ==
 
== Basics ==
 +
 +
=== Quick-start guide ===
 +
 +
Note: this section is only valid for fppkg from fpc version 2.5.1 or higher.
 +
 +
==== Setting up ====
 +
 +
When you run fppkg for the first time, it will create new configuration files with the default values. To check if these values are ok, run 'fppkg list'. You should see something like below.
 +
 +
Name                Installed    Available 
 +
a52                  2.5.1-1      -         
 +
aspell              2.5.1-1      -         
 +
bfd                  2.5.1-1      -         
 +
lnet                -            0.6.3-0 
 +
 +
If fppkg does not shows any installed packages, you have to adapt the path to your fpc-installation in the default compiler configuration file. By default this file is named '~/.fppkg/config/default' on Unix/Linux/Posix and '%appdata%\fpc\fppkg\config\default' on windows systems. If you have found this file, open it in your favourite text editor and change the 'GlobalInstallDir' to the location where fpc is installed. For example: 'GlobalInstallDir=/home/joost/fpc-trunk/lib/fpc/2.5.1/'. Save the file and run 'fppkg list' again. If you have still problems please read the section about configuring fppkg.
  
 
== Commandline arguments ==
 
== Commandline arguments ==

Revision as of 16:27, 23 April 2010

Introduction

Fppkg is the freepascal package manager. This tool manages packages from a repository, unzips, builds and installs.

See also FPMake.

Basics

Quick-start guide

Note: this section is only valid for fppkg from fpc version 2.5.1 or higher.

Setting up

When you run fppkg for the first time, it will create new configuration files with the default values. To check if these values are ok, run 'fppkg list'. You should see something like below.

Name                 Installed    Available   
a52                  2.5.1-1      -           
aspell               2.5.1-1      -           
bfd                  2.5.1-1      -           
lnet                 -            0.6.3-0  

If fppkg does not shows any installed packages, you have to adapt the path to your fpc-installation in the default compiler configuration file. By default this file is named '~/.fppkg/config/default' on Unix/Linux/Posix and '%appdata%\fpc\fppkg\config\default' on windows systems. If you have found this file, open it in your favourite text editor and change the 'GlobalInstallDir' to the location where fpc is installed. For example: 'GlobalInstallDir=/home/joost/fpc-trunk/lib/fpc/2.5.1/'. Save the file and run 'fppkg list' again. If you have still problems please read the section about configuring fppkg.

Commandline arguments

Output of fppkg -h

Usage: .../fppkg [options] <action> <package>
Options:
  -c --config        Set compiler configuration to use
  -h --help          This help
  -v --verbose       Show more information
  -d --debug         Show debugging information
  -g --global        Force installation to global (system-wide) directory
  -f --force         Force installation also if the package is already installed
  -r --recovery      Recovery mode, use always internal fpmkunit
Actions:
  update             Update packages list
  list               List available and installed packages
  build              Build package
  compile            Compile package
  install            Install package
  clean              Clean package
  archive            Create archive of package
  download           Download package
  convertmk          Convert Makefile.fpc to fpmake.pp

Actions

Update

Update packages list

List

List available and installed packages

Build

Build package

Install

Install package

Download

Download package

Convertmk

Convert Makefile.fpc to fpmake.pp