From mwlucas@blackhelicopters.org Sun Nov 25 16:08:36 2001 Return-Path: Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18]) by hub.freebsd.org (Postfix) with ESMTP id EC78C37B417 for ; Sun, 25 Nov 2001 16:08:35 -0800 (PST) Received: (from mwlucas@localhost) by blackhelicopters.org (8.11.6/8.11.6) id fAQ08ZU38065; Sun, 25 Nov 2001 19:08:35 -0500 (EST) (envelope-from mwlucas) Message-Id: <200111260008.fAQ08ZU38065@blackhelicopters.org> Date: Sun, 25 Nov 2001 19:08:35 -0500 (EST) From: mwlucas@blackhelicopters.org Reply-To: mwlucas@blackhelicopters.org To: FreeBSD-gnats-submit@freebsd.org Subject: additional info for ports section X-Send-Pr-Version: 3.2 >Number: 32278 >Category: docs >Synopsis: additional info for ports section >Confidential: no >Severity: non-critical >Priority: low >Responsible: mwlucas >State: closed >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Sun Nov 25 16:10:01 PST 2001 >Closed-Date: Mon Jan 21 11:20:16 PST 2002 >Last-Modified: Mon Jan 21 11:21:44 PST 2002 >Originator: Michael Lucas >Release: FreeBSD 3.5-STABLE i386 >Organization: None >Environment: today's -doc tree >Description: Describe what a distfile is, and how it's used in both a CDROM and Internet port install. Minor language tightening in the sections I'm touching anyway. Someone may want to justify the last portion of this in a whitespace-only commit. >How-To-Repeat: >Fix: *** en_US.ISO8859-1/books/handbook/ports/chapter.sgml-dist Tue Nov 20 21:19:43 2001 --- en_US.ISO8859-1/books/handbook/ports/chapter.sgml Sun Nov 25 19:04:04 2001 *************** *** 671,678 **** ports. ! Now that you have found a port you would like to install, you ! are ready to do the actual installation. Installing Ports from a CDROM --- 671,687 ---- ports. ! Now that you have found a port you would like to install, ! you are ready to do the actual installation. The port ! includes instructions on how to build source code, but no ! actual source code. You can get the source code from a CDROM ! or from the Internet. Source code is distributed in whatever ! manner the software author desires. Frequently this is a ! tarred and gzipped file, but it might be compressed with some ! other tool or even uncompressed. The program source code, ! whatever form it comes in, is called a ! distfile. You can get the distfile from a ! CDROM or from the Internet. Installing Ports from a CDROM *************** *** 681,696 **** ports installing from CDROM ! As you may have guessed from the title, everything ! described in this section assumes you have a FreeBSD CDROM set. ! If you do not, you can order one from the FreeBSD Mall. ! ! Assuming that your FreeBSD CDROM is in the drive and is ! mounted on /cdrom (and the mount point ! must be /cdrom), ! you are ready to install the port. To begin, change ! to the directory where the port you want to install lives: &prompt.root; cd /usr/ports/sysutils/lsof --- 690,708 ---- ports installing from CDROM ! The FreeBSD Project's official CDROM images no longer ! includes distfiles. They take up a lot of room that is ! better used by precompiled packages. CDROM products such as ! the FreeBSD Power Pak do include distfiles, and you can ! order these sets from a vendor such as the FreeBSD Mall. ! This section assumes you have such a FreeBSD CDROM ! set. ! ! Place your FreeBSD CDROM in the drive. Mount it on ! /cdrom. (If you use a different mount ! point, the install will not work.) To begin, change to the ! directory for the port you want to install: &prompt.root; cd /usr/ports/sysutils/lsof *************** *** 776,783 **** Installing a port from the Internet is done exactly the same way as it would be if you were installing from a CDROM. The ! only difference between the two is that the program's source ! code is downloaded from the Internet instead of pulled from the CDROM. The steps involved are identical: --- 788,795 ---- Installing a port from the Internet is done exactly the same way as it would be if you were installing from a CDROM. The ! only difference between the two is that the port distfile ! is downloaded from the Internet instead of pulled from the CDROM. The steps involved are identical: >Release-Note: >Audit-Trail: From: Dag-Erling Smorgrav To: mwlucas@blackhelicopters.org Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/32278: additional info for ports section Date: 26 Nov 2001 01:12:17 +0100 mwlucas@blackhelicopters.org writes: > ! other tool or even uncompressed. The program source code, > ! whatever form it comes in, is called a > ! distfile. You can get the distfile from a > ! CDROM or from the Internet. I believe the proper markup for distfile here would be quote, not literal. DES -- Dag-Erling Smorgrav - des@ofug.org From: Michael Lucas To: Dag-Erling Smorgrav Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/32278: additional info for ports section Date: Sun, 25 Nov 2001 19:24:27 -0500 --vtzGhvizbBRQ85DL Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Mon, Nov 26, 2001 at 01:12:17AM +0100, Dag-Erling Smorgrav wrote: > I believe the proper markup for distfile here would be quote, not > literal. Quite possibly. is not in the FDP, however. seemed the best match of what's listed. I'm attaching a patch with this change. -doc masters, use whichever one is correct. If it's , then we should probably have added to the SGML section of the FDP. ==ml -- Michael Lucas mwlucas@blackhelicopters.org http://www.blackhelicopters.org/~mwlucas/ Big Scary Daemons: http://www.oreillynet.com/pub/q/Big_Scary_Daemons --vtzGhvizbBRQ85DL Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename=ports-cd *** en_US.ISO8859-1/books/handbook/ports/chapter.sgml-dist Tue Nov 20 21:19:43 2001 --- en_US.ISO8859-1/books/handbook/ports/chapter.sgml Sun Nov 25 19:04:04 2001 *************** *** 671,678 **** ports. ! Now that you have found a port you would like to install, you ! are ready to do the actual installation. Installing Ports from a CDROM --- 671,687 ---- ports. ! Now that you have found a port you would like to install, ! you are ready to do the actual installation. The port ! includes instructions on how to build source code, but no ! actual source code. You can get the source code from a CDROM ! or from the Internet. Source code is distributed in whatever ! manner the software author desires. Frequently this is a ! tarred and gzipped file, but it might be compressed with some ! other tool or even uncompressed. The program source code, ! whatever form it comes in, is called a ! distfile. You can get the distfile from a ! CDROM or from the Internet. Installing Ports from a CDROM *************** *** 681,696 **** ports installing from CDROM ! As you may have guessed from the title, everything ! described in this section assumes you have a FreeBSD CDROM set. ! If you do not, you can order one from the FreeBSD Mall. ! ! Assuming that your FreeBSD CDROM is in the drive and is ! mounted on /cdrom (and the mount point ! must be /cdrom), ! you are ready to install the port. To begin, change ! to the directory where the port you want to install lives: &prompt.root; cd /usr/ports/sysutils/lsof --- 690,708 ---- ports installing from CDROM ! The FreeBSD Project's official CDROM images no longer ! includes distfiles. They take up a lot of room that is ! better used by precompiled packages. CDROM products such as ! the FreeBSD Power Pak do include distfiles, and you can ! order these sets from a vendor such as the FreeBSD Mall. ! This section assumes you have such a FreeBSD CDROM ! set. ! ! Place your FreeBSD CDROM in the drive. Mount it on ! /cdrom. (If you use a different mount ! point, the install will not work.) To begin, change to the ! directory for the port you want to install: &prompt.root; cd /usr/ports/sysutils/lsof *************** *** 776,783 **** Installing a port from the Internet is done exactly the same way as it would be if you were installing from a CDROM. The ! only difference between the two is that the program's source ! code is downloaded from the Internet instead of pulled from the CDROM. The steps involved are identical: --- 788,795 ---- Installing a port from the Internet is done exactly the same way as it would be if you were installing from a CDROM. The ! only difference between the two is that the port distfile ! is downloaded from the Internet instead of pulled from the CDROM. The steps involved are identical: --vtzGhvizbBRQ85DL-- Responsible-Changed-From-To: freebsd-doc->mwlucas Responsible-Changed-By: keramida Responsible-Changed-When: Thu Dec 6 19:50:03 PST 2001 Responsible-Changed-Why: Michael can close his own PR's now :) http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32278 State-Changed-From-To: open->closed State-Changed-By: mwlucas State-Changed-When: Mon Jan 21 11:20:16 PST 2002 State-Changed-Why: Close my last submitted PR. Committing, using instead of . http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32278 >Unformatted: