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

Fix indentation issues.

Browse source 
This was done mechanically and then manually reviewed for issues.

I asked for special attention to be paid to this patch, but mistakes are
still possible.

Translators may ignore.
Approved by:	bcr (mentor)
This commit is contained in:
Eitan Adler 2013-04-01 22:29:52 +00:00
parent 0e504c7539
commit 77e144fe04
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=41341
1 changed files with 66 additions and 66 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

132
en_US.ISO8859-1/books/faq/book.xml
View file

@ -23,7 +23,7 @@
<book lang='en'>
<bookinfo>
<title>Frequently Asked Questions for &os;
&rel2.relx;, and &rel.relx;</title>
&rel2.relx;, and &rel.relx;</title>
<corpauthor>The &os; Documentation Project</corpauthor>
@ -83,7 +83,7 @@
url="book.html">HTML</ulink> file with HTTP or as a variety
of other formats from the <ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">&os; FTP
server</ulink>.</para>
server</ulink>.</para>
</abstract>
</bookinfo>
@ -1897,7 +1897,7 @@
<answer>
<para>The answer is, unfortunately, <quote>It
depends</quote>. These mice with additional features
depends</quote>. These mice with additional features
require specialized driver in most cases. Unless the
mouse device driver or the user program has specific
support for the mouse, it will act just like a standard
@ -2151,7 +2151,7 @@ bindkey ^[[3~ delete-char # for xterm</programlisting>
<qandaentry>
<question id="trap-12-panic">
<para>My system crashes with either <errorname>Fatal trap 12:
page fault in kernel mode</errorname>, or
page fault in kernel mode</errorname>, or
<errorname>panic:</errorname>, and spits out a bunch of
information. What should I do?</para>
</question>
@ -2212,7 +2212,7 @@ bindkey ^[[3~ delete-char # for xterm</programlisting>
<question id="mail-loopback">
<para>Why does <application>sendmail</application> give me an
error reading <errorname>mail loops back to
myself</errorname>?</para>
myself</errorname>?</para>
</question>
<answer>
@ -2414,7 +2414,7 @@ kern.timecounter.hardware: TSC -&gt; i8254</screen>
<qandaentry>
<question id="indefinite-wait-buffer">
<para>What does the error <errorname>swap_pager: indefinite
wait buffer:</errorname> mean?</para>
wait buffer:</errorname> mean?</para>
</question>
<answer>
@ -2433,7 +2433,7 @@ kern.timecounter.hardware: TSC -&gt; i8254</screen>
<qandaentry>
<question id="lock-order-reversal">
<para>What is a <errorname>lock order
reversal</errorname>?</para>
reversal</errorname>?</para>
</question>
<answer>
@ -2475,7 +2475,7 @@ kern.timecounter.hardware: TSC -&gt; i8254</screen>
<qandaentry>
<question id="called-with-non-sleepable-locks-held">
<para>What does <errorname>Called ... with the following
non-sleepable locks held</errorname> mean?</para>
non-sleepable locks held</errorname> mean?</para>
</question>
<answer>
@ -2513,7 +2513,7 @@ kern.timecounter.hardware: TSC -&gt; i8254</screen>
<para>Why does
<maketarget>buildworld</maketarget>/<maketarget>installworld</maketarget>
die with the message <errorname>touch: not
found</errorname>?</para>
found</errorname>?</para>
</question>
<answer>
@ -2779,7 +2779,7 @@ kern.timecounter.hardware: TSC -&gt; i8254</screen>
compare for yourself the memory utilization of all these
shells by looking at the <quote>VSZ</quote> and
<quote>RSS</quote> columns in a <command>ps
<option>-u</option></command> listing.)</para>
<option>-u</option></command> listing.)</para>
</answer>
</qandaentry>
@ -2813,7 +2813,7 @@ kern.timecounter.hardware: TSC -&gt; i8254</screen>
<answer>
<para>The open-source <application><ulink
url="http://www.openoffice.org">Apache OpenOffice</ulink></application>
url="http://www.openoffice.org">Apache OpenOffice</ulink></application>
and <application><ulink
url="http://www.libreoffice.org">LibreOffice</ulink></application>
office suites work natively on &os;.</para>
@ -3377,13 +3377,13 @@ C:\="DOS"</programlisting>
&man.sysinstall.8; copies the partition table before copying
<filename>/boot/boot0</filename> to the MBR.</para>
<warning>
<para><emphasis>Do not simply copy
<warning>
<para><emphasis>Do not simply copy
<filename>/boot/boot0</filename> instead of
<filename>/boot/boot1</filename>; you will overwrite
your partition table and render your computer
un-bootable!</emphasis></para>
</warning>
</warning>
<para>When the &os; boot manager runs it records the last OS
booted by setting the active flag on the partition table
@ -3548,7 +3548,7 @@ C:\="DOS"</programlisting>
<qandaentry>
<question id="mount-cd-superblock">
<para>Why do I get <errorname>Incorrect super
block</errorname> when mounting a CD-ROM?</para>
block</errorname> when mounting a CD-ROM?</para>
</question>
<answer>
@ -3563,7 +3563,7 @@ C:\="DOS"</programlisting>
<qandaentry>
<question id="cdrom-not-configured">
<para>Why do I get <errorname>Device not
configured</errorname> when mounting a CD-ROM?</para>
configured</errorname> when mounting a CD-ROM?</para>
</question>
<answer>
@ -3626,7 +3626,7 @@ C:\="DOS"</programlisting>
<qandaentry>
<question id="mount-audio-CD">
<para>Why can I not <command>mount</command> an audio
CD?</para>
CD?</para>
</question>
<answer>
@ -3890,7 +3890,7 @@ C:\="DOS"</programlisting>
because part of the ARC is holding the L2ARC index,
pushing part of the working set into the
L2ARC which is slower than RAM.</para>
</answer>
</answer>
</qandaentry>
<qandaentry>
@ -4024,8 +4024,8 @@ C:\="DOS"</programlisting>
<qandaentry>
<question id="root-not-found-cron-errors">
<para>Why do I keep getting messages like <errorname>root: not
found</errorname> after editing
<filename>/etc/crontab</filename></para>
found</errorname> after editing
<filename>/etc/crontab</filename></para>
</question>
<answer>
@ -4073,7 +4073,7 @@ C:\="DOS"</programlisting>
<qandaentry>
<question id="su-wheel-group">
<para>Why do I get the error, <errorname>you are not in the
correct group to su root</errorname> when I try to
correct group to su root</errorname> when I try to
<command>su</command> to <username>root</username>?</para>
</question>
@ -4285,7 +4285,7 @@ options SYSVMSG # enable for messaging</programlisting>
different mail-servers to chose from is considered a good
thing; therefore try to avoid asking questions like
<quote>Is <application>sendmail</application> better than
<application>qmail</application>?</quote> in the mailing
<application>qmail</application>?</quote> in the mailing
lists. If you do feel like asking, first check the mailing
list archives. The advantages and disadvantages of each and
every one of the available MTAs have already been discussed
@ -4443,7 +4443,7 @@ options SYSVMSG # enable for messaging</programlisting>
<answer>
<para>Short answer: it is just a name.
<emphasis>RC</emphasis> stands for <quote>Release
Candidate</quote>. It signifies that a release is imminent.
Candidate</quote>. It signifies that a release is imminent.
In &os;, <emphasis>-PRERELEASE</emphasis> is typically
synonymous with the code freeze before a release. (For some
releases, the <emphasis>-BETA</emphasis> label was used in
@ -4453,7 +4453,7 @@ options SYSVMSG # enable for messaging</programlisting>
places. Major, dot-zero, releases, such as 9.0-RELEASE
are branched from the head of the development
stream, commonly referred to as <link
linkend="current">-CURRENT</link>. Minor releases, such as
linkend="current">-CURRENT</link>. Minor releases, such as
6.3-RELEASE or 5.2-RELEASE, have been snapshots of the
active <link linkend="stable">-STABLE</link> branch.
Starting with 4.3-RELEASE, each release also now has its own
@ -4576,7 +4576,7 @@ options SYSVMSG # enable for messaging</programlisting>
<para>You are running at an elevated (i.e., greater than 0)
securelevel. Lower the securelevel and try again. For more
information, see <link linkend="securelevel">the FAQ entry
on securelevel</link> and the &man.init.8; manual
on securelevel</link> and the &man.init.8; manual
page.</para>
</answer>
</qandaentry>
@ -4636,7 +4636,7 @@ options SYSVMSG # enable for messaging</programlisting>
<command>top</command> mean?</para>
</question>
<!-- Provided by John Dyson via Usenet -->
<!-- Provided by John Dyson via Usenet -->
<answer>
<itemizedlist>
<listitem>
@ -4703,10 +4703,10 @@ options SYSVMSG # enable for messaging</programlisting>
<para>How much free memory is available?</para>
</question>
<!-- Provided by John Dyson via Usenet -->
<!-- Provided by John Dyson via Usenet -->
<answer>
<para>There are a couple of kinds of <quote>free
memory</quote>. One kind is the amount of memory
memory</quote>. One kind is the amount of memory
immediately available without paging anything else out.
That is approximately the size of cache queue + size of free
queue (with a derating factor, depending upon system
@ -4746,7 +4746,7 @@ options SYSVMSG # enable for messaging</programlisting>
<question id="newsyslog-expectations">
<para>I just changed
<filename>/etc/newsyslog.conf</filename>. How can I check
if it does what I expect?</para>
if it does what I expect?</para>
</question>
<answer>
@ -4793,7 +4793,7 @@ options SYSVMSG # enable for messaging</programlisting>
<para>Many implementations are available for different
architectures and operating systems. An implementation of
the server-side code is properly known as an <literal>X
server</literal>.</para>
server</literal>.</para>
</answer>
</qandaentry>
@ -4950,7 +4950,7 @@ EndSection</programlisting>
</answer>
</qandaentry>
<qandaentry>
<qandaentry>
<question id="x-and-synaptic">
<para>My laptop has a Synaptics touchpad. Can I use
it in X?</para>
@ -5030,7 +5030,7 @@ EndSection</programlisting>
(hold down <keycap>Alt</keycap> and press
<keycap>F2</keycap>), and you will find a login prompt
waiting for you on the second <quote>virtual
console</quote>! When you want to go back to the original
console</quote>! When you want to go back to the original
session, do <keycombo
action="simul"><keycap>Alt</keycap><keycap>F1</keycap></keycombo>.</para>
@ -5197,7 +5197,7 @@ ttyvb "/usr/libexec/getty Pc" xterm off secure</programlisting>
<qandaentry>
<question id="xconsole-failure">
<para>Why do I get <errorname>Couldn't open
console</errorname> when I run
console</errorname> when I run
<command>xconsole</command>?</para>
</question>
@ -5431,13 +5431,13 @@ Key F15 A A Menu Workplace Nop</programlisting>
<para><quote>Diskless booting</quote> means that the &os;
box is booted over a network, and reads the necessary
files from a server instead of its hard disk. For full
details, please read <ulink
url="&url.books.handbook;/network-diskless.html">the Handbook entry on diskless booting</ulink>.</para>
</answer>
</qandaentry>
details, please read <ulink
url="&url.books.handbook;/network-diskless.html">the Handbook entry on diskless booting</ulink>.</para>
</answer>
</qandaentry>
<qandaentry>
<question id="router">
<qandaentry>
<question id="router">
<para>Can a &os; box be used as a dedicated network
router?</para>
</question>
@ -5522,7 +5522,7 @@ Key F15 A A Menu Workplace Nop</programlisting>
<answer>
<para>If the alias is on the same subnet as an address already
configured on the interface, then add <literal>netmask
0xffffffff</literal> to your &man.ifconfig.8; command-line,
0xffffffff</literal> to your &man.ifconfig.8; command-line,
as in the following:</para>
<screen>&prompt.root; <userinput>ifconfig <replaceable>ed0</replaceable> alias <replaceable>192.0.2.2</replaceable> netmask 0xffffffff</userinput></screen>
@ -5609,7 +5609,7 @@ Key F15 A A Menu Workplace Nop</programlisting>
<qandaentry>
<question id="network-permission-denied">
<para>Why do I get an error, <errorname>Permission
denied</errorname>, for all networking operations?</para>
denied</errorname>, for all networking operations?</para>
</question>
<answer>
@ -5712,7 +5712,7 @@ Key F15 A A Menu Workplace Nop</programlisting>
<qandaentry>
<question id="bpf-not-configured">
<para>Why do I get <errorname>/dev/bpf0: device not
configured</errorname>?</para>
configured</errorname>?</para>
</question>
<answer>
@ -5742,7 +5742,7 @@ Key F15 A A Menu Workplace Nop</programlisting>
<qandaentry>
<question id="icmp-response-bw-limit">
<para>What are these messages about: <errorname>Limiting
icmp/open port/closed port response</errorname> in my log
icmp/open port/closed port response</errorname> in my log
files?</para>
</question>
@ -5799,7 +5799,7 @@ Key F15 A A Menu Workplace Nop</programlisting>
<qandaentry>
<question id="unknown-hw-addr-format">
<para>What are these <errorname>arp: unknown hardware address
format</errorname> error messages?</para>
format</errorname> error messages?</para>
</question>
<answer>
@ -5816,7 +5816,7 @@ Key F15 A A Menu Workplace Nop</programlisting>
<qandaentry>
<question id="arp-wrong-iface">
<para>Why do I keep seeing messages like: <errorname>192.168.0.10 is on
fxp1 but got reply from 00:15:17:67:cf:82 on rl0</errorname>, and how do I
fxp1 but got reply from 00:15:17:67:cf:82 on rl0</errorname>, and how do I
disable it?</para>
</question>
@ -6414,7 +6414,7 @@ deny pred1 deflate deflate24 protocomp acfcomp shortseq vj</programlisting>
<answer>
<para>Occasionally, just after connecting, you may see
messages in the log that say <errorname>Magic is
same</errorname>. Sometimes, these messages are harmless,
same</errorname>. Sometimes, these messages are harmless,
and sometimes one side or the other exits. Most PPP
implementations cannot survive this problem, and even if the
link seems to come up, you will see repeated configure
@ -6639,7 +6639,7 @@ set dfilter 3 permit 0/0 0/0</programlisting>
everything until the queue is run (usually, sendmail is
run with <option>-bd -q30m</option>, telling it to run
the queue every 30 minutes) or until a <command>sendmail
<option>-q</option></command> is done (perhaps from your
<option>-q</option></command> is done (perhaps from your
<filename>ppp.linkup</filename>).</para>
</answer>
</qandaentry>
@ -7029,7 +7029,7 @@ ATDT1234567</programlisting>
<para>This section answers common questions about serial
communications with &os;. PPP is covered in the <link
linkend="networking">Networking</link> section.</para>
linkend="networking">Networking</link> section.</para>
<qandaset>
<qandaentry>
@ -7473,7 +7473,7 @@ hint.sio.7.irq="12"</programlisting>
<answer>
<para>He does not have one, and is just called <quote>the BSD
daemon</quote>. If you insist upon using a name, call him
daemon</quote>. If you insist upon using a name, call him
<quote>beastie</quote>. Note that <quote>beastie</quote> is
pronounced <quote>BSD</quote>.</para>
@ -7547,7 +7547,7 @@ hint.sio.7.irq="12"</programlisting>
long argument about whether &man.sleep.1; should take
fractional second arguments, &a.phk; posted a long message
entitled <quote><ulink
url="http://www.FreeBSD.org/cgi/getmsg.cgi?fetch=506636+517178+/usr/local/www/db/text/1999/freebsd-hackers/19991003.freebsd-hackers">A bike shed (any color will do) on greener grass...</ulink></quote>.
url="http://www.FreeBSD.org/cgi/getmsg.cgi?fetch=506636+517178+/usr/local/www/db/text/1999/freebsd-hackers/19991003.freebsd-hackers">A bike shed (any color will do) on greener grass...</ulink></quote>.
The appropriate portions of that message are quoted
below.</para>
@ -7561,11 +7561,11 @@ hint.sio.7.irq="12"</programlisting>
<para>It is a long story, or rather it is an old story, but
it is quite short actually. C. Northcote Parkinson wrote
a book in the early 1960s, called <quote>Parkinson's
Law</quote>, which contains a lot of insight into the
Law</quote>, which contains a lot of insight into the
dynamics of management.</para>
<para><emphasis>[snip a bit of commentary on the
book]</emphasis></para>
book]</emphasis></para>
<para>In the specific example involving the bike shed, the
other vital component is an atomic power-plant, I guess
@ -7594,10 +7594,10 @@ hint.sio.7.irq="12"</programlisting>
<emphasis>here</emphasis>.</para>
<para>In Denmark we call it <quote>setting your
fingerprint</quote>. It is about personal pride and
fingerprint</quote>. It is about personal pride and
prestige, it is about being able to point somewhere and
say <quote>There! <emphasis>I</emphasis> did
that.</quote> It is a strong trait in politicians, but
that.</quote> It is a strong trait in politicians, but
present in most people given the chance. Just think about
footsteps in wet cement.</para>
</blockquote>
@ -7699,7 +7699,7 @@ hint.sio.7.irq="12"</programlisting>
<para>Three to submit PRs about it, one of which is misfiled
under doc and consists only of <quote>it's
dark</quote>;</para>
dark</quote>;</para>
<para>One to commit an untested lightbulb which breaks
buildworld, then back it out five minutes later;</para>
@ -7761,8 +7761,8 @@ hint.sio.7.irq="12"</programlisting>
-chat and unsubscribe in protest;</para>
<para>Thirteen to post <quote>unsubscribe</quote>, <quote>How
do I unsubscribe?</quote>, or <quote>Please remove me from
the list</quote>, followed by the usual footer;</para>
do I unsubscribe?</quote>, or <quote>Please remove me from
the list</quote>, followed by the usual footer;</para>
<para>One to commit a working lightbulb while everybody is too
busy flaming everybody else to notice;</para>
@ -7776,7 +7776,7 @@ hint.sio.7.irq="12"</programlisting>
fairings;</para>
<para>Nine (including the PR originators) to ask <quote>what
is MFC?</quote>;</para>
is MFC?</quote>;</para>
<para>Fifty-seven to complain about the lights being out two
weeks after the bulb has been changed.</para>
@ -7784,18 +7784,18 @@ hint.sio.7.irq="12"</programlisting>
<para><emphasis>&a.nik; adds:</emphasis></para>
<para><emphasis>I was laughing quite hard at
this.</emphasis></para>
this.</emphasis></para>
<para><emphasis>And then I thought, <quote>Hang on, shouldn't
there be '1 to document it.' in that list
somewhere?</quote></emphasis></para>
there be '1 to document it.' in that list
somewhere?</quote></emphasis></para>
<para><emphasis>And then I was enlightened
:-)</emphasis></para>
:-)</emphasis></para>
<para><emphasis>&a.tabthorpe;</emphasis> says: <quote>None,
<emphasis>real</emphasis> &os; hackers are not afraid of the
dark!</quote></para>
<emphasis>real</emphasis> &os; hackers are not afraid of the
dark!</quote></para>
</answer>
</qandaentry>
@ -7936,7 +7936,7 @@ hint.sio.7.irq="12"</programlisting>
<para><literal>HEAD</literal> is not an actual branch tag,
like the others; it is simply a symbolic constant for
<quote><emphasis>the current, non-branched development
stream</emphasis></quote> which we simply refer to as
stream</emphasis></quote> which we simply refer to as
<emphasis>-CURRENT</emphasis>.</para>
<para>Right now, <emphasis>-CURRENT</emphasis> is the
@ -8128,7 +8128,7 @@ panic: page fault</programlisting>
it recover the crash dump to another directory where you
have more room. It is possible to limit the size of the
crash dump by using <literal>options
MAXMEM=<replaceable>N</replaceable></literal> where
MAXMEM=<replaceable>N</replaceable></literal> where
<replaceable>N</replaceable> is the size of kernel's
memory usage in KBs. For example, if you have 1&nbsp;GB
of RAM, you can limit the kernel's memory usage to