[24504] branches/dp2mp-move/base/doc
source_changes at macosforge.org
source_changes at macosforge.org
Thu Apr 26 21:41:12 PDT 2007
Revision: 24504
http://trac.macosforge.org/projects/macports/changeset/24504
Author: jmpp at macports.org
Date: 2007-04-26 21:41:11 -0700 (Thu, 26 Apr 2007)
Log Message:
-----------
darwinports to macports updates in base/doc, while also applying out my ideas for the new installation layout
Modified Paths:
--------------
branches/dp2mp-move/base/doc/INTERNALS
branches/dp2mp-move/base/doc/macports.conf.5
branches/dp2mp-move/base/doc/porthier.7
branches/dp2mp-move/base/doc/sources.conf
Modified: branches/dp2mp-move/base/doc/INTERNALS
===================================================================
--- branches/dp2mp-move/base/doc/INTERNALS 2007-04-27 03:57:55 UTC (rev 24503)
+++ branches/dp2mp-move/base/doc/INTERNALS 2007-04-27 04:41:11 UTC (rev 24504)
@@ -1,7 +1,7 @@
-DARWIN PORTS INTERNALS
+MacPorts Internals:
-The darwin ports system is composed of a three TCL libraries:
- darwinports - public API
+The MacPports system is composed of a three TCL libraries:
+ macports - public API
port - portfile parsing and execution
pextlib - neccesary C extensions to TCL
@@ -9,36 +9,36 @@
allow for complex versioning and have a provide/require model of use, making
them well suited for maintaining a backwards compatable ports system.
- The "darwinports" TCL Library provides a public API into the darwin
+ The "macports" TCL Library provides a public API into the mac
ports system. Any external application wishing to manipulate a port can
-load the "darwinports" TCL library. 'port', the included command line port
-utility, uses only the exported "darwinports" API.
+load the "macports" TCL library. 'port', the included command line port
+utility, uses only the exported "macports" API.
- The "darwinports" API provides very simple primitives for dealing with
-ports (ie, dportexec/dportopen/dportget). Also, the API has very little
+ The "macports" API provides very simple primitives for dealing with
+ports (ie, mportexec/mportopen/mportget). Also, the API has very little
knowledge of the contents of a portfile; instead, it relies entirely upon
the "port" TCL library. By keeping the high level API simple and generic,
a revision of the underlying ports system will not neccesarily require
-a revision of the high level "darwinports" API.
+a revision of the high level "macports" API.
TCL packages allow for complex versioning with a strong requires/provides
model; this means that a revision of the API at any level will not break
backwards compatibility.
- When parsing a port, the "darwinports" library loads the Portfile into a
+ When parsing a port, the "macports" library loads the Portfile into a
sub-interpreter. The "port" library and all port-specific code is run
entirely within this sub-interpreter, and thus can never pollute the TCL
-space of other ports, the "darwinports" library, or the calling application.
+space of other ports, the "macports" library, or the calling application.
- The "darwinports" library is also responsible for loading user specified
+ The "macports" library is also responsible for loading user specified
options into the sub-interpreter to be evaluated by the "ports" library. In
that case it sets the variable name in the sub-interpreter and adds the
option to the sub-interpreter's global array user_options(). User options
-are passed as part of the call to dportopen.
+are passed as part of the call to mportopen.
- The "port" TCL package provides all the primitives required for a darwin
+ The "port" TCL package provides all the primitives required for a mac
portfile to be parsed, queried, and its actions executed. It also provides
-a single procedure call that the "darwinports" TCL package uses to kick off
+a single procedure call that the "macports" TCL package uses to kick off
execution: "eval_targets".
The port TCL package is loaded by every Portfile with the following line
Modified: branches/dp2mp-move/base/doc/macports.conf.5
===================================================================
--- branches/dp2mp-move/base/doc/macports.conf.5 2007-04-27 03:57:55 UTC (rev 24503)
+++ branches/dp2mp-move/base/doc/macports.conf.5 2007-04-27 04:41:11 UTC (rev 24504)
@@ -64,7 +64,7 @@
and the main registry. Same path restrictions apply as for '${prefix}'.
.br
.Ic Default:
-${prefix}/var/db/dports
+${prefix}/var/macports
.It Va portdbformat
Storage type to use for the MacPorts registry. Currently the only supportted format is "flat".
.br
@@ -87,19 +87,19 @@
NOTE. Mac OS X 10.2 and Darwin 6.x users should switch to 'direct' mode to have MacPorts working properly
on their systems.
.It Va sources_conf
-Location of the sources file. This file enables rsync synchronization of the default dports tree with the
+Location of the sources file. This file enables rsync synchronization of the default ports tree with the
MacPorts rsync server (through the "sync" target of the
.Nm port
commnand) and any other local tree(s) you might have.
.br
.Ic Default:
-${prefix}/etc/ports/sources.conf
+${prefix}/etc/macports/sources.conf
.It Va variants_conf
Location of the optional global variants definition file, listing those that should be used in all installed
ports if available.
.br
.Ic Default:
-${prefix}/etc/ports/variants.conf
+${prefix}/etc/macports/variants.conf
.It Va portarchivemode
Key governing the creation of binary archives of installed ports for installation/reinstallation ease.
.br
@@ -109,7 +109,7 @@
Location where to store/retrieve ports binary archive files from when archive mode is active.
.br
.Ic Default:
-${prefix}/var/db/dports/packages
+${portdbpath}/packages
.It Va portarchivetype
Colon or comma separated, space free list of supported formats of archives to create or read from when
\&'${archivemode}' is set to 'yes'. Use of multiple types will cause archive creation to build all the
@@ -141,22 +141,22 @@
Default rsync server to connect to when running "selfupdate" through the
.Nm port
command to update your entire MacPorts
-installation (spanning both the MacPorts infrastucture and the dports tree).
+installation (spanning both the MacPorts infrastucture and the ports tree).
.br
.Ic Default:
-rsync.darwinports.org
+rsync.macports.org
.It Va rsync_dir
Rsync directory from which to pull the base/ component (infrastructure) of the MacPorts system off
of the default rsync server.
.br
.Ic Default:
-dpupdate1/base/ (to pull in the sources from the shipping "release1" branch off of the MacPorts rsync
+release/base/ (to pull in the sources from the shipping "release1" branch off of the MacPorts rsync
server)
.It Va rsync_options
Default rsync options to use when connecting to the rsync server.
.br
.Ic Default:
--rtzv --delete --delete-after
+-rtzv --delete-after
.It Va binpath
Sets the directory search path for locating system executables used by MacPorts. This variable should contain
the paths for locating utilities such as rsync, tar, cvs and others.
@@ -168,11 +168,11 @@
.El
.Sh FILES
.Bl -tag -width
-.It Va ${prefix}/etc/ports/ports.conf
+.It Va ${prefix}/etc/macports/macports.conf
Standard system-wide MacPorts configuration file.
-.It Va ~/.macports/ports.conf
+.It Va ~/.macports/macports.conf
User-specific configuration override. This file, if found, will be used instead of the default file at
-${prefix}/etc/port/ports.conf.
+${prefix}/etc/macport/macports.conf.
.El
.Sh SEE ALSO
.Xr port 1 ,
Modified: branches/dp2mp-move/base/doc/porthier.7
===================================================================
--- branches/dp2mp-move/base/doc/porthier.7 2007-04-27 03:57:55 UTC (rev 24503)
+++ branches/dp2mp-move/base/doc/porthier.7 2007-04-27 04:41:11 UTC (rev 24504)
@@ -81,8 +81,8 @@
.Bl -tag -width "spool/" -compact
.It Pa db/
misc. automatically generated system-specific database files
-.Bl -tag -width "dports/"
-.It Pa dports/
+.Bl -tag -width "ports/"
+.It Pa ports/
MacPorts runtime data
.Bl -tag -width "build/"
.It Pa build/
@@ -127,7 +127,7 @@
.El
.Sh SEE ALSO
.Xr port 1 ,
-.Xr ports.conf 5 ,
+.Xr macports.conf 5 ,
.Xr portfile 7 ,
.Xr portgroup 7 ,
.Xr portstyle 7 ,
Modified: branches/dp2mp-move/base/doc/sources.conf
===================================================================
--- branches/dp2mp-move/base/doc/sources.conf 2007-04-27 03:57:55 UTC (rev 24503)
+++ branches/dp2mp-move/base/doc/sources.conf 2007-04-27 04:41:11 UTC (rev 24504)
@@ -1,5 +1,5 @@
# To enable your local ports repository, uncomment and customize the
-# following line to point at your local dports directory
+# following line to point at your local ports directory
# Example: file:///Users/landonf/misc/MacPorts/ports
#
# To get MacPorts from the www.macports.org rsync server use:
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20070426/5a4e998d/attachment.html
More information about the macports-changes
mailing list