source: trunk/README @ 275

Last change on this file since 275 was 275, checked in by landonf (Landon Fuller), 18 years ago

Commit first draft of example port

  • Property svn:eol-style set to native
File size: 1.7 KB
Line 
1README for the Darwin Port System
2
3WHAT IS THE DARWIN PORTS SYSTEM
4
5    Darwin Ports is a software build, install, and packaging infrastructure
6designed to meet the same functionality requirements as the FreeBSD ports
7architecture while maintaining extensibility for future enhancement.
8
9    Darwin Ports currently builds and runs on MacOS X 10.2 (Darwin 6.0). The
10system is portable, written in TCL with a limited set of TCL extensions in C.
11
12INSTALLING
13
14    Summary:
15        1. bsdmake
16        2. bsdmake install
17
18    All necessary code and TCL will be compiled and installed as follows:
19        /System/Library/Tcl/8.3/darwinports1.0
20            - TCL library for interfacing with the Darwin Ports System
21        /usr/local/bin/portbuild
22            - Command line port building utility
23        /usr/local/share/darwinports/
24            - TCL libraries internal to the ports system
25
26USING PORTBUILD
27
28    All included port descriptions are currently stored in the software/
29subdirectory of the ports distribution, in the form of:
30
31        software/<category>/<portname>
32
33    To build a port, cd to the port's directory and run 'portbuild'. To install
34a port, run 'portbuild -t install'. Please refer to the portbuild man page for
35complete documentation on the 'portbuild' command.
36
37CREATING NEW PORTS
38
39    Ports consist of directory containing both a Portfile and associated
40files. Currently the only bundled files are patch files, and these are likely
41to be kept to a minimum.
42
43    A Portfile consists of valid TCL, evaluated by a TCL interpreter
44instantiated by the Darwin Ports System. Portfiles use extremely straight-
45forward key/value pair syntax, while allowing the author to use the full
46extent of TCL's functionality where necessary.
47
48    To get started, refer to doc/exampleport.
Note: See TracBrowser for help on using the repository browser.