Final touches:

Update the synopsis.
Add a man xref to the distfile description.
Add a 'dealing with imake' section.
Fix 2 spelling errors while I'm here.
This commit is contained in:
Tom Rhodes 2003-05-20 19:41:29 +00:00
parent faca532dd0
commit 39adab85e5
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=16999

View file

@ -35,6 +35,13 @@
<listitem>
<para>How to remove previously installed packages or ports.</para>
</listitem>
<listitem>
<para>How to override default the default values that the ports
collection uses.</para>
</listitem>
<listitem>
<para>How to upgrade your ports.</para>
</listitem>
</itemizedlist>
</sect1>
@ -317,7 +324,7 @@ local: lsof-4.56.4.tgz remote: lsof-4.56.4.tgz
<para>The example above would download the correct package and add
it without any further user intervention. &man.pkg.add.1; uses
&man.fetch.3; to download the files, which honours various
&man.fetch.3; to download the files, which honors various
environment variables, including <envar>FTP_PASSIVE_MODE</envar>,
<envar>FTP_PROXY</envar>, and <envar>FTP_PASSWORD</envar>. You
may need to set one or more of these if you are behind a firewall,
@ -597,7 +604,7 @@ docbook =
<para>A <filename>distinfo</filename> file. This file contains
information about the files that must be downloaded to build the
port and their checksums, to verify that files have not been
corrupted during the download.</para>
corrupted during the download using &man.md5.1;.</para>
</listitem>
<listitem>
@ -873,7 +880,7 @@ Receiving lsof_4.57D.freebsd.tar.gz (439860 bytes): 100%
you where the system is fetching the port distfile from.</para>
<para>The ports system uses &man.fetch.1; to download the files,
which honours various environment variables, including
which honors various environment variables, including
<envar>FTP_PASSIVE_MODE</envar>, <envar>FTP_PROXY</envar>,
and <envar>FTP_PASSWORD</envar>. You may need to set one or more
of these if you are behind a firewall, or need to use an FTP/HTTP
@ -939,6 +946,21 @@ Receiving lsof_4.57D.freebsd.tar.gz (439860 bytes): 100%
<para>will combine the two (it is too long to completely write on
this page, but it should give you the general idea).</para>
<para>Alternatively, these variables can also be set
as part of your environment. Read the manual page for your shell for
instructions on doing so.</para>
</sect3>
<sect3>
<title>Dealing with <command>imake</command></title>
<para>Some ports that use <command>imake</command> (a part of the X Windows
System) do not work well with <makevar>PREFIX</makevar>, and will insist on
installing under <filename>/usr/X11R6</filename>. Similarly, some Perl ports
ignore <makevar>PREFIX</makevar> and install in the Perl tree. Making these
ports respect <makevar>PREFIX</makevar> is a difficult or impossible
job.</para>
</sect3>
</sect2>