docs/70920: [PATCH] fix couple typos && s/words/entities (handbook preface)
Jesus R.Camou
jcamou at cox.net
Tue Aug 24 21:20:17 UTC 2004
>Number: 70920
>Category: docs
>Synopsis: [PATCH] fix couple typos && s/words/entities (handbook preface)
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: update
>Submitter-Id: current-users
>Arrival-Date: Tue Aug 24 21:20:15 GMT 2004
>Closed-Date:
>Last-Modified:
>Originator: Jesus R. Camou
>Release: FreeBSD 4.10-STABLE i386
>Organization:
>Environment:
System: FreeBSD nightfall.cox.net 4.10-STABLE FreeBSD 4.10-STABLE #11: Mon Jul 26 20:10:25 MST 2004 root at nightfall.cox.net:/usr/obj/usr/src/sys/NIGHTFALL i386
>Description:
doc/en_US.ISO8859-1/books/handbook/preface/preface.sgml:
Fix typos:
o travelled -> traveled
o Alt,and -> Alt, and
While in here, use entities for:
o FreeBSD (&os;)
o FreeBSD-STABLE (&os.stable;)
o FreeBSD-CURRENT (&os.current;)
o Linux (&linux;)
>How-To-Repeat:
>Fix:
--- preface.diff begins here ---
Index: preface.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/preface/preface.sgml,v
retrieving revision 1.23
diff -u -r1.23 preface.sgml
--- preface.sgml 1 Aug 2004 05:48:15 -0000 1.23
+++ preface.sgml 24 Aug 2004 20:59:56 -0000
@@ -8,16 +8,16 @@
<bridgehead id="preface-audience" renderas=sect1>Intended
Audience</bridgehead>
- <para>The FreeBSD newcomer will find that the first section of this
- book guides the user through the FreeBSD installation process and
+ <para>The &os; newcomer will find that the first section of this
+ book guides the user through the &os; installation process and
gently introduces the concepts and conventions that underpin &unix;.
Working through this section requires little more than the desire
to explore, and the ability to take on board new concepts as they
are introduced.</para>
- <para>Once you have travelled this far, the second, far larger,
+ <para>Once you have traveled this far, the second, far larger,
section of the Handbook is a comprehensive reference to all manner
- of topics of interest to FreeBSD system administrators. Some of
+ of topics of interest to &os; system administrators. Some of
these chapters may recommend that you do some prior reading, and
this is noted in the synopsis at the beginning of each
chapter.</para>
@@ -29,7 +29,7 @@
Second Edition</bridgehead>
<para>This third edition is the culmination of over two years of
- work by the dedicated members of the FreeBSD Documentation
+ work by the dedicated members of the &os; Documentation
Project. The following are the major changes in this new
edition:</para>
@@ -51,7 +51,7 @@
<listitem>
<para><xref linkend="mac">, Mandatory Access Control (MAC), is
a new chapter with this edition. It explains what MAC is
- and how this mechanism can be used to secure a FreeBSD
+ and how this mechanism can be used to secure a &os;
system.</para>
</listitem>
@@ -94,7 +94,7 @@
<listitem>
<para><xref linkend="advanced-networking">, Advanced
Networking, has been expanded with new information about
- using Bluetooth devices with FreeBSD, setting up wireless
+ using Bluetooth devices with &os;, setting up wireless
networks, and Asynchronous Transfer Mode (ATM)
networking.</para>
</listitem>
@@ -115,7 +115,7 @@
First Edition</bridgehead>
<para>The second edition was the culmination of over two years of
- work by the dedicated members of the FreeBSD Documentation
+ work by the dedicated members of the &os; Documentation
Project. The following were the major changes in this
edition:</para>
@@ -139,7 +139,7 @@
<quote>Appendices</quote>.</para>
</listitem>
<listitem>
- <para><xref linkend="install"> (<quote>Installing FreeBSD</quote>) was completely
+ <para><xref linkend="install"> (<quote>Installing &os;</quote>) was completely
rewritten with many screenshots to make it much easier for new
users to grasp the text.</para>
</listitem>
@@ -159,7 +159,7 @@
technologies such as <application>KDE</application> and <application>GNOME</application> on &xfree86; 4.X.</para>
</listitem>
<listitem>
- <para><xref linkend="boot"> (<quote>The FreeBSD Booting Process</quote>) has been
+ <para><xref linkend="boot"> (<quote>The &os; Booting Process</quote>) has been
expanded.</para>
</listitem>
<listitem>
@@ -171,7 +171,7 @@
</listitem>
<listitem>
<para><xref linkend="serialcomms"> (<quote>Serial Communications</quote>) has been completely
- reorganized and updated for FreeBSD 4.X/5.X.</para>
+ reorganized and updated for &os; 4.X/5.X.</para>
</listitem>
<listitem>
<para><xref linkend="ppp-and-slip"> (<quote>PPP and SLIP</quote>) has been substantially
@@ -211,11 +211,11 @@
<para>This book is split into five logically distinct sections.
The first section, <emphasis>Getting Started</emphasis>, covers
- the installation and basic usage of FreeBSD. It is expected that
+ the installation and basic usage of &os;. It is expected that
the reader will follow these chapters in sequence, possibly
skipping chapters covering familiar topics. The second section,
<emphasis>Common Tasks</emphasis>, covers some frequently used
- features of FreeBSD. This section, and all subsequent sections,
+ features of &os;. This section, and all subsequent sections,
can be read out of order. Each chapter begins with a succinct
synopsis that
describes what the chapter covers and what the reader is expected
@@ -234,8 +234,8 @@
<varlistentry>
<term><emphasis><xref linkend="introduction">, Introduction</emphasis></term>
<listitem>
- <para>Introduces FreeBSD to a new user. It describes the
- history of the FreeBSD Project, its goals and development model.</para>
+ <para>Introduces &os; to a new user. It describes the
+ history of the &os; Project, its goals and development model.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -250,7 +250,7 @@
<term><emphasis><xref linkend="basics">, &unix; Basics</emphasis></term>
<listitem>
<para>Covers the basic commands and functionality of the
- FreeBSD operating system. If you are familiar with Linux or
+ &os; operating system. If you are familiar with Linux or
another flavor of &unix; then you can probably skip this
chapter.</para>
</listitem>
@@ -259,7 +259,7 @@
<term><emphasis><xref linkend="ports">, Installing Applications</emphasis></term>
<listitem>
<para>Covers the installation of third-party software with
- both FreeBSD's innovative <quote>Ports Collection</quote> and standard
+ both &os;'s innovative <quote>Ports Collection</quote> and standard
binary packages.</para>
</listitem>
</varlistentry>
@@ -267,7 +267,7 @@
<term><emphasis><xref linkend="x11">, The X Window System</emphasis></term>
<listitem>
<para>Describes the X Window System in general and using
- <application>&xfree86;</application> on FreeBSD in particular. Also describes common
+ <application>&xfree86;</application> on &os; in particular. Also describes common
desktop environments such as <application>KDE</application> and <application>GNOME</application>.</para>
</listitem>
</varlistentry>
@@ -279,7 +279,7 @@
<listitem>
<para>Lists some common desktop applications, such as web browsers
and productivity suites, and describes how to install them on
- FreeBSD.</para>
+ &os;.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -290,7 +290,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><emphasis><xref linkend="kernelconfig">, Configuring the FreeBSD
+ <term><emphasis><xref linkend="kernelconfig">, Configuring the &os;
Kernel</emphasis></term>
<listitem>
<para>Explains why you might need to configure a new kernel
@@ -301,7 +301,7 @@
<varlistentry>
<term><emphasis><xref linkend="printing">, Printing</emphasis></term>
<listitem>
- <para>Describes managing printers on FreeBSD, including
+ <para>Describes managing printers on &os;, including
information about banner pages, printer accounting, and
initial setup.</para>
</listitem>
@@ -309,9 +309,9 @@
<varlistentry>
<term><emphasis><xref linkend="linuxemu">, Linux Binary Compatibility</emphasis></term>
<listitem>
- <para>Describes the Linux compatibility features of FreeBSD.
+ <para>Describes the Linux compatibility features of &os;.
Also provides detailed installation instructions for many
- popular Linux applications such as <application>&oracle;</application>, <application>&sap.r3;</application>, and
+ popular &linux; applications such as <application>&oracle;</application>, <application>&sap.r3;</application>, and
<application>&mathematica;</application>.</para>
</listitem>
</varlistentry>
@@ -322,15 +322,15 @@
<term><emphasis><xref linkend="config-tuning">, Configuration and Tuning</emphasis></term>
<listitem>
<para>Describes the parameters available for system
- administrators to tune a FreeBSD system for optimum
+ administrators to tune a &os; system for optimum
performance. Also describes the various configuration files
- used in FreeBSD and where to find them.</para>
+ used in &os; and where to find them.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><emphasis><xref linkend="boot">, Booting Process</emphasis></term>
<listitem>
- <para>Describes the FreeBSD boot process and explains
+ <para>Describes the &os; boot process and explains
how to control this process with configuration options.</para>
</listitem>
</varlistentry>
@@ -347,7 +347,7 @@
<term><emphasis><xref linkend="security">, Security</emphasis></term>
<listitem>
<para>Describes many different tools available to help keep your
- FreeBSD system secure, including Kerberos, IPsec, OpenSSH, and
+ &os; system secure, including Kerberos, IPsec, OpenSSH, and
network firewalls.</para>
</listitem>
</varlistentry>
@@ -355,14 +355,14 @@
<term><emphasis><xref linkend="mac">, Mandatory Access Control</emphasis></term>
<listitem>
<para>Explains what Mandatory Access Control (MAC) is and how this
- mechanism can be used to secure a FreeBSD system.</para>
+ mechanism can be used to secure a &os; system.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><emphasis><xref linkend="disks">, Storage</emphasis></term>
<listitem>
<para>Describes how to manage storage media and filesystems
- with FreeBSD. This includes physical disks, RAID arrays,
+ with &os;. This includes physical disks, RAID arrays,
optical and tape media, memory-backed disks, and network
filesystems.</para>
</listitem>
@@ -378,7 +378,7 @@
<varlistentry>
<term><emphasis><xref linkend="l10n">, Localization</emphasis></term>
<listitem>
- <para>Describes how to use FreeBSD in languages other than
+ <para>Describes how to use &os; in languages other than
English. Covers both system and application level
localization.</para>
</listitem>
@@ -386,8 +386,8 @@
<varlistentry>
<term><emphasis><xref linkend="cutting-edge">, The Cutting Edge</emphasis></term>
<listitem>
- <para>Explains the differences between FreeBSD-STABLE,
- FreeBSD-CURRENT, and FreeBSD releases. Describes which users
+ <para>Explains the differences between &os.stable;,
+ &os.current;, and &os; releases. Describes which users
would benefit from tracking a development system and outlines
that process.</para>
</listitem>
@@ -399,14 +399,14 @@
<term><emphasis><xref linkend="serialcomms">, Serial Communications</emphasis></term>
<listitem>
<para>Explains how to connect terminals and modems to your
- FreeBSD system for both dial in and dial out connections.</para>
+ &os; system for both dial in and dial out connections.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><emphasis><xref linkend="ppp-and-slip">, PPP and SLIP</emphasis></term>
<listitem>
<para>Describes how to use PPP, SLIP, or PPP over Ethernet to
- connect to remote systems with FreeBSD.</para>
+ connect to remote systems with &os;.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -422,7 +422,7 @@
<term><emphasis><xref linkend="network-servers">, Network Servers</emphasis></term>
<listitem>
<para>Provides detailed instructions and example configuration
- files to set up your FreeBSD machine as a network filesystem
+ files to set up your &os; machine as a network filesystem
server, domain name server, network information system
server, or time synchronization server.</para>
</listitem>
@@ -440,11 +440,11 @@
<!-- Part V - Appendices -->
<varlistentry>
- <term><emphasis><xref linkend="mirrors">, Obtaining FreeBSD </emphasis></term>
+ <term><emphasis><xref linkend="mirrors">, Obtaining &os;</emphasis></term>
<listitem>
- <para>Lists different sources for obtaining FreeBSD media on CDROM
+ <para>Lists different sources for obtaining &os; media on CDROM
or DVD as well as different sites on the Internet that allow
- you to download and install FreeBSD.</para>
+ you to download and install &os;.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -459,15 +459,15 @@
<varlistentry>
<term><emphasis><xref linkend="eresources">, Resources on the Internet</emphasis></term>
<listitem>
- <para>Describes the many forums available for FreeBSD users to
+ <para>Describes the many forums available for &os; users to
post questions and engage in technical conversations about
- FreeBSD.</para>
+ &os;.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><emphasis><xref linkend="pgpkeys">, PGP Keys</emphasis></term>
<listitem>
- <para>Lists the PGP fingerprints of several FreeBSD Developers.</para>
+ <para>Lists the PGP fingerprints of several &os; Developers.</para>
</listitem>
</varlistentry>
</variablelist>
@@ -525,7 +525,7 @@
</para>
<para>Meaning the user should type the <keycap>Ctrl</keycap>,
- <keycap>Alt</keycap>,and <keycap>Del</keycap> keys at the same
+ <keycap>Alt</keycap>, and <keycap>Del</keycap> keys at the same
time.</para>
<para>Keys that are meant to be typed in sequence will be separated with
@@ -559,7 +559,7 @@
<screen><prompt>E:\></prompt> <userinput>tools\fdimage floppies\kern.flp A:</userinput></screen>
<para>Examples starting with &prompt.root; indicate a command that
- must be invoked as the superuser in FreeBSD. You can login as
+ must be invoked as the superuser in &os;. You can login as
<username>root</username> to type the command, or login as your
normal account and use &man.su.1; to gain
superuser privileges.</para>
@@ -585,7 +585,7 @@
document by paying authors to work on it full-time, paying for
publication, etc. In particular, BSDi (subsequently acquired by
<ulink url="http://www.windriver.com">Wind River Systems</ulink>)
- paid members of the FreeBSD Documentation Project to work on
+ paid members of the &os; Documentation Project to work on
improving this book full time leading up to the publication of the
first printed edition in March 2000 (ISBN 1-57176-241-8). Wind
River Systems then paid several additional authors to make a
--- preface.diff ends here ---
>Release-Note:
>Audit-Trail:
>Unformatted:
More information about the freebsd-doc
mailing list