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
Security Information</ulink> page.</para>
<para>As may be obvious
from its title the VuXML database is an
<para>The VuXML database is an
XML document. Its source file <filename>vuln.xml</filename>
is kept right inside the port <filename
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>
version while
<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>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>
<para>Obviously, the former version should match while the
<para>The former version should match while the
latter one should not.</para>
<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
<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
that the port should not set the values of these variables
absolutely, overriding existing values; instead, it should
that the port must not set the values of these variables
absolutely, overriding existing values; instead, it may
append whatever values it needs to the existing values. This
is so that build options that affect all ports can be set
globally.</para>
@ -15363,10 +15362,10 @@ exec %%LOCALBASE%%/bin/java -jar %%DATADIR%%/foo.jar "$@"</programlisting>
<sect1 id="dads-cflags">
<title>Respect <makevar>CFLAGS</makevar></title>
<para>The port should respect the <makevar>CFLAGS</makevar>
variable. What we mean by this is that the port should not
<para>The port must respect the <makevar>CFLAGS</makevar>
variable. What we mean by this is that the port must not
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
that affect all ports can be set globally.</para>