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

Modified <indexterm>'s to be more specific with <filename>, <command>,

Browse source 
<application> and <username>.

Submitted by:	Valentino Vaschetto <valentino.vaschetto@windriver.com>
Reviewed by:	murray
This commit is contained in:
Chern Lee 2001-07-20 23:25:05 +00:00
parent 7a328b6a9a
commit eaa53a21e1
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=9987
11 changed files with 124 additions and 39 deletions
en_US.ISO8859-1/books/handbook
l10n
chapter.sgml
mail
chapter.sgml
multimedia
chapter.sgml
pgpkeys
chapter.sgml
ports
chapter.sgml
ppp-and-slip
chapter.sgml
printing
chapter.sgml
security
chapter.sgml
sound
chapter.sgml
users
chapter.sgml
x11
chapter.sgml

34
en_US.ISO8859-1/books/handbook/l10n/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/l10n/chapter.sgml,v 1.58 2001/07/19 12:03:00 dd Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/l10n/chapter.sgml,v 1.59 2001/07/19 23:18:07 chern Exp $
-->
<chapter id="l10n">
@ -292,7 +292,9 @@ taiwan:Taiwanese User:\
<para>Changing Login Classes with &man.vipw.8;</para>
<indexterm><primary>vipw</primary></indexterm>
<indexterm>
<primary><command>vipw</command></primary>
</indexterm>
<para>Use <command>vipw</command> to add new users, and make
the entry look like this:</para>
@ -300,7 +302,9 @@ taiwan:Taiwanese User:\
<para>Changing Login Classes with &man.adduser.8;</para>
<indexterm><primary>adduser</primary></indexterm>
<indexterm>
<primary><command>adduser</command></primary>
</indexterm>
<indexterm><primary>login class</primary></indexterm>
<para>Use <command>adduser</command> to add new users, and do
the following:</para>
@ -331,7 +335,9 @@ taiwan:Taiwanese User:\
</itemizedlist>
<para>Changing Login Classes with &man.pw.8;</para>
<indexterm><primary>pw</primary></indexterm>
<indexterm>
<primary><command>pw</command></primary>
</indexterm>
<para>If you use &man.pw.8; for adding new users, call it in
this form:</para>
@ -404,7 +410,9 @@ font8x8=<replaceable>font_name</replaceable></programlisting>
the <filename>/usr/share/syscons/fonts</filename> directory,
without the <filename>.fnt</filename> suffix.</para>
<indexterm><primary>sysinstall</primary></indexterm>
<indexterm>
<primary><application>sysinstall</application></primary>
</indexterm>
<indexterm><primary>keymap</primary></indexterm>
<indexterm><primary>screenmap</primary></indexterm>
<para>Also be sure to set the correct keymap and screenmap for your
@ -435,7 +443,9 @@ keychange="<replaceable>fkey_number sequence</replaceable>"</programlisting>
<para>then examine the mouse cursor information in the next
paragraph.</para>
<indexterm><primary>moused</primary></indexterm>
<indexterm>
<primary><application>moused</application></primary>
</indexterm>
<para>By default the mouse cursor of the syscons driver occupies the
0xd0-0xd3 range in the character set. If your language uses this
range, you need to move the cursor's range outside of it. To enable
@ -617,7 +627,9 @@ keychange="<replaceable>fkey_number sequence</replaceable>"</programlisting>
other programs have built in support for I18N and need no special
consideration.</para>
<indexterm><primary>MySQL</primary></indexterm>
<indexterm>
<primary><application>MySQL</application></primary>
</indexterm>
<para>However, some applications such as
<application>MySQL</application> need to be have the
<filename>Makefile</filename> configured with the specific
@ -674,8 +686,12 @@ keychange="<replaceable>fkey_number sequence</replaceable>"</programlisting>
<sect3>
<title>Perl and Python</title>
<indexterm><primary>Perl</primary></indexterm>
<indexterm><primary>Python</primary></indexterm>
<indexterm>
<primary>Perl</primary>
</indexterm>
<indexterm>
<primary>Python</primary>
</indexterm>
<para>Perl and Python have I18N and wide characters handling
libraries. Please use them for I18N compliance.</para>

12
en_US.ISO8859-1/books/handbook/mail/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/mail/chapter.sgml,v 1.22 2001/06/26 15:40:27 phantom Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/mail/chapter.sgml,v 1.23 2001/06/28 14:40:27 murray Exp $
-->
<chapter id="mail">
@ -65,19 +65,19 @@
<title>Mailhost Server Daemon</title>
<indexterm>
<primary>mail server daemon</primary>
<secondary>sendmail</secondary>
<secondary><application>sendmail</application></secondary>
</indexterm>
<indexterm>
<primary>mail server daemon</primary>
<secondary>postfix</secondary>
<secondary><application>postfix</application></secondary>
</indexterm>
<indexterm>
<primary>mail server daemon</primary>
<secondary>qmail</secondary>
<secondary><application>qmail</application></secondary>
</indexterm>
<indexterm>
<primary>mail server daemon</primary>
<secondary>exim</secondary>
<secondary><application>exim</application></secondary>
</indexterm>
<para>This is usually <application>sendmail</application> (by
@ -121,7 +121,7 @@
<title>Receiving Mail</title>
<indexterm>
<primary>email</primary>
<Secondary>receiving</secondary>
<secondary>receiving</secondary>
</indexterm>
<para>Receiving mail for your domain is done by the mail host. It

7
en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/sound/chapter.sgml,v 1.7 2001/07/06 13:03:06 dd Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/sound/chapter.sgml,v 1.8 2001/07/19 23:18:09 chern Exp $
-->
<chapter id="sound">
@ -80,7 +80,10 @@
</listitem>
</itemizedlist>
<indexterm><primary>kernel</primary><secondary>configuration</secondary></indexterm>
<indexterm>
<primary>kernel</primary>
<secondary>configuration</secondary>
</indexterm>
<para>The driver you use in your kernel depends on the kind of card
you have. The sections below provide more information and what
you will need to add to your <link linkend="kernelconfig">kernel

3
en_US.ISO8859-1/books/handbook/pgpkeys/chapter.sgml
View file

@ -1,12 +1,13 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/pgpkeys/chapter.sgml,v 1.75 2001/07/16 23:32:45 murray Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/pgpkeys/chapter.sgml,v 1.76 2001/07/18 19:57:36 ben Exp $
-->
<appendix id="pgpkeys">
<title>PGP Keys</title>
<indexterm><primary>pgp keys</primary></indexterm>
<para>In case you need to verify a signature or send encrypted email
to one of the officers or developers a number of keys are provided
here for your convenience. &a.wollman; maintains <ulink

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

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml,v 1.127 2001/07/19 13:55:58 dd Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml,v 1.128 2001/07/19 23:18:08 chern Exp $
-->
<chapter id="ports">
@ -10,6 +10,8 @@
<sect1>
<title>Synopsis</title>
<indexterm><primary>ports</primary></indexterm>
<indexterm><primary>packages</primary></indexterm>
<para>There is only so much you can do with FreeBSD. If you are an
operating systems developer then the base system likely contains
everything you need. If that is not what you are planning to do with
@ -237,7 +239,14 @@
<sect2>
<title>Installing a Package</title>
<indexterm>
<primary>packages</primary>
<secondary>installing</secondary>
</indexterm>
<indexterm>
<primary><command>pkg_add</command></primary>
</indexterm>
<para>You can use the &man.pkg.add.1; utility to install a
FreeBSD software package from a local file or from a server on
the network.</para>
@ -277,6 +286,8 @@ local: xchat-1.7.1.tgz remote: xchat-1.7.1.tgz
and then to fetch and install the package from an FTP site.
</para>
<indexterm>
<primary><command>pkg_add</command></primary></indexterm>
<screen>&prompt.root; <userinput>pkg_add -r <replaceable>xchat-1.7.1</replaceable></userinput></screen>
<para>This would download the correct package and add it without
@ -305,6 +316,13 @@ local: xchat-1.7.1.tgz remote: xchat-1.7.1.tgz
<sect2>
<title>Deleting a Package</title>
<screen>&prompt.root <userinput>pkg_delete <replaceable>xchat-1.7.1</replaceable></userinput></screen>
<indexterm>
<primary><command>pkg_delete</command></primary>
</indexterm>
<indexterm>
<primary>packages</primary>
<secondary>deleting</secondary>
</indexterm>
<para>&man.pkg.delete.1; is the utility for removing
previously installed software package distributions.
</para>
@ -313,10 +331,17 @@ local: xchat-1.7.1.tgz remote: xchat-1.7.1.tgz
<sect2>
<title>Managing packages</title>
<indexterm>
<primary>packages</primary>
<secondary>managing</secondary>
</indexterm>
<para>&man.pkg.info.1; a utility that lists and describes
the various packages installed.
</para>
<indexterm>
<primary><command>pkg_info</command></primary>
</indexterm>
<screen>&prompt.root <userinput>pkg_info</userinput>
cvsup-bin-16.1 A general network file distribution system optimized for CV
docbook-1.2 Meta-port for the different versions of the DocBook DTD
@ -393,6 +418,10 @@ docbook =
<sect2 id="ports-skeleton">
<title>Installing Ports</title>
<indexterm>
<primary>ports</primary>
<secondary>installing</secondary>
</indexterm>
<para>The first thing that should be explained
when it comes to the Ports collection is what is actually meant
by a <quote>skeleton</quote>. In a nutshell, a port skeleton is a
@ -510,6 +539,10 @@ R-deps: XFree86-3.3.5 gettext-0.10.35 giflib-4.1.0 glib-1.2.6 gtk-1.2.6 imlib-1.
<sect3 id="ports-cd">
<title>Installing ports from a CDROM</title>
<indexterm>
<primary>ports</primary>
<secondary>installing from CDROM</secondary>
</indexterm>
<para>As you may have guessed from the title, everything
described in this section assumes you have a FreeBSD CDROM set.
If you do not, you can order one from the <ulink
@ -654,6 +687,10 @@ Receiving xchat-1.3.8.tar.bz2 (305543 bytes): 100%
<sect2 id="ports-removing">
<title>Removing Installed Ports</title>
<indexterm>
<primary>ports</primary>
<secondary>removing</secondary>
</indexterm>
<para>Now that you know how to install ports, you are probably
wondering how to remove them, just in case you install one and
later on you decide that you installed the wrong port. The next
@ -725,6 +762,7 @@ Receiving xchat-1.3.8.tar.bz2 (305543 bytes): 100%
</answer>
</qandaentry>
<indexterm><primary>tarball</primary></indexterm>
<qandaentry>
<question>
<para id="ports-tarball">What is all this about
@ -756,6 +794,7 @@ Receiving xchat-1.3.8.tar.bz2 (305543 bytes): 100%
</answer>
</qandaentry>
<indexterm><primary>checksum</primary></indexterm>
<qandaentry>
<question>
<para id="ports-checksum">And a checksum?</para>

35
en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml,v 1.39 2001/07/17 22:20:51 chern Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml,v 1.40 2001/07/19 23:18:08 chern Exp $
-->
<chapter id="ppp-and-slip">
@ -242,8 +242,12 @@ tun0: flags=8010&lt;POINTOPOINT,MULTICAST&gt; mtu 1500</screen>
<title>Name Resolution Configuration</title>
<indexterm><primary>resolver</primary></indexterm>
<indexterm><primary>hostname</primary></indexterm>
<indexterm><primary>hosts</primary></indexterm>
<indexterm>
<primary><command>hostname</command></primary>
</indexterm>
<indexterm>
<primary><filename>hosts</filename></primary>
</indexterm>
<para>The resolver is the part of the system that turns IP
addresses into hostnames and vice versa. It can be configured
to look for maps that describe IP to hostname mappings in one of
@ -872,7 +876,9 @@ mary:
<sect5 id="userppp-mgetty">
<title><command>mgetty</command> and AutoPPP</title>
<indexterm><primary>mgetty</primary></indexterm>
<indexterm>
<primary><command>mgetty</command></primary>
</indexterm>
<indexterm><primary>AutoPPP</primary></indexterm>
<indexterm><primary>LCP</primary></indexterm>
@ -1107,7 +1113,9 @@ set nbns 203.14.100.5</programlisting>
<programlisting>router_enable="NO"</programlisting>
<indexterm><primary>routed</primary></indexterm>
<indexterm>
<primary><application>routed</application></primary>
</indexterm>
<para>It is important that the <command>routed</command> daemon is
not started (it is started by default), as it
<command>routed</command> tends to delete the default routing
@ -1122,7 +1130,9 @@ set nbns 203.14.100.5</programlisting>
<programlisting>sendmail_flags="-bd"</programlisting>
<indexterm><primary>sendmail</primary></indexterm>
<indexterm>
<primary><application>sendmail</application></primary>
</indexterm>
<para>The downside of this is that you must force
<command>sendmail</command> to re-examine the mail queue
whenever the ppp link is up by typing:</para>
@ -2558,7 +2568,9 @@ Shelmerg dc-slip sl-helmerg 0xfffffc00 autocomp</programlisting
<link linkend="slips-prereqs">slips-prereqs</link> section
and/or consult your IP network manager.</para>
<indexterm><primary>gated</primary></indexterm>
<indexterm>
<primary><command>gated</command></primary>
</indexterm>
<para>If you are going to use a separate subnet for your SLIP
clients, you will need to allocate the subnet number out of
your assigned IP network number and assign each of your SLIP
@ -2716,7 +2728,10 @@ Shelmerg dc-slip sl-helmerg 0xfffffc00 autocomp</programlisting
<sect3>
<title>Routing Considerations</title>
<indexterm><primary>SLIP</primary><secondary>routing</secondary></indexterm>
<indexterm>
<primary>SLIP</primary>
<secondary>routing</secondary>
</indexterm>
<para>If you are not using the <quote>proxy ARP</quote> method for
routing packets between your SLIP clients and the rest of your
network (and perhaps the Internet), you will probably either
@ -2742,7 +2757,9 @@ Shelmerg dc-slip sl-helmerg 0xfffffc00 autocomp</programlisting
<sect4>
<title>Running <command>gated</command></title>
<indexterm><primary>gated</primary></indexterm>
<indexterm>
<primary><application>gated</application></primary>
</indexterm>
<para>An alternative to the headaches of static routes is to
install <command>gated</command> on your FreeBSD SLIP server
and configure it to use the appropriate routing protocols

6
en_US.ISO8859-1/books/handbook/printing/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/printing/chapter.sgml,v 1.38 2001/07/17 00:11:23 chern Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/printing/chapter.sgml,v 1.39 2001/07/17 23:33:26 chern Exp $
-->
<chapter id="printing">
@ -1432,7 +1432,9 @@ $%&amp;'()*+,-./01234567
capability in <filename>/etc/printcap</filename>, or
<filename>/dev/console</filename> by default).</para>
<indexterm><primary>troff</primary></indexterm>
<indexterm>
<primary><command>troff</command></primary>
</indexterm>
<para>Which filter LPD starts and the filter's arguments depend on
what is listed in the <filename>/etc/printcap</filename> file and
what arguments the user specified for the job on the

6
en_US.ISO8859-1/books/handbook/security/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/security/chapter.sgml,v 1.59 2001/07/17 22:20:51 chern Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/security/chapter.sgml,v 1.60 2001/07/17 23:33:27 chern Exp $
-->
<chapter id="security">
@ -205,7 +205,9 @@
<sect2 id="securing-root-and-staff">
<title>Securing the root account and staff accounts</title>
<indexterm><primary><command>su</command></primary></indexterm>
<indexterm>
<primary><command>su</command></primary>
</indexterm>
<para>First off, do not bother securing staff accounts if you have
not secured the root account. Most systems have a password

7
en_US.ISO8859-1/books/handbook/sound/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/sound/chapter.sgml,v 1.7 2001/07/06 13:03:06 dd Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/sound/chapter.sgml,v 1.8 2001/07/19 23:18:09 chern Exp $
-->
<chapter id="sound">
@ -80,7 +80,10 @@
</listitem>
</itemizedlist>
<indexterm><primary>kernel</primary><secondary>configuration</secondary></indexterm>
<indexterm>
<primary>kernel</primary>
<secondary>configuration</secondary>
</indexterm>
<para>The driver you use in your kernel depends on the kind of card
you have. The sections below provide more information and what
you will need to add to your <link linkend="kernelconfig">kernel

6
en_US.ISO8859-1/books/handbook/users/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/users/chapter.sgml,v 1.16 2001/07/19 13:55:38 dd Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/users/chapter.sgml,v 1.17 2001/07/19 23:18:09 chern Exp $
-->
<chapter id="users">
@ -87,7 +87,7 @@
</indexterm>
<indexterm>
<primary>accounts</primary>
<secondary>operator</secondary>
<secondary><username>operator</username></secondary>
</indexterm>
<para>Examples of system users are <username>daemon</username>,
<username>operator</username>, <username>bind</username> (for
@ -97,7 +97,7 @@
<indexterm>
<primary>accounts</primary>
<secondary>nobody</secondary>
<secondary><username>nobody</username></secondary>
</indexterm>
<para><username>nobody</username> is the generic unprivileged
system user. However, it's important to keep in mind that the

6
en_US.ISO8859-1/books/handbook/x11/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/x11/chapter.sgml,v 1.32 2001/07/17 20:51:52 chern Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/x11/chapter.sgml,v 1.33 2001/07/20 21:09:39 chern Exp $
-->
<chapter id="x11">
@ -1463,7 +1463,9 @@ EndSection</programlisting>
keyword. In the example above the target monitor's rates where
entered.</para>
<indexterm><primary>XF86Config</primary></indexterm>
<indexterm>
<primary><command>XF86Config</command></primary>
</indexterm>
<para>While the <filename>XF86Config.new</filename>
configuration file is still open in an editor, next the user