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

Small wording changes to avoid 'should' and 'obvious'.

Browse source 
The 'obvious' ones are not so, should is replaced with must or may

Approved by:	gjb
This commit is contained in:
Eitan Adler 2012-02-05 19:20:28 +00:00
parent 18ccb541f1
commit 5873a01610
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=38392
1 changed files with 9 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
en_US.ISO8859-1/books/porters-handbook/book.sgml
View file

@ -10330,8 +10330,7 @@ as .putsy.conf and edit it.</programlisting>
url="http://www.freebsd.org/security/#how">FreeBSD url="http://www.freebsd.org/security/#how">FreeBSD
Security Information</ulink> page.</para> Security Information</ulink> page.</para>
<para>As may be obvious <para>The VuXML database is an
from its title the VuXML database is an
XML document. Its source file <filename>vuln.xml</filename> XML document. Its source file <filename>vuln.xml</filename>
is kept right inside the port <filename is kept right inside the port <filename
role="package">security/vuxml</filename>. Therefore role="package">security/vuxml</filename>. Therefore
@ -10496,7 +10495,7 @@ as .putsy.conf and edit it.</programlisting>
will selectively match every <literal>2.x</literal> will selectively match every <literal>2.x</literal>
version while version while
<literal>&lt;ge&gt;2.0&lt;/ge&gt;&lt;lt&gt;3.0&lt;/lt&gt;</literal> <literal>&lt;ge&gt;2.0&lt;/ge&gt;&lt;lt&gt;3.0&lt;/lt&gt;</literal>
will obviously not since the latter misses will not since the latter misses
<literal>2.r3</literal> and matches <literal>2.r3</literal> and matches
<literal>3.b</literal>.</para> <literal>3.b</literal>.</para>
@ -10709,7 +10708,7 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
1 problem(s) found.</screen> 1 problem(s) found.</screen>
<para>Obviously, the former version should match while the <para>The former version should match while the
latter one should not.</para> latter one should not.</para>
<para>Finally, verify whether the web page generated from the <para>Finally, verify whether the web page generated from the
@ -15323,10 +15322,10 @@ exec %%LOCALBASE%%/bin/java -jar %%DATADIR%%/foo.jar "$@"</programlisting>
<title>Respect Both <makevar>CC</makevar> and <title>Respect Both <makevar>CC</makevar> and
<makevar>CXX</makevar></title> <makevar>CXX</makevar></title>
<para>The port should respect both <makevar>CC</makevar> and <para>The port must respect both <makevar>CC</makevar> and
<makevar>CXX</makevar> variables. What we mean by this is <makevar>CXX</makevar> variables. What we mean by this is
that the port should not set the values of these variables that the port must not set the values of these variables
absolutely, overriding existing values; instead, it should absolutely, overriding existing values; instead, it may
append whatever values it needs to the existing values. This append whatever values it needs to the existing values. This
is so that build options that affect all ports can be set is so that build options that affect all ports can be set
globally.</para> globally.</para>
@ -15363,10 +15362,10 @@ exec %%LOCALBASE%%/bin/java -jar %%DATADIR%%/foo.jar "$@"</programlisting>
<sect1 id="dads-cflags"> <sect1 id="dads-cflags">
<title>Respect <makevar>CFLAGS</makevar></title> <title>Respect <makevar>CFLAGS</makevar></title>
<para>The port should respect the <makevar>CFLAGS</makevar> <para>The port must respect the <makevar>CFLAGS</makevar>
variable. What we mean by this is that the port should not variable. What we mean by this is that the port must not
set the value of this variable absolutely, overriding the set the value of this variable absolutely, overriding the
existing value; instead, it should append whatever values it existing value; instead, it may append whatever values it
needs to the existing value. This is so that build options needs to the existing value. This is so that build options
that affect all ports can be set globally.</para> that affect all ports can be set globally.</para>