os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- Remove phrase 'bloat in the master source repository' as a leftover from the cvs times

Browse source 
- Remove phrase about 'automatically determining of closet master site...', it
  was in planing phase for more than 15 years
- Replace 'gzipped' with 'compressed' when appropriate
- Update url for the backup master site
- Fix typo: s/otn/from/
- Remove reference to DATA option

Differential Revision:	https://reviews.freebsd.org/D1017
Approved by:	portmgr (mat)
This commit is contained in:
Alex Kozlov 2017-10-14 07:28:50 +00:00
parent 9c199e5643
commit 2b87c76011
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=51120
1 changed files with 10 additions and 16 deletions
Download patch file Download diff file Expand all files Collapse all files

26
en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
View file

@ -1697,8 +1697,7 @@ PORTEPOCH= 1</programlisting>
we can discuss it before we import it. As a committer, we can discuss it before we import it. As a committer,
send a note to the &a.ports; so we can discuss it send a note to the &a.ports; so we can discuss it
first. Too often, new ports are imported to the wrong first. Too often, new ports are imported to the wrong
category only to be moved right away. This causes unnecessary category only to be moved right away.</para>
and undesirable bloat in the master source repository.</para>
</sect2> </sect2>
<sect2 xml:id="proposing-categories"> <sect2 xml:id="proposing-categories">
@ -2058,10 +2057,7 @@ DIST_SUBDIR= ${PORTNAME}-${PORTVERSION}</programlisting>
<para>It is recommended that multiple sites are included on this <para>It is recommended that multiple sites are included on this
list, preferably from different continents. This will list, preferably from different continents. This will
safeguard against wide-area network problems. We are even safeguard against wide-area network problems.</para>
planning to add support for automatically determining the
closest master site and fetching from there; having multiple
sites will go a long way towards helping this effort.</para>
<important> <important>
<para><varname>MASTER_SITES</varname> must not be blank. It <para><varname>MASTER_SITES</varname> must not be blank. It
@ -2968,7 +2964,7 @@ EXTRACT_ONLY= source.tar.gz</programlisting>
<filename>.bz2</filename> or <filename>.xz</filename>.</para> <filename>.bz2</filename> or <filename>.xz</filename>.</para>
<para>If the patch is distributed with some other files, such as <para>If the patch is distributed with some other files, such as
documentation, in a <command>gzip</command>ped tarball, using documentation, in a compressed tarball, using
<varname>PATCHFILES</varname> is not possible. If that is the <varname>PATCHFILES</varname> is not possible. If that is the
case, add the name and the location of the patch tarball to case, add the name and the location of the patch tarball to
<varname>DISTFILES</varname> and <varname>DISTFILES</varname> and
@ -2997,9 +2993,8 @@ EXTRACT_ONLY= source.tar.gz</programlisting>
<note> <note>
<para>The tarball will have been extracted alongside the <para>The tarball will have been extracted alongside the
regular source by then, so there is no need to explicitly regular source by then, so there is no need to explicitly
extract it if it is a regular <command>gzip</command>ped or extract it if it is a regular compressed tarball. Take extra
<command>compress</command>ed tarball. Take extra care not care not to overwrite something that already exists in that
to overwrite something that already exists in that
directory if extracting it manually. Also, do not forget to directory if extracting it manually. Also, do not forget to
add a command to remove the copied patch in the add a command to remove the copied patch in the
<buildtarget>pre-clean</buildtarget> target.</para> <buildtarget>pre-clean</buildtarget> target.</para>
@ -3676,8 +3671,9 @@ PATCHFILES= patch1:test</programlisting>
that subdirectory.</para> that subdirectory.</para>
<para>It will also look at the subdirectory with the same name <para>It will also look at the subdirectory with the same name
on the backup master site at on the backup master site at <link>
<filename>ftp.FreeBSD.org</filename>. (Setting <xlink:href="http://distcache.FreeBSD.org">http://distcache.FreeBSD.org</link>
(Setting
<varname>DISTDIR</varname> explicitly in <varname>DISTDIR</varname> explicitly in
<filename>Makefile</filename> will not accomplish this, so <filename>Makefile</filename> will not accomplish this, so
please use <varname>DIST_SUBDIR</varname>.)</para> please use <varname>DIST_SUBDIR</varname>.)</para>
@ -4772,7 +4768,7 @@ LICENSE_FILE= ${WRKSRC}/COPYING</programlisting>
Equivalent to setting <link Equivalent to setting <link
linkend="porting-restrictions-no_package"><varname>NO_PACKAGE</varname></link>. linkend="porting-restrictions-no_package"><varname>NO_PACKAGE</varname></link>.
The package will <emphasis>not</emphasis> be distributed The package will <emphasis>not</emphasis> be distributed
otn the &os; package from the &os; package
<acronym>CDN</acronym> <link <acronym>CDN</acronym> <link
xlink:href="http://pkg.freebsd.org/">http://pkg.freebsd.org/</link>.</para> xlink:href="http://pkg.freebsd.org/">http://pkg.freebsd.org/</link>.</para>
</listitem> </listitem>
@ -7445,10 +7441,8 @@ DISTVERSION= 1.0</programlisting>
additional documentation installed in additional documentation installed in
<varname>DOCSDIR</varname>. It does not apply to standard <varname>DOCSDIR</varname>. It does not apply to standard
man pages and info pages. Things installed in man pages and info pages. Things installed in
<varname>DATADIR</varname> and
<varname>EXAMPLESDIR</varname> are controlled by <varname>EXAMPLESDIR</varname> are controlled by
<literal>DATA</literal> and <literal>EXAMPLES</literal> the <literal>EXAMPLES</literal> option.</para>
options, respectively.</para>
</note> </note>
<para>These variables are exported to <para>These variables are exported to