source: trunk/README @ 789

Last change on this file since 789 was 789, checked in by jkh, 17 years ago

Update to conform to the current state of reality.

  • Property svn:eol-style set to native
File size: 3.5 KB
Line 
1WHAT IS THE DARWIN PORTS SYSTEM
2
3    Darwin Ports is a software build, install, and packaging infrastructure
4designed to meet the same functionality requirements as the FreeBSD ports
5architecture while maintaining extensibility for future enhancement.
6
7    Darwin Ports currently builds and runs on MacOS X 10.2 (Darwin 6.0). The
8system is portable, written in TCL with a limited set of TCL extensions in C.
9
10    For in-depth documentation on the internals of the ports system
11architecture, refer to docs/INTERNALS.
12
13    Please note that darwinports is split into two parts.  The "darwin ports
14infrastructure", which lives in the base/ subdirectory and is the only
15mandatory component of the system, and the "dports" directory which contains
16the actual ported software descriptions.  The latter is optional and can be
17either fetched on demand over the net or a local copy can be used.  See
18documentation on /etc/ports/sources.conf below.
19
20INSTALLATION
21
22    Installation Steps:
23        1. make
24                Run 'make' to compile all necessary software.
25
26        2. sudo make install
27                Run 'sudo make install' to install darwinports on your system.
28
29        3. [optional] edit /etc/ports/ports.conf
30                The /etc/ports/ports.conf configuration file takes the same
31                directives as a Portfile, and can be used to override all
32                ports' defaults. You may wish to set things like debugging
33                and "verbosity" options in this file, the list of available
34                options being as follows:
35
36                portdbpath - Specifies path to store ports system specific data.
37
38                ports_debug - Takes either a "yes" or "no" value.
39                            If set, debug messages are printed
40
41                ports_verbose - Takes either a "yes" or "no" value.
42                            If set, informational messages are printed
43
44        3. [optional] edit /etc/ports/sources.conf
45                The /etc/ports/sources.conf file lists the location of
46                both local and remote port software hierarchies. By default,
47                the ports system will fetch ports from www.opendarwin.org.
48                If you wish to use a local ports tree, specify it here.
49
50    All necessary code and TCL will be compiled and installed as follows:
51        /System/Library/Tcl/8.3/darwinports1.0
52            - TCL library for interfacing with the Darwin Ports System
53        /opt/local/bin/port
54            - Command line port building utility
55        /opt/local/share/darwinports/
56            - TCL libraries internal to the ports system
57        /etc/defaults/ports.conf
58            - System-wide port default settings
59        /etc/ports/ports.conf
60            - User customizable port settings
61        /etc/ports/sources.conf
62            - List of port sources
63
64
65USING THE PORT COMMAND
66
67    If you haven't already, add /opt/local/bin to your path. If you're
68unsure how, add the following line to your ~/.cshrc file.
69
70        set path=($path /opt/local/bin)
71
72    Your changes to ~/.cshrc will not take effect until you have opened
73a new shell.
74
75    To update your local indexes, run:
76
77        port sync
78
79    The following command will build and install a port:
80
81        port install <portname>
82
83    To find a specific port, try using "port search".
84
85        port search vi
86
87    Please refer to the port man page for complete documentation on the port
88    command.
89
90CREATING NEW PORTS
91
92    Ports consist of directory containing both a Portfile and associated
93files. Currently the only bundled files are patch files, and these are likely
94to be kept to a minimum.
95
96    A Portfile consists of valid TCL, evaluated by a TCL interpreter
97instantiated by the Darwin Ports System. Portfiles use extremely straight-
98forward key/value pair syntax, while allowing the author to use the full
99extent of TCL's functionality where necessary.
100
101    To get started, refer to doc/exampleport and the portfile(7) man page.
Note: See TracBrowser for help on using the repository browser.