{{{
#!comment
<LEFT-MENU>
}}}
{{{
#!div style="width:15%; float:left; clear:none; margin-right:1em; background:#ffb; border:1px solid #b00; padding-left:1em; padding-right:1em"
[wiki:WikiStart Home] [[BR]] [[BR]]
'''TOL''' [[BR]] [wiki:Software Software] [[BR]] [wiki:Download Download] [[BR]] [wiki:Installation Installation] [[BR]] [wiki:Packages Packages] [[BR]] [wiki:OTAN OTAN] [[BR]] [[BR]]
'''TOL Project''' [[BR]] [wiki:About About TOL] [[BR]] [wiki:Manuals Manuals] [[BR]] [wiki:Development Development] [[BR]] [wiki:Rprojects R-Projects] [[BR]] [[BR]]
'''Other Links''' [[BR]] [wiki:TracGuide Trac Guide] [[BR]] [wiki:WikiTree Wiki Tree] [[BR]] [https://mms.tol-project.org MMS]  
}}}
{{{
#!div style="margin-left:20%; margin-right:20%; padding-left:2em; padding-right:2em"
{{{
#!comment
</LEFT-MENU>
}}}

= Packages =

{{{
#!div style="background:#fcc; border: 1px solid red; color:red; padding-left:1em; margin-right:1em"
To do. See [wiki:TolPackageRulesAndComments].
}}}

== Introduction ==

Bla bla bla ...

== TolPackage ==

The TOL kernel provides a module to manage packages: TolPackage.

This module allow TOL users to download, update or upgrade packages. It provides also utilities for creating and uploading packages. For more details, see [wiki:TolPackage].

== Requiring a package ==

TOL provides a preevaluation directive: {{{#Require}}} to indicate the package requeriments.

{{{
#!cpp
#Require <PackageName>;
}}}

When you ''compile'' a package requirement, TolPackage try to load the package, searching into the repositories, downloading it and intalling it if necessary.

== Official TOL Archive Network ==

The official repository of TOL packages is called '''OTAN''' ('''O'''fficial '''T'''OL '''A'''rchive '''N'''etwork). In this link: [wiki:OTAN] you can browse the full list of public packages.

== Package manager in TOLBase ==

From version 3 onwards, TOLBase includes a graphic interface especially designed to make the management of packages easier. 
It can be accessed from the "Tools" menu, in the "Manage Packages..." option.

'''Screenshot''': Package manager in TOLBase.
[[Image(Screenshots:tolbase_tolpkg_01.png, width=500px)]]

The interface offers a list of all available packages from all of the of the repositories to which they have access for installation, updates or upgrades.

Different package states are displayed in the form of various different icons:
 * [[Image(source:tolp/trunk/tolbase/lib/toltk/images/p_no.gif)]]: New, not installed.
 * [[Image(source:tolp/trunk/tolbase/lib/toltk/images/p_upd.gif)]]: Update required; a more recent package of an identical version is available.
 * [[Image(source:tolp/trunk/tolbase/lib/toltk/images/p_upg.gif)]]: Upgrade required, a package with a superior version is available.
 * [[Image(source:tolp/trunk/tolbase/lib/toltk/images/p_unu.gif)]]: Upgrade and update required, both of these are required periodically.
 * [[Image(source:tolp/trunk/tolbase/lib/toltk/images/p_ok.gif)]]: Package okay, currently installed without requirement for update or upgrade.

Various actions can be carried out on packages. These are offered in the contextual menu.