= HOWTO section =

This section contains some HOWTOs for different things, which users might find useful.

These HOWTOs are organized in a [http://en.wikipedia.org/wiki/Wiki wiki], which means everyone can edit these pages. You can also contribute new HOWTOs right away. All you need is to register an account with the site in order to keep spam bots away.

== General Notes ==

Some command you should type in your Terminal are marked with a dollar sign (`$`) in front.
Example:
{{{
$ sudo port selfupdate
}}}

== HOWTO Index ==

  * Port building:
    * [wiki:howto/buildUniversal How to build Universal Binaries]
    * [wiki:howto/ccache How to enable ccache]
    * [wiki:howto/ParallelBuilding How to enable parallel building]
    * [wiki:howto/InstallingOlderPort How to install an older version of a port]
    * [wiki:howto/ShareArchives How to share archives between computers]

  * Software setup:
    * [wiki:howto/MAMP How to get a Apache, PHP, MySQL (MAMP) setup]
    * [wiki:howto/Subversion How to setup Subversion client or server]
    * [wiki:howto/SetupDovecot How to setup Dovecot IMAP Server]
    * [wiki:howto/SetupFetchmail How to setup Fetchmail mail collector]
    * [wiki:howto/SetupTracAjpWsgi How to use Trac with ajp-wsgi and Apache]

  * Daily use:
    * [wiki:howto/bash-completion How to use bash-completion]

  * Alternatives for syncing the ports tree without rsync:
    * [wiki:howto/PortTreeTarball How to use the Daily Tarball to sync your ports tree]
    * [wiki:howto/SyncingWithSVN How to use svn for syncing the ports tree]

  * MacPorts Development:
    * [wiki:howto/Upgrade How to most effectively upgrade outdated ports] (mostly complete)
    * [wiki:howto/RunningTrunk How to run MacPorts from the subversion trunk] 

== Unfinished HOWTOs ==

Feel free to add HOWTO requests to this list or help out to complete them!
 
  * [wiki:howto/SetupPostfix How to setup Postfix mail transfer agent] (unfinished)
  * [wiki:howto/distcc How to enable distcc] (unwritten)
  * [wiki:howto/Proxy How to use a proxy for rsync/HTTP/FTP] (unwritten)
  * [wiki:howto/SourceTrees How to add additional local or remote source trees] (unwritten)
  * [wiki:howto/Portfile How to start writing a Portfile] (unwritten, requested)
  * [wiki:howto/build64bit How to build 64-bit binaries] (unwritten)
  * [wiki:howto/SetupProofGeneral How to setup ProofGeneral and Isabelle]
  * [wiki:howto/Koha How to install Koha - Integrated Library System] (unfinished)

There is also a [wiki:howto/Template Template] for new HOWTOs.