{\rtf1\mac\ansicpg10000\cocoartf102
{\fonttbl\f0\fswiss\fcharset77 Helvetica;\f1\fswiss\fcharset77 Helvetica-Bold;\f2\fswiss\fcharset77 Helvetica-Oblique;
}
{\colortbl;\red255\green255\blue255;}
\margl1440\margr1440\vieww13720\viewh11840\viewkind0
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
\f0\fs24 \cf0 \
DarwinPorts is a software build, install, and packaging infrastructure for installing open source software. It is designed to meet the same functionality requirements as the FreeBSD ports architecture while maintaining extensibility for future enhancement.\
\
\f1\b System Requirements\
\f0\b0 DarwinPorts currently builds and runs on MacOS X 10.2 (Darwin 6.0.1) or later. The system is portable, written in TCL with a limited set of TCL extensions in C, and is also available for other platforms.\
\
\f1\b How to Use\
\f0\b0 You can simple double-click the "Port Authority" application installed in /Applications/DarwinPorts. Command-line users can also invoke the "port" command, which (like other DarwinPorts binaries) is in "/opt/local/bin." Your path will be automatically modified to include that, if needed, during the install; note that you may need to open a new shell first.\
\
\f1\b What is Installed\
\f0\b0 The DarwinPorts infrastructure is installed in "/opt/local/var/db/dports/." In particular, the sources for the infrastructure and "Portfiles" are located in sources. These files are owned by root, and require "sudo" or equivalent to access.\
\
\f1\b Documentation\
\f0\b0 \
The "DarwinPorts User Guide" is available at .\
There are also man pages for
\f2\i port
\f0\i0 ,
\f2\i ports.conf, portfile
\f0\i0 ,
\f2\i portgroup, portstyle,
\f0\i0 and
\f2\i porthier
\f0\i0 .\
\
\f1\b Using the Port Command\
\f0\b0 \
The following command will build and install a port:\
\
$ port install \
\
To find a specific port, try using "port search".\
\
$ port search vi\
\
Please refer to the port(1) man page for complete documentation on the port command.\
\
\
\f1\b Creating New Ports\
\f0\b0 \
Ports consist of directory containing both a Portfile and associated files. Currently the only bundled files are patch files, and these are likely to be kept to a minimum.\
\
A Portfile consists of valid TCL, evaluated by a TCL interpreter instantiated by the DarwinPorts System. Portfiles use extremely straightforward key/value pair syntax, while allowing the author to use the full extent of TCL's functionality where necessary.\
\
To get started, refer to the base/doc/exampleport found in the DarwinPorts sources and the portfile(7) man page, or The DarwinPorts Guide, at http://www.darwinports.org/docs .\
}