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

Whitespace, indentation, translators can ignore.

Browse source 
Noticed by:	igor
Sponsored by:	Absolight
This commit is contained in:
Mathieu Arnold 2015-10-28 13:40:40 +00:00
parent 0a4ab32374
commit 2b932a83b6
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=47693
1 changed files with 74 additions and 71 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

49
en_US.ISO8859-1/books/porters-handbook/upgrading/chapter.xml
View file

@ -24,13 +24,13 @@
dependencies.</para>
<para>The next step is to see if there is an update already pending.
To do this, there are two options. There is a searchable interface
to the <link
xlink:href="https://bugs.freebsd.org/search/">FreeBSD
Problem Report (PR) or bug database</link>.
Select <literal>Ports Tree</literal> in
the <literal>Product</literal> dropdown, and enter the name of the port in the
<literal>Summary</literal> field.</para>
To do this, there are two options. There is a searchable
interface to the <link
xlink:href="https://bugs.freebsd.org/search/">FreeBSD Problem
Report (PR) or bug database</link>. Select <literal>Ports
Tree</literal> in the <literal>Product</literal> dropdown, and
enter the name of the port in the <literal>Summary</literal>
field.</para>
<para>However, sometimes people forget to put the name of the port
into the Summary field in an unambiguous fashion. In that
@ -62,9 +62,10 @@
<para>To create a suitable <command>diff</command> for a single
patch, copy the file that needs patching to
<filename><replaceable>something</replaceable>.orig</filename>, save the changes to
<filename><replaceable>something</replaceable></filename> and then create the
patch:</para>
<filename><replaceable>something</replaceable>.orig</filename>,
save the changes to
<filename><replaceable>something</replaceable></filename> and then
create the patch:</para>
<informalexample>
<screen>&prompt.user; <userinput>diff -u <replaceable>something</replaceable>.orig <replaceable>something</replaceable> &gt; something.diff</userinput></screen>
@ -187,8 +188,8 @@
<callout arearefs="svn-FreeBSD-org">
<para><link
xlink:href="https://svn.FreeBSD.org/">svn.FreeBSD.org</link>
is the &os; public <application>Subversion</application> server.
See <link
is the &os; public <application>Subversion</application>
server. See <link
xlink:href="&url.books.handbook;/svn.html#svn-mirrors">Subversion
mirror sites</link> for more information.</para>
</callout>
@ -312,7 +313,8 @@
<para>When including exact
<application>portmaster</application>,
<application>portupgrade</application>, and/or
<application>pkg</application> instructions, please make sure
<application>pkg</application> instructions, please make
sure
to get the shell escaping right. For example, do
<emphasis>not</emphasis> use:</para>
@ -329,12 +331,12 @@
<note>
<para>It is recommended that the AFFECTS line contains a glob
matching all the ports affected by the entry so that automated
tools can parse it as easily as possible. If an update
concerns all the existing <application>BIND 9</application>
versions the <literal>AFFECTS</literal> content must be
<literal>users of dns/bind9*</literal>, it must
<emphasis>not</emphasis> be <literal>users of BIND
matching all the ports affected by the entry so that
automated tools can parse it as easily as possible. If an
update concerns all the existing <application>BIND
9</application> versions the <literal>AFFECTS</literal>
content must be <literal>users of dns/bind9*</literal>, it
must <emphasis>not</emphasis> be <literal>users of BIND
9</literal></para>
</note>
@ -362,8 +364,8 @@
delete the line in this file that states that it was
removed.</para>
<para>If a port was renamed and then renamed back to its original
name, add a new one with the intermediate name to the
<para>If a port was renamed and then renamed back to its
original name, add a new one with the intermediate name to the
old name, and remove the old entry as to not create a
loop.</para>
@ -371,11 +373,12 @@
<para>Any changes must be validated with
<command>Tools/scripts/MOVEDlint.awk</command>.</para>
<para>If using a ports directory other than <filename>/usr/ports</filename>, use:</para>
<para>If using a ports directory other than
<filename>/usr/ports</filename>, use:</para>
<informalexample>
<screen>&prompt.user; <userinput>cd <replaceable>/home/user/ports</replaceable></userinput>
&prompt.user; <userinput>env PORTSDIR=$PWD Tools/scripts/MOVEDlint.awk</userinput></screen>
&prompt.user; <userinput>env PORTSDIR=$PWD Tools/scripts/MOVEDlint.awk</userinput></screen>
</informalexample>
</note>
</sect2>