Changeset 18786


Ignore:
Timestamp:
Jul 28, 2006, 7:58:18 PM (14 years ago)
Author:
jberry
Message:

Updates to help and port(1) man page

Location:
trunk/base
Files:
4 edited

Legend:

Unmodified
Added
Removed
  • trunk/base/ChangeLog

    r18785 r18786  
    11#
    2 #   $Id: ChangeLog,v 1.39 2006/07/28 18:30:11 jberry Exp $
     2#   $Id: ChangeLog,v 1.40 2006/07/28 19:58:17 jberry Exp $
    33#
    44#   This is a log of major user-visible changes in each release
     
    1515      SVN. (pguyot)
    1616
    17         - Added a new test case for the previous bug. (pguyot)
    18        
    19         - Added ruby gems support for ruby group. (rcavanaugh & pguyot)
    20 
    21         - Trace now forbids creation of directories outside the sandbox. (pguyot)
    22        
    2317        - Fixed a bug, introduced in 1.3, that prevented -f selfupdate from forcing
    2418          a build of the fetched sources. (jberry)
     
    2721          (jberry)
    2822
     23        - Added a new test case for the previous bug. (pguyot)
     24       
     25        - Added ruby gems support for ruby group. (rcavanaugh & pguyot)
     26
     27        - Trace now forbids creation of directories outside the sandbox. (pguyot)
     28       
     29        - Additions to man page for port(1):
     30           * new port options -F, -i, -x, -p
     31           * mention interactive and batch modes
     32           * document extensions to info command.
     33       
    2934Release 1.3 (27-Jul-2006):
    3035
  • trunk/base/doc/TODO.txt

    r18734 r18786  
    11#
    2 # $Id: TODO.txt,v 1.7 2006/07/25 16:19:39 jberry Exp $
     2# $Id: TODO.txt,v 1.8 2006/07/28 19:58:18 jberry Exp $
    33#
    44# DarwinPorts TODO List
     
    88#
    99
    10 Version 1.2:
     10Outstanding ToDos:
    1111
    12         (these may make it into 1.2)
    13     - Enhance port(1) man page with stuff that didn't make it into the 1.2 release (Juan, James & Joe)
    1412    - Add to portfile(7) manpage docs for the new startupitem keys. (idem)
    1513        (James added some suggested text to bug #4905)
    1614    - Add to ports.conf(5) manpage docs on new startupitem_type option. (idem)
    1715        (James added some suggested text to bug #4905)
    18     - Maybe: cvs/svn fetch w/ patches: http://bugzilla.opendarwin.org/show_bug.cgi?id=5269 (yeled?)
    19 
    20 Version 1.3:
    21 
    22         - Add new global options -p, -x, -F, -i to port(1) man page.
    23         - Document interactive/batch mode in port(1) man page.
    24         - Document extended info command in port(1) man page.
    25         - Check whether stuff listed above for 1.2 got documented.
  • trunk/base/src/port/port.1

    r18710 r18786  
    3737.Sh SYNOPSIS
    3838.Nm
    39 .Op Fl vdqfonRusbckt
     39.Op Fl vdqfonRusbckixpt
    4040.Op Fl D Ar portdir
     41.Op Fl F Ar cmdfile
    4142.Ar action
    4243.Op Ar actionflags
     
    5455is specified, the current working directory is assumed; if no
    5556.Ar action
    56 is specified, the usage is displayed.
     57is specified, the port command enters interactive mode in which commands are read via stdin. Batch files of commands may be specified via batch files   .
    5758Port
    5859.Ar options
     
    220221specify
    221222.Ar portdir
     223.It Fl F
     224Read and process the
     225.Ar file
     226of commands specified by the argument. If the argument is '-', then read commands from stdin. If the option is given multiple times, then multiple files will be read.
     227.It Fl i
     228Read commands from stdin. Short for -F -
     229.It Fl x
     230In batch and interactive mode, exit on the first error encountered. Otherwise, errors during batch execution are simply reported.
     231.It Fl p
     232Despite any errors encountered, proceed to process multiple ports and commands.
    222233.It Fl t
    223234enable trace mode debug facilities on platforms that support it (MacOS X). This feature is two-folded. It consists in automatically detecting and reporting undeclared dependencies based on what files the port reads or what programs the port executes. In verbose mode, it will also report unused dependencies for each stage of the port installation. It also consists in forbidding and reporting file creation and file writes outside allowed directories (temporary directories and ${worksrcpath}).
     235
    224236.El
    225237.Sh USER TARGETS
     
    233245Displays all the meta-information available for
    234246.Ar portname .
     247Specific meta-information may be requested through an option such as
     248.Fl --maintainer
     249or
     250.Fl --category
     251(recognized field names are those from the portindex). If the global option
     252.Fl -q
     253is in effect, the meta-info fields will not be labeled; if the option
     254.Fl --line
     255is provided, all such data will be consolodated into a single line per port, suitable for processing in a pipe of commands.
     256For example:
     257.Pp
     258.Dl "port info vim"
     259.Dl "port info --category --name apache*"
     260.Dl "port -q info --category --name --version category:java"
     261.Dl "port info --line --category --name all"
    235262.Ss variants
    236263Lists the build variants available for
  • trunk/base/src/port/port.tcl

    r18784 r18786  
    33exec @TCLSH@ "$0" "$@"
    44# port.tcl
    5 # $Id: port.tcl,v 1.161 2006/07/28 18:15:32 jberry Exp $
     5# $Id: port.tcl,v 1.162 2006/07/28 19:58:18 jberry Exp $
    66#
    77# Copyright (c) 2002-2006 DarwinPorts organization
     
    125125proc print_usage {args} {
    126126        global cmdname
    127         set syntax { [-bcdfFiknopqRstuxv] [-D portdir] [-F cmdfile] action [privopts] [actionflags]
     127        set syntax { [-bcdfiknopqRstuvx] [-D portdir] [-F cmdfile] action [privopts] [actionflags]
    128128[[portname|pseudo-portname|port-url] [@version] [+-variant]... [option=value]...]...
    129129}
     
    138138        global action_array
    139139       
    140         set syntax { [-bcdfFiknopqRstuxv] [-D portdir] [-F cmdfile] action [privopts] [actionflags]
     140        set syntax { [-bcdfiknopqRstuvx] [-D portdir] [-F cmdfile] action [privopts] [actionflags]
    141141[[portname|pseudo-portname|port-url] [@version] [+-variant]... [option=value]...]...
    142142}
Note: See TracChangeset for help on using the changeset viewer.