Changes between Version 2 and Version 5 of Ticket #306


Ignore:
Timestamp:
Mar 24, 2016, 12:40:51 PM (8 years ago)
Author:
ryandesign (Ryan Carsten Schmidt)
Comment:

Legend:

Unmodified
Added
Removed
Modified

  • Ticket #306

    • Property Component changed from www to guide

  • Ticket #306 – Description

    v2 v5  
    11this is an updated version of portfileHOWTO.php.
    2 - debug and verbose settings don't exist anymore in ports.conf, the reference
    3 to these are updated
    4 - long_description is more or less required, thus it should me mentioned
    5 in the howto.
     2- debug and verbose settings don't exist anymore in ports.conf, the reference to these are updated
     3- long_description is more or less required, thus it should me mentioned in the howto.
    64I did sign up for an account for darwinports-www, is someone from core
    7 grants me access, I would commit this.
     5grants me access, I would commit this.\\
    86the patch can also be grabbed from:
    97http://www.opendarwin.org/~fkr/patch-portfileHOWTO.diff
    108
    119here is the diff:
    12 ==================
    1310
     11{{{
    1412Index: portfileHOWTO.php
    1513===================================================================
    … …  
    2018+++ portfileHOWTO.php   27 Dec 2002 19:47:37 -0000
    2119@@ -33,14 +33,7 @@
    22  In order to work with DarwinPorts, you'll need to download and install it on
    23 your system.  The DarwinPorts project <a
    24 href="http://opendarwin.org/projects/darwinports/">homepage</a> describes how to
    25 get and install it.
     20 In order to work with DarwinPorts, you'll need to download and install it on your system.  The DarwinPorts project <a href="http://opendarwin.org/projects/darwinports/">homepage</a> describes how to get and install it.
    2621 </p>
    2722 <p>
    28 -Since you're interested in writing a Portfile, let's change some configuration
    29 options that will help in debugging as we go.  Edit the file
    30 <tt>/etc/ports/ports.conf</tt> to contain the following (you'll likely have to
    31 use <tt>sudo</tt> to edit this file):
     23-Since you're interested in writing a Portfile, let's change some configuration options that will help in debugging as we go.  Edit the file <tt>/etc/ports/ports.conf</tt> to contain the following (you'll likely have to use <tt>sudo</tt> to edit this file):
    3224-</p>
    3325-<pre><tt>
    … …  
    3628-</tt></pre>
    3729-<p>
    38 -This will display useful debugging messages that are usually suppressed while
    39 running DarwinPorts.
    40 +Since you're interested in writing a Portfile, you should invoke the
    41 <tt>port</tt> command with the <tt>-v</tt> (verbose output) and the <tt>-d</tt>
    42 (debugging output) switches. This will display useful debugging messages that
    43 are usually suppressed while running DarwinPorts.
     30-This will display useful debugging messages that are usually suppressed while running DarwinPorts.
     31+Since you're interested in writing a Portfile, you should invoke the <tt>port</tt> command with the <tt>-v</tt> (verbose output) and the <tt>-d</tt> (debugging output) switches. This will display useful debugging messages that are usually suppressed while running DarwinPorts.
    4432 </p>
    4533 <p>
    … …  
    5038 maintainers     kevin@opendarwin.org
    5139+description     an IRC and ICB client
    52 +long_description        The ircII program is a full screen, termcap based
    53 interface to Internet Relay \
    54 +                        Chat. It gives full access to all of the normal IRC
    55 functions, plus a variety \
     40+long_description        The ircII program is a full screen, termcap based interface to Internet Relay \
     41+                        Chat. It gives full access to all of the normal IRC functions, plus a variety \
    5642+                        of additional options.
    5743 master_sites    ftp://ircftp.au.eterna.com.au/pub/ircII/
    5844 </tt></pre>
    5945 <p>
    60 -A Portfile consists of key/value pairs.  The <tt>name</tt> and <tt>version</tt>
    61 key describe the name and version of the software.  The <tt>categories</tt> key
    62 is a list of the logical categories to which the software belongs; this is used
    63 for organizational purposes.  The first entry in <tt>categories</tt> should
    64 match the directory in which the port's directory resides in the port tree.  The
    65 <tt>maintainers</tt> key should contain your email address, and the
    66 <tt>master_sites</tt> key should contain a list of sites where the distribution
    67 sources may be downloaded.  DarwinPorts uses the terms 'keys' and 'options'
    68 interchangeably since most keys are used as options of a particular task in the
    69 porting process.
    70 +A Portfile consists of key/value pairs.  The <tt>name</tt> and <tt>version</tt>
    71 key describe the name and version of the software.  The <tt>categories</tt> key
    72 is a list of the logical categories to which the software belongs; this is used
    73 for organizational purposes.  The first entry in <tt>categories</tt> should
    74 match the directory in which the port's directory resides in the port tree.  The
    75 <tt>maintainers</tt> key should contain your email address. <tt>description</tt>
    76 provides a short description of the port, while <tt>long_description</tt> holds
    77 a more detailled description of the Software. The <tt>master_sites</tt> key
    78 should contain a list of sites where the distribution sources may be downloaded.
    79  DarwinPorts uses the terms 'keys' and 'options' interchangeably since most keys
    80 are used as options of a particular task in the porting process.
     46-A Portfile consists of key/value pairs.  The <tt>name</tt> and <tt>version</tt> key describe the name and version of the software.  The <tt>categories</tt> key is a list of the logical categories to which the software belongs; this is used for organizational purposes.  The first entry in <tt>categories</tt> should match the directory in which the port's directory resides in the port tree.  The <tt>maintainers</tt> key should contain your email address, and the <tt>master_sites</tt> key should contain a list of sites where the distribution sources may be downloaded.  DarwinPorts uses the terms 'keys' and 'options' interchangeably since most keys are used as options of a particular task in the porting process.
     47+A Portfile consists of key/value pairs.  The <tt>name</tt> and <tt>version</tt> key describe the name and version of the software.  The <tt>categories</tt> key is a list of the logical categories to which the software belongs; this is used for organizational purposes.  The first entry in <tt>categories</tt> should match the directory in which the port's directory resides in the port tree.  The <tt>maintainers</tt> key should contain your email address. <tt>description</tt> provides a short description of the port, while <tt>long_description</tt> holds a more detailled description of the Software. The <tt>master_sites</tt> key should contain a list of sites where the distribution sources may be downloaded.
     48 DarwinPorts uses the terms 'keys' and 'options' interchangeably since most keys are used as options of a particular task in the porting process.
    8149 </p>
    8250 <p>
    83  At this point, the Portfile is complete enough to download ircII.  By default,
    84 DarwinPorts will append the <tt>version</tt> to the <tt>name</tt> and assume
    85 sources are in <tt>.tar.gz</tt> format.  From your working directory, execute
    86 the following command:
     51 At this point, the Portfile is complete enough to download ircII.  By default, DarwinPorts will append the <tt>version</tt> to the <tt>name</tt> and assume sources are in <tt>.tar.gz</tt> format.  From your working directory, execute the following command:
    8752@@ -292,6 +289,10 @@
    8853 version         20020912
    … …  
    9055 maintainers     kevin@opendarwin.org
    9156+description     an IRC and ICB client
    92 +long_description        The ircII program is a full screen, termcap based
    93 interface to Internet Relay \
    94 +                        Chat. It gives full access to all of the normal IRC
    95 functions, plus a variety \
     57+long_description        The ircII program is a full screen, termcap based interface to Internet Relay \
     58+                        Chat. It gives full access to all of the normal IRC functions, plus a variety \
    9659+                        of additional options.
    9760 master_sites    ftp://ircftp.au.eterna.com.au/pub/ircII/
    9861 checksums       md5 2ae68c015698f58763a113e9bc6852cc
    9962 configure.args  --disable-ipv6
     63}}}