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

Fix a whole boatload of typos and grammar errors.

Browse source 
PR:		16854
Submitted by:	Bob Johnson <bobj@atlantic.net>
This commit is contained in:
Jim Mock 2000-02-22 07:38:14 +00:00
parent 834b1a9d63
commit 833adb2914
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=6579
4 changed files with 128 additions and 88 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

54
en_US.ISO8859-1/books/handbook/ports/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO_8859-1/books/handbook/ports/chapter.sgml,v 1.83 2000/02/17 07:23:57 gsutter Exp $
$FreeBSD: doc/en_US.ISO_8859-1/books/handbook/ports/chapter.sgml,v 1.84 2000/02/18 02:44:58 jim Exp $
-->
<chapter id="ports">
@ -2013,7 +2013,7 @@ lib/libtvl80.so.1
<filename>/usr/lib</filename> only, and will royally screw up the
user's machine ("Help, xinit does not run anymore after I install
this port!"). Anybody who does this will be shot and cut in 65,536
pieces by a rusty knife and have is liver chopped out by a bunch of
pieces by a rusty knife and have his liver chopped out by a bunch of
crows and will eternally rot to death in the deepest bowels of hell
(not necessarily in that order&hellip;)</para>
</sect3>
@ -2026,7 +2026,7 @@ lib/libtvl80.so.1
3.0-RELEASE, we need to convert many ports that build shared
libraries to support ELF. Complicating this task is that a 3.0
system can run as both ELF and a.out, and we wish to unofficially
support the 2.2 as long as possible. Below are the guidelines on
support the 2.2 branch as long as possible. Below are the guidelines on
how to convert a.out only ports to support both a.out and ELF
compilation.</para>
@ -2351,7 +2351,7 @@ ${PREFIX}/man/man4/baz.4.gz
${PREFIX}/man/ja/man4/baz.4.gz</programlisting>
<para>Additionally <filename>${PREFIX}/man/man8/alt-name.8.gz</filename>
may or may-not be installed by your port. Regardless, a
may or may not be installed by your port. Regardless, a
symlink will be made to join the foo(1) manpage and
alt-name(8) manpage.</para>
@ -2430,7 +2430,7 @@ ${PREFIX}/man/ja/man4/baz.4.gz</programlisting>
<para>The new version of texinfo (included in 2.2.2-RELEASE and onwards)
contains a utility called <command>install-info</command> to add and
delete entries to the <filename>dir</filename> file. If your port
installs any info documents, please follow this instructions so your
installs any info documents, please follow these instructions so your
port/package will correctly update the user's
<filename><makevar>PREFIX</makevar>/info/dir</filename> file. (Sorry
for the length of this section, but is it imperative to weave all the
@ -2816,7 +2816,7 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting>
among several ports or have to write to one of the above files (see
<link linkend="porting-wrkdir">writing to places other than
<makevar>WRKDIR</makevar></link> for why it is a bad idea to write
directly in to the <filename>pkg</filename> subdirectory.</para>
directly in to the <filename>pkg</filename> subdirectory).</para>
<para>Here is a list of variable names and their default
values.</para>
@ -2973,9 +2973,9 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting>
</sect2>
<sect2>
<title><anchor id="porting-dads">Do's and Dont's</title>
<title><anchor id="porting-dads">Dos and Don'ts</title>
<para>Here is a list of common do's and dont's that you encounter during
<para>Here is a list of common dos and don'ts that you encounter during
the porting process.You should check your own port against this list,
but you can also check ports in the PR database that others have
submitted. Submit any comments on ports you check as described in
@ -3394,8 +3394,18 @@ post-install:
<entry>330002</entry>
</row>
<row>
<entry>3.4-RELEASE</entry>
<entry>340000</entry>
</row>
<row>
<entry>3.4-STABLE</entry>
<entry>340001</entry>
</row>
<row>
<entry>4.0-CURRENT after 3/4 branch</entry>
<entry>4.0-CURRENT after 3.4 branch</entry>
<entry>400000</entry>
</row>
@ -3579,7 +3589,7 @@ post-install:
<row>
<entry><makevar>PORTOBJFORMAT</makevar></entry>
<entry>The object format of the system
(<literal>aout</literal> or <literal>elf</literal></entry>
(<literal>aout</literal> or <literal>elf</literal>)</entry>
</row>
<row>
@ -3612,7 +3622,7 @@ post-install:
</note>
<para>Here are some examples of things you can write after
<filename>bsd.port.pre.mk</filename>;</para>
<filename>bsd.port.pre.mk</filename>:</para>
<programlisting>
# no need to compile lang/perl5 if perl5 is already in system
@ -3979,7 +3989,7 @@ mysql:*:88:88:MySQL Daemon:/var/db/mysql:/sbin/nologin</programlisting>
<para>Do look at existing examples and the
<filename>bsd.port.mk</filename> file before asking us questions!
<!-- smiley --><emphasis>;)</emphasis></para>
<!-- smiley --><emphasis>;-)</emphasis></para>
<para>Do ask us questions if you have any trouble! Do not just beat
your head against a wall! <!-- smiley
@ -4039,7 +4049,7 @@ PATCH_SITES= ftp://ftp.sra.co.jp/pub/X11/japanese/
PATCHFILES= xdvi-18.patch1.gz xdvi-18.patch2.gz
[maintainer; *mandatory*! This is the person (preferably with commit
privileges) who a user can contact for questions and bug reports - this
privileges) whom a user can contact for questions and bug reports - this
person should be the porter or someone who can forward questions to the
original porter reasonably promptly. If you really do not want to have
your address here, set it to "ports@FreeBSD.org".]
@ -4102,7 +4112,7 @@ pre-install:
<screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find * -type d) &gt; OLD-DIRS</userinput></screen>
<para>If your port honours <makevar>PREFIX</makevar> (which it should)
<para>If your port honors <makevar>PREFIX</makevar> (which it should)
you can then install the port and create the package list.</para>
<screen>&prompt.root; <userinput>make install PREFIX=/var/tmp/<replaceable>port-name</replaceable></userinput>
@ -4156,7 +4166,7 @@ pre-install:
</listitem>
<listitem>
<para>The <filename>name</filename> part should be all lowercases,
<para>The <filename>name</filename> part should be all lowercase,
except for a really large package (with lots of programs in it).
Things like XFree86 (yes there really is a port of it, check it
out) and ImageMagick fall into this category. Otherwise, convert
@ -4343,7 +4353,7 @@ pre-install:
<tbody>
<row>
<entry><filename>afterstep*</filename></entry>
<entry>Ports to support AfterStep window manager</entry>
<entry>Ports to support the AfterStep window manager.</entry>
</row>
<row>
@ -4407,7 +4417,7 @@ pre-install:
<entry><filename>devel</filename></entry>
<entry>Development utilities. Do not put libraries here just
because they are libraries&mdash;unless they truly do not
belong to anywhere else, they should not be in this
belong anywhere else, they should not be in this
category.</entry>
</row>
@ -4464,7 +4474,7 @@ pre-install:
<row>
<entry><filename>irc</filename></entry>
<entry>Internet Chat Relay utilities.</entry>
<entry>Internet Relay Chat utilities.</entry>
</row>
<row>
@ -4512,7 +4522,7 @@ pre-install:
<row>
<entry><filename>misc</filename></entry>
<entry>Miscellaneous utilities&mdash;basically things that
does not belong to anywhere else. This is the only category
do not belong anywhere else. This is the only category
that should not appear with any other non-virtual category.
If you have <literal>misc</literal> with something else in
your <makevar>CATEGORIES</makevar> line, that means you can
@ -4715,7 +4725,7 @@ pre-install:
instance, an HTML editor should be listed as <literal>www
editors</literal>, not the other way around. Also, you do not
need to list <literal>net</literal> when the port belongs to
either of <literal>irc</literal>, <literal>mail</literal>,
any of <literal>irc</literal>, <literal>mail</literal>,
<literal>mbone</literal>, <literal>news</literal>,
<literal>security</literal>, or <literal>www</literal>.</para>
</listitem>
@ -4746,9 +4756,9 @@ pre-install:
<para>If you are not sure about the category, please put a comment to
that effect in your <command>send-pr</command> submission so we can
discuss it before import it. (If you are a committer, send a note
discuss it before we import it. If you are a committer, send a note
&a.ports; so we can discuss it first&mdash;too often new ports are
imported to a wrong category only to be moved right away.)</para>
imported to a wrong category only to be moved right away.</para>
</sect3>
</sect2>

54
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/handbook/ports/chapter.sgml,v 1.83 2000/02/17 07:23:57 gsutter Exp $
$FreeBSD: doc/en_US.ISO_8859-1/books/handbook/ports/chapter.sgml,v 1.84 2000/02/18 02:44:58 jim Exp $
-->
<chapter id="ports">
@ -2013,7 +2013,7 @@ lib/libtvl80.so.1
<filename>/usr/lib</filename> only, and will royally screw up the
user's machine ("Help, xinit does not run anymore after I install
this port!"). Anybody who does this will be shot and cut in 65,536
pieces by a rusty knife and have is liver chopped out by a bunch of
pieces by a rusty knife and have his liver chopped out by a bunch of
crows and will eternally rot to death in the deepest bowels of hell
(not necessarily in that order&hellip;)</para>
</sect3>
@ -2026,7 +2026,7 @@ lib/libtvl80.so.1
3.0-RELEASE, we need to convert many ports that build shared
libraries to support ELF. Complicating this task is that a 3.0
system can run as both ELF and a.out, and we wish to unofficially
support the 2.2 as long as possible. Below are the guidelines on
support the 2.2 branch as long as possible. Below are the guidelines on
how to convert a.out only ports to support both a.out and ELF
compilation.</para>
@ -2351,7 +2351,7 @@ ${PREFIX}/man/man4/baz.4.gz
${PREFIX}/man/ja/man4/baz.4.gz</programlisting>
<para>Additionally <filename>${PREFIX}/man/man8/alt-name.8.gz</filename>
may or may-not be installed by your port. Regardless, a
may or may not be installed by your port. Regardless, a
symlink will be made to join the foo(1) manpage and
alt-name(8) manpage.</para>
@ -2430,7 +2430,7 @@ ${PREFIX}/man/ja/man4/baz.4.gz</programlisting>
<para>The new version of texinfo (included in 2.2.2-RELEASE and onwards)
contains a utility called <command>install-info</command> to add and
delete entries to the <filename>dir</filename> file. If your port
installs any info documents, please follow this instructions so your
installs any info documents, please follow these instructions so your
port/package will correctly update the user's
<filename><makevar>PREFIX</makevar>/info/dir</filename> file. (Sorry
for the length of this section, but is it imperative to weave all the
@ -2816,7 +2816,7 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting>
among several ports or have to write to one of the above files (see
<link linkend="porting-wrkdir">writing to places other than
<makevar>WRKDIR</makevar></link> for why it is a bad idea to write
directly in to the <filename>pkg</filename> subdirectory.</para>
directly in to the <filename>pkg</filename> subdirectory).</para>
<para>Here is a list of variable names and their default
values.</para>
@ -2973,9 +2973,9 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting>
</sect2>
<sect2>
<title><anchor id="porting-dads">Do's and Dont's</title>
<title><anchor id="porting-dads">Dos and Don'ts</title>
<para>Here is a list of common do's and dont's that you encounter during
<para>Here is a list of common dos and don'ts that you encounter during
the porting process.You should check your own port against this list,
but you can also check ports in the PR database that others have
submitted. Submit any comments on ports you check as described in
@ -3394,8 +3394,18 @@ post-install:
<entry>330002</entry>
</row>
<row>
<entry>3.4-RELEASE</entry>
<entry>340000</entry>
</row>
<row>
<entry>3.4-STABLE</entry>
<entry>340001</entry>
</row>
<row>
<entry>4.0-CURRENT after 3/4 branch</entry>
<entry>4.0-CURRENT after 3.4 branch</entry>
<entry>400000</entry>
</row>
@ -3579,7 +3589,7 @@ post-install:
<row>
<entry><makevar>PORTOBJFORMAT</makevar></entry>
<entry>The object format of the system
(<literal>aout</literal> or <literal>elf</literal></entry>
(<literal>aout</literal> or <literal>elf</literal>)</entry>
</row>
<row>
@ -3612,7 +3622,7 @@ post-install:
</note>
<para>Here are some examples of things you can write after
<filename>bsd.port.pre.mk</filename>;</para>
<filename>bsd.port.pre.mk</filename>:</para>
<programlisting>
# no need to compile lang/perl5 if perl5 is already in system
@ -3979,7 +3989,7 @@ mysql:*:88:88:MySQL Daemon:/var/db/mysql:/sbin/nologin</programlisting>
<para>Do look at existing examples and the
<filename>bsd.port.mk</filename> file before asking us questions!
<!-- smiley --><emphasis>;)</emphasis></para>
<!-- smiley --><emphasis>;-)</emphasis></para>
<para>Do ask us questions if you have any trouble! Do not just beat
your head against a wall! <!-- smiley
@ -4039,7 +4049,7 @@ PATCH_SITES= ftp://ftp.sra.co.jp/pub/X11/japanese/
PATCHFILES= xdvi-18.patch1.gz xdvi-18.patch2.gz
[maintainer; *mandatory*! This is the person (preferably with commit
privileges) who a user can contact for questions and bug reports - this
privileges) whom a user can contact for questions and bug reports - this
person should be the porter or someone who can forward questions to the
original porter reasonably promptly. If you really do not want to have
your address here, set it to "ports@FreeBSD.org".]
@ -4102,7 +4112,7 @@ pre-install:
<screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find * -type d) &gt; OLD-DIRS</userinput></screen>
<para>If your port honours <makevar>PREFIX</makevar> (which it should)
<para>If your port honors <makevar>PREFIX</makevar> (which it should)
you can then install the port and create the package list.</para>
<screen>&prompt.root; <userinput>make install PREFIX=/var/tmp/<replaceable>port-name</replaceable></userinput>
@ -4156,7 +4166,7 @@ pre-install:
</listitem>
<listitem>
<para>The <filename>name</filename> part should be all lowercases,
<para>The <filename>name</filename> part should be all lowercase,
except for a really large package (with lots of programs in it).
Things like XFree86 (yes there really is a port of it, check it
out) and ImageMagick fall into this category. Otherwise, convert
@ -4343,7 +4353,7 @@ pre-install:
<tbody>
<row>
<entry><filename>afterstep*</filename></entry>
<entry>Ports to support AfterStep window manager</entry>
<entry>Ports to support the AfterStep window manager.</entry>
</row>
<row>
@ -4407,7 +4417,7 @@ pre-install:
<entry><filename>devel</filename></entry>
<entry>Development utilities. Do not put libraries here just
because they are libraries&mdash;unless they truly do not
belong to anywhere else, they should not be in this
belong anywhere else, they should not be in this
category.</entry>
</row>
@ -4464,7 +4474,7 @@ pre-install:
<row>
<entry><filename>irc</filename></entry>
<entry>Internet Chat Relay utilities.</entry>
<entry>Internet Relay Chat utilities.</entry>
</row>
<row>
@ -4512,7 +4522,7 @@ pre-install:
<row>
<entry><filename>misc</filename></entry>
<entry>Miscellaneous utilities&mdash;basically things that
does not belong to anywhere else. This is the only category
do not belong anywhere else. This is the only category
that should not appear with any other non-virtual category.
If you have <literal>misc</literal> with something else in
your <makevar>CATEGORIES</makevar> line, that means you can
@ -4715,7 +4725,7 @@ pre-install:
instance, an HTML editor should be listed as <literal>www
editors</literal>, not the other way around. Also, you do not
need to list <literal>net</literal> when the port belongs to
either of <literal>irc</literal>, <literal>mail</literal>,
any of <literal>irc</literal>, <literal>mail</literal>,
<literal>mbone</literal>, <literal>news</literal>,
<literal>security</literal>, or <literal>www</literal>.</para>
</listitem>
@ -4746,9 +4756,9 @@ pre-install:
<para>If you are not sure about the category, please put a comment to
that effect in your <command>send-pr</command> submission so we can
discuss it before import it. (If you are a committer, send a note
discuss it before we import it. If you are a committer, send a note
&a.ports; so we can discuss it first&mdash;too often new ports are
imported to a wrong category only to be moved right away.)</para>
imported to a wrong category only to be moved right away.</para>
</sect3>
</sect2>

54
en_US.ISO_8859-1/books/handbook/ports/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO_8859-1/books/handbook/ports/chapter.sgml,v 1.83 2000/02/17 07:23:57 gsutter Exp $
$FreeBSD: doc/en_US.ISO_8859-1/books/handbook/ports/chapter.sgml,v 1.84 2000/02/18 02:44:58 jim Exp $
-->
<chapter id="ports">
@ -2013,7 +2013,7 @@ lib/libtvl80.so.1
<filename>/usr/lib</filename> only, and will royally screw up the
user's machine ("Help, xinit does not run anymore after I install
this port!"). Anybody who does this will be shot and cut in 65,536
pieces by a rusty knife and have is liver chopped out by a bunch of
pieces by a rusty knife and have his liver chopped out by a bunch of
crows and will eternally rot to death in the deepest bowels of hell
(not necessarily in that order&hellip;)</para>
</sect3>
@ -2026,7 +2026,7 @@ lib/libtvl80.so.1
3.0-RELEASE, we need to convert many ports that build shared
libraries to support ELF. Complicating this task is that a 3.0
system can run as both ELF and a.out, and we wish to unofficially
support the 2.2 as long as possible. Below are the guidelines on
support the 2.2 branch as long as possible. Below are the guidelines on
how to convert a.out only ports to support both a.out and ELF
compilation.</para>
@ -2351,7 +2351,7 @@ ${PREFIX}/man/man4/baz.4.gz
${PREFIX}/man/ja/man4/baz.4.gz</programlisting>
<para>Additionally <filename>${PREFIX}/man/man8/alt-name.8.gz</filename>
may or may-not be installed by your port. Regardless, a
may or may not be installed by your port. Regardless, a
symlink will be made to join the foo(1) manpage and
alt-name(8) manpage.</para>
@ -2430,7 +2430,7 @@ ${PREFIX}/man/ja/man4/baz.4.gz</programlisting>
<para>The new version of texinfo (included in 2.2.2-RELEASE and onwards)
contains a utility called <command>install-info</command> to add and
delete entries to the <filename>dir</filename> file. If your port
installs any info documents, please follow this instructions so your
installs any info documents, please follow these instructions so your
port/package will correctly update the user's
<filename><makevar>PREFIX</makevar>/info/dir</filename> file. (Sorry
for the length of this section, but is it imperative to weave all the
@ -2816,7 +2816,7 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting>
among several ports or have to write to one of the above files (see
<link linkend="porting-wrkdir">writing to places other than
<makevar>WRKDIR</makevar></link> for why it is a bad idea to write
directly in to the <filename>pkg</filename> subdirectory.</para>
directly in to the <filename>pkg</filename> subdirectory).</para>
<para>Here is a list of variable names and their default
values.</para>
@ -2973,9 +2973,9 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting>
</sect2>
<sect2>
<title><anchor id="porting-dads">Do's and Dont's</title>
<title><anchor id="porting-dads">Dos and Don'ts</title>
<para>Here is a list of common do's and dont's that you encounter during
<para>Here is a list of common dos and don'ts that you encounter during
the porting process.You should check your own port against this list,
but you can also check ports in the PR database that others have
submitted. Submit any comments on ports you check as described in
@ -3394,8 +3394,18 @@ post-install:
<entry>330002</entry>
</row>
<row>
<entry>3.4-RELEASE</entry>
<entry>340000</entry>
</row>
<row>
<entry>3.4-STABLE</entry>
<entry>340001</entry>
</row>
<row>
<entry>4.0-CURRENT after 3/4 branch</entry>
<entry>4.0-CURRENT after 3.4 branch</entry>
<entry>400000</entry>
</row>
@ -3579,7 +3589,7 @@ post-install:
<row>
<entry><makevar>PORTOBJFORMAT</makevar></entry>
<entry>The object format of the system
(<literal>aout</literal> or <literal>elf</literal></entry>
(<literal>aout</literal> or <literal>elf</literal>)</entry>
</row>
<row>
@ -3612,7 +3622,7 @@ post-install:
</note>
<para>Here are some examples of things you can write after
<filename>bsd.port.pre.mk</filename>;</para>
<filename>bsd.port.pre.mk</filename>:</para>
<programlisting>
# no need to compile lang/perl5 if perl5 is already in system
@ -3979,7 +3989,7 @@ mysql:*:88:88:MySQL Daemon:/var/db/mysql:/sbin/nologin</programlisting>
<para>Do look at existing examples and the
<filename>bsd.port.mk</filename> file before asking us questions!
<!-- smiley --><emphasis>;)</emphasis></para>
<!-- smiley --><emphasis>;-)</emphasis></para>
<para>Do ask us questions if you have any trouble! Do not just beat
your head against a wall! <!-- smiley
@ -4039,7 +4049,7 @@ PATCH_SITES= ftp://ftp.sra.co.jp/pub/X11/japanese/
PATCHFILES= xdvi-18.patch1.gz xdvi-18.patch2.gz
[maintainer; *mandatory*! This is the person (preferably with commit
privileges) who a user can contact for questions and bug reports - this
privileges) whom a user can contact for questions and bug reports - this
person should be the porter or someone who can forward questions to the
original porter reasonably promptly. If you really do not want to have
your address here, set it to "ports@FreeBSD.org".]
@ -4102,7 +4112,7 @@ pre-install:
<screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find * -type d) &gt; OLD-DIRS</userinput></screen>
<para>If your port honours <makevar>PREFIX</makevar> (which it should)
<para>If your port honors <makevar>PREFIX</makevar> (which it should)
you can then install the port and create the package list.</para>
<screen>&prompt.root; <userinput>make install PREFIX=/var/tmp/<replaceable>port-name</replaceable></userinput>
@ -4156,7 +4166,7 @@ pre-install:
</listitem>
<listitem>
<para>The <filename>name</filename> part should be all lowercases,
<para>The <filename>name</filename> part should be all lowercase,
except for a really large package (with lots of programs in it).
Things like XFree86 (yes there really is a port of it, check it
out) and ImageMagick fall into this category. Otherwise, convert
@ -4343,7 +4353,7 @@ pre-install:
<tbody>
<row>
<entry><filename>afterstep*</filename></entry>
<entry>Ports to support AfterStep window manager</entry>
<entry>Ports to support the AfterStep window manager.</entry>
</row>
<row>
@ -4407,7 +4417,7 @@ pre-install:
<entry><filename>devel</filename></entry>
<entry>Development utilities. Do not put libraries here just
because they are libraries&mdash;unless they truly do not
belong to anywhere else, they should not be in this
belong anywhere else, they should not be in this
category.</entry>
</row>
@ -4464,7 +4474,7 @@ pre-install:
<row>
<entry><filename>irc</filename></entry>
<entry>Internet Chat Relay utilities.</entry>
<entry>Internet Relay Chat utilities.</entry>
</row>
<row>
@ -4512,7 +4522,7 @@ pre-install:
<row>
<entry><filename>misc</filename></entry>
<entry>Miscellaneous utilities&mdash;basically things that
does not belong to anywhere else. This is the only category
do not belong anywhere else. This is the only category
that should not appear with any other non-virtual category.
If you have <literal>misc</literal> with something else in
your <makevar>CATEGORIES</makevar> line, that means you can
@ -4715,7 +4725,7 @@ pre-install:
instance, an HTML editor should be listed as <literal>www
editors</literal>, not the other way around. Also, you do not
need to list <literal>net</literal> when the port belongs to
either of <literal>irc</literal>, <literal>mail</literal>,
any of <literal>irc</literal>, <literal>mail</literal>,
<literal>mbone</literal>, <literal>news</literal>,
<literal>security</literal>, or <literal>www</literal>.</para>
</listitem>
@ -4746,9 +4756,9 @@ pre-install:
<para>If you are not sure about the category, please put a comment to
that effect in your <command>send-pr</command> submission so we can
discuss it before import it. (If you are a committer, send a note
discuss it before we import it. If you are a committer, send a note
&a.ports; so we can discuss it first&mdash;too often new ports are
imported to a wrong category only to be moved right away.)</para>
imported to a wrong category only to be moved right away.</para>
</sect3>
</sect2>

54
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/handbook/ports/chapter.sgml,v 1.83 2000/02/17 07:23:57 gsutter Exp $
$FreeBSD: doc/en_US.ISO_8859-1/books/handbook/ports/chapter.sgml,v 1.84 2000/02/18 02:44:58 jim Exp $
-->
<chapter id="ports">
@ -2013,7 +2013,7 @@ lib/libtvl80.so.1
<filename>/usr/lib</filename> only, and will royally screw up the
user's machine ("Help, xinit does not run anymore after I install
this port!"). Anybody who does this will be shot and cut in 65,536
pieces by a rusty knife and have is liver chopped out by a bunch of
pieces by a rusty knife and have his liver chopped out by a bunch of
crows and will eternally rot to death in the deepest bowels of hell
(not necessarily in that order&hellip;)</para>
</sect3>
@ -2026,7 +2026,7 @@ lib/libtvl80.so.1
3.0-RELEASE, we need to convert many ports that build shared
libraries to support ELF. Complicating this task is that a 3.0
system can run as both ELF and a.out, and we wish to unofficially
support the 2.2 as long as possible. Below are the guidelines on
support the 2.2 branch as long as possible. Below are the guidelines on
how to convert a.out only ports to support both a.out and ELF
compilation.</para>
@ -2351,7 +2351,7 @@ ${PREFIX}/man/man4/baz.4.gz
${PREFIX}/man/ja/man4/baz.4.gz</programlisting>
<para>Additionally <filename>${PREFIX}/man/man8/alt-name.8.gz</filename>
may or may-not be installed by your port. Regardless, a
may or may not be installed by your port. Regardless, a
symlink will be made to join the foo(1) manpage and
alt-name(8) manpage.</para>
@ -2430,7 +2430,7 @@ ${PREFIX}/man/ja/man4/baz.4.gz</programlisting>
<para>The new version of texinfo (included in 2.2.2-RELEASE and onwards)
contains a utility called <command>install-info</command> to add and
delete entries to the <filename>dir</filename> file. If your port
installs any info documents, please follow this instructions so your
installs any info documents, please follow these instructions so your
port/package will correctly update the user's
<filename><makevar>PREFIX</makevar>/info/dir</filename> file. (Sorry
for the length of this section, but is it imperative to weave all the
@ -2816,7 +2816,7 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting>
among several ports or have to write to one of the above files (see
<link linkend="porting-wrkdir">writing to places other than
<makevar>WRKDIR</makevar></link> for why it is a bad idea to write
directly in to the <filename>pkg</filename> subdirectory.</para>
directly in to the <filename>pkg</filename> subdirectory).</para>
<para>Here is a list of variable names and their default
values.</para>
@ -2973,9 +2973,9 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting>
</sect2>
<sect2>
<title><anchor id="porting-dads">Do's and Dont's</title>
<title><anchor id="porting-dads">Dos and Don'ts</title>
<para>Here is a list of common do's and dont's that you encounter during
<para>Here is a list of common dos and don'ts that you encounter during
the porting process.You should check your own port against this list,
but you can also check ports in the PR database that others have
submitted. Submit any comments on ports you check as described in
@ -3394,8 +3394,18 @@ post-install:
<entry>330002</entry>
</row>
<row>
<entry>3.4-RELEASE</entry>
<entry>340000</entry>
</row>
<row>
<entry>3.4-STABLE</entry>
<entry>340001</entry>
</row>
<row>
<entry>4.0-CURRENT after 3/4 branch</entry>
<entry>4.0-CURRENT after 3.4 branch</entry>
<entry>400000</entry>
</row>
@ -3579,7 +3589,7 @@ post-install:
<row>
<entry><makevar>PORTOBJFORMAT</makevar></entry>
<entry>The object format of the system
(<literal>aout</literal> or <literal>elf</literal></entry>
(<literal>aout</literal> or <literal>elf</literal>)</entry>
</row>
<row>
@ -3612,7 +3622,7 @@ post-install:
</note>
<para>Here are some examples of things you can write after
<filename>bsd.port.pre.mk</filename>;</para>
<filename>bsd.port.pre.mk</filename>:</para>
<programlisting>
# no need to compile lang/perl5 if perl5 is already in system
@ -3979,7 +3989,7 @@ mysql:*:88:88:MySQL Daemon:/var/db/mysql:/sbin/nologin</programlisting>
<para>Do look at existing examples and the
<filename>bsd.port.mk</filename> file before asking us questions!
<!-- smiley --><emphasis>;)</emphasis></para>
<!-- smiley --><emphasis>;-)</emphasis></para>
<para>Do ask us questions if you have any trouble! Do not just beat
your head against a wall! <!-- smiley
@ -4039,7 +4049,7 @@ PATCH_SITES= ftp://ftp.sra.co.jp/pub/X11/japanese/
PATCHFILES= xdvi-18.patch1.gz xdvi-18.patch2.gz
[maintainer; *mandatory*! This is the person (preferably with commit
privileges) who a user can contact for questions and bug reports - this
privileges) whom a user can contact for questions and bug reports - this
person should be the porter or someone who can forward questions to the
original porter reasonably promptly. If you really do not want to have
your address here, set it to "ports@FreeBSD.org".]
@ -4102,7 +4112,7 @@ pre-install:
<screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find * -type d) &gt; OLD-DIRS</userinput></screen>
<para>If your port honours <makevar>PREFIX</makevar> (which it should)
<para>If your port honors <makevar>PREFIX</makevar> (which it should)
you can then install the port and create the package list.</para>
<screen>&prompt.root; <userinput>make install PREFIX=/var/tmp/<replaceable>port-name</replaceable></userinput>
@ -4156,7 +4166,7 @@ pre-install:
</listitem>
<listitem>
<para>The <filename>name</filename> part should be all lowercases,
<para>The <filename>name</filename> part should be all lowercase,
except for a really large package (with lots of programs in it).
Things like XFree86 (yes there really is a port of it, check it
out) and ImageMagick fall into this category. Otherwise, convert
@ -4343,7 +4353,7 @@ pre-install:
<tbody>
<row>
<entry><filename>afterstep*</filename></entry>
<entry>Ports to support AfterStep window manager</entry>
<entry>Ports to support the AfterStep window manager.</entry>
</row>
<row>
@ -4407,7 +4417,7 @@ pre-install:
<entry><filename>devel</filename></entry>
<entry>Development utilities. Do not put libraries here just
because they are libraries&mdash;unless they truly do not
belong to anywhere else, they should not be in this
belong anywhere else, they should not be in this
category.</entry>
</row>
@ -4464,7 +4474,7 @@ pre-install:
<row>
<entry><filename>irc</filename></entry>
<entry>Internet Chat Relay utilities.</entry>
<entry>Internet Relay Chat utilities.</entry>
</row>
<row>
@ -4512,7 +4522,7 @@ pre-install:
<row>
<entry><filename>misc</filename></entry>
<entry>Miscellaneous utilities&mdash;basically things that
does not belong to anywhere else. This is the only category
do not belong anywhere else. This is the only category
that should not appear with any other non-virtual category.
If you have <literal>misc</literal> with something else in
your <makevar>CATEGORIES</makevar> line, that means you can
@ -4715,7 +4725,7 @@ pre-install:
instance, an HTML editor should be listed as <literal>www
editors</literal>, not the other way around. Also, you do not
need to list <literal>net</literal> when the port belongs to
either of <literal>irc</literal>, <literal>mail</literal>,
any of <literal>irc</literal>, <literal>mail</literal>,
<literal>mbone</literal>, <literal>news</literal>,
<literal>security</literal>, or <literal>www</literal>.</para>
</listitem>
@ -4746,9 +4756,9 @@ pre-install:
<para>If you are not sure about the category, please put a comment to
that effect in your <command>send-pr</command> submission so we can
discuss it before import it. (If you are a committer, send a note
discuss it before we import it. If you are a committer, send a note
&a.ports; so we can discuss it first&mdash;too often new ports are
imported to a wrong category only to be moved right away.)</para>
imported to a wrong category only to be moved right away.</para>
</sect3>
</sect2>