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

Remove references to first-person pronouns ("I", "me", etc.): all they

Browse source 
do is serve to confuse the reader (who is this "I"?).
This commit is contained in:
Dima Dorfman 2001-04-17 01:39:30 +00:00
parent a0415e82f0
commit 692183c8a5
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=9210
4 changed files with 40 additions and 34 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO_8859-1/books/porters-handbook/book.sgml,v 1.141 2001/03/24 21:45:57 asami Exp $
$FreeBSD: doc/en_US.ISO_8859-1/books/porters-handbook/book.sgml,v 1.142 2001/04/09 00:33:58 dd Exp $
-->
<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN" [
@ -1258,7 +1258,7 @@ MASTER_SITE_SUBDIR= applications</programlisting>
way the behaviour you want can be accomplished. It will cause the
other port to always be built (and installed, by default), and the
dependency will go into the packages as well. If this is really
what you need, I recommend you write it as
what you need, you should probably write it as
<literal>BUILD_DEPENDS</literal> and
<literal>RUN_DEPENDS</literal> instead&mdash;at least the
intention will be clear.</para>
@ -1796,8 +1796,9 @@ Options:
</note>
<para>Here's a seven-step procedure to convert ports to use
<command>install-info</command>. I will use
<filename>editors/emacs</filename> as an example.</para>
<command>install-info</command>.
<filename>editors/emacs</filename> will be used as an
example.</para>
<procedure>
<step>
@ -1838,7 +1839,7 @@ Options:
<para>You can give the <literal>dir</literal> entries to
<command>install-info</command> as arguments
(<option>--section</option> and <option>--entry</option>) instead
of patching the texinfo sources. I do not think this is a good
of patching the texinfo sources. This probably is not a good
idea for ports because you need to duplicate the same information
in <emphasis>three</emphasis> places
(<filename>Makefile</filename> and
@ -1859,8 +1860,8 @@ Options:
the info files, they should be rebuilt when you type
<command>make</command>; but many <filename>Makefile</filename>s
do not include correct dependencies for info files. In
<command>emacs</command>' case, I had to patch the main
<filename>Makefile.in</filename> so it will descend into the
<command>emacs</command>' case, it was necessary to patch the main
<filename>Makefile.in</filename> so it would descend into the
<filename>man</filename> subdirectory to rebuild the info
pages.</para>
@ -1891,10 +1892,11 @@ Options:
the <filename>man</filename> subdir is called
<maketarget>info</maketarget>, while the main
<filename>Makefile</filename> wants to call
<maketarget>all</maketarget>. I also deleted the installation of
the <filename>info</filename> info file because we already have
one with the same name in <filename>/usr/share/info</filename>
(that patch is not shown here).</para>
<maketarget>all</maketarget>. The installation of the
<filename>info</filename> info file was also removed because we
already have one with the same name in
<filename>/usr/share/info</filename> (that patch is not shown
here).</para>
</step>
<step>
@ -3662,8 +3664,8 @@ pre-install:
<screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name && find * -type d) | comm -13 OLD-DIRS - | sed -e 's#^#@dirrm #' &gt;&gt; pkg-plist</replaceable></userinput></screen>
<para>Finally, you need to tidy up the packing list by hand. I lied
when I said this was all automated. Manual pages should be listed in
<para>Finally, you need to tidy up the packing list by hand; it isn't
<emphasis>all</emphasis> automated. Manual pages should be listed in
the port's <filename>Makefile</filename> under
<makevar>MAN<replaceable>n</replaceable></makevar>, and not in the
package list. User configuration files should be removed, or

9
en_US.ISO8859-1/books/ppp-primer/book.sgml
View file

@ -18,7 +18,7 @@
</author>
</authorgroup>
<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/ppp-primer/book.sgml,v 1.7 2001/04/05 01:44:24 dd Exp $</pubdate>
<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/ppp-primer/book.sgml,v 1.8 2001/04/09 00:33:58 dd Exp $</pubdate>
<abstract><para>This is a step-by-step guide for configuring FreeBSD systems to act as
a dial-up router/gateway in a Local Area Environment. All entries may
@ -740,9 +740,10 @@ and <filename>/usr/share/examples/ppp</filename> directories. Please take
some time to review these files; they were derived from working
systems and represent the features and capabilities of the PPP
program.</para>
<para>I <emphasis>strongly</emphasis> encourage you to learn from these sample files and
apply them to your own configuration as necessary.</para>
<para>You are <emphasis>strongly</emphasis> encouraged to learn from
these sample files and apply them to your own configuration as
necessary.</para>
<para>For detailed information about the `ppp` program, read the ppp
manpage:

28
en_US.ISO_8859-1/books/porters-handbook/book.sgml
View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO_8859-1/books/porters-handbook/book.sgml,v 1.141 2001/03/24 21:45:57 asami Exp $
$FreeBSD: doc/en_US.ISO_8859-1/books/porters-handbook/book.sgml,v 1.142 2001/04/09 00:33:58 dd Exp $
-->
<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN" [
@ -1258,7 +1258,7 @@ MASTER_SITE_SUBDIR= applications</programlisting>
way the behaviour you want can be accomplished. It will cause the
other port to always be built (and installed, by default), and the
dependency will go into the packages as well. If this is really
what you need, I recommend you write it as
what you need, you should probably write it as
<literal>BUILD_DEPENDS</literal> and
<literal>RUN_DEPENDS</literal> instead&mdash;at least the
intention will be clear.</para>
@ -1796,8 +1796,9 @@ Options:
</note>
<para>Here's a seven-step procedure to convert ports to use
<command>install-info</command>. I will use
<filename>editors/emacs</filename> as an example.</para>
<command>install-info</command>.
<filename>editors/emacs</filename> will be used as an
example.</para>
<procedure>
<step>
@ -1838,7 +1839,7 @@ Options:
<para>You can give the <literal>dir</literal> entries to
<command>install-info</command> as arguments
(<option>--section</option> and <option>--entry</option>) instead
of patching the texinfo sources. I do not think this is a good
of patching the texinfo sources. This probably is not a good
idea for ports because you need to duplicate the same information
in <emphasis>three</emphasis> places
(<filename>Makefile</filename> and
@ -1859,8 +1860,8 @@ Options:
the info files, they should be rebuilt when you type
<command>make</command>; but many <filename>Makefile</filename>s
do not include correct dependencies for info files. In
<command>emacs</command>' case, I had to patch the main
<filename>Makefile.in</filename> so it will descend into the
<command>emacs</command>' case, it was necessary to patch the main
<filename>Makefile.in</filename> so it would descend into the
<filename>man</filename> subdirectory to rebuild the info
pages.</para>
@ -1891,10 +1892,11 @@ Options:
the <filename>man</filename> subdir is called
<maketarget>info</maketarget>, while the main
<filename>Makefile</filename> wants to call
<maketarget>all</maketarget>. I also deleted the installation of
the <filename>info</filename> info file because we already have
one with the same name in <filename>/usr/share/info</filename>
(that patch is not shown here).</para>
<maketarget>all</maketarget>. The installation of the
<filename>info</filename> info file was also removed because we
already have one with the same name in
<filename>/usr/share/info</filename> (that patch is not shown
here).</para>
</step>
<step>
@ -3662,8 +3664,8 @@ pre-install:
<screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name && find * -type d) | comm -13 OLD-DIRS - | sed -e 's#^#@dirrm #' &gt;&gt; pkg-plist</replaceable></userinput></screen>
<para>Finally, you need to tidy up the packing list by hand. I lied
when I said this was all automated. Manual pages should be listed in
<para>Finally, you need to tidy up the packing list by hand; it isn't
<emphasis>all</emphasis> automated. Manual pages should be listed in
the port's <filename>Makefile</filename> under
<makevar>MAN<replaceable>n</replaceable></makevar>, and not in the
package list. User configuration files should be removed, or

9
en_US.ISO_8859-1/books/ppp-primer/book.sgml
View file

@ -18,7 +18,7 @@
</author>
</authorgroup>
<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/ppp-primer/book.sgml,v 1.7 2001/04/05 01:44:24 dd Exp $</pubdate>
<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/ppp-primer/book.sgml,v 1.8 2001/04/09 00:33:58 dd Exp $</pubdate>
<abstract><para>This is a step-by-step guide for configuring FreeBSD systems to act as
a dial-up router/gateway in a Local Area Environment. All entries may
@ -740,9 +740,10 @@ and <filename>/usr/share/examples/ppp</filename> directories. Please take
some time to review these files; they were derived from working
systems and represent the features and capabilities of the PPP
program.</para>
<para>I <emphasis>strongly</emphasis> encourage you to learn from these sample files and
apply them to your own configuration as necessary.</para>
<para>You are <emphasis>strongly</emphasis> encouraged to learn from
these sample files and apply them to your own configuration as
necessary.</para>
<para>For detailed information about the `ppp` program, read the ppp
manpage: