From owner-freebsd-ports Sun Jan 25 21:51:06 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id VAA08371 for freebsd-ports-outgoing; Sun, 25 Jan 1998 21:51:06 -0800 (PST) (envelope-from owner-freebsd-ports@FreeBSD.ORG) Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (8.8.8/8.8.8) with SMTP id VAA08357 for ; Sun, 25 Jan 1998 21:51:03 -0800 (PST) (envelope-from imp@village.org) Received: from harmony [10.0.0.6] by rover.village.org with esmtp (Exim 1.71 #1) id 0xwhRh-0007PU-00; Sun, 25 Jan 1998 22:50:57 -0700 Received: from harmony.village.org (localhost [127.0.0.1]) by harmony.village.org (8.8.8/8.8.3) with ESMTP id WAA09838 for ; Sun, 25 Jan 1998 22:51:36 -0700 (MST) Message-Id: <199801260551.WAA09838@harmony.village.org> To: ports@FreeBSD.ORG Subject: DRAFT: ports.7 Date: Sun, 25 Jan 1998 22:51:36 -0700 From: Warner Losh Sender: owner-freebsd-ports@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Here's a draft of the direction I'd like to take ports.7. It is incomplete, but complete enough for people to start to give me feedback on the direction, if not the content. Blah Blah Blah, means that I want to write more there, but haven't yet :-). Comments? Warner .\" .\" Copyright (c) 1997 David E. O'Brien .\" .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" $Id: ports.7,v 1.1 1997/11/09 06:05:45 obrien Exp $ .\" .Dd January 25, 1997 .Dt PORTS 7 .Os FreeBSD 2.2 .Sh NAME .Nm ports .Nd contributed applications .Sh DESCRIPTION The .Nm FreeBSD Ports Collection offers a simple way for users and administrators to install applications. Each .Ar port listed here contains any patches necessary to make the original application source code compile and run on BSD. Installing an application is as simple as downloading the port, unpacking it and typing make in the port directory. The Makefile automatically fetches the application source code, either from a local disk or via ftp, unpacks it on your system, applies the patches, and compiles. If all goes well, simply type .Ar make install to install the application. .Pp For more information about using ports, see .Nm The Ports Collection (file:/usr/share/doc/handbook/ports.html --or-- http://www.freebsd.org/handbook/ports.html). For information about creating new ports, see .Nm Porting applications (file:/usr/share/doc/handbook/porting.html --or-- http://www.freebsd.org/handbook/porting.html). Both are part of the FreeBSD Handbook. .Pp .Sh TARGETS .Ss fetch Fetch all of the files needed to build this port from the site(s) listed in MASTER_SITES and PATCH_SITES. See FETCH_CMD, MASTER_SITES, PATCH_SITES, and MASTER_SITE_OVERRIDE for details on how those environment variables impact this command. If there are subdirectories, then this target operates recursively. .Ss extract Checksum the files for the port and then extract them into a work directory. Defining NO_CHECKSUM will skip the checksum check step. Files will be fetched in the same way that make fetch fetches them. If there are subdirectories, then this target operates recursively. .Ss patch Patches the port. Blah Blah Blah. .Ss configure Configures the port. Blah Blah Blah. .Ss build Builds the the port. Blah Blah Blah. .Ss install Installs the the port. Blah Blah Blah. .Ss deinstall Deinstalls the the port. Blah Blah Blah. .Ss package Makes a binary package for the port from an installed port. You must install the package first. Blah Blah Blah. .Ss clean Cleans up after yourself. Blah Blah Blah. .Sh ENVIRONMENT VARIABLES .Ss MASTER_SITES Blah Blah Blah. .Ss PATCH_SITES Blah Blah Blah. .Ss FETCH_CMD Blah Blah Blah. .Ss MASTER_SITE_OVERRIDE Blah Blah Blah. .Sh FILES .Bl -tag -width /usr/ports/xxxx -compact .It Pa /usr/ports The default ports directory (FreeBSD and OpenBSD). .It Pa /usr/pkgsrc The default ports directory (NetBSD). .Sh SEE ALSO .Xr make 1 , .Xr pkg_add 1 , .Xr pkg_create 1 , .Xr pkg_delete 1 , .Xr pkg_info 1 . .Sh AUTHORS This man page has been written by David E. O'Brien. The ports collection is maintained by Satoshi Asami and the .\" incredible awesome ports team. .Sh HISTORY .Nm The Ports Collection appeared in .Fx 1.0 .