From owner-svn-doc-all@FreeBSD.ORG Wed May 14 11:59:37 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 5B7EE543; Wed, 14 May 2014 11:59:37 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 47A742825; Wed, 14 May 2014 11:59:37 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s4EBxb5g096676; Wed, 14 May 2014 11:59:37 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s4EBxbak096675; Wed, 14 May 2014 11:59:37 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201405141159.s4EBxbak096675@svn.freebsd.org> From: Dru Lavigne Date: Wed, 14 May 2014 11:59:37 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44827 - head/en_US.ISO8859-1/books/faq X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 14 May 2014 11:59:37 -0000 Author: dru Date: Wed May 14 11:59:36 2014 New Revision: 44827 URL: http://svnweb.freebsd.org/changeset/doc/44827 Log: Put acronym tags around FAQ. Start to remove "you/we" usage. Many more commits to come. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/faq/book.xml Modified: head/en_US.ISO8859-1/books/faq/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/faq/book.xml Wed May 14 09:58:21 2014 (r44826) +++ head/en_US.ISO8859-1/books/faq/book.xml Wed May 14 11:59:36 2014 (r44827) @@ -69,8 +69,9 @@ $FreeBSD$ - This is the FAQ for &os; versions &rel3.relx;, &rel2.relx; - and &rel.relx;. Every effort has been made to make this FAQ + This is the Frequently Asked Questions + FAQ for &os; versions &rel3.relx;, &rel2.relx; + and &rel.relx;. Every effort has been made to make this FAQ as informative as possible; if you have any suggestions as to how it may be improved, send them to the &a.doc;. @@ -138,12 +139,12 @@ - Yes. Those restrictions do not control how you use - the code, merely how you treat the &os; Project itself. - If you have serious license concerns, read the actual + Yes. Those restrictions do not control how + the code is used, but how to treat the &os; Project itself. + The license itself is available at license. - The license can be summarized like + xlink:href="http://www.FreeBSD.org/copyright/freebsd-license.html">license + and can be summarized like this: @@ -202,15 +203,15 @@ robust and full-featured environment for applications. It supports a wide variety of web browsers, office suites, email readers, graphics programs, programming - environments, network servers, and just about everything - else you might want. Most of these applications can be + environments, network servers, and much more. + Most of these applications can be managed through the Ports Collection. - If you need to use an application that is only - available on one operating system, you simply cannot - replace that operating system. Chances are there is a + If an application is only + available on one operating system, you cannot just + replace that operating system. Chances are, there is a very similar application on &os;, however. If you want a solid office or Internet server, a reliable workstation, or just the ability to do your job without interruptions, @@ -219,15 +220,14 @@ and experienced &unix; administrators, use &os; as their only desktop operating system. - If you are migrating to &os; from some other &unix; - environment, you already know most of what you need to. - If your background is in graphic-driven operating systems - such as &windows; and &macos;, you may be interested in + Users migrating to &os; from another &unix;-like + environment will find &os; to be similar. + &windows; and &macos; users may be interested in instead using PC-BSD, a &os; - based distribution, instead. If you have not used &unix; - before expect to invest additional time learning the - &unix; way of doing things. This FAQ and the PC-BSD, a + &os;-based desktop distribution. Non-&unix; users should + expect to invest some additional time learning the + &unix; way of doing things. This FAQ and the &os; Handbook are excellent places to start. @@ -262,9 +262,9 @@ It is worth pointing out that the word - free is being used in two ways here, one - meaning at no cost, the other meaning - you can do whatever you like. Apart from + free is being used in two ways here: one + meaning at no cost and the other meaning + do whatever you like. Apart from one or two things you cannot do with the &os; code, for example pretending you wrote it, you can really do whatever you like with it. @@ -354,9 +354,8 @@ possibly unstable) features of the latest -CURRENT snapshot. Releases can come from either branch, but -CURRENT - should only be used if you are prepared for its increased - volatility (relative to -STABLE, that - is). + is meant for users who are prepared for its increased + volatility, relative to -STABLE. Releases are made every few months. While many people stay more @@ -391,7 +390,7 @@ for details on running -CURRENT. - If you are not familiar with &os; you should not use + Users not familiar with &os; should not use &os.current;. This branch sometimes evolves quite quickly and due to mistake can be un-buildable at times. People that use &os.current; are expected to be able to analyze, @@ -435,9 +434,9 @@ No claims are made that any -CURRENT snapshot can be considered - production quality for any purpose. If you - want to run a stable and fully tested system, you will - have to stick to full releases, or use the + production quality for any purpose. + If a stable and fully tested system is needed, + stick to full releases or use the -STABLE snapshots. Snapshot releases are directly available from http://www.FreeBSD.org/docs.html. In addition, the Bibliography at the - end of this FAQ, and FAQ, and the one in the Handbook reference other recommended books. @@ -661,10 +660,10 @@ The document's language and encoding. These are - based on the locale names you will find under - /usr/share/locale on your &os; - system. The current languages and encodings that we - have for documentation are as follows: + based on the locale names found under + /usr/share/locale on a &os; + system. The current languages and encodings + are as follows: @@ -920,16 +919,15 @@ - After choosing the format and compression mechanism - that you want to download, you will have to download the - compressed files yourself, uncompress them, and then copy + After choosing the format and compression mechanism, + download the + compressed files, uncompress them, and then copy the appropriate documents into place. - For example, the split HTML version of the FAQ, + For example, the split HTML version of the FAQ, compressed using &man.bzip2.1;, can be found in doc/en_US.ISO8859-1/books/faq/book.html-split.tar.bz2 - To download and uncompress that file you would have to do - this: + To download and uncompress that file, type: &prompt.root; fetch ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/en_US.ISO8859-1/books/faq/book.html-split.tar.bz2 &prompt.root; tar xvf book.html-split.tar.bz2 @@ -986,14 +984,14 @@ a general help channel with many users at any time. The conversations have been known to run off-topic for a while, but priority is given to users with &os; - questions. We are good about helping you understand + questions. Other users can help you understand the basics, referring to the Handbook whenever - possible, and directing you where to learn more about - the topic you need help with. We are a primarily - English speaking channel, though we have users from - all over the world. If you would like to speak in - your native language, try to ask the question in - English and then relocate to another channel + possible and providing links for learning more about + the topic you need help with. This is primarily an + English speaking channel, though it does have users from + all over the world. Non-native English speakers should + try to ask the question in + English first and then relocate to ##freebsd-lang as appropriate. @@ -1039,13 +1037,9 @@ list of IRC channels. Each of these channels are distinct and are not - connected to each other. Their chat styles also differ, - so you may need to try each to find one suited to your - chat style. As with all types of IRC - traffic, if you are easily offended or cannot deal with - lots of young people (and more than a few older ones) - doing the verbal equivalent of jello wrestling, do not - even bother with it. + connected to each other. Since their chat styles differ, + try each to find one suited to your + chat style. @@ -1077,10 +1071,9 @@ BSD Certification Group, Inc. provides system administration certifications for DragonFly BSD, - &os;, NetBSD, and OpenBSD. If you are interested in them, - visit their - site. + site for more information. Any other organizations providing training and support should contact the Project to be listed here. @@ -1111,10 +1104,9 @@ &arch.amd64; is the term &os; uses for 64-bit compatible x86 architectures (also known as "x86-64" or "x64"). Most modern computers should use &arch.amd64;. - Older hardware should use &arch.i386;. If you are - installing on a non-x86-compatible architecture select the - platform which best matches the architecture you are - using. + Older hardware should use &arch.i386;. When + installing on a non-x86-compatible architecture, select the + platform which best matches the hardware. @@ -1126,8 +1118,8 @@ On the Getting - &os; page select [iso] next to - the architecture you want to use. + &os; page, select [iso] next to + the architecture that matches the hardware. Any of the following can be used: @@ -1258,8 +1250,8 @@ - For &os; you will need a 486 or better PC, with - 64 MB or more of RAM and at least 1 GB of hard + &os; requires a 486 or better PC, + 64 MB or more of RAM, and at least 1 GB of hard disk space. See also . @@ -1289,8 +1281,8 @@ If &windows; is installed first, then yes. &os;'s boot manager will then manage to boot &windows; and &os;. - If you install &windows; second, it will boorishly - overwrite your boot manager without even asking. If that + If &windows; is installed afterwards, it will + overwrite the boot manager. If that happens, see the next section. @@ -1302,9 +1294,8 @@ - This depends on what boot manager you have installed. - The &os; boot selection menu (likely what you are using - if you end up in this situation) can be reinstalled using + This depends upon the boot manager. + The &os; boot selection menu can be reinstalled using &man.boot0cfg.8;. For example, to restore the boot menu onto the disk ada0: @@ -1337,7 +1328,7 @@ see the CD-ROM to boot from it, but why &os; cannot see it to complete the install. - Reconfigure your system so that the CD-ROM is either + Reconfigure the system so that the CD-ROM is either the master device on the IDE controller it is attached to, or make sure that it is the slave on an IDE controller that also has a master device. @@ -1388,10 +1379,10 @@ default. These are believed to be more secure than the traditional &unix; password format, which used a scheme based on the DES algorithm. DES - passwords are still available if you need to share your - password file with legacy operating systems which still - use the less secure password format. &os; also allows you - to use the Blowfish and MD5 password formats. Which + passwords are still available for backwards compatibility + with legacy operating systems which still + use the less secure password format. &os; also supports + the Blowfish and MD5 password formats. Which password format to use for new passwords is controlled by the passwd_format login capability in /etc/login.conf, which takes values @@ -1459,12 +1450,12 @@ - Because your world and kernel are out of sync. This - is not supported. Be sure you use make + The world and kernel are out of sync. This + is not supported. Be sure to use make buildworld and make - buildkernel to update your kernel. + buildkernel to update the kernel. - You can boot by specifying the kernel directly at the + Boot the system by specifying the kernel directly at the second stage, pressing any key when the | shows up before loader is started. @@ -1503,9 +1494,8 @@ This is discussed continually on the &os; mailing - lists. Since hardware changes so quickly, however, we - expect this. We still strongly - recommend that you read through the Hardware Notes + lists but is to be expected since hardware changes so quickly. + Read through the Hardware Notes for &os; &rel.current; or archives before asking about the latest and greatest hardware. - Chances are a discussion about the type of hardware you - are looking for took place just last week. + Chances are a discussion about that type of hardware + took place just last week. - If you are looking for a laptop, check the - &a.mobile; archives. Otherwise, you probably want the - archives for the &a.questions;, or possibly a specific + Before purchasing a laptop, check the archives for + &a.mobile; and &a.questions;, or possibly a specific mailing list for a particular hardware type. @@ -1587,9 +1576,8 @@ to be used with PAE are actually usable. A rule of thumb is that if the driver is usable on 64-bit architectures (like AMD64), it is also usable with PAE. - If you wish to create your own kernel configuration - file, you can enable PAE by adding the following line to - your configuration: + When creating a custom kernel configuration + file, PAE can be enabled by adding the following line: options PAE @@ -1729,11 +1717,11 @@ you actually control the changer can be found in the &man.chio.1; manual page. - If you are not using - AMANDA or some other product - that already understands changers, remember that they - only know how to move a tape from one point to another, - so you need to keep track of which slot a tape is in, + While + AMANDA and some other products + already understands changers, other applications + only know how to move a tape from one point to another/ + In this case, keep track of which slot a tape is in and which slot the tape currently in the drive needs to go back to. @@ -1811,7 +1799,7 @@ When the mouse daemon is running, access to the mouse must be coordinated between the mouse daemon and - other programs such as X Windows. Refer to the FAQ + other programs such as X Windows. Refer to the FAQ Why does my mouse not work with X? for more details on this issue. @@ -2003,7 +1991,7 @@ bindkey ^[[3~ delete-char # for xterm

If it is a problem with part of the base &os; system, it may also be buggy code, but more often than not these problems are found and fixed long before us - general FAQ readers get to use these bits of code + general FAQ readers get to use these bits of code (that is what -CURRENT is for). @@ -2092,7 +2080,7 @@ bindkey ^[[3~ delete-char # for xterm

- You should also read the SIG11 FAQ (listed below) + You should also read the SIG11 FAQ (listed below) which has excellent explanations of all these problems, albeit from a &linux; viewpoint. It also discusses how memory testing software or hardware can still pass faulty @@ -2102,9 +2090,9 @@ bindkey ^[[3~ delete-char # for xterm

- There is an extensive FAQ on this at There is an extensive FAQ on this at the SIG11 - problem FAQ. + problem FAQ. @@ -2120,7 +2108,7 @@ bindkey ^[[3~ delete-char # for xterm

The &os; developers are very interested in these errors, but need some more information than just the error you see. Copy your full crash message. Then consult the - FAQ section on FAQ section on kernel panics, build a debugging kernel, and get a backtrace. This might sound difficult, but you do not @@ -2180,7 +2168,8 @@ bindkey ^[[3~ delete-char # for xterm

This is answered in the Sendmail - FAQ as follows. This FAQ is recommended reading + FAQ as follows. This + FAQ is recommended reading when tweaking the mail setup. I'm getting these error messages: @@ -4557,7 +4546,7 @@ options SYSVMSG # enable for You are running a securelevel greater than 0. Lower the securelevel and try again. For - more information, see the FAQ + more information, see the FAQ entry on securelevel and the &man.init.8; manual page. @@ -5665,7 +5654,7 @@ Key F15 A A Menu Wo way the user expects. This behavior is a feature and not a bug. - See the FAQ about + See the FAQ about redirecting services, the &man.natd.8; manual, or one of the several port redirecting utilities in the Ports @@ -7424,7 +7413,7 @@ hint.sio.7.irq="12" See the Translation - FAQ in the &os; Documentation Project + FAQ in the &os; Documentation Project Primer. @@ -8301,7 +8290,7 @@ panic: page fault We wish to thank every one of the people responsible, and we encourage you to join - them in making this FAQ even better. + them in making this FAQ even better. &bibliography;