docs/32278: additional info for ports section
mwl...@blackhelicopters.org
>Number: 32278
>Category: docs
>Synopsis: additional info for ports section
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: change-request
>Submitter-Id: current-users
>Arrival-Date: Sun Nov 25 16:10:01 PST 2001
>Closed-Date:
>Last-Modified:
>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.</para>
</note>
! <para>Now that you have found a port you would like to install, you
! are ready to do the actual installation.</para>
<sect3 id="ports-cd">
<title>Installing Ports from a CDROM</title>
--- 671,687 ----
ports.</para>
</note>
! <para>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
! <literal>distfile</literal>. You can get the distfile from a
! CDROM or from the Internet.</para>
<sect3 id="ports-cd">
<title>Installing Ports from a CDROM</title>
***************
*** 681,696 ****
<primary>ports</primary>
<secondary>installing from CDROM</secondary>
</indexterm>
! <para>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 <ulink
! url="http://www.freebsdmall.com/">FreeBSD Mall</ulink>.</para>
!
! <para>Assuming that your FreeBSD CDROM is in the drive and is
! mounted on <filename>/cdrom</filename> (and the mount point
! <emphasis>must</emphasis> be <filename>/cdrom</filename>),
! you are ready to install the port. To begin, change
! to the directory where the port you want to install lives:</para>
<screen>&prompt.root; <userinput>cd /usr/ports/sysutils/lsof</userinput></screen>
--- 690,708 ----
<primary>ports</primary>
<secondary>installing from CDROM</secondary>
</indexterm>
! <para>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 <ulink
! url="http://www.freebsdmall.com/">FreeBSD Mall</ulink>.
! This section assumes you have such a FreeBSD CDROM
! set.</para>
!
! <para>Place your FreeBSD CDROM in the drive. Mount it on
! <filename>/cdrom</filename>. (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:</para>
<screen>&prompt.root; <userinput>cd /usr/ports/sysutils/lsof</userinput></screen>
***************
*** 776,783 ****
<para>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.</para>
<para>The steps involved are identical:</para>
--- 788,795 ----
<para>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.</para>
<para>The steps involved are identical:</para>
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majo...@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Dag-Erling Smorgrav
From: Dag-Erling Smorgrav <d...@ofug.org>
To: mwl...@blackhelicopters.org
Cc: FreeBSD-gn...@freebsd.org
Subject: Re: docs/32278: additional info for ports section
Date: 26 Nov 2001 01:12:17 +0100
mwl...@blackhelicopters.org writes:
> ! other tool or even uncompressed. The program source code,
> ! whatever form it comes in, is called a
> ! <literal>distfile</literal>. You can get the distfile from a
> ! CDROM or from the Internet.</para>
I believe the proper markup for distfile here would be quote, not
literal.
DES
--
Dag-Erling Smorgrav - d...@ofug.org
Michael Lucas
From: Michael Lucas <mwl...@blackhelicopters.org>
To: Dag-Erling Smorgrav <d...@ofug.org>
Cc: FreeBSD-gn...@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. <quote> is not in the FDP, however. <literal> 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 <quote>, then we should probably have <quote>
added to the SGML section of the FDP.
==ml
--
Michael Lucas
mwl...@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.</para>
</note>
! <para>Now that you have found a port you would like to install, you
! are ready to do the actual installation.</para>
<sect3 id="ports-cd">
<title>Installing Ports from a CDROM</title>
--- 671,687 ----
ports.</para>
</note>
! <para>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
! <quote>distfile</quote>. You can get the distfile from a
! CDROM or from the Internet.</para>
--vtzGhvizbBRQ85DL--