Changeset 12689


Ignore:
Timestamp:
Jun 16, 2005, 8:46:26 PM (15 years ago)
Author:
jmpp
Message:

Bug: 3549
Submitted by: matt@
Reviewed by: jmpp@

Formating changes to the main README file and mention of Mac OS X 10.4
I can't imagine doing this for the Spanish file.. speak any Spanish Matt??

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/README

    r12092 r12689  
    11WHAT IS THE DARWIN PORTS SYSTEM
    22
    3     DarwinPorts is a software build, install, and packaging infrastructure
    4 designed to meet the same functionality requirements as the FreeBSD ports
    5 architecture while maintaining extensibility for future enhancement.
     3        DarwinPorts is a software build, install, and packaging
     4        infrastructure designed to meet the same functionality requirements
     5        as the FreeBSD ports architecture while maintaining extensibility
     6        for future enhancement.
    67
    7     DarwinPorts currently builds and runs on MacOS X 10.2 (Darwin 6.0) and
    8 MacOS X 10.3 (Darwin 7.0).  The system is portable, written in TCL with a
    9 limited set of TCL extensions in C.
     8        DarwinPorts currently builds and runs on Mac OS X 10.2 (Darwin
     9        6.0), Mac OS X 10.3 (Darwin 7.0.0) and Mac OS X 10.4 (Darwin
     10        8.0.0). The system is portable, written in TCL with a limited set
     11        of TCL extensions in C.
    1012
    11     The "DarwinPorts User Guide" is available at:
    12         http://darwinports.opendarwin.org/docs
     13                The "DarwinPorts User Guide" is available at:
     14                http://darwinports.opendarwin.org/docs
    1315
    14     For in-depth documentation on the internals of the ports system
    15 architecture, refer to base/doc/INTERNALS.
     16        For in-depth documentation on the internals of the ports system
     17        architecture, refer to base/doc/INTERNALS.
    1618
    17     Please note that DarwinPorts is split into two parts.  The "darwin ports
    18 infrastructure", which lives in the base/ subdirectory and is the only
    19 mandatory component of the system, and the "dports" directory which contains
    20 the actual ported software descriptions.  The latter is optional and can be
    21 either fetched on demand over the net or a local copy can be used.  See
    22 documentation on ${prefix}/etc/ports/sources.conf below.
     19        Please note that DarwinPorts is split into two parts.  The "darwin
     20        ports infrastructure", which lives in the base/ subdirectory and is
     21        the only mandatory component of the system, and the "dports"
     22        directory which contains the actual ported software descriptions.
     23        The latter is optional and can be either fetched on demand over the
     24        net or a local copy can be used.  See documentation on ${prefix}
     25        etc/ports/sources.conf below.
     26
    2327
    2428INSTALLATION
     
    2630        For platform specific instructions, read base/doc/README.platforms.
    2731
    28     Installation Steps:
     32        Installation Steps:
    2933
    3034        1. cd base/
    3135           ./configure
    3236                Switch to the base/ directory and run the configure-script.
    33                 Optionally parameters can be passed to the configure-script 
     37                Optionally parameters can be passed to the configure-script
    3438                (see below).
    3539   
     
    3842               
    3943        3. sudo make install
    40                 Run 'sudo make install' to install DarwinPorts on your system.
     44                Run 'sudo make install' to install DarwinPorts on your
     45                system.
    4146
    4247        4. [optional] edit ${prefix}/etc/ports/ports.conf
    43                 The ${prefix}/etc/ports/ports.conf configuration file defines several
    44                 configuration options for the DarwinPorts infrastructure. If
    45                 you wish to change installation paths or the location at
    46                 which various port system specific data is stored, change the
    47                 following settings:
     48                The ${prefix}/etc/ports/ports.conf configuration file
     49                defines several configuration options for the DarwinPorts
     50                infrastructure. If you wish to change installation paths or
     51                the location at which various port system specific data is
     52                stored, change the following settings:
    4853
    49                 portdbpath      Specifies path to store ports system specific
    50                                 data.
    51                 prefix          Specifies directory in which to install ports.
     54                        portdbpath      Specifies path to store ports
     55                                        system specific data.
     56
     57                        prefix          Specifies directory in which to
     58                                        install ports.
    5259
    5360        5. [optional] edit ${prefix}/etc/ports/sources.conf
    54                 The ${prefix}/etc/ports/sources.conf file lists the location of both
    55                 local and remote port software hierarchies. If the
    56                 --with-dports-dir=DIR argument was not specified for the
    57                 ./configure script, the default dports-tree
    58                 (darwinports/dports, the copy from which you install) will be
    59                 added to sources.conf.
     61                The ${prefix}/etc/ports/sources.conf file lists the
     62                location of both local and remote port softwarehierarchies.
     63                If the --with-dports-dir=DIR argument was not specified for
     64                the ./configure script, the default dports-tree
     65                (darwinports/dports, the copy from which you install) will
     66                be added to sources.conf.
    6067
    61     All necessary code and TCL will be compiled and installed as follows:
    62         [Mac OS X 10.3] /Library/Tcl/darwinports1.0
    63         [Mac OS X 10.2] /System/Library/Tcl/darwinports1.0
    64         [FreeBSD] /usr/local/lib/tcl8.3/darwinports1.0
    65             - TCL library for interfacing with the DarwinPorts System
     68        All necessary code and TCL will be compiled and installed as
     69        follows:
     70
     71        [Mac OS X 10.2] /System/Library/Tcl/darwinports1.0
     72        [Mac OS X 10.3] /Library/Tcl/darwinports1.0
     73        [Mac OS X 10.4] /Library/Tcl/darwinports1.0
     74        [FreeBSD]       /usr/local/lib/tcl8.3/darwinports1.0
     75                        - TCL library for interfacing with the DarwinPorts
     76                        System.
    6677
    6778        ${prefix} is set to /opt/local but can be overridden by changing
     
    8495USING THE PORT COMMAND
    8596
    86     If you haven't already, add /opt/local/bin to your path (or ${prefix}/bin
    87 if you've elected to install DarwinPorts somewhere else).
     97        If you haven't already, add /opt/local/bin to your path (or
     98        ${prefix}/bin if you've elected to install DarwinPorts somewhere
     99        else).
    88100
    89         If you're unsure how and using Panther (OS X 10.3), add the following
    90 line to your ~/.profile file.  If this file does not exist, create it. (This
    91 also applies if you're using a bourne shell in Jaguar.)
     101        If you're unsure how and using Panther (OS X 10.3), add the
     102        following line to your ~/.profile file. If this file does not
     103        exist, create it. (This also applies if you're using a bourne shell
     104        in Jaguar.)
    92105       
    93         export PATH=$PATH:/opt/local/bin
     106                export PATH=$PATH:/opt/local/bin
    94107
    95         If using Jaguar (OS X 10.2), add the following line to your ~/.cshrc file.
    96 If this file does not exist, create it. (This also applies if you're using tcsh in Panther.)
     108        If using Jaguar (OS X 10.2), add the following line to your
     109        ~/.cshrc file. If this file does not exist, create it. (This also
     110        applies if you're using tcsh in Panther.)
    97111
    98         set path=($path /opt/local/bin)
     112                set path=($path /opt/local/bin)
    99113       
    100     Your changes will not take effect until you have opened a new shell.
     114        Your changes will not take effect until you have opened a new
     115        shell.
    101116
    102     The following command will build and install a port:
     117        The following command will build and install a port:
    103118
    104         port install <portname>
     119                port install <portname>
    105120
    106     To find a specific port, try using "port search".
     121        To find a specific port, try using "port search".
    107122
    108         port search vi
     123                port search vi
    109124
    110     Please refer to the port(1) man page for complete documentation on the port
    111     command.
     125        Please refer to the port(1) man page for complete documentation on
     126        the port command.
    112127
    113     It is also possible to do operations, like building or fetching, for
    114     all ports on the system using the portall command.  It takes essentially
    115     the same arguments as the port command but operates iteratively on every
    116     port in dports/.
     128        It is also possible to do operations, like building or fetching,
     129        for all ports on the system using the portall command. It takes
     130        essentially the same arguments as the port command but operates
     131        iteratively on every port in dports/.
    117132
    118133
    119134CREATING NEW PORTS
    120135
    121     Ports consist of directory containing both a Portfile and associated
    122 files. Currently the only bundled files are patch files, and these are likely
    123 to be kept to a minimum.
     136        Ports consist of directory containing both a Portfile and
     137        associated files. Currently the only bundled files are patch files,
     138        and these are likely to be kept to a minimum.
    124139
    125     A Portfile consists of valid TCL, evaluated by a TCL interpreter
    126 instantiated by the DarwinPorts System. Portfiles use extremely straight-
    127 forward key/value pair syntax, while allowing the author to use the full
    128 extent of TCL's functionality where necessary.
     140        A Portfile consists of valid TCL, evaluated by a TCL interpreter
     141        instantiated by the DarwinPorts System. Portfiles use extremely
     142        straight-forward key/value pair syntax, while allowing the author
     143        to use the full extent of TCL's functionality where necessary.
    129144
    130     To get started, refer to base/doc/exampleport and the portfile(7) man page,
    131 or The DarwinPorts Guide, at http://darwinports.opendarwin.org/docs .
     145        To get started, refer to base/doc/exampleport and the portfile(7)
     146        man page, or The DarwinPorts Guide, at:
     147        http://darwinports.opendarwin.org/docs
Note: See TracChangeset for help on using the changeset viewer.