= Global !HaikuPorter Configuration =

Global !HaikuPorter options are specified in the file /etc/haikuports.conf. This file is expected to be a shell script which can be sourced (executed) by !HaikuPorter. The resulting set of environment variables is scanned for the global options known by !HaikuPorter.

Here's an example:
{{{
# HaikuPorts configuration

TREE_PATH="/Sources/haikuports.git"
PACKAGER="Peter Packman <packman@example.org>"

# ALLOW_UNTESTED=yes

}}}


== Available Options ==

=== ALLOW_TESTED ===
 - '''Type:''' !YesNo
 - '''Contents:''' 'yes' if packages that have been marked as untested on the current Haiku architecture should be considered, 'no' if not.
 - '''Required:''' No
 - '''Default:''' 'no'

=== PACKAGER ===
 - '''Type:''' String
 - '''Contents:''' Full e-mail address (with name) of the packager (i.e. the person that is using !HaikuPorter to create packages. This address will be shown in packages, such that the packager can be contacted should there be any problems.
 - '''Required:''' Yes
 - '''Default:''' None

=== TARGET_ARCHITECTURE ===
 - '''Type:''' !MachineArchitecture
 - '''Contents:''' If the ports tree in use is the 'haikuports.cross'-tree, !HaikuPorter needs to be told for which target architecture the bootstrap-packages should be built. These machine architectures are currently supported:
  - 'ppc'
    Haiku on ppc (using gcc4)
  - 'x86_gcc2' 
    Haiku on x86, using gcc2
  - 'x86'
    Haiku on x86, using gcc4
 - '''Required:''' Yes for the cross-repository, otherwise this option is ignored
 - '''Default:''' None

=== TREE_PATH ===
 - '''Type:''' String
 - '''Contents:''' The path to the ports tree containing all the build recipe files. This usually is a checkout of one of these two git-repositories: 
  - [https://bitbucket.org/haikuports/haikuports haikuports]
   The main repository of !HaikuPorts, packages made available through Haiku's official software repositories are built using this ports tree.
  - [https://bitbucket.org/haikuports/haikuports.cross haikuports.cross]
   The cross-build repository used for bootstrapping Haiku on a new architecture or when an binary incompatible change has been made to an existing architecture. The packages in this ports tree are being cross-compiled.
 - '''Required:''' Yes
 - '''Default:''' None