From owner-freebsd-doc@FreeBSD.ORG Sun Feb 12 01:10:12 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C24081065673 for ; Sun, 12 Feb 2012 01:10:12 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 80F2D8FC0C for ; Sun, 12 Feb 2012 01:10:12 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q1C1AClt013045 for ; Sun, 12 Feb 2012 01:10:12 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q1C1AC0u013042; Sun, 12 Feb 2012 01:10:12 GMT (envelope-from gnats) Resent-Date: Sun, 12 Feb 2012 01:10:12 GMT Resent-Message-Id: <201202120110.q1C1AC0u013042@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Jeremy Huddleston Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 963A11065670 for ; Sun, 12 Feb 2012 01:09:10 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 7C50E8FC14 for ; Sun, 12 Feb 2012 01:09:10 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q1C19AEP075711 for ; Sun, 12 Feb 2012 01:09:10 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id q1C19A20075710; Sun, 12 Feb 2012 01:09:10 GMT (envelope-from nobody) Message-Id: <201202120109.q1C19A20075710@red.freebsd.org> Date: Sun, 12 Feb 2012 01:09:10 GMT From: Jeremy Huddleston To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/165009: indent(1) man page fix X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 12 Feb 2012 01:10:12 -0000 >Number: 165009 >Category: docs >Synopsis: indent(1) man page fix >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Feb 12 01:10:12 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Jeremy Huddleston >Release: trunk >Organization: Apple Inc >Environment: NA >Description: -bacc is not described in FreeBSD's indent(1) man page, but it is supported by the tool. This report contains a patch to indent.1 from Apple's indent.1 which was in turn from NetBSD's indent.1 >How-To-Repeat: >Fix: Index: indent.1 =================================================================== --- indent.1 (revision 75832) +++ indent.1 (revision 75833) @@ -43,6 +43,7 @@ .Sh SYNOPSIS .Nm .Op Ar input_file Op Ar output_file +.Op Fl bacc | Fl nbacc .Op Fl bad | Fl nbad .Op Fl bap | Fl nbap .Bk -words @@ -125,6 +126,15 @@ The options listed below control the formatting style imposed by .Nm . .Bl -tag -width Op +.It Fl bacc , nbacc +If +.Fl bacc +is specified, a blank line is forced around every conditional +compilation block. +For example, in front of every #ifdef and after every #endif. +Other blank lines surrounding such blocks will be swallowed. +Default: +.Fl nbacc . .It Fl bad , nbad If .Fl bad >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun Feb 12 01:39:56 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C4CAE106566B; Sun, 12 Feb 2012 01:39:56 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 973478FC08; Sun, 12 Feb 2012 01:39:56 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q1C1duTv041895; Sun, 12 Feb 2012 01:39:56 GMT (envelope-from eadler@freefall.freebsd.org) Received: (from eadler@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q1C1dut0041891; Sun, 12 Feb 2012 01:39:56 GMT (envelope-from eadler) Date: Sun, 12 Feb 2012 01:39:56 GMT Message-Id: <201202120139.q1C1dut0041891@freefall.freebsd.org> To: eadler@FreeBSD.org, freebsd-doc@FreeBSD.org, eadler@FreeBSD.org From: eadler@FreeBSD.org Cc: Subject: Re: docs/165009: indent(1) man page fix X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 12 Feb 2012 01:39:56 -0000 Synopsis: indent(1) man page fix Responsible-Changed-From-To: freebsd-doc->eadler Responsible-Changed-By: eadler Responsible-Changed-When: Sun Feb 12 01:39:56 UTC 2012 Responsible-Changed-Why: I'll take it. http://www.freebsd.org/cgi/query-pr.cgi?pr=165009 From owner-freebsd-doc@FreeBSD.ORG Sun Feb 12 02:29:33 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9736E106564A; Sun, 12 Feb 2012 02:29:33 +0000 (UTC) (envelope-from jeremyhu@apple.com) Received: from mail-out.apple.com (crispin.apple.com [17.151.62.50]) by mx1.freebsd.org (Postfix) with ESMTP id 7341D8FC0A; Sun, 12 Feb 2012 02:29:33 +0000 (UTC) MIME-version: 1.0 Content-transfer-encoding: 7BIT Content-type: text/plain; CHARSET=US-ASCII Received: from relay16.apple.com ([17.128.113.55]) by mail-out.apple.com (Oracle Communications Messaging Server 7u4-23.01 (7.0.4.23.0) 64bit (built Aug 10 2011)) with ESMTP id <0LZ9006LJAONAFG0@mail-out.apple.com>; Sat, 11 Feb 2012 17:26:51 -0800 (PST) X-AuditID: 11807137-b7b87ae000004a2b-bc-4f37155b96ef Received: from jimbu (jimbu.apple.com [17.151.62.37]) (using TLS with cipher RC4-MD5 (RC4-MD5/128 bits)) (Client did not present a certificate) by relay16.apple.com (Apple SCV relay) with SMTP id 91.36.18987.B55173F4; Sat, 11 Feb 2012 17:26:51 -0800 (PST) Received: from [17.153.52.157] (unknown [17.153.52.157]) by cardamom.apple.com (Oracle Communications Messaging Server 7u4-23.01 (7.0.4.23.0) 64bit (built Aug 10 2011)) with ESMTPSA id <0LZ90083MAOQWHA0@cardamom.apple.com>; Sat, 11 Feb 2012 17:26:51 -0800 (PST) From: Jeremy Huddleston In-reply-to: <201202120110.q1C1AClA013038@freefall.freebsd.org> Date: Sat, 11 Feb 2012 17:26:50 -0800 Message-id: <1970FD24-A6BA-49BC-8668-A365FFA22993@apple.com> References: <201202120110.q1C1AClA013038@freefall.freebsd.org> To: FreeBSD-gnats-submit@FreeBSD.org, freebsd-doc@FreeBSD.org X-Mailer: Apple Mail (2.1426) X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFprLLMWRmVeSWpSXmKPExsUiON1OVTda1Nzf4GqPnsWpM12sFi1PVrM7 MHnM+DSfJYAxissmJTUnsyy1SN8ugStj0gbtgtVcFefW32dvYPzH3sXIySEhYCKx7NxzVghb TOLCvfVsXYxcHEICrUwSFyduY4VwepkkVkzezAhSxSygJbF+53EmEJtXQE/i3L65YJOEBQwk OhbcZ+5i5OBgE9CRaJ7NARLmFLCXmLFxKguIzSKgKjHx9X12iDHyEpvXvGWGGGMj0bh4D1ir kICdxMUWZZCwiICtxNmOxWwQt8lKHJqxknECI/8sJEfMQnLELCRTFzAyr2IULErNSaw0NNNL LCjISdVLzs/dxAgKtIZC8x2M2//KHWIU4GBU4uEV5Df3F2JNLCuuzD3EKMHBrCTCm+ps5i/E m5JYWZValB9fVJqTWnyIUZqDRUmcl3eNib+QQHpiSWp2ampBahFMlomDU6qBUWni7SDPsICb ayZvi1TzPH2laTXP9/d3aj8tDdJZP7FkTXz001O2R6VjWTNCt5afe7oh4YZKaVXWxyd5X1L4 ot2f6h7+Zzw/r9TPbU77B3uj9TtdumbyP+Revlm+YuIHvVN5xYsd/z9ctb+i852cdJyXQZ1o xDYts58XQ9X9QosTi156BK9jVGIpzkg01GIuKk4EAHDcnHMwAgAA Cc: Subject: Re: docs/165009: indent(1) man page fix X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 12 Feb 2012 02:29:33 -0000 -eei is also missing: Index: indent.1 =================================================================== --- indent.1 (revision 75833) +++ indent.1 (working copy) @@ -63,6 +63,8 @@ .Op Fl d Ns Ar n .Op Fl \&di Ns Ar n .Bk -words +.Op Fl ei | Fl ei +.Op Fl eei | Fl eei .Op Fl fbs | Fl nfbs .Op Fl fc1 | Fl nfc1 .Op Fl fcb | Fl nfcb @@ -276,6 +278,16 @@ statement. The default is .Fl ei . +.It Fl eei , neei +Enables (disables) extra indentation on continuation lines of +the expression part of +.Ic if +and +.Ic while +statements. +These continuation lines will be indented one extra level. +The default is +.Fl neei . .It Fl fbs , nfbs Enables (disables) splitting the function declaration and opening brace across two lines. On Feb 11, 2012, at 5:10 PM, freebsd-gnats-submit@FreeBSD.org wrote: > Thank you very much for your problem report. > It has the internal identification `docs/165009'. > The individual assigned to look at your > report is: freebsd-doc. > > You can access the state of your problem report at any time > via this link: > > http://www.freebsd.org/cgi/query-pr.cgi?pr=165009 > >> Category: docs >> Responsible: freebsd-doc >> Synopsis: indent(1) man page fix >> Arrival-Date: Sun Feb 12 01:10:12 UTC 2012 > From owner-freebsd-doc@FreeBSD.ORG Mon Feb 13 05:39:13 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 12839106566B for ; Mon, 13 Feb 2012 05:39:13 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-1.mit.edu (DMZ-MAILSEC-SCANNER-1.MIT.EDU [18.9.25.12]) by mx1.freebsd.org (Postfix) with ESMTP id A0A1E8FC1F for ; Mon, 13 Feb 2012 05:39:12 +0000 (UTC) X-AuditID: 1209190c-b7fad6d000000920-cd-4f38a1ffa30c Received: from mailhub-auth-1.mit.edu ( [18.9.21.35]) by dmz-mailsec-scanner-1.mit.edu (Symantec Messaging Gateway) with SMTP id D2.D3.02336.FF1A83F4; Mon, 13 Feb 2012 00:39:11 -0500 (EST) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-1.mit.edu (8.13.8/8.9.2) with ESMTP id q1D5dBcH016156; Mon, 13 Feb 2012 00:39:11 -0500 Received: from multics.mit.edu (MULTICS.MIT.EDU [18.187.1.73]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id q1D5d84O011911 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 13 Feb 2012 00:39:11 -0500 (EST) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id q1D5d8B6025435; Mon, 13 Feb 2012 00:39:08 -0500 (EST) Date: Mon, 13 Feb 2012 00:39:08 -0500 (EST) From: Benjamin Kaduk To: Eitan Adler In-Reply-To: Message-ID: References: User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrBIsWRmVeSWpSXmKPExsUixCmqrPt/oYW/we/DVhanznSxWiw60c7k wOQxbfNBNo8Zn+azBDBFcdmkpOZklqUW6dslcGW8vDGDrWCvXcWNXf2sDYyHDLoYOTkkBEwk Tiz9wwhhi0lcuLeerYuRi0NIYB+jxMl9/YwQzgZGic87VrNDOAeYJE6f7WSFcBoYJRZuPcIC 0s8ioC1x6P4qJhCbTUBFYuabjWwgtoiAmsS7191gO5gFpCUa1m8GqxEW0JCY8mwe0CAODk6B QIkVi8NBwrwC9hJ/3p5mBAkLCQRIXHpnDxIWFdCRWL1/CgtEiaDEyZlPWCAmWkr8W/uLdQKj 4CwkqVlIUgsYmVYxyqbkVunmJmbmFKcm6xYnJ+blpRbpGurlZpbopaaUbmIEB6okzw7GNweV DjEKcDAq8fAGFFv4C7EmlhVX5h5ilORgUhLljV4AFOJLyk+pzEgszogvKs1JLT7EKMHBrCTC qxcDlONNSaysSi3Kh0lJc7AoifOqaL3zExJITyxJzU5NLUgtgsnKcHAoSfD6AyNSSLAoNT21 Ii0zpwQhzcTBCTKcB2g4K0gNb3FBYm5xZjpE/hSjLsfErvUXGIVY8vLzUqXEeXNBigRAijJK 8+DmwBLMK0ZxoLeEeRtAqniAyQlu0iugJUxAS6TPmYAsKUlESEk1MJYxKpndeRmveGFpTsrs J11362rc/Hfv481m5rKMnHdZ9qM8+9uTfed+MxpO+519UsLue+TGY4FWKaWpATcjvY/bxs+9 xTv1Q0mmjsOpu9Y2Vdb7ajONI27l3rTJDTJeXTFDcPkijUuuDRP+h0Smd7v8kl/5Ikr8RfST hjQ1zmo9fl2dn+8eKLEUZyQaajEXFScCAJZCXTALAwAA Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 13 Feb 2012 05:39:13 -0000 On Fri, 10 Feb 2012, Eitan Adler wrote: > I started working on editing the config chapter. The following is the work of > Niclas Zeising, wblock, myself, and others in the #bsddocs channel. > > I'm looking for additional review of the following patch: > http://people.freebsd.org/~eadler/files/yoda-can-has-a-donught.diff Inline patches are easier to review. % Index: chapter.sgml % =================================================================== % RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v % retrieving revision 1.250 % diff -u -r1.250 chapter.sgml % --- chapter.sgml 31 Jan 2012 14:14:59 -0000 1.250 % +++ chapter.sgml 10 Feb 2012 01:15:29 -0000 % @@ -475,22 +475,21 @@ % The cron utility uses two different % types of configuration files, the system crontab and user crontabs. The % only difference between these two formats is the sixth field. In the % - system crontab, the sixth field is the name of a user for the command % - to run as. This gives the system crontab the ability to run commands % - as any user. In a user crontab, the sixth field is the command to run, % + system crontab, cron will run the command as this user. % + In a user crontab, the sixth field is the command to run, I can't see how this could possibly be correct. A command line in a crontab requires a command to run, which would be a seventh field in the system crontab. But this is not mentioned at all, here! % and all commands run as the user who created the crontab; this is an % important security feature. % % % User crontabs allow individual users to schedule tasks without the % - need for root privileges. Commands in a user's crontab run with the % - permissions of the user who owns the crontab. % + need for root privileges. Commands in a user's crontab run with the % + permissions of the user who owns the crontab. Are these just whitespace changes? % % The root user can have a user crontab just like % - any other user. This one is different from % - /etc/crontab (the system crontab). Because of the % - system crontab, there is usually no need to create a user crontab % - for root. % + any other user. root's crontab is % + distinct from /etc/crontab (the system crontab). % + Because of the system crontab, there is usually no need to % + create a user crontab for root. % Fine. % % Let us take a look at the /etc/crontab file % @@ -547,11 +546,9 @@ % day of the week. All these fields must be numeric values, and follow % the twenty-four hour clock. The who field is special, % and only exists in the /etc/crontab file. % - This field specifies which user the command should be run as. % - When a user installs his or her crontab file, they % - will not have this option. Finally, the command option is listed. % - This is the last field, so naturally it should designate the command % - to be executed. % + The command will be run as the user named in this % + field. Finally, the last field is the command to be % + executed. This feels a bit odd; most of the sentences here have "the [nth] field" as the subject of the sentence, so switching to having the command be the subject seems out-of-place. I think I would keep the first sentence as-is, but dropping the "When a user..." sentence is probably okay. "Finally, the last field" feels a bit redundant. % % % % @@ -584,13 +581,13 @@ % Installing a Crontab % % % - You must not use the procedure described here to % - edit/install the system crontab. Simply use your favorite % - editor: the cron utility will notice that the file % - has changed and immediately begin using the updated version. % - See % - % - this FAQ entry for more information. % + Do not use the procedure described here to % + edit and install the system crontab. Simply use your favorite % + editor: the cron utility will notice that the file % + has changed and immediately begin using the updated version. % + See % + this FAQ entry We should be able to make this line shorter, right? % + for more information. % % % To install a freshly written user [snip some minor/formatting changes] % @@ -2390,15 +2386,35 @@ % of the Handbook. % % % - Swap on a New Hard Drive % + Swap on a New or Existing Hard Drive % + % + The best way to add swap space, and the way that gives the best % + performance, is to add a new swap partition on an existing or new hard % + drive. Setting up partitions and hard drives is explained in % + . % + discusses partition layouts and swap partition size considerations. The old text was sort of advocating for using a new drive for swap, but it seems to have not actually mentioned (at least in the context that is quoted) perhaps the best reason for doing so: having a dedicated spindle for swap avoids extra seeks from competition with normal i/o. It would seem that if we are going to claim there is a "best" way, it should involve a dedicated drive. % + % + Use &man.swapon.8; to add a swap partition to the system. For example: % + % + &prompt.root; swapon/dev/ada1s1p2 % + % + % + It is possible to use any partition not currently mounted, even % + if it already contains data. Using &man.swapon.8; on a partition that % + contains data will overwrite and destroy that data. % + Make sure that the partition to be added as swap % + is really the intended partition before running % + swapon. % + % + Hmm, I thought that that there would be a check for the swap partition type, but glancing through the kernel code (vm/swap_pager.c) makes it seem like swap can be enabled in a great many places... % + To automatically add this swap partition on boot, % + add an entry to /etc/fstab for the % + partition: % + % + /dev/ada1s1p1 none swap sw 0 0 % % - The best way to add swap, of course, is to use this as an % - excuse to add another hard drive. You can always use another % - hard drive, after all. If you can do this, go reread the % - discussion of swap space % - in % - of the Handbook for some suggestions on how to best % - arrange your swap. % + &man.fstab.5; explains the entries in % + /etc/fstab. I kind of feel like "explains the entries" is too concise. Are we looking for the meaning of the entries, or their format, or something else? % % % [snip more minor stuff] -Ben Kaduk From owner-freebsd-doc@FreeBSD.ORG Mon Feb 13 11:06:13 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0150F106566B for ; Mon, 13 Feb 2012 11:06:13 +0000 (UTC) (envelope-from owner-bugmaster@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id D8A258FC1B for ; Mon, 13 Feb 2012 11:06:12 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q1DB6CTI090047 for ; Mon, 13 Feb 2012 11:06:12 GMT (envelope-from owner-bugmaster@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q1DB6BPx090027 for freebsd-doc@FreeBSD.org; Mon, 13 Feb 2012 11:06:11 GMT (envelope-from owner-bugmaster@FreeBSD.org) Date: Mon, 13 Feb 2012 11:06:11 GMT Message-Id: <201202131106.q1DB6BPx090027@freefall.freebsd.org> X-Authentication-Warning: freefall.freebsd.org: gnats set sender to owner-bugmaster@FreeBSD.org using -f From: FreeBSD bugmaster To: FreeBSD doc list Cc: Subject: Current unassigned doc problem reports X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 13 Feb 2012 11:06:13 -0000 (Note: an HTML version of this report is available at http://www.freebsd.org/cgi/query-pr-summary.cgi?category=doc .) The following is a listing of current problems submitted by FreeBSD users. These represent problem reports covering all versions including experimental development code and obsolete releases. S Tracker Resp. Description -------------------------------------------------------------------------------- o docs/164826 doc handbook ports page does not suggest config-recursive o docs/164803 doc Unclear manual page for mount_unionfs(8) o docs/164800 doc Handbook's installation topic doesn't mention ZFS o docs/164772 doc incorrect ipfw sched parameters in manual o docs/164682 doc Handbook contains wrong information about Flash player o docs/164620 doc Raid 1 issues o docs/164564 doc [if_bridge] Incorrect default timeout for a bridge in o docs/164099 doc gparm(8): man page for gparm set is incorrect and inco o docs/164034 doc acl(9) documentation lacking o docs/163879 doc [handbook] handbook does not say about how to force to o docs/163877 doc apm(4) is not installed o docs/163830 doc device smbios: missing documentation, no manpage o docs/163771 doc getnameinfo(3) man-page detail o docs/163742 doc [patch] document failok mount(8) option o docs/163576 doc zfs(8) sync property not noted in the manpage o docs/163177 doc [patch] man page for gnats(7) incorrectly lists gnatsd o docs/163149 doc [patch] Red Hat Linux/i386 9 HTML format sudo man page o docs/163119 doc mktemp(3) is referring to (now) non-existent gcc optio o docs/163043 doc [patch] gsched.8: remove reference to gsched_as o docs/162775 doc zpool(1): Document some undocumented zpool import opti o docs/162765 doc [patch] lseek(2) may return successful although no see o docs/162699 doc Handbook/Upgrading instructions: should mention delete o docs/162433 doc [handbook] QEMU instructions for FreeBSD guests o docs/162419 doc [request] please document (new) zfs and zpool cmdline o docs/162404 doc [handbook] IPv6 link-local address compared with IPv4 o docs/162380 doc Documentation lacking for getfacl/setfacl p docs/162265 doc [Patch] ipfw.8: Documentation clarity o docs/162172 doc rctl manpage erroneously lists nproc a docs/161808 doc Missing documentation critical to correct usage of uui o docs/161804 doc New documentation: French translation for building-pro o docs/161754 doc p4tcc(4), est(4) and qpi(4) are not documented o docs/161496 doc zfs(1): Please document that sysctl vfs.usermount must o docs/161057 doc [handbook] Error in section 18.17.4 of the handbook o docs/160491 doc [patch] reaper of the dead: remove ancient FAQ entries o docs/160460 doc [handbook] Network setup guide suggestion o docs/160447 doc [handbook] Developer's Handbook contains some outdated o docs/160446 doc [handbook] Handbook sound setup seems outdated o docs/160445 doc [handbook] Handbook does not mention ACL o docs/160399 doc Man page for re(4) missing jumbo frames info o docs/159898 doc [patch] libusb.3 whitespace, markup, grammar fixes o docs/159854 doc [patch] grammar updates for carp.4 o docs/159307 doc [patch] lpd smm chapter unconditionally installed o docs/159298 doc [handbook] document Konqueror with Webkit support to i o docs/158813 doc [patch] grammar updates for jme(4) o docs/158388 doc Incorrect documentation of LOCAL_SCRIPT in release(7) o docs/158387 doc The tree(3) man should mention the RB_FOREACH_SAFE() A o docs/157908 doc [handbook] Description of post-install should include o docs/157698 doc [patch] gpart(8) man page contains old/incorrect size o docs/157453 doc [patch] document 16-fib cap in setfib.2 o docs/157452 doc [patch] grammar and style nits in ipfw.8 o docs/157316 doc [patch] update devstat(9) man page o docs/157234 doc [patch] nullfs(5): //proc/curproc/file returns "unknow o docs/157049 doc FreeBSD Handbook: Chapter 14 (Security) Inaccuracy o docs/156955 doc bug in share/man/man2/setsockopt.2 a docs/156920 doc isspecial(3) is not helpful o docs/156815 doc chmod(1): manpage should describe that chmod kicks +t o docs/156689 doc stf(4) output-only documentation gives bad configurati f docs/156187 doc [handbook] [patch] Add bsnmpd to handbook o docs/156081 doc troff falls with troff.core with UTF-8 man with incorr o docs/155982 doc [handbook] reaper of the dead: remove reference to flo o docs/155773 doc dialog(1): dialog manpages not updated o docs/155149 doc [patch] don't encourage using xorg.conf outside of PRE o docs/154838 doc update cvs-tags information on releng_* to reflect sup o docs/153958 doc ksu man-page documented, but not installed o docs/153738 doc [patch] Docuement requirement to alter some sysctls wh a docs/153012 doc [patch] iostat(8) requires an argument to -c option o docs/151752 doc pw.conf(5) doesn't define format for file clearly o docs/150991 doc [patch] Install upgtfw using pkg_add as advised in upg o docs/150917 doc [patch] icmp.4, wrong description of icmplim and icmpl o docs/150877 doc ambiguity in newsyslog(8) man page about zfs with comp o docs/150255 doc dtrace description should mention makeoptions DEBUG=-g o docs/150219 doc zfs(8) manual page misses jail/unjail o docs/149574 doc [patch] update mi_switch(9) man page o docs/149051 doc [request] No document for clang or clang++ o docs/149047 doc [patch] tcsh(1) bears no mention of brace expansion in o docs/148987 doc [patch] {MD[245]|SHA_|SHA1_|SHA256_}{End|File|FileChun o docs/148984 doc [handbook] Mistake in section 16.15.4 of the handbook o docs/148680 doc [sysctl][patch] Document some sys/kern sysctls o docs/148071 doc Failover mode between wired and wireless interfaces o docs/147995 doc elf.5 man page has has missing reference o docs/146958 doc bad link to "XaQti XMAC II datasheet" in sk(4) manual o docs/146521 doc [handbook] Update IPv6 system handbook section to ment o docs/145719 doc [patch] 7.3 relnotes erroneously describes new getpage o docs/145699 doc hexdump(1) mutes all format qualifier output following o docs/145644 doc Add artical about creating manpage from scratch o docs/145069 doc Dialup firewalling with FreeBSD article out dated. o docs/145066 doc Update for new uart dev names for serial port. s docs/144818 doc all mailinglist archives dated 19970101 contain traili o docs/144630 doc [patch] domainname(1) manpage contains old information o docs/144515 doc [handbook] Expand handbook Table of contents o docs/144488 doc share/examples/etc/make.conf: contains dangerous examp o docs/143850 doc procfs(5) manpage for status > controlling terminal is o docs/143416 doc [handbook] IPFW handbook page issues o docs/143408 doc man filedesc(9) is missing o docs/142168 doc [patch] ld(1): ldd(1) not mentioned in ld(1) manpage o docs/141032 doc misleading documentation for rtadvd.conf(5) raflags se s docs/140847 doc [request] add documentation on ECMP and new route args p docs/140457 doc [patch] Grammar fix for isspace(3) o docs/140444 doc [patch] New Traditional Chinese translation of custom- o docs/140375 doc [UPDATE] Updated zh_TW.Big5/articles/nanobsd o docs/139336 doc [request] ZFS documentation suggestion o docs/139165 doc gssapi.3 man page out of sync with between crypto and o docs/139018 doc translation of submitting.sgml from docproj/submitting o docs/138845 doc Exceeding kern.ipc.maxpipekva refers to tuning(7) whic o docs/138663 doc system(3) man page confuses users about "return value o docs/138485 doc bpf(4) and ip(4) man pages missing important corner ca o docs/136712 doc [handbook] [patch] draft new section on gmirror per pa o docs/136666 doc [handbook] Configure serial port for remote kernel deb o docs/136035 doc ftpchroot(5) omits an important option o docs/135516 doc [patch] pax(1) manual not mentioning chflags unawarene o docs/135475 doc [patch] jot(1) manpage and behaviour differ o docs/134123 doc The RUNQUEUE(9) man page is out of date o docs/132839 doc [patch] Fix example script in ldap-auth article o docs/132718 doc [handbook] Information about adding a new mirror is ou o docs/132260 doc dhcpd(8) pid not stored in documented location o docs/132190 doc EPERM explanation for send(2), sendto(2), and sendmsg( o docs/131918 doc [patch] Fixes for the BPF(4) man page o docs/131626 doc [patch] dump(8) "recommended" cache option confusing o docs/130238 doc nfs.lockd man page doesn't mention NFSLOCKD option or o docs/129671 doc New TCP chapter for Developer's Handbook (from rwatson o docs/129464 doc using packages system o docs/129095 doc ipfw(8): Can not check that packet originating/destine s docs/128356 doc [request] add Firefox plugin for FreeBSD manual pages s docs/127844 doc Example code skeleton_capture_n.c in meteor(4) manpage o docs/126590 doc [patch] Write routine called forever in Sample Echo Ps o docs/126484 doc libc function res-zonscut2 is not documented o docs/125921 doc lpd(8) talks about blocks in minfree while it is KB in f docs/122052 doc minor update on handbook section 20.7.1 o docs/121952 doc Handbook chapter on Network Address Translation wrong o docs/121585 doc [handbook] Wrong multicast specification s docs/121541 doc [request] no man pages for wlan_scan_ap o docs/121312 doc RELNOTES_LANG breaks release if not en_US.ISO8859-1 o docs/121173 doc [patch] mq_getattr(2): mq_flags mistakenly described a s docs/120917 doc [request]: Man pages mising for thr_xxx syscalls o docs/120539 doc Inconsistent ipfw's man page o docs/120125 doc [patch] Installing FreeBSD 7.0 via serial console and o docs/120024 doc resolver(5) and hosts(5) need updated for IPv6 o docs/119545 doc books/arch-handbook/usb/chapter.sgml formatting o docs/118902 doc [patch] wrong signatures in d2i_RSAPublicKey man pages o docs/118214 doc close(2) error returns incomplete o docs/118020 doc ipfilter(4): man pages query for man 4 ipfilter return o docs/116116 doc mktemp (3) re/move note o docs/116080 doc PREFIX is documented, but not the more important LOCAL p docs/115065 doc [patch] sync ps.1 with p_flag and keywords o docs/114371 doc [patch] [ip6] rtadvd.con(5) should show how to adverti o docs/114139 doc mbuf(9) has misleading comments on M_DONTWAIT and M_TR o docs/113194 doc [patch] [request] crontab.5: handling of day-in-month o docs/112804 doc groff(1) command should be called to explicitly use "p o docs/112682 doc Handbook GEOM_GPT explanation does not provide accurat o docs/111425 doc Missing chunks of text in historical manpages o docs/111265 doc [request] Clarify how to set common shell variables o docs/111147 doc hostapd.conf is not documented o docs/110999 doc carp(4) should document unsupported interface types o docs/110692 doc wi(4) man page doesn't say WPA is not supported o docs/110376 doc [patch] add some more explanations for the iwi/ipw fir o docs/110253 doc [patch] rtprio(1): remove processing starvation commen o docs/110062 doc [patch] mount_nfs(8) fails to mention a failure condit p docs/110061 doc [patch] tuning(7) missing reference to vfs.read_max o docs/109981 doc No manual entry for post-grohtml o docs/109977 doc No manual entry for ksu o docs/109973 doc No manual entry for c++filt o docs/109972 doc No manual entry for zless/bzless f docs/109226 doc [request] No manual entry for sntp o docs/109201 doc [request]: manual for callbootd a docs/108980 doc list of missing man pages o docs/106135 doc [request] articles/vinum needs to be updated o docs/105608 doc fdc(4) debugging description staled o docs/104879 doc Howto: Listen to IMA ADPCM .wav files on FreeBSD box o docs/102719 doc [patch] ng_bpf(4) example leads to unneeded promiscuos o docs/100196 doc man login.conf does explain not "unlimited" o docs/99506 doc FreeBSD Handbook addition: IPv6 Server Settings o docs/98974 doc Missing tunables in loader(8) manpage o docs/98115 doc Missing parts after rendering handbook to RTF format o docs/96207 doc Comments of a sockaddr_un structure could confuse one o docs/94625 doc [patch] growfs man page -- document "panic: not enough o docs/92626 doc jail manpage should mention disabling some periodic sc o docs/91506 doc ndis(4) man page should be more specific about support o docs/91149 doc read(2) can return EINVAL for unaligned access to bloc o docs/88512 doc [patch] mount_ext2fs(8) man page has no details on lar o docs/87936 doc Handbook chapter on NIS/YP lacks good information on a o docs/87857 doc ifconfig(8) wireless options order matters o docs/85128 doc [patch] loader.conf(5) autoboot_delay incompletly desc o docs/84956 doc [patch] intro(5) manpage doesn't mention API coverage o docs/84932 doc new document: printing with an Epson ALC-3000N on Free o docs/84670 doc [patch] tput(1) manpage missing ENVIRONMENT section wi o docs/84317 doc fdp-primer doesn't show class=USERNAME distinctively o docs/84271 doc [patch] compress(1) doesn't warn about nasty link hand o docs/83820 doc getino(3) manpage not installed o docs/81611 doc [patch] natd runs with -same_ports by default o docs/78480 doc Networked printer setup unnecessarily complex in handb o docs/61605 doc [request] Improve documentation for i386 disk geometry o docs/61301 doc [patch] Manpage patch for aue(4) to enable HomePNA fun o docs/59835 doc ipfw(8) man page does not warn about accepted but mean o docs/59477 doc Outdated Info Documents at http://docs.freebsd.org/inf o docs/59044 doc [patch] doc.docbook.mk does not properly handle a sour o docs/57298 doc [patch] add using compact flash cards info to handbook s docs/54752 doc bus_dma explained in ISA section in Handbook: should b o docs/53751 doc bus_dma(9) incorrectly documents BUS_DMA_ALLOCNOW o docs/53596 doc Updates to mt(1) manual page o docs/53271 doc bus_dma(9) fails to document alignment restrictions o docs/51480 doc Multiple undefined references in the FreeBSD manual pa o docs/50211 doc [patch] doc.docbook.mk: fix textfile creation o docs/48101 doc [patch] Add documentation on the fixit disk o docs/43823 doc [patch] update to environ(7) manpage o docs/41089 doc pax(1) -B option does not mention interaction with -z o docs/40423 doc Keyboard(4)'s definition of parameters to GETFKEY/SETF o docs/38982 doc [patch] developers-handbook/Jail fix o docs/38556 doc EPS file of beastie, as addition to existing examples s docs/35678 doc docproj Makefiles for web are broken for paths with sp s docs/33589 doc [patch] to doc.docbook.mk to post process .tex files. o docs/27605 doc [patch] Cross-document references () o docs/26286 doc *printf(3) etc should gain format string warnings o docs/24786 doc missing FILES descriptions in sa(4) s docs/20028 doc ASCII docs should reflect tags in the sourc 214 problems total. From owner-freebsd-doc@FreeBSD.ORG Wed Feb 15 03:36:50 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 96C9F1065672 for ; Wed, 15 Feb 2012 03:36:50 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-we0-f182.google.com (mail-we0-f182.google.com [74.125.82.182]) by mx1.freebsd.org (Postfix) with ESMTP id 18E8F8FC08 for ; Wed, 15 Feb 2012 03:36:49 +0000 (UTC) Received: by werm13 with SMTP id m13so567707wer.13 for ; Tue, 14 Feb 2012 19:36:49 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=5g7CHHb5anOT2JTiour9l9j7Newb+9A2e1+nWTkQqNQ=; b=RfUlbSHCmo2vEZTgXWitR89so8lIJeKtBumQovfAYfWWhNa24EiCSXr6bH1eIfFvxv IQij47xsUy/ZQdWaWaQOiyzA85YXYh+rakFpvLRv/yS2d9ECFoOQBKBNmMparqxm950t TkJTJ+4T2KjZ1VtWP0NSK0Fax2gaiBbAvHTuo= Received: by 10.180.90.194 with SMTP id by2mr33071038wib.5.1329277009204; Tue, 14 Feb 2012 19:36:49 -0800 (PST) MIME-Version: 1.0 Received: by 10.223.15.90 with HTTP; Tue, 14 Feb 2012 19:36:19 -0800 (PST) In-Reply-To: References: From: Eitan Adler Date: Tue, 14 Feb 2012 22:36:19 -0500 Message-ID: To: Benjamin Kaduk Content-Type: text/plain; charset=UTF-8 X-Gm-Message-State: ALoCoQk9Zpa9SGRyK72LmxOqQMbKUooYziRKyk5RIBfHkZ78YU9jb+4Djo1/U/nD0urlm1LvfZEG Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 15 Feb 2012 03:36:50 -0000 What about the following? Index: chapter.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v retrieving revision 1.251 diff -u -r1.251 chapter.sgml --- chapter.sgml 13 Feb 2012 04:28:35 -0000 1.251 +++ chapter.sgml 15 Feb 2012 03:34:17 -0000 @@ -473,13 +473,14 @@ certain times. The cron utility uses two different - types of configuration files, the system crontab and user crontabs. The - only difference between these two formats is the sixth field. In the - system crontab, the sixth field is the name of a user for the command - to run as. This gives the system crontab the ability to run commands - as any user. In a user crontab, the sixth field is the command to run, - and all commands run as the user who created the crontab; this is an - important security feature. + types of configuration files, the system crontab and user crontabs. + These formats only differ in the sixth field and later. In the + system crontab, cron will run the command as the user + specified in the sixth field. In a user crontab, all commands run as + the user who created the crontab, so the sixth field is the last field; + this is an important security feature. The final field is always + the command to run. + User crontabs allow individual users to schedule tasks without the @@ -487,10 +488,10 @@ permissions of the user who owns the crontab. The root user can have a user crontab just like - any other user. This one is different from - /etc/crontab (the system crontab). Because of the - system crontab, there is usually no need to create a user crontab - for root. + any other user. root's crontab is + distinct from /etc/crontab (the system crontab). + Because of the system crontab, there is usually no need to + create a user crontab for root. Let us take a look at the /etc/crontab file @@ -547,11 +548,8 @@ day of the week. All these fields must be numeric values, and follow the twenty-four hour clock. The who field is special, and only exists in the /etc/crontab file. - This field specifies which user the command should be run as. - When a user installs his or her crontab file, they - will not have this option. Finally, the command option is listed. - This is the last field, so naturally it should designate the command - to be executed. + This field specifies which user the command should be run + as. The last field is the command to be executed. @@ -584,13 +582,14 @@ Installing a Crontab - You must not use the procedure described here to - edit/install the system crontab. Simply use your favorite - editor: the cron utility will notice that the file - has changed and immediately begin using the updated version. - See - - this FAQ entry for more information. + Do not use the procedure described here to + edit and install the system crontab, + /etc/crontab. Simply use your favorite + editor: the cron utility will notice that the file + has changed and immediately begin using the updated version. + See + + this FAQ entry for more information. To install a freshly written user @@ -613,8 +612,7 @@ without the use of a template, the crontab -e option is available. This will invoke the selected editor with an empty file. When the file is saved, it will be - automatically installed by the crontab command. - + automatically installed by the crontab command. If you later want to remove your user crontab completely, use crontab with the @@ -636,7 +634,7 @@ - Using rc under &os; + Using <literal>rc</literal> Under &os; In 2002 &os; integrated the NetBSD rc.d system for system initialization. @@ -1674,7 +1672,7 @@ - Tuning with sysctl + Tuning with <command>sysctl</command> sysctl @@ -1944,7 +1942,7 @@ out of space and the update to fail. - More Details about Soft Updates + More Details About Soft Updates Soft Updates @@ -2390,15 +2388,36 @@ of the Handbook. - Swap on a New Hard Drive + Swap on a New or Existing Hard Drive - The best way to add swap, of course, is to use this as an - excuse to add another hard drive. You can always use another - hard drive, after all. If you can do this, go reread the - discussion of swap space - in - of the Handbook for some suggestions on how to best - arrange your swap. + Adding a new hard drive for swap gives better performance + than adding a partition on an existing drive. Setting up + partitions and hard drives is explained in + . + discusses partition layouts and swap partition size considerations. + + Use &man.swapon.8; to add a swap partition to the system. For example: + + &prompt.root; swapon/dev/ada1s1p2 + + + It is possible to use any partition not currently mounted, even + if it already contains data. Using &man.swapon.8; on a partition that + contains data will overwrite and destroy that data. + Make sure that the partition to be added as swap + is really the intended partition before running + swapon. + + + To automatically add this swap partition on boot, + add an entry to /etc/fstab for the + partition: + + /dev/ada1s1p1 none swap sw 0 0 + + &man.fstab.5; explains the meaning of the entries and + their format in + /etc/fstab. @@ -2739,7 +2758,7 @@ An ACPI-compliant system has various components. The BIOS and chipset vendors - provide various fixed tables (e.g., FADT) + provide various fixed tables (e.g., FADT) in memory that specify things like the APIC map (used for SMP), config registers, and simple configuration values. Additionally, a table of bytecode @@ -2878,7 +2897,7 @@ on Linux, it is likely a &os; driver problem and narrowing down which driver causes the problems will help us fix the problem. Note that the ACPI maintainers do not - usually maintain other drivers (e.g sound, + usually maintain other drivers (e.g., sound, ATA, etc.) so any work done on tracking down a driver problem should probably eventually be posted to the &a.current.name; list and mailed to the driver @@ -2898,7 +2917,7 @@ - System Hangs (temporary or permanent) + System Hangs (Temporary or Permanent) Most system hangs are a result of lost interrupts or an interrupt storm. Chipsets have a lot of problems based on how @@ -3058,7 +3077,7 @@ how to fix them: - _OS dependencies + _OS Dependencies Some AML assumes the world consists of various &windows; versions. You can tell &os; to claim it is @@ -3070,7 +3089,7 @@ - Missing Return statements + Missing Return Statements Some methods do not explicitly return a value as the standard requires. While ACPI-CA @@ -3112,8 +3131,7 @@ - Getting Debugging Output From - <acronym>ACPI</acronym> + Getting Debugging Output from <acronym>ACPI</acronym> ACPI -- Eitan Adler From owner-freebsd-doc@FreeBSD.ORG Wed Feb 15 03:46:03 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx2.freebsd.org (mx2.freebsd.org [IPv6:2001:4f8:fff6::35]) by hub.freebsd.org (Postfix) with ESMTP id 395A41065670 for ; Wed, 15 Feb 2012 03:46:03 +0000 (UTC) (envelope-from dougb@FreeBSD.org) Received: from 172-17-150-251.globalsuite.net (hub.freebsd.org [IPv6:2001:4f8:fff6::36]) by mx2.freebsd.org (Postfix) with ESMTP id 9A1A314DB18; Wed, 15 Feb 2012 03:46:02 +0000 (UTC) Message-ID: <4F3B2A7A.3030505@FreeBSD.org> Date: Tue, 14 Feb 2012 19:46:02 -0800 From: Doug Barton Organization: http://SupersetSolutions.com/ User-Agent: Mozilla/5.0 (X11; FreeBSD i386; rv:10.0.1) Gecko/20120213 Thunderbird/10.0.1 MIME-Version: 1.0 To: Eitan Adler References: In-Reply-To: X-Enigmail-Version: 1.3.5 OpenPGP: id=1A1ABC84 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 15 Feb 2012 03:46:03 -0000 On 02/14/2012 19:36, Eitan Adler wrote: > What about the following? For my taste it's still a little too wordy .... In looking this over I have some ideas, but can't really put work into it right atm, is updating this urgent? If not, what's your time frame? Doug -- It's always a long day; 86400 doesn't fit into a short. Breadth of IT experience, and depth of knowledge in the DNS. Yours for the right price. :) http://SupersetSolutions.com/ From owner-freebsd-doc@FreeBSD.ORG Wed Feb 15 03:55:36 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DF2331065670; Wed, 15 Feb 2012 03:55:36 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-we0-f182.google.com (mail-we0-f182.google.com [74.125.82.182]) by mx1.freebsd.org (Postfix) with ESMTP id 4C4E78FC08; Wed, 15 Feb 2012 03:55:35 +0000 (UTC) Received: by werm13 with SMTP id m13so576241wer.13 for ; Tue, 14 Feb 2012 19:55:35 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=p8zjvTF4uenh/B6HzJ+CB+/GTHwUNs+ShSEEIBJgelk=; b=JymG5M+tUBZPKx9Qb/lWodSBZ26Ae8U5eFMZw7rOaHDaXPSyyz9L7CvS7Gvcuc4R/L Z4zE6ULlMglf0LldbfMCpGmSvluHVZlhdBrMNCa8WrBKqBtuIOVxAwo5CdVy8F9k5G+R H2XWx67ANqFZERl1pRvPPmwVYlddlPu/A7zvU= Received: by 10.180.90.194 with SMTP id by2mr33131161wib.5.1329278135204; Tue, 14 Feb 2012 19:55:35 -0800 (PST) MIME-Version: 1.0 Received: by 10.223.15.90 with HTTP; Tue, 14 Feb 2012 19:55:05 -0800 (PST) In-Reply-To: <4F3B2A7A.3030505@FreeBSD.org> References: <4F3B2A7A.3030505@FreeBSD.org> From: Eitan Adler Date: Tue, 14 Feb 2012 22:55:05 -0500 Message-ID: To: Doug Barton Content-Type: text/plain; charset=UTF-8 X-Gm-Message-State: ALoCoQk1XqHVD5rdAkvH2owQInSKh6gtbP1T1mOSCquh3bsUNzC4COYoUUab1X3h7fVJnQjz98Id Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 15 Feb 2012 03:55:37 -0000 On Tue, Feb 14, 2012 at 10:46 PM, Doug Barton wrote: > On 02/14/2012 19:36, Eitan Adler wrote: >> What about the following? > > For my taste it's still a little too wordy .... In looking this over I > have some ideas, but can't really put work into it right atm, is > updating this urgent? If not, what's your time frame? I'd like to commit some changes in the next week or so and would be happy to continue making improvements in the future. On the other hand this isn't urgent by any sense of the word. -- Eitan Adler From owner-freebsd-doc@FreeBSD.ORG Wed Feb 15 03:57:31 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx2.freebsd.org (mx2.freebsd.org [IPv6:2001:4f8:fff6::35]) by hub.freebsd.org (Postfix) with ESMTP id E99831065679 for ; Wed, 15 Feb 2012 03:57:31 +0000 (UTC) (envelope-from dougb@FreeBSD.org) Received: from 172-17-150-251.globalsuite.net (hub.freebsd.org [IPv6:2001:4f8:fff6::36]) by mx2.freebsd.org (Postfix) with ESMTP id 2379814EC66; Wed, 15 Feb 2012 03:57:31 +0000 (UTC) Message-ID: <4F3B2D2A.9070406@FreeBSD.org> Date: Tue, 14 Feb 2012 19:57:30 -0800 From: Doug Barton Organization: http://SupersetSolutions.com/ User-Agent: Mozilla/5.0 (X11; FreeBSD i386; rv:10.0.1) Gecko/20120213 Thunderbird/10.0.1 MIME-Version: 1.0 To: Eitan Adler References: <4F3B2A7A.3030505@FreeBSD.org> In-Reply-To: X-Enigmail-Version: 1.3.5 OpenPGP: id=1A1ABC84 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 15 Feb 2012 03:57:32 -0000 On 02/14/2012 19:55, Eitan Adler wrote: > On Tue, Feb 14, 2012 at 10:46 PM, Doug Barton wrote: >> On 02/14/2012 19:36, Eitan Adler wrote: >>> What about the following? >> >> For my taste it's still a little too wordy .... In looking this over I >> have some ideas, but can't really put work into it right atm, is >> updating this urgent? If not, what's your time frame? > > I'd like to commit some changes in the next week or so Oh yeah, I'll definitely be able to get to it in the next few days. -- It's always a long day; 86400 doesn't fit into a short. Breadth of IT experience, and depth of knowledge in the DNS. Yours for the right price. :) http://SupersetSolutions.com/ From owner-freebsd-doc@FreeBSD.ORG Wed Feb 15 04:03:14 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 60F8C1065745 for ; Wed, 15 Feb 2012 04:03:14 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id 0C4D68FC1A for ; Wed, 15 Feb 2012 04:03:13 +0000 (UTC) Received: (qmail 98548 invoked by uid 0); 14 Feb 2012 23:03:13 -0500 Received: from unknown (HELO glenbarber.us) (76.124.49.145) by 0 with SMTP; 14 Feb 2012 23:03:13 -0500 Date: Tue, 14 Feb 2012 23:03:11 -0500 From: Glen Barber To: Eitan Adler Message-ID: <20120215040311.GB1862@glenbarber.us> References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Operating-System: FreeBSD 10.0-CURRENT amd64 User-Agent: Mutt/1.5.21 (2010-09-15) Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 15 Feb 2012 04:03:14 -0000 Off hand... On Tue, Feb 14, 2012 at 10:36:19PM -0500, Eitan Adler wrote: > What about the following? > > Index: chapter.sgml > =================================================================== > RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v > retrieving revision 1.251 > diff -u -r1.251 chapter.sgml > --- chapter.sgml 13 Feb 2012 04:28:35 -0000 1.251 > +++ chapter.sgml 15 Feb 2012 03:34:17 -0000 > @@ -473,13 +473,14 @@ > certain times. > > The cron utility uses two different > - types of configuration files, the system crontab and user crontabs. The > - only difference between these two formats is the sixth field. In the > - system crontab, the sixth field is the name of a user for the command > - to run as. This gives the system crontab the ability to run commands > - as any user. In a user crontab, the sixth field is the command to run, > - and all commands run as the user who created the crontab; this is an > - important security feature. > + types of configuration files, the system crontab and user crontabs. > + These formats only differ in the sixth field and later. In the > + system crontab, cron will run the command as the user > + specified in the sixth field. In a user crontab, all commands run as ^^^^^ Please use 2 spaces between sentences. > + the user who created the crontab, so the sixth field is the last field; > + this is an important security feature. The final field is always > + the command to run. > + > s should be on the same line as the ending sentence. > > User crontabs allow individual users to schedule tasks without the > @@ -487,10 +488,10 @@ > permissions of the user who owns the crontab. > > The root user can have a user > crontab just like > - any other user. This one is different from > - /etc/crontab (the system crontab). Because of the > - system crontab, there is usually no need to create a user crontab > - for root. > + any other user. root's crontab is I'd prefer "The root user crontab .... here. > + distinct from /etc/crontab (the system crontab). > + Because of the system crontab, there is usually no need to > + create a user crontab for root. "Because of the system crontab" is something I'm not fond of. I'd prefer "Since the system crontab effectively invokes the specified commands as root..." or something. Not a nit directly about your patch; I wasn't fond of the original version. > > > Let us take a look at the /etc/crontab file > @@ -547,11 +548,8 @@ > day of the week. All these fields must be numeric values, and follow > the twenty-four hour clock. The who field is special, > and only exists in the /etc/crontab file. > - This field specifies which user the command should be run as. > - When a user installs his or her crontab file, they > - will not have this option. Finally, the command > option is listed. >> - This is the last field, so naturally it should designate the command > - to be executed. > + This field specifies which user the command should be run > + as. The last field is the command to be executed. Grammar nit: What do you think about "This field specifies the user root under which the command should run." ? > > > > @@ -584,13 +582,14 @@ > Installing a Crontab > > > - You must not use the procedure described here to > - edit/install the system crontab. Simply use your favorite > - editor: the cron utility will notice that the file > - has changed and immediately begin using the updated version. > - See > - > - this FAQ entry for more information. > + Do not use the procedure described here to > + edit and install the system crontab, > + /etc/crontab. Simply use your favorite > + editor: the cron utility will notice that the file > + has changed and immediately begin using the updated version. > + See > + > + this FAQ entry for more information. > I don't see any content changes here outside of the first two lines of the . > > To install a freshly written user > @@ -613,8 +612,7 @@ > without the use of a template, the crontab -e > option is available. This will invoke the selected editor > with an empty file. When the file is saved, it will be > - automatically installed by the crontab command. > - > + automatically installed by the crontab command. Personal nit: I'd prefer using "&man.crontab.8;" over "crontab command." > > If you later want to remove your user crontab > completely, use crontab with the > @@ -636,7 +634,7 @@ > > > > - Using rc under &os; > + Using <literal>rc</literal> Under &os; > > In 2002 &os; integrated the NetBSD > rc.d system for system initialization. > @@ -1674,7 +1672,7 @@ > > > > - Tuning with sysctl > + Tuning with <command>sysctl</command> > > sysctl > > @@ -1944,7 +1942,7 @@ > out of space and the update to fail. > > > - More Details about Soft Updates > + More Details About Soft Updates > > > Soft Updates > @@ -2390,15 +2388,36 @@ > of the Handbook. > > > - Swap on a New Hard Drive > + Swap on a New or Existing Hard Drive > > - The best way to add swap, of course, is to use this as an > - excuse to add another hard drive. You can always use another > - hard drive, after all. If you can do this, go reread the > - discussion of swap space > - in > - of the Handbook for some suggestions on how to best > - arrange your swap. > + Adding a new hard drive for swap gives better performance > + than adding a partition on an existing drive. Setting up > + partitions and hard drives is explained in > + . > + discusses partition layouts and swap partition size considerations. > + > + Use &man.swapon.8; to add a swap partition to the system. > For example: > + > + &prompt.root; > swapon/dev/ada1s1p2 > + > + > + It is possible to use any partition not currently mounted, even > + if it already contains data. Using &man.swapon.8; on a partition that > + contains data will overwrite and destroy that data. > + Make sure that the partition to be added as swap > + is really the intended partition before running > + swapon. > + > + > + To automatically add this swap partition on boot, > + add an entry to /etc/fstab for the > + partition: > + > + /dev/ada1s1p1 none swap sw 0 0 > + > + &man.fstab.5; explains the meaning of the entries and > + their format in > + /etc/fstab. > > > > @@ -2739,7 +2758,7 @@ > > An ACPI-compliant system has various > components. The BIOS and chipset vendors > - provide various fixed tables (e.g., FADT) > + provide various fixed tables (e.g., FADT) The space between the comma and opening tag is not necessary. It also makes things more difficult for translators to find what changed. > in memory that specify things like the APIC > map (used for SMP), config registers, and > simple configuration values. Additionally, a table of bytecode > @@ -2878,7 +2897,7 @@ > on Linux, it is likely a &os; driver problem and narrowing down > which driver causes the problems will help us fix the problem. > Note that the ACPI maintainers do not > - usually maintain other drivers (e.g sound, > + usually maintain other drivers (e.g., sound, > ATA, etc.) so any work done on tracking > down a driver problem should probably eventually be posted > to the &a.current.name; list and mailed to the driver > @@ -2898,7 +2917,7 @@ > > > > - System Hangs (temporary or permanent) > + System Hangs (Temporary or Permanent) > > Most system hangs are a result of lost interrupts or an > interrupt storm. Chipsets have a lot of problems based on how > @@ -3058,7 +3077,7 @@ > how to fix them: > > > - _OS dependencies > + _OS Dependencies > > Some AML assumes the world consists of > various &windows; versions. You can tell &os; to claim it is > @@ -3070,7 +3089,7 @@ > > > > - Missing Return statements > + Missing Return Statements > > Some methods do not explicitly return a value as the > standard requires. While ACPI-CA > @@ -3112,8 +3131,7 @@ > > > > - Getting Debugging Output From > - <acronym>ACPI</acronym> > + Getting Debugging Output from <acronym>ACPI</acronym> > > > ACPI > > Glen From owner-freebsd-doc@FreeBSD.ORG Wed Feb 15 04:12:01 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 6E4B8106566B for ; Wed, 15 Feb 2012 04:12:01 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id 117E28FC0A for ; Wed, 15 Feb 2012 04:12:00 +0000 (UTC) Received: (qmail 1541 invoked by uid 0); 14 Feb 2012 23:12:00 -0500 Received: from unknown (HELO glenbarber.us) (76.124.49.145) by 0 with SMTP; 14 Feb 2012 23:12:00 -0500 Date: Tue, 14 Feb 2012 23:11:58 -0500 From: Glen Barber To: Eitan Adler Message-ID: <20120215041158.GC1862@glenbarber.us> References: <20120215040311.GB1862@glenbarber.us> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20120215040311.GB1862@glenbarber.us> X-Operating-System: FreeBSD 10.0-CURRENT amd64 User-Agent: Mutt/1.5.21 (2010-09-15) Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 15 Feb 2012 04:12:01 -0000 On Tue, Feb 14, 2012 at 11:03:11PM -0500, Glen Barber wrote: > > @@ -547,11 +548,8 @@ > > day of the week. All these fields must be numeric values, and follow > > the twenty-four hour clock. The who field is special, > > and only exists in the /etc/crontab file. > > - This field specifies which user the command should be run as. > > - When a user installs his or her crontab file, they > > - will not have this option. Finally, the command > > option is listed. > >> - This is the last field, so naturally it should designate the command > > - to be executed. > > + This field specifies which user the command should be run > > + as. The last field is the command to be executed. > > Grammar nit: What do you think about "This field specifies the user > root under which the command should run." ? > Wording issue on my part. What I meant was: "This field specifies the user under which root should invoke the command." Glen From owner-freebsd-doc@FreeBSD.ORG Wed Feb 15 15:03:40 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 472681065670 for ; Wed, 15 Feb 2012 15:03:40 +0000 (UTC) (envelope-from "") Received: from mta8.tradekey.com (mta8.tradekey.com [69.16.197.6]) by mx1.freebsd.org (Postfix) with ESMTP id 120F18FC12 for ; Wed, 15 Feb 2012 15:03:39 +0000 (UTC) Received: by mta8.tradekey.com id h7f4km1252gb for ; Wed, 15 Feb 2012 14:37:41 +0000 (envelope-from <>) From: TradeKey.com To: freebsd-doc@freebsd.org Date: Wed, 15 Feb 2012 14:37:41 +0000 Message-Id: <20120215150340.472681065670@hub.freebsd.org> MIME-Version: 1.0 Content-Type: text/plain X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Subject: About your company X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: no-reply@tradekey.com List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 15 Feb 2012 15:03:40 -0000 TradeKey.com Your business details have been added on [1]TradeKey.com by your business friend. He would like you to join TradeKey.com and explore: - 6 million importers and exporters - Global buying and selling opportunity - Ways to promote your business locally and internationally - Free counsultancy for your business expansion [2]Verify Your Details Your business details will not be visible until you accept the invitation and create your account on TradeKey.com. Happy Trading, TradeKey.com Don't want to receive email notifications? [3]Unsubscribe Do you know anybody that might like Tradekey.com ? [4]Invite others to join Tradekey values your privacy. At no time has Tradekey made your email address available to any other without your permission. © 2011, Tradekey.com. [index.html?action=tracking_emailopen&eid=ZnJlZWJzZC1kb2NAZnJlZWJzZC5v cmc=&sdt=2012-02-15 02:02:05&utm_source=6031227&utm_medium=Email&utm_term=0&utm_content=0& utm_campaign=InviteContact&sb_code=7290591&follow_emails=1] References 1. http://www.tradekey.com/index.html?action=signup_step1&mclinkid=4941273&CI=1&pl=1&c_id=53WLYfjubkI%3D 2. http://www.tradekey.com/index.html?action=signup_step1&mclinkid=4941273&CI=1&pl=1&c_id=53WLYfjubkI%3D 3. http://www.tradekey.com/index.html?action=otherpages_invitationmember&var=c12Ra8yfZxaOOGUPwMU7v5dS1P5YutA0zJZ%2FIZ8ABy27zva%2Fufut8QGRQUdKtg%2FQEomtc2L20gg%3D 4. http://www.tradekey.com/index.html?action=contactsimporter_importer From owner-freebsd-doc@FreeBSD.ORG Wed Feb 15 15:24:48 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C8BBA1065677 for ; Wed, 15 Feb 2012 15:24:48 +0000 (UTC) (envelope-from "") Received: from mta6.tradekey.com (mta6.tradekey.com [69.16.196.131]) by mx1.freebsd.org (Postfix) with ESMTP id 9529A8FC0C for ; Wed, 15 Feb 2012 15:24:48 +0000 (UTC) Received: by mta6.tradekey.com id h7f7401252ge for ; Wed, 15 Feb 2012 14:37:00 +0000 (envelope-from <>) From: TradeKey.com To: doc@freebsd.org Date: Wed, 15 Feb 2012 14:37:01 +0000 Message-Id: <20120215152448.C8BBA1065677@hub.freebsd.org> MIME-Version: 1.0 Content-Type: text/plain X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: Subject: About your company X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: no-reply@tradekey.com List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 15 Feb 2012 15:24:48 -0000 TradeKey.com Your business details have been added on [1]TradeKey.com by your business friend. He would like you to join TradeKey.com and explore: - 6 million importers and exporters - Global buying and selling opportunity - Ways to promote your business locally and internationally - Free counsultancy for your business expansion [2]Verify Your Details Your business details will not be visible until you accept the invitation and create your account on TradeKey.com. Happy Trading, TradeKey.com Don't want to receive email notifications? [3]Unsubscribe Do you know anybody that might like Tradekey.com ? [4]Invite others to join Tradekey values your privacy. At no time has Tradekey made your email address available to any other without your permission. © 2011, Tradekey.com. [index.html?action=tracking_emailopen&eid=ZG9jQGZyZWVic2Qub3Jn&sdt=201 2-02-15 02:02:24&utm_source=6031227&utm_medium=Email&utm_term=0&utm_content=0& utm_campaign=InviteContact&sb_code=7291801&follow_emails=1] References 1. http://www.tradekey.com/index.html?action=signup_step1&mclinkid=4941273&CI=1&pl=1&c_id=2qyg4%2BUcpYw%3D 2. http://www.tradekey.com/index.html?action=signup_step1&mclinkid=4941273&CI=1&pl=1&c_id=2qyg4%2BUcpYw%3D 3. http://www.tradekey.com/index.html?action=otherpages_invitationmember&var=c12Ra8yfZxbZXsBzwqpKScsDL6ALVNZIcrcjuaAkL%2FaeQ1jGqr5v2F7%2B%2BsPIc3E3 4. http://www.tradekey.com/index.html?action=contactsimporter_importer From owner-freebsd-doc@FreeBSD.ORG Wed Feb 15 17:29:45 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 650EB1065675; Wed, 15 Feb 2012 17:29:45 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 21E7A8FC12; Wed, 15 Feb 2012 17:29:44 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q1FHThZw033411; Wed, 15 Feb 2012 10:29:43 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q1FHTgu7033408; Wed, 15 Feb 2012 10:29:42 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Wed, 15 Feb 2012 10:29:42 -0700 (MST) From: Warren Block To: Glen Barber In-Reply-To: <20120215041158.GC1862@glenbarber.us> Message-ID: References: <20120215040311.GB1862@glenbarber.us> <20120215041158.GC1862@glenbarber.us> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Wed, 15 Feb 2012 10:29:43 -0700 (MST) Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 15 Feb 2012 17:29:45 -0000 On Tue, 14 Feb 2012, Glen Barber wrote: > On Tue, Feb 14, 2012 at 11:03:11PM -0500, Glen Barber wrote: >>> @@ -547,11 +548,8 @@ >>> day of the week. All these fields must be numeric values, and follow >>> the twenty-four hour clock. The who field is special, >>> and only exists in the /etc/crontab file. >>> - This field specifies which user the command should be run as. >>> - When a user installs his or her crontab file, they >>> - will not have this option. Finally, the command >>> option is listed. >>>> - This is the last field, so naturally it should designate the command >>> - to be executed. >>> + This field specifies which user the command should be run >>> + as. The last field is the command to be executed. >> >> Grammar nit: What do you think about "This field specifies the user >> root under which the command should run." ? >> > > Wording issue on my part. What I meant was: "This field specifies the > user under which root should invoke the command." How about "user as which root will run the command." From owner-freebsd-doc@FreeBSD.ORG Wed Feb 15 17:31:41 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 7E3B9106566B for ; Wed, 15 Feb 2012 17:31:41 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id 2B2778FC14 for ; Wed, 15 Feb 2012 17:31:40 +0000 (UTC) Received: (qmail 74310 invoked by uid 0); 15 Feb 2012 12:31:40 -0500 Received: from unknown (HELO glenbarber.us) (75.146.225.65) by 0 with SMTP; 15 Feb 2012 12:31:40 -0500 Date: Wed, 15 Feb 2012 12:31:33 -0500 From: Glen Barber To: Warren Block Message-ID: <20120215173133.GA5203@glenbarber.us> References: <20120215040311.GB1862@glenbarber.us> <20120215041158.GC1862@glenbarber.us> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Operating-System: FreeBSD 10.0-CURRENT amd64 User-Agent: Mutt/1.5.21 (2010-09-15) Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 15 Feb 2012 17:31:41 -0000 On Wed, Feb 15, 2012 at 10:29:42AM -0700, Warren Block wrote: > On Tue, 14 Feb 2012, Glen Barber wrote: > > > On Tue, Feb 14, 2012 at 11:03:11PM -0500, Glen Barber wrote: > >>> @@ -547,11 +548,8 @@ > >>> day of the week. All these fields must be numeric values, and follow > >>> the twenty-four hour clock. The who field is special, > >>> and only exists in the /etc/crontab file. > >>> - This field specifies which user the command should be run as. > >>> - When a user installs his or her crontab file, they > >>> - will not have this option. Finally, the command > >>> option is listed. > >>>> - This is the last field, so naturally it should designate the command > >>> - to be executed. > >>> + This field specifies which user the command should be run > >>> + as. The last field is the command to be executed. > >> > >> Grammar nit: What do you think about "This field specifies the user > >> root under which the command should run." ? > >> > > > > Wording issue on my part. What I meant was: "This field specifies the > > user under which root should invoke the command." > > How about > > "user as which root will run the command." > Even better. Thanks! Glen From owner-freebsd-doc@FreeBSD.ORG Wed Feb 15 21:34:49 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D6835106564A for ; Wed, 15 Feb 2012 21:34:49 +0000 (UTC) (envelope-from perrin@apotheon.com) Received: from oproxy4-pub.bluehost.com (oproxy4.bluehost.com [IPv6:2605:dc00:100:2::a4]) by mx1.freebsd.org (Postfix) with SMTP id 73D738FC08 for ; Wed, 15 Feb 2012 21:34:49 +0000 (UTC) Received: (qmail 10937 invoked by uid 0); 15 Feb 2012 21:34:49 -0000 Received: from unknown (HELO box543.bluehost.com) (74.220.219.143) by cpoproxy1.bluehost.com with SMTP; 15 Feb 2012 21:34:49 -0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=apotheon.com; s=default; h=In-Reply-To:Content-Type:MIME-Version:References:Message-ID:Subject:To:From:Date; bh=GT8pFiO4wtkFOrISy74lSljYsv5j9al9oHWIn2KoqbU=; b=QsJN3vinzjQWpJTu5oVhHrX2kkdBr/cAzEgRagCAe0OP0Jmuu6sww2Xc0Nb6lYFvfmaa/S27IAVu16cyS70Suk8QoCFnvLXy+gx9g6vgY3NV+Hb5bH1ChzUUtTO4t0W4; Received: from c-24-8-180-234.hsd1.co.comcast.net ([24.8.180.234] helo=localhost) by box543.bluehost.com with esmtpsa (TLSv1:AES128-SHA:128) (Exim 4.76) (envelope-from ) id 1RxmUy-0005B6-HP for freebsd-doc@freebsd.org; Wed, 15 Feb 2012 14:34:48 -0700 Date: Wed, 15 Feb 2012 14:34:48 -0700 From: Chad Perrin To: freebsd-doc@freebsd.org Message-ID: <20120215213448.GA29817@hemlock.hydra> References: <20120215040311.GB1862@glenbarber.us> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20120215040311.GB1862@glenbarber.us> User-Agent: Mutt/1.5.21 (2010-09-15) X-Identified-User: {2737:box543.bluehost.com:apotheon:apotheon.com} {sentby:smtp auth 24.8.180.234 authed with perrin@apotheon.com} Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 15 Feb 2012 21:34:49 -0000 On Tue, Feb 14, 2012 at 11:03:11PM -0500, Glen Barber wrote: > On Tue, Feb 14, 2012 at 10:36:19PM -0500, Eitan Adler wrote: > > > > + Because of the system crontab, there is usually no need to > > + create a user crontab for root. > > "Because of the system crontab" is something I'm not fond of. I'd > prefer "Since the system crontab effectively invokes the specified > commands as root..." or something. Not a nit directly about your patch; > I wasn't fond of the original version. I'm not crazy about using a time-ordering term ("since") as a synonym for a term indicating causality ("because"). How about "Because the system crontab effectively invokes . . ." ? -- Chad Perrin [ original content licensed OWL: http://owl.apotheon.org ] From owner-freebsd-doc@FreeBSD.ORG Wed Feb 15 22:18:16 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3469D1065674 for ; Wed, 15 Feb 2012 22:18:16 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id D767C8FC18 for ; Wed, 15 Feb 2012 22:18:15 +0000 (UTC) Received: (qmail 67760 invoked by uid 0); 15 Feb 2012 17:18:15 -0500 Received: from unknown (HELO glenbarber.us) (75.146.225.65) by 0 with SMTP; 15 Feb 2012 17:18:15 -0500 Date: Wed, 15 Feb 2012 17:18:13 -0500 From: Glen Barber To: Chad Perrin Message-ID: <20120215221813.GB5203@glenbarber.us> References: <20120215040311.GB1862@glenbarber.us> <20120215213448.GA29817@hemlock.hydra> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20120215213448.GA29817@hemlock.hydra> X-Operating-System: FreeBSD 10.0-CURRENT amd64 User-Agent: Mutt/1.5.21 (2010-09-15) Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 15 Feb 2012 22:18:16 -0000 On Wed, Feb 15, 2012 at 02:34:48PM -0700, Chad Perrin wrote: > On Tue, Feb 14, 2012 at 11:03:11PM -0500, Glen Barber wrote: > > On Tue, Feb 14, 2012 at 10:36:19PM -0500, Eitan Adler wrote: > > > > > > + Because of the system crontab, there is usually no need to > > > + create a user crontab for root. > > > > "Because of the system crontab" is something I'm not fond of. I'd > > prefer "Since the system crontab effectively invokes the specified > > commands as root..." or something. Not a nit directly about your patch; > > I wasn't fond of the original version. > > I'm not crazy about using a time-ordering term ("since") as a synonym for > a term indicating causality ("because"). How about "Because the system > crontab effectively invokes . . ." ? > IMHO, it sounds better than the original version. Thanks. Glen From owner-freebsd-doc@FreeBSD.ORG Thu Feb 16 01:32:05 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BBC12106566C; Thu, 16 Feb 2012 01:32:05 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-wi0-f182.google.com (mail-wi0-f182.google.com [209.85.212.182]) by mx1.freebsd.org (Postfix) with ESMTP id 21F268FC14; Thu, 16 Feb 2012 01:32:03 +0000 (UTC) Received: by wibhn14 with SMTP id hn14so1408236wib.13 for ; Wed, 15 Feb 2012 17:32:03 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=QvNVJNLEKiPaGDSeGu/wn9rVT9BOoqf53yAPyGmc2v0=; b=Gy5f0T4gi+BKYkUBW778PU70N2lYE/ICoVAK4d8X/d1vzMVvjx2spAb5NhvHPBZcOV XgDoo6DMIqJ65ShlJC40xwirihtEdIj6FlT/ep3qUVJ7MYdxwkhJNkSh6Kj2qihQCxVa Dwm1iDQX0p6TPqIfPbreN/Ps2E78WULtiqc6s= Received: by 10.180.90.225 with SMTP id bz1mr12010748wib.5.1329355923242; Wed, 15 Feb 2012 17:32:03 -0800 (PST) MIME-Version: 1.0 Received: by 10.223.15.90 with HTTP; Wed, 15 Feb 2012 17:31:33 -0800 (PST) In-Reply-To: <20120215221813.GB5203@glenbarber.us> References: <20120215040311.GB1862@glenbarber.us> <20120215213448.GA29817@hemlock.hydra> <20120215221813.GB5203@glenbarber.us> From: Eitan Adler Date: Wed, 15 Feb 2012 20:31:33 -0500 Message-ID: To: Glen Barber Content-Type: text/plain; charset=UTF-8 X-Gm-Message-State: ALoCoQm4OalU5vgtw6lKYDfofHA5yKIDgJjJcinzFpEEYO490KTFDNe9UqLUwuTUcI4NtES0nzSm Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Feb 2012 01:32:05 -0000 Everyone, Thanks for the input. Here is the current version. Index: chapter.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v retrieving revision 1.251 diff -u -r1.251 chapter.sgml --- chapter.sgml 13 Feb 2012 04:28:35 -0000 1.251 +++ chapter.sgml 16 Feb 2012 01:29:21 -0000 @@ -473,13 +473,13 @@ certain times. The cron utility uses two different - types of configuration files, the system crontab and user crontabs. The - only difference between these two formats is the sixth field. In the - system crontab, the sixth field is the name of a user for the command - to run as. This gives the system crontab the ability to run commands - as any user. In a user crontab, the sixth field is the command to run, - and all commands run as the user who created the crontab; this is an - important security feature. + types of configuration files, the system crontab and user crontabs. + These formats only differ in the sixth field and later. In the + system crontab, cron will run the command as the user + specified in the sixth field. In a user crontab, all commands run as + the user who created the crontab, so the sixth field is the last field; + this is an important security feature. The final field is always + the command to run. User crontabs allow individual users to schedule tasks without the @@ -487,10 +487,11 @@ permissions of the user who owns the crontab. The root user can have a user crontab just like - any other user. This one is different from - /etc/crontab (the system crontab). Because of the - system crontab, there is usually no need to create a user crontab - for root. + any other user. The root user crontab is + distinct from /etc/crontab (the system crontab). + Because the system system crontab effectively invokes the + specified commands as root there is usually no need to + create a user crontab for root. Let us take a look at the /etc/crontab file @@ -547,11 +548,8 @@ day of the week. All these fields must be numeric values, and follow the twenty-four hour clock. The who field is special, and only exists in the /etc/crontab file. - This field specifies which user the command should be run as. - When a user installs his or her crontab file, they - will not have this option. Finally, the command option is listed. - This is the last field, so naturally it should designate the command - to be executed. + This field specifies which user the command should be run + as. The last field is the command to be executed. @@ -584,8 +582,9 @@ Installing a Crontab - You must not use the procedure described here to - edit/install the system crontab. Simply use your favorite + Do not use the procedure described here to + edit and install the system crontab, + /etc/crontab. Simply use your favorite editor: the cron utility will notice that the file has changed and immediately begin using the updated version. See @@ -596,7 +595,7 @@ To install a freshly written user crontab, first use your favorite editor to create a file in the proper format, and then use the - crontab utility. The most common usage + crontabman.crontab.8; utility. The most common usage is: &prompt.user; crontab crontab-file @@ -606,18 +605,17 @@ There is also an option to list installed crontab files: just pass the - option to crontab and look + option to crontabman.crontab.8; and look over the output. For users who wish to begin their own crontab file from scratch, without the use of a template, the crontab -e option is available. This will invoke the selected editor with an empty file. When the file is saved, it will be - automatically installed by the crontab command. - + automatically installed by the crontabman.crontab.8; command. If you later want to remove your user crontab - completely, use crontab with the + completely, use crontabman.crontab.8; with the option. @@ -636,7 +634,7 @@ - Using rc under &os; + Using <literal>rc</literal> Under &os; In 2002 &os; integrated the NetBSD rc.d system for system initialization. @@ -1674,7 +1672,7 @@ - Tuning with sysctl + Tuning with <command>sysctl</command> sysctl @@ -1944,7 +1942,7 @@ out of space and the update to fail. - More Details about Soft Updates + More Details About Soft Updates Soft Updates @@ -2390,15 +2388,36 @@ of the Handbook. - Swap on a New Hard Drive + Swap on a New or Existing Hard Drive - The best way to add swap, of course, is to use this as an - excuse to add another hard drive. You can always use another - hard drive, after all. If you can do this, go reread the - discussion of swap space - in - of the Handbook for some suggestions on how to best - arrange your swap. + Adding a new hard drive for swap gives better performance + than adding a partition on an existing drive. Setting up + partitions and hard drives is explained in + . + discusses partition layouts and swap partition size considerations. + + Use &man.swapon.8; to add a swap partition to the system. For example: + + &prompt.root; swapon/dev/ada1s1p2 + + + It is possible to use any partition not currently mounted, even + if it already contains data. Using &man.swapon.8; on a partition that + contains data will overwrite and destroy that data. + Make sure that the partition to be added as swap + is really the intended partition before running + swapon. + + + To automatically add this swap partition on boot, + add an entry to /etc/fstab for the + partition: + + /dev/ada1s1p1 none swap sw 0 0 + + &man.fstab.5; explains the meaning of the entries and + their format in + /etc/fstab. @@ -2878,7 +2897,7 @@ on Linux, it is likely a &os; driver problem and narrowing down which driver causes the problems will help us fix the problem. Note that the ACPI maintainers do not - usually maintain other drivers (e.g sound, + usually maintain other drivers (e.g., sound, ATA, etc.) so any work done on tracking down a driver problem should probably eventually be posted to the &a.current.name; list and mailed to the driver @@ -2898,7 +2917,7 @@ - System Hangs (temporary or permanent) + System Hangs (Temporary or Permanent) Most system hangs are a result of lost interrupts or an interrupt storm. Chipsets have a lot of problems based on how @@ -3058,7 +3077,7 @@ how to fix them: - _OS dependencies + _OS Dependencies Some AML assumes the world consists of various &windows; versions. You can tell &os; to claim it is @@ -3070,7 +3089,7 @@ - Missing Return statements + Missing Return Statements Some methods do not explicitly return a value as the standard requires. While ACPI-CA @@ -3112,8 +3131,7 @@ - Getting Debugging Output From - <acronym>ACPI</acronym> + Getting Debugging Output from <acronym>ACPI</acronym> ACPI Eitan Adler From owner-freebsd-doc@FreeBSD.ORG Thu Feb 16 01:53:06 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 976031065674 for ; Thu, 16 Feb 2012 01:53:06 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id 4AD8F8FC18 for ; Thu, 16 Feb 2012 01:53:06 +0000 (UTC) Received: (qmail 37729 invoked by uid 0); 15 Feb 2012 20:53:05 -0500 Received: from unknown (HELO glenbarber.us) (76.124.49.145) by 0 with SMTP; 15 Feb 2012 20:53:05 -0500 Date: Wed, 15 Feb 2012 20:53:00 -0500 From: Glen Barber To: Eitan Adler Message-ID: <20120216015300.GA1837@glenbarber.us> References: <20120215040311.GB1862@glenbarber.us> <20120215213448.GA29817@hemlock.hydra> <20120215221813.GB5203@glenbarber.us> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Operating-System: FreeBSD 10.0-CURRENT amd64 User-Agent: Mutt/1.5.21 (2010-09-15) Cc: freebsd-doc@FreeBSD.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Feb 2012 01:53:06 -0000 On Wed, Feb 15, 2012 at 08:31:33PM -0500, Eitan Adler wrote: > Everyone, > > Thanks for the input. > > Here is the current version. > > Index: chapter.sgml > =================================================================== > RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v > retrieving revision 1.251 > diff -u -r1.251 chapter.sgml > --- chapter.sgml 13 Feb 2012 04:28:35 -0000 1.251 > +++ chapter.sgml 16 Feb 2012 01:29:21 -0000 > @@ -473,13 +473,13 @@ > certain times. > > The cron utility uses two different > - types of configuration files, the system crontab and user crontabs. The > - only difference between these two formats is the sixth field. In the > - system crontab, the sixth field is the name of a user for the command > - to run as. This gives the system crontab the ability to run commands > - as any user. In a user crontab, the sixth field is the command to run, > - and all commands run as the user who created the crontab; this is an > - important security feature. > + types of configuration files, the system crontab and user crontabs. > + These formats only differ in the sixth field and later. In the > + system crontab, cron will run the command as the user > + specified in the sixth field. In a user crontab, all commands run as > + the user who created the crontab, so the sixth field is the last field; > + this is an important security feature. The final field is always > + the command to run. > > > User crontabs allow individual users to schedule tasks without the > @@ -487,10 +487,11 @@ > permissions of the user who owns the crontab. > > The root user can have a user > crontab just like > - any other user. This one is different from > - /etc/crontab (the system crontab). Because of the > - system crontab, there is usually no need to create a user crontab > - for root. > + any other user. The root user crontab is > + distinct from /etc/crontab (the system crontab). I don't understand this sentence. "Distinct" why/how? Maybe it would be better to just say "separate" here. > + Because the system system crontab effectively invokes the > + specified commands as root there is usually no need to > + create a user crontab for root. > > > Let us take a look at the /etc/crontab file > @@ -547,11 +548,8 @@ > day of the week. All these fields must be numeric values, and follow > the twenty-four hour clock. The who field is special, > and only exists in the /etc/crontab file. > - This field specifies which user the command should be run as. > - When a user installs his or her crontab file, they > - will not have this option. Finally, the command > option is listed. > - This is the last field, so naturally it should designate the command > - to be executed. > + This field specifies which user the command should be run > + as. The last field is the command to be executed. > > > > @@ -584,8 +582,9 @@ > Installing a Crontab > > > - You must not use the procedure described here to > - edit/install the system crontab. Simply use your favorite > + Do not use the procedure described here to > + edit and install the system crontab, > + /etc/crontab. Simply use your favorite > editor: the cron utility will notice that the file > has changed and immediately begin using the updated version. I would vote to reword this sentence. It's not part of the original reasons for the changes to this file, I agree, but "simply" is subjective. If it's so simple, why document it? Or, if it's so simple, why did I need to read about it in the handbook? > See > @@ -596,7 +595,7 @@ > To install a freshly written user > crontab, first use your favorite editor to create > a file in the proper format, and then use the > - crontab utility. The most common usage > + crontabman.crontab.8; utility. The most common usage What I meant here is replacing the '' tags entirely with &man.crontab.8;. However, it looks like I fat-fingered the mdoc entity reference; the crontab manual is in section 1, not section 8. > is: > > &prompt.user; crontab > crontab-file > @@ -606,18 +605,17 @@ > > There is also an option to list installed > crontab files: just pass the > - option to crontab and look > + option to > crontabman.crontab.8; and look I don't understand why this change was made. I think you replaced more references to crontab than I pointed to. > over the output. > > For users who wish to begin their own crontab file from scratch, > without the use of a template, the crontab -e > option is available. This will invoke the selected editor > with an empty file. When the file is saved, it will be > - automatically installed by the crontab command. > - > + automatically installed by the > crontabman.crontab.8; command. I don't understand why this change was made. I think you replaced more references to crontab than I pointed to. > > If you later want to remove your user crontab > - completely, use crontab with the > + completely, use crontabman.crontab.8; with the I don't understand why this change was made. I think you replaced more references to crontab than I pointed to. > > option. > > > @@ -636,7 +634,7 @@ > > > > - Using rc under &os; > + Using <literal>rc</literal> Under &os; > I'd replace "rc" with "&man.rc.8;" here. > In 2002 &os; integrated the NetBSD > rc.d system for system initialization. > @@ -1674,7 +1672,7 @@ > > > > - Tuning with sysctl > + Tuning with <command>sysctl</command> > I'd replace "sysctl" with "&man.sysctl.8;" here. > sysctl > > @@ -1944,7 +1942,7 @@ > out of space and the update to fail. > > > - More Details about Soft Updates > + More Details About Soft Updates > I'm not sure this "about" should be capitalized. I may be wrong, but I do not believe prepositions should be capitalized in titles like this unless they are the first word of the title. > > Soft Updates > @@ -2390,15 +2388,36 @@ > of the Handbook. > > > - Swap on a New Hard Drive > + Swap on a New or Existing Hard Drive > > - The best way to add swap, of course, is to use this as an > - excuse to add another hard drive. You can always use another > - hard drive, after all. If you can do this, go reread the > - discussion of swap space > - in > - of the Handbook for some suggestions on how to best > - arrange your swap. > + Adding a new hard drive for swap gives better performance > + than adding a partition on an existing drive. Setting up > + partitions and hard drives is explained in > + . > + discusses partition layouts and swap partition size considerations. > + > + Use &man.swapon.8; to add a swap partition to the system. > For example: > + > + &prompt.root; > swapon/dev/ada1s1p2 > + > + > + It is possible to use any partition not currently mounted, even > + if it already contains data. Using &man.swapon.8; on a partition that > + contains data will overwrite and destroy that data. > + Make sure that the partition to be added as swap > + is really the intended partition before running > + swapon. I'd replace the command tags with the mdoc macro for the swapon(8) manual here. > + > + > + To automatically add this swap partition on boot, > + add an entry to /etc/fstab for the > + partition: > + > + /dev/ada1s1p1 none swap sw 0 0 > + > + &man.fstab.5; explains the meaning of the entries and > + their format in > + /etc/fstab. > > > > @@ -2878,7 +2897,7 @@ > on Linux, it is likely a &os; driver problem and narrowing down > which driver causes the problems will help us fix the problem. > Note that the ACPI maintainers do not > - usually maintain other drivers (e.g sound, > + usually maintain other drivers (e.g., sound, > ATA, etc.) so any work done on tracking > down a driver problem should probably eventually be posted > to the &a.current.name; list and mailed to the driver > @@ -2898,7 +2917,7 @@ > > > > - System Hangs (temporary or permanent) > + System Hangs (Temporary or Permanent) > > Most system hangs are a result of lost interrupts or an > interrupt storm. Chipsets have a lot of problems based on how > @@ -3058,7 +3077,7 @@ > how to fix them: > > > - _OS dependencies > + _OS Dependencies > > Some AML assumes the world consists of > various &windows; versions. You can tell &os; to claim it is > @@ -3070,7 +3089,7 @@ > > > > - Missing Return statements > + Missing Return Statements > > Some methods do not explicitly return a value as the > standard requires. While ACPI-CA > @@ -3112,8 +3131,7 @@ > > > > - Getting Debugging Output From > - <acronym>ACPI</acronym> > + Getting Debugging Output from <acronym>ACPI</acronym> > > > ACPI > > > Glen From owner-freebsd-doc@FreeBSD.ORG Thu Feb 16 02:02:30 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 925801065672 for ; Thu, 16 Feb 2012 02:02:30 +0000 (UTC) (envelope-from perrin@apotheon.com) Received: from oproxy9.bluehost.com (oproxy9.bluehost.com [IPv6:2605:dc00:100:2::a2]) by mx1.freebsd.org (Postfix) with SMTP id 53FB48FC14 for ; Thu, 16 Feb 2012 02:02:30 +0000 (UTC) Received: (qmail 18060 invoked by uid 0); 16 Feb 2012 02:02:29 -0000 Received: from unknown (HELO box543.bluehost.com) (74.220.219.143) by oproxy9.bluehost.com with SMTP; 16 Feb 2012 02:02:29 -0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=apotheon.com; s=default; h=In-Reply-To:Content-Type:MIME-Version:References:Message-ID:Subject:To:From:Date; bh=Ko662ryZ4LtYcAQtdkt8NhWtrMwAmgKGahPmr5j75/A=; b=nUSrRKzIl6aarckWIsDSyNrZYRajk9XKitlHHF7g837eEUnJo+lJePaFW4RJbtTtKTvWVjXfuDHPZnV6Qt4wjNKBViQnwF2C8TD4SIHulqw/PNboYNzRd4eldydmyJSi; Received: from c-24-8-180-234.hsd1.co.comcast.net ([24.8.180.234] helo=localhost) by box543.bluehost.com with esmtpsa (TLSv1:AES128-SHA:128) (Exim 4.76) (envelope-from ) id 1Rxqg1-0004PS-21 for freebsd-doc@freebsd.org; Wed, 15 Feb 2012 19:02:29 -0700 Date: Wed, 15 Feb 2012 19:02:28 -0700 From: Chad Perrin To: freebsd-doc@freebsd.org Message-ID: <20120216020228.GA1094@hemlock.hydra> References: <20120215040311.GB1862@glenbarber.us> <20120215213448.GA29817@hemlock.hydra> <20120215221813.GB5203@glenbarber.us> <20120216015300.GA1837@glenbarber.us> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20120216015300.GA1837@glenbarber.us> User-Agent: Mutt/1.5.21 (2010-09-15) X-Identified-User: {2737:box543.bluehost.com:apotheon:apotheon.com} {sentby:smtp auth 24.8.180.234 authed with perrin@apotheon.com} Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Feb 2012 02:02:30 -0000 On Wed, Feb 15, 2012 at 08:53:00PM -0500, Glen Barber wrote: > On Wed, Feb 15, 2012 at 08:31:33PM -0500, Eitan Adler wrote: > > > > sysctl > > > > @@ -1944,7 +1942,7 @@ > > out of space and the update to fail. > > > > > > - More Details about Soft Updates > > + More Details About Soft Updates > > I'm not sure this "about" should be capitalized. I may be wrong, but I > do not believe prepositions should be capitalized in titles like this > unless they are the first word of the title. Different capitalization standards for titles apply in different contexts. Some prefer "Only the first letter capitalized" while other prefer "Every Single Word Is Capitalized" and still others prefer variations between the two. There are even cases where sentence punctuation is the "standard". I don't know what's most appropriate in this case. -- Chad Perrin [ original content licensed OWL: http://owl.apotheon.org ] From owner-freebsd-doc@FreeBSD.ORG Thu Feb 16 02:23:45 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 36D2F1065741 for ; Thu, 16 Feb 2012 02:23:45 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id F09FA8FC0C for ; Thu, 16 Feb 2012 02:23:44 +0000 (UTC) Received: (qmail 47666 invoked by uid 0); 15 Feb 2012 21:23:44 -0500 Received: from unknown (HELO glenbarber.us) (76.124.49.145) by 0 with SMTP; 15 Feb 2012 21:23:44 -0500 Date: Wed, 15 Feb 2012 21:23:42 -0500 From: Glen Barber To: Chad Perrin Message-ID: <20120216022342.GC1837@glenbarber.us> References: <20120215040311.GB1862@glenbarber.us> <20120215213448.GA29817@hemlock.hydra> <20120215221813.GB5203@glenbarber.us> <20120216015300.GA1837@glenbarber.us> <20120216020228.GA1094@hemlock.hydra> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20120216020228.GA1094@hemlock.hydra> X-Operating-System: FreeBSD 10.0-CURRENT amd64 User-Agent: Mutt/1.5.21 (2010-09-15) Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Feb 2012 02:23:45 -0000 On Wed, Feb 15, 2012 at 07:02:28PM -0700, Chad Perrin wrote: > On Wed, Feb 15, 2012 at 08:53:00PM -0500, Glen Barber wrote: > > On Wed, Feb 15, 2012 at 08:31:33PM -0500, Eitan Adler wrote: > > > > > > sysctl > > > > > > @@ -1944,7 +1942,7 @@ > > > out of space and the update to fail. > > > > > > > > > - More Details about Soft Updates > > > + More Details About Soft Updates > > > > I'm not sure this "about" should be capitalized. I may be wrong, but I > > do not believe prepositions should be capitalized in titles like this > > unless they are the first word of the title. > > Different capitalization standards for titles apply in different > contexts. Some prefer "Only the first letter capitalized" while other > prefer "Every Single Word Is Capitalized" and still others prefer > variations between the two. There are even cases where sentence > punctuation is the "standard". I don't know what's most appropriate in > this case. > The FDP Primer suggests there should be full capitalization within tags: http://www.freebsd.org/doc/en/books/fdp-primer/examples.html#AEN3621 However the example does not contain words such as "a", "an", "the", "about", etc. As the FreeBSD Handbook is occasionally printed for hard-copy distribution, I am inclined to think the paradigm should accordingly, for example, after an admittedly short search, the "Title Case", mentioned here: http://grammar.about.com/od/grammarfaq/f/capitalstitle.htm Glen From owner-freebsd-doc@FreeBSD.ORG Thu Feb 16 03:24:55 2012 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 06A451065672; Thu, 16 Feb 2012 03:24:55 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id B51298FC16; Thu, 16 Feb 2012 03:24:54 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q1G3Oq4p039118; Wed, 15 Feb 2012 20:24:52 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q1G3OqVs039115; Wed, 15 Feb 2012 20:24:52 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Wed, 15 Feb 2012 20:24:52 -0700 (MST) From: Warren Block <wblock@wonkity.com> To: Glen Barber <gjb@freebsd.org> In-Reply-To: <20120216015300.GA1837@glenbarber.us> Message-ID: <alpine.BSF.2.00.1202152008360.38645@wonkity.com> References: <CAF6rxgnvyoibFt7ijm6GpWoeF-eAOLu3SgvhEGCBDUAV4grybw@mail.gmail.com> <alpine.GSO.1.10.1202120028440.882@multics.mit.edu> <CAF6rxgmPyVXSFRJiOZZaJQFObhCsZMHS5_5UneVrb3t=wznMhA@mail.gmail.com> <20120215040311.GB1862@glenbarber.us> <20120215213448.GA29817@hemlock.hydra> <20120215221813.GB5203@glenbarber.us> <CAF6rxgkY21MMfUWRMRnvWsTGC_2QspnfWqCKrFc_QDedTQMOoQ@mail.gmail.com> <20120216015300.GA1837@glenbarber.us> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Wed, 15 Feb 2012 20:24:52 -0700 (MST) Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Thu, 16 Feb 2012 03:24:55 -0000 On Wed, 15 Feb 2012, Glen Barber wrote: >> <para>User crontabs allow individual users to schedule tasks without the >> @@ -487,10 +487,11 @@ >> permissions of the user who owns the crontab.</para> >> >> <para>The <username>root</username> user can have a user >> crontab just like >> - any other user. This one is different from >> - <filename>/etc/crontab</filename> (the system crontab). Because of the >> - system crontab, there is usually no need to create a user crontab >> - for <username>root</username>.</para> >> + any other user. The <username>root</username> user crontab is >> + distinct from <filename>/etc/crontab</filename> (the system crontab). > > I don't understand this sentence. "Distinct" why/how? Maybe it would > be better to just say "separate" here. Distinct was my word, trying to point out that /etc/crontab is *not* root's crontab. ... >> @@ -1944,7 +1942,7 @@ >> out of space and the update to fail.</para> >> >> <sect3> >> - <title>More Details about Soft Updates >> + More Details About Soft Updates >> > > I'm not sure this "about" should be capitalized. I may be wrong, but I > do not believe prepositions should be capitalized in titles like this > unless they are the first word of the title. Or, in AP style, if they are longer than four letters. From owner-freebsd-doc@FreeBSD.ORG Thu Feb 16 03:35:27 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D5387106566C for ; Thu, 16 Feb 2012 03:35:27 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id 7F65C8FC0A for ; Thu, 16 Feb 2012 03:35:27 +0000 (UTC) Received: (qmail 70468 invoked by uid 0); 15 Feb 2012 22:35:26 -0500 Received: from unknown (HELO glenbarber.us) (76.124.49.145) by 0 with SMTP; 15 Feb 2012 22:35:26 -0500 Date: Wed, 15 Feb 2012 22:35:25 -0500 From: Glen Barber To: Warren Block Message-ID: <20120216033525.GD1837@glenbarber.us> References: <20120215040311.GB1862@glenbarber.us> <20120215213448.GA29817@hemlock.hydra> <20120215221813.GB5203@glenbarber.us> <20120216015300.GA1837@glenbarber.us> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Operating-System: FreeBSD 10.0-CURRENT amd64 User-Agent: Mutt/1.5.21 (2010-09-15) Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Feb 2012 03:35:27 -0000 On Wed, Feb 15, 2012 at 08:24:52PM -0700, Warren Block wrote: > > I'm not sure this "about" should be capitalized. I may be wrong, but I > > do not believe prepositions should be capitalized in titles like this > > unless they are the first word of the title. > > Or, in AP style, if they are longer than four letters. Yes, that's what I was looking for, but my Google-fu failed. I seem to recall that prepositions, even if exceeding four letters, are still not capitalized in AP. I'm happy to be wrong though. Glen From owner-freebsd-doc@FreeBSD.ORG Thu Feb 16 03:40:29 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 850CF106564A; Thu, 16 Feb 2012 03:40:29 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 3E9218FC0C; Thu, 16 Feb 2012 03:40:29 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q1G3eSSn039241; Wed, 15 Feb 2012 20:40:28 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q1G3eSYd039238; Wed, 15 Feb 2012 20:40:28 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Wed, 15 Feb 2012 20:40:28 -0700 (MST) From: Warren Block To: Glen Barber In-Reply-To: <20120216033525.GD1837@glenbarber.us> Message-ID: References: <20120215040311.GB1862@glenbarber.us> <20120215213448.GA29817@hemlock.hydra> <20120215221813.GB5203@glenbarber.us> <20120216015300.GA1837@glenbarber.us> <20120216033525.GD1837@glenbarber.us> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Wed, 15 Feb 2012 20:40:28 -0700 (MST) Cc: freebsd-doc@FreeBSD.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Feb 2012 03:40:29 -0000 On Wed, 15 Feb 2012, Glen Barber wrote: > On Wed, Feb 15, 2012 at 08:24:52PM -0700, Warren Block wrote: >>> I'm not sure this "about" should be capitalized. I may be wrong, but I >>> do not believe prepositions should be capitalized in titles like this >>> unless they are the first word of the title. >> >> Or, in AP style, if they are longer than four letters. > > Yes, that's what I was looking for, but my Google-fu failed. I seem to > recall that prepositions, even if exceeding four letters, are still not > capitalized in AP. I'm happy to be wrong though. There's some reference to the various styles here: http://grammar.quickanddirtytips.com/capitalizing-titles.aspx igor kind of checks for AP title capitalization style, for no better reason than it seemed not too hard to program the basic rules. From owner-freebsd-doc@FreeBSD.ORG Thu Feb 16 04:26:15 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B86D2106566B; Thu, 16 Feb 2012 04:26:15 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-ww0-f50.google.com (mail-ww0-f50.google.com [74.125.82.50]) by mx1.freebsd.org (Postfix) with ESMTP id 1D1AA8FC08; Thu, 16 Feb 2012 04:26:14 +0000 (UTC) Received: by wgbdq11 with SMTP id dq11so1571881wgb.31 for ; Wed, 15 Feb 2012 20:26:14 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=FHpF1Mkg8ke0xfuK44qEPK+etGjo6I3Z7QNTLXXW7PA=; b=kD2m/e1PsZI5MdN8YYAUUZRaSwWDIGCW/mbW4m2t/EzfmgsbAzDLaLDMRFli8JwHZI oOt2IVoWhBMux8xpSqMJlbPlxFgujw7TITcfm5qhamUsC6UnovZ/whRk3I1KFBhgqCYO EiBoDvvu5UjFVS/ZqKz0W2NorEE9XluxcxQ+E= Received: by 10.180.107.99 with SMTP id hb3mr1540540wib.5.1329366374209; Wed, 15 Feb 2012 20:26:14 -0800 (PST) MIME-Version: 1.0 Received: by 10.223.15.90 with HTTP; Wed, 15 Feb 2012 20:25:44 -0800 (PST) In-Reply-To: References: <20120215040311.GB1862@glenbarber.us> <20120215213448.GA29817@hemlock.hydra> <20120215221813.GB5203@glenbarber.us> <20120216015300.GA1837@glenbarber.us> <20120216033525.GD1837@glenbarber.us> From: Eitan Adler Date: Wed, 15 Feb 2012 23:25:44 -0500 Message-ID: To: Warren Block Content-Type: text/plain; charset=UTF-8 X-Gm-Message-State: ALoCoQnQqsYAaeX/DH4aFKW7u7rKOHWViv9QMJOYYmxtndRuskGKJirVPM/yisGTcUSZYiSXjB8x Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Feb 2012 04:26:15 -0000 I'm sorry about that last patch. This one should be better. Index: config/chapter.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v retrieving revision 1.251 diff -u -r1.251 chapter.sgml --- config/chapter.sgml 13 Feb 2012 04:28:35 -0000 1.251 +++ config/chapter.sgml 16 Feb 2012 04:24:13 -0000 @@ -473,13 +473,13 @@ certain times. The cron utility uses two different - types of configuration files, the system crontab and user crontabs. The - only difference between these two formats is the sixth field. In the - system crontab, the sixth field is the name of a user for the command - to run as. This gives the system crontab the ability to run commands - as any user. In a user crontab, the sixth field is the command to run, - and all commands run as the user who created the crontab; this is an - important security feature. + types of configuration files, the system crontab and user crontabs. + These formats only differ in the sixth field and later. In the + system crontab, cron will run the command as the user + specified in the sixth field. In a user crontab, all commands run as + the user who created the crontab, so the sixth field is the last field; + this is an important security feature. The final field is always + the command to run. User crontabs allow individual users to schedule tasks without the @@ -487,10 +487,11 @@ permissions of the user who owns the crontab. The root user can have a user crontab just like - any other user. This one is different from - /etc/crontab (the system crontab). Because of the - system crontab, there is usually no need to create a user crontab - for root. + any other user. The root user crontab is + separate from /etc/crontab (the system crontab). + Because the system system crontab effectively invokes the + specified commands as root there is usually no need to + create a user crontab for root. Let us take a look at the /etc/crontab file @@ -547,11 +548,8 @@ day of the week. All these fields must be numeric values, and follow the twenty-four hour clock. The who field is special, and only exists in the /etc/crontab file. - This field specifies which user the command should be run as. - When a user installs his or her crontab file, they - will not have this option. Finally, the command option is listed. - This is the last field, so naturally it should designate the command - to be executed. + This field specifies which user the command should be run + as. The last field is the command to be executed. @@ -584,8 +582,9 @@ Installing a Crontab - You must not use the procedure described here to - edit/install the system crontab. Simply use your favorite + Do not use the procedure described here to + edit and install the system crontab, + /etc/crontab. Just use your favorite editor: the cron utility will notice that the file has changed and immediately begin using the updated version. See @@ -596,7 +595,7 @@ To install a freshly written user crontab, first use your favorite editor to create a file in the proper format, and then use the - crontab utility. The most common usage + &man.crontab.1; utility. The most common usage is: &prompt.user; crontab crontab-file @@ -613,8 +612,7 @@ without the use of a template, the crontab -e option is available. This will invoke the selected editor with an empty file. When the file is saved, it will be - automatically installed by the crontab command. - + automatically installed by the crontab command. If you later want to remove your user crontab completely, use crontab with the @@ -636,7 +634,7 @@ - Using rc under &os; + Using &man.rc.8; Under &os; In 2002 &os; integrated the NetBSD rc.d system for system initialization. @@ -1674,7 +1672,7 @@ - Tuning with sysctl + Tuning with &man.sysctl.8; sysctl @@ -1944,7 +1942,7 @@ out of space and the update to fail. - More Details about Soft Updates + More Details About Soft Updates Soft Updates @@ -2390,15 +2388,36 @@ of the Handbook. - Swap on a New Hard Drive + Swap on a New or Existing Hard Drive - The best way to add swap, of course, is to use this as an - excuse to add another hard drive. You can always use another - hard drive, after all. If you can do this, go reread the - discussion of swap space - in - of the Handbook for some suggestions on how to best - arrange your swap. + Adding a new hard drive for swap gives better performance + than adding a partition on an existing drive. Setting up + partitions and hard drives is explained in + . + discusses partition layouts and swap partition size considerations. + + Use &man.swapon.8; to add a swap partition to the system. For example: + + &prompt.root; swapon/dev/ada1s1p2 + + + It is possible to use any partition not currently mounted, even + if it already contains data. Using &man.swapon.8; on a partition that + contains data will overwrite and destroy that data. + Make sure that the partition to be added as swap + is really the intended partition before running + &man.swapon.8;. + + + To automatically add this swap partition on boot, + add an entry to /etc/fstab for the + partition: + + /dev/ada1s1p1 none swap sw 0 0 + + &man.fstab.5; explains the meaning of the entries and + their format in + /etc/fstab. @@ -2878,7 +2897,7 @@ on Linux, it is likely a &os; driver problem and narrowing down which driver causes the problems will help us fix the problem. Note that the ACPI maintainers do not - usually maintain other drivers (e.g sound, + usually maintain other drivers (e.g., sound, ATA, etc.) so any work done on tracking down a driver problem should probably eventually be posted to the &a.current.name; list and mailed to the driver @@ -2898,7 +2917,7 @@ - System Hangs (temporary or permanent) + System Hangs (Temporary or Permanent) Most system hangs are a result of lost interrupts or an interrupt storm. Chipsets have a lot of problems based on how @@ -3058,7 +3077,7 @@ how to fix them: - _OS dependencies + _OS Dependencies Some AML assumes the world consists of various &windows; versions. You can tell &os; to claim it is @@ -3070,7 +3089,7 @@ - Missing Return statements + Missing Return Statements Some methods do not explicitly return a value as the standard requires. While ACPI-CA @@ -3112,8 +3131,7 @@ - Getting Debugging Output From - <acronym>ACPI</acronym> + Getting Debugging Output from <acronym>ACPI</acronym> ACPI -- Eitan Adler From owner-freebsd-doc@FreeBSD.ORG Thu Feb 16 07:45:45 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A14391065670 for ; Thu, 16 Feb 2012 07:45:45 +0000 (UTC) (envelope-from vabo@dccmail.ru) Received: from mx-g19.proxad.net (ivr94-10-88-177-171-234.fbx.proxad.net [88.177.171.234]) by mx1.freebsd.org (Postfix) with ESMTP id 228768FC15 for ; Thu, 16 Feb 2012 07:45:43 +0000 (UTC) Message-ID: <8836F291FA942D01A97E4FFA6276F04D@IVR94-10-88-177-171-234.FBX.PROXAD.NET> From: "=?utf-8?B?0JPQvtGB0LfQsNC60YPQv9C60Lg=?=" To: Date: Thu, 16 Feb 2012 11:45:42 +0300 MIME-Version: 1.0 X-Priority: 3 X-MSMail-Priority: Normal Importance: Normal X-Mailer: Microsoft Windows Live Mail 15.4.3538.513 X-MimeOLE: Produced By Microsoft MimeOLE V15.4.3538.513 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: Subject: =?utf-8?b?0JPQvtGB0LfQsNC60LDQtyDQvtCx0YPRh9C10L3QuNC1IDk0LdCk?= =?utf-8?b?0JcsINGN0LvQtdC60YLRgNC+0L3QvdGL0Lkg0LDRg9C60YbQuNC+0L0=?= X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Feb 2012 07:45:45 -0000 =D0=93=D0=9E=D0=A1=D0=A3=D0=94=D0=90=D0=A0=D0=A1=D0=A2=D0=92=D0=95=D0=9D=D0= =9D=D0=AB=D0=99 = (=D0=9C=D0=A3=D0=9D=D0=98=D0=A6=D0=98=D0=9F=D0=90=D0=9B=D0=AC=D0=9D=D0=AB= =D0=99) =D0=97=D0=90=D0=9A=D0=90=D0=97 2011-2012: =D0=9A=D0=9E=D0=9D=D0=9A=D0=A3=D0=A0=D0=A1, = =D0=AD=D0=9B=D0=95=D0=9A=D0=A2=D0=A0=D0=9E=D0=9D=D0=9D=D0=AB=D0=99 = =D0=90=D0=A3=D0=9A=D0=A6=D0=98=D0=9E=D0=9D, = =D0=9C=D0=95=D0=A2=D0=9E=D0=94=D0=AB = =D0=97=D0=90=D0=A9=D0=98=D0=A2=D0=AB = =D0=98=D0=9D=D0=A2=D0=95=D0=A0=D0=95=D0=A1=D0=9E=D0=92 =D1=81=D0=B5=D0=BC=D0=B8=D0=BD=D0=B0=D1=80 = =D0=BF=D1=80=D0=BE=D0=B2=D0=BE=D0=B4=D0=B8=D1=82=D1=81=D1=8F =D1=81 = =D1=83=D1=87=D0=B0=D1=81=D1=82=D0=B8=D0=B5=D0=BC = =D1=81=D0=BF=D0=B5=D1=86=D0=B8=D0=B0=D0=BB=D0=B8=D1=81=D1=82=D0=BE=D0=B2 = =D0=9C=D0=B8=D0=BD=D1=8D=D0=BA=D0=BE=D0=BD=D0=BE=D0=BC=D1=80=D0=B0=D0=B7=D0= =B2=D0=B8=D1=82=D0=B8=D1=8F =D0=B8 = =D0=A4=D0=B5=D0=B4=D0=B5=D1=80=D0=B0=D0=BB=D1=8C=D0=BD=D0=BE=D0=B9 =D0=B0=D0=BD=D1=82=D0=B8=D0=BC=D0=BE=D0=BD=D0=BE=D0=BF=D0=BE=D0=BB=D1=8C=D0= =BD=D0=BE=D0=B9 =D1=81=D0=BB=D1=83=D0=B6=D0=B1=D1=8B =D0=A0=D0=A4 =D0=9F=D1=80=D0=BE=D0=B2=D0=BE=D0=B4=D0=B8=D1=82=D1=81=D1=8F: 29 = =D1=84=D0=B5=D0=B2=D1=80=D0=B0=D0=BB=D1=8F =E2=80=93 01 = =D0=BC=D0=B0=D1=80=D1=82=D0=B0 =D0=B2 = =D0=9C=D0=BE=D1=81=D0=BA=D0=B2=D0=B5 =D0=A2=D0=B5=D0=BB=D0=B5=D1=84=D0=BE=D0=BD =D0=B4=D0=BB=D1=8F = =D0=B7=D0=B0=D0=BF=D0=B8=D1=81=D0=B8: 8(495)995 ..15 ..48 =D0=92 =D0=BF=D1=80=D0=BE=D0=B3=D1=80=D0=B0=D0=BC=D0=BC=D1=83 = =D0=BC=D0=B5=D1=80=D0=BE=D0=BF=D1=80=D0=B8=D1=8F=D1=82=D0=B8=D1=8F = =D0=B2=D0=BA=D0=BB=D1=8E=D1=87=D0=B5=D0=BD=D0=BE: 1. =D0=98=D0=B7=D0=BC=D0=B5=D0=BD=D0=B5=D0=BD=D0=B8=D1=8F =D0=B2 = =D0=B7=D0=B0=D0=BA=D0=BE=D0=BD=D0=BE=D0=B4=D0=B0=D1=82=D0=B5=D0=BB=D1=8C=D1= =81=D1=82=D0=B2=D0=B5 =D0=BE = =D1=80=D0=B0=D0=B7=D0=BC=D0=B5=D1=89=D0=B5=D0=BD=D0=B8=D0=B8 = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D0=BE=D0=B2 =D0=B4=D0=BB=D1=8F = =D0=B3=D0=BE=D1=81=D1=83=D0=B4=D0=B0=D1=80=D1=81=D1=82=D0=B2=D0=B5=D0=BD=D0= =BD=D1=8B=D1=85 =D0=B8 =D0=BC=D1=83=D0=BD=D0=B8=D1=86=D0=B8=D0=BF=D0=B0=D0=BB=D1=8C=D0=BD=D1=8B=D1= =85 =D0=BD=D1=83=D0=B6=D0=B4. = =D0=9E=D0=B1=D0=BE=D1=81=D0=BD=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D0=B5 = =D0=BD=D0=B0=D1=87=D0=B0=D0=BB=D1=8C=D0=BD=D0=BE=D0=B9 = =D0=BC=D0=B0=D0=BA=D1=81=D0=B8=D0=BC=D0=B0=D0=BB=D1=8C=D0=BD=D0=BE=D0=B9 = =D1=86=D0=B5=D0=BD=D1=8B = =D0=BA=D0=BE=D0=BD=D1=82=D1=80=D0=B0=D0=BA=D1=82=D0=B0 = (=D1=80=D0=B0=D1=81=D1=87=D0=B5=D1=82 =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D1=87=D0=B8=D0=BA=D0=B0, = =D1=81=D0=BC=D0=B5=D1=82=D0=BD=D1=8B=D0=B9 = =D1=80=D0=B0=D1=81=D1=87=D0=B5=D1=82, = =D0=BA=D0=B0=D0=BB=D1=8C=D0=BA=D1=83=D0=BB=D1=8F=D1=86=D0=B8=D1=8F, = =D0=BC=D0=BE=D0=BD=D0=B8=D1=82=D0=BE=D1=80=D0=B8=D0=BD=D0=B3 = =D1=81=D1=80=D0=B5=D0=B4=D0=BD=D0=B8=D1=85 =D1=86=D0=B5=D0=BD, = =D0=BE=D0=BF=D1=80=D0=BE=D1=81 =D1=86=D0=B5=D0=BD, = =D0=B2=D0=BD=D0=B5=D1=88=D0=BD=D0=B8=D0=B5 =D0=B8=D1=81=D1=82=D0=BE=D1=87=D0=BD=D0=B8=D0=BA=D0=B8 = =D0=B8=D0=BD=D1=84=D0=BE=D1=80=D0=BC=D0=B0=D1=86=D0=B8=D0=B8, =D0=B2 = =D1=82.=D1=87. =D0=B2 =D1=81=D0=B5=D1=82=D0=B8 = =D0=B8=D0=BD=D1=82=D0=B5=D1=80=D0=BD=D0=B5=D1=82). = =D0=9F=D1=80=D0=B0=D0=BA=D1=82=D0=B8=D1=87=D0=B5=D1=81=D0=BA=D0=B8=D0=B5 = =D1=80=D0=B5=D0=BA=D0=BE=D0=BC=D0=B5=D0=BD=D0=B4=D0=B0=D1=86=D0=B8=D0=B8 = (=D0=BF=D1=80=D0=B8=D0=BC=D0=B5=D1=80=D1=8B) =D0=BF=D0=BE =D0=BF=D0=BE=D1=80=D1=8F=D0=B4=D0=BA=D1=83 =D0=B5=D0=B5 = =D1=84=D0=BE=D1=80=D0=BC=D0=B8=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8F.= =D0=97=D0=B0=D0=B2=D1=8B=D1=88=D0=B5=D0=BD=D0=B8=D0=B5 = =D1=86=D0=B5=D0=BD=D1=8B = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D1=87=D0=B8=D0=BA=D0=BE=D0=BC. = =D0=A2=D1=80=D0=B5=D0=B1=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8F = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D1=87=D0=B8=D0=BA=D0=B0 =D0=BA =D0=BA=D0=BE=D0=BD=D0=BA=D1=80=D0=B5=D1=82=D0=BD=D1=8B=D0=BC = =D0=BF=D0=BE=D0=BA=D0=B0=D0=B7=D0=B0=D1=82=D0=B5=D0=BB=D1=8F=D0=BC = =D1=82=D0=BE=D0=B2=D0=B0=D1=80=D0=BE=D0=B2, = =D1=83=D0=BA=D0=B0=D0=B7=D0=B0=D0=BD=D0=B8=D0=B5 =D0=BD=D0=B0 = =D1=82=D0=BE=D0=B2=D0=B0=D1=80=D0=BD=D1=8B=D0=B9 = =D0=B7=D0=BD=D0=B0=D0=BA =D0=B8 = =D1=8D=D0=BA=D0=B2=D0=B8=D0=B2=D0=B0=D0=BB=D0=B5=D0=BD=D1=82=D0=BD=D0=BE=D1= =81=D1=82=D1=8C =D0=B2 =D1=81=D0=BE=D1=81=D1=82=D0=B0=D0=B2=D0=B5 = =D0=B0=D1=83=D0=BA=D1=86=D0=B8=D0=BE=D0=BD=D0=BD=D0=BE=D0=B9 = =D0=B4=D0=BE=D0=BA=D1=83=D0=BC=D0=B5=D0=BD=D1=82=D0=B0=D1=86=D0=B8=D0=B8.= =D0=9F=D0=BE=D0=B4=D0=B3=D0=BE=D1=82=D0=BE=D0=B2=D0=BA=D0=B0 = =D0=BF=D0=B5=D1=80=D0=B2=D1=8B=D1=85 = =D1=87=D0=B0=D1=81=D1=82=D0=B5=D0=B9 = =D0=B7=D0=B0=D1=8F=D0=B2=D0=BE=D0=BA =D1=81 = =D1=83=D1=87=D0=B5=D1=82=D0=BE=D0=BC = =D1=82=D1=80=D0=B5=D0=B1=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D0=B9 =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D1=87=D0=B8=D0=BA=D0=B0, = =D0=BE=D1=82=D0=BA=D0=BB=D0=BE=D0=BD=D0=B5=D0=BD=D0=B8=D0=B5 = =D0=B7=D0=B0=D1=8F=D0=B2=D0=BE=D0=BA. = =D0=9F=D1=80=D0=B0=D0=BA=D1=82=D0=B8=D0=BA=D0=B0 = =D0=BE=D0=B1=D0=B6=D0=B0=D0=BB=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D0=B9 = =D0=B4=D0=B5=D0=B9=D1=81=D1=82=D0=B2=D0=B8=D0=B9 = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D1=87=D0=B8=D0=BA=D0=B0. = =D0=9D=D0=BE=D0=B2=D1=8B=D0=B5 = =D0=BF=D1=80=D0=B0=D0=B2=D0=B8=D0=BB=D0=B0 =D0=BE=D0=B1=D0=B5=D1=81=D0=BF=D0=B5=D1=87=D0=B5=D0=BD=D0=B8=D1=8F = =D0=B8=D1=81=D0=BF=D0=BE=D0=BB=D0=BD=D0=B5=D0=BD=D0=B8=D1=8F = =D0=B3=D0=BE=D1=81=D1=83=D0=B4=D0=B0=D1=80=D1=81=D1=82=D0=B2=D0=B5=D0=BD=D0= =BD=D0=BE=D0=B3=D0=BE = (=D0=BC=D1=83=D0=BD=D0=B8=D1=86=D0=B8=D0=BF=D0=B0=D0=BB=D1=8C=D0=BD=D0=BE= =D0=B3=D0=BE) =D0=BA=D0=BE=D0=BD=D1=82=D0=B0=D0=BA=D1=82=D0=B0. = =D0=A2=D1=80=D0=B5=D0=B1=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8F =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D1=87=D0=B8=D0=BA=D0=B0 =D0=BA = =D0=BE=D0=B1=D1=8F=D0=B7=D0=B0=D1=82=D0=B5=D0=BB=D1=8C=D1=81=D1=82=D0=B2=D0= =B0=D0=BC =D0=BF=D0=BE = =D0=BA=D0=BE=D0=BD=D1=82=D1=80=D0=B0=D0=BA=D1=82=D1=83, = =D0=BA=D0=BE=D1=82=D0=BE=D1=80=D1=8B=D0=B5 = =D0=B4=D0=BE=D0=BB=D0=B6=D0=BD=D1=8B =D0=B1=D1=8B=D1=82=D1=8C = =D0=BE=D0=B1=D0=B5=D1=81=D0=BF=D0=B5=D1=87=D0=B5=D0=BD=D1=8B. = =D0=92=D0=BE=D0=B7=D0=BC=D0=BE=D0=B6=D0=BD=D0=BE=D1=81=D1=82=D1=8C =D0=BF=D0=BE=D1=81=D1=82=D0=B0=D0=B2=D0=BA=D0=B8 = =D1=82=D0=BE=D0=B2=D0=B0=D1=80=D0=BE=D0=B2 =D1=81 = =D1=83=D0=BB=D1=83=D1=87=D1=88=D0=B5=D0=BD=D0=BD=D1=8B=D0=BC=D0=B8 = =D1=85=D0=B0=D1=80=D0=B0=D0=BA=D1=82=D0=B5=D1=80=D0=B8=D1=81=D1=82=D0=B8=D0= =BA=D0=B0=D0=BC=D0=B8 =D0=B8 = =D0=BA=D0=B0=D1=87=D0=B5=D1=81=D1=82=D0=B2=D0=BE=D0=BC. = =D0=A2=D1=80=D0=B5=D0=B1=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8F =D0=BA =D0=B3=D0=B0=D1=80=D0=B0=D0=BD=D1=82=D0=B8=D0=B9=D0=BD=D0=BE=D0=BC=D1=83 = =D1=81=D1=80=D0=BE=D0=BA=D1=83 =D0=B8 = =D0=BE=D0=B1=D1=8A=D0=B5=D0=BC=D1=83 = =D0=B3=D0=B0=D1=80=D0=B0=D0=BD=D1=82=D0=B8=D0=B9 = =D0=BA=D0=B0=D1=87=D0=B5=D1=81=D1=82=D0=B2=D0=B0 = =D1=82=D0=BE=D0=B2=D0=B0=D1=80=D0=B0, = =D1=80=D0=B0=D0=B1=D0=BE=D1=82=D1=8B, =D1=83=D1=81=D0=BB=D1=83=D0=B3, = =D0=BA = =D1=82=D0=B5=D1=85=D0=BD=D0=B8=D1=87=D0=B5=D1=81=D0=BA=D0=BE=D0=BC=D1=83 =D0=BE=D0=B1=D1=81=D0=BB=D1=83=D0=B6=D0=B8=D0=B2=D0=B0=D0=BD=D0=B8=D1=8E,= =D0=BC=D0=BE=D0=BD=D1=82=D0=B0=D0=B6=D1=83 =D0=B8 = =D0=BD=D0=B0=D0=BB=D0=B0=D0=B4=D0=BA=D0=B5. = =D0=A1=D1=80=D0=BE=D0=BA=D0=B8 =D0=B8 = =D0=BE=D0=B1=D1=8A=D0=B5=D0=BC=D1=8B = =D0=B3=D0=B0=D1=80=D0=B0=D0=BD=D1=82=D0=B8=D0=B9. = =D0=9E=D0=B6=D0=B8=D0=B4=D0=B0=D0=B5=D0=BC=D1=8B=D0=B5 = =D0=B8=D0=B7=D0=BC=D0=B5=D0=BD=D0=B5=D0=BD=D0=B8=D1=8F =D0=B2 =D0=B7=D0=B0=D0=BA=D0=BE=D0=BD=D0=BE=D0=B4=D0=B0=D1=82=D0=B5=D0=BB=D1=8C=D1= =81=D1=82=D0=B2=D0=BE =D0=BE = =D0=B3=D0=BE=D1=81=D1=83=D0=B4=D0=B0=D1=80=D1=81=D1=82=D0=B2=D0=B5=D0=BD=D0= =BD=D1=8B=D1=85 =D0=B8 = =D0=BC=D1=83=D0=BD=D0=B8=D1=86=D0=B8=D0=BF=D0=B0=D0=BB=D1=8C=D0=BD=D1=8B=D1= =85 =D0=B7=D0=B0=D0=BA=D1=83=D0=BF=D0=BA=D0=B0=D1=85. = =D0=9A=D0=BE=D0=BD=D1=86=D0=B5=D0=BF=D1=86=D0=B8=D1=8F =D0=BF=D1=80=D0=BE=D0=B5=D0=BA=D1=82=D0=B0 = =D0=B7=D0=B0=D0=BA=D0=BE=D0=BD=D0=B0 "=D0=9E = =D1=84=D0=B5=D0=B4=D0=B5=D1=80=D0=B0=D0=BB=D1=8C=D0=BD=D0=BE=D0=B9 = =D0=BA=D0=BE=D0=BD=D1=82=D1=80=D0=B0=D0=BA=D1=82=D0=BD=D0=BE=D0=B9 = =D1=81=D0=B8=D1=81=D1=82=D0=B5=D0=BC=D0=B5". 2. =D0=9F=D1=80=D0=B0=D0=BA=D1=82=D0=B8=D0=BA=D0=B0 = =D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D0=B4=D0=B5=D0=BD=D0=B8=D1=8F = =D0=BE=D1=82=D0=BA=D1=80=D1=8B=D1=82=D1=8B=D1=85 = =D0=B0=D1=83=D0=BA=D1=86=D0=B8=D0=BE=D0=BD=D0=BE=D0=B2 =D0=B2 = =D1=8D=D0=BB=D0=B5=D0=BA=D1=82=D1=80=D0=BE=D0=BD=D0=BD=D0=BE=D0=B9 = =D1=84=D0=BE=D1=80=D0=BC=D0=B5 =D0=B2 = =D1=81=D0=BE=D0=BE=D1=82=D0=B2=D0=B5=D1=82=D1=81=D1=82=D0=B2=D0=B8=D0=B8 = =D1=81 =D0=A4=D0=97- 94. =D0=9E=D1=81=D0=BE=D0=B1=D0=B5=D0=BD=D0=BD=D0=BE=D1=81=D1=82=D0=B8 = =D1=80=D0=B0=D0=B7=D0=BC=D0=B5=D1=89=D0=B5=D0=BD=D0=B8=D1=8F = =D0=B3=D0=BE=D1=81=D1=83=D0=B4=D0=B0=D1=80=D1=81=D1=82=D0=B2=D0=B5=D0=BD=D0= =BD=D0=BE=D0=B3=D0=BE =D0=B8 = =D0=BC=D1=83=D0=BD=D0=B8=D1=86=D0=B8=D0=BF=D0=B0=D0=BB=D1=8C=D0=BD=D0=BE=D0= =B3=D0=BE =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D0=B0 = =D0=BF=D1=83=D1=82=D0=B5=D0=BC = =D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D0=B4=D0=B5=D0=BD=D0=B8=D1=8F =D1=8D=D0=BB=D0=B5=D0=BA=D1=82=D1=80=D0=BE=D0=BD=D0=BD=D0=BE=D0=B3=D0=BE = =D0=B0=D1=83=D0=BA=D1=86=D0=B8=D0=BE=D0=BD=D0=B0 =D0=BD=D0=B0 = =D1=8D=D0=BB=D0=B5=D0=BA=D1=82=D1=80=D0=BE=D0=BD=D0=BD=D1=8B=D1=85 = =D1=82=D0=BE=D1=80=D0=B3=D0=BE=D0=B2=D1=8B=D1=85 = =D0=BF=D0=BB=D0=BE=D1=89=D0=B0=D0=B4=D0=BA=D0=B0=D1=85 = (=D0=AD=D0=A2=D0=9F). =D0=9E=D0=B1=D0=B7=D0=BE=D1=80 = =D1=81=D1=83=D1=89=D0=B5=D1=81=D1=82=D0=B2=D1=83=D1=8E=D1=89=D0=B8=D1=85 =D1=8D=D0=BB=D0=B5=D0=BA=D1=82=D1=80=D0=BE=D0=BD=D0=BD=D1=8B=D1=85 = =D0=BF=D0=BB=D0=BE=D1=89=D0=B0=D0=B4=D0=BE=D0=BA. = =D0=9F=D0=B5=D1=80=D0=B5=D1=87=D0=B5=D0=BD=D1=8C = =D1=80=D0=B0=D0=B1=D0=BE=D1=82 =D0=B8 =D1=83=D1=81=D0=BB=D1=83=D0=B3, = =D0=BE=D0=B1=D1=8F=D0=B7=D0=B0=D1=82=D0=B5=D0=BB=D1=8C=D0=BD=D1=8B=D1=85 = =D0=BA =D0=B7=D0=B0=D0=BA=D1=83=D0=BF=D0=BA=D0=B5 = =D1=87=D0=B5=D1=80=D0=B5=D0=B7 = =D1=8D=D0=BB=D0=B5=D0=BA=D1=82=D1=80=D0=BE=D0=BD=D0=BD=D1=83=D1=8E =D1=84=D0=BE=D1=80=D0=BC=D1=83 = =D0=B0=D1=83=D0=BA=D1=86=D0=B8=D0=BE=D0=BD=D0=B0. = =D0=9E=D1=81=D0=BE=D0=B1=D0=B5=D0=BD=D0=BD=D0=BE=D1=81=D1=82=D0=B8 = =D1=8D=D0=BB=D0=B5=D0=BA=D1=82=D1=80=D0=BE=D0=BD=D0=BD=D0=BE=D0=B3=D0=BE = =D0=B4=D0=BE=D0=BA=D1=83=D0=BC=D0=B5=D0=BD=D1=82=D0=BE=D0=BE=D0=B1=D0=BE=D1= =80=D0=BE=D1=82=D0=B0. = =D0=A0=D0=B0=D0=B7=D1=80=D0=B0=D0=B1=D0=BE=D1=82=D0=BA=D0=B0 =D0=B8 = =D1=83=D1=82=D0=B2=D0=B5=D1=80=D0=B6=D0=B4=D0=B5=D0=BD=D0=B8=D0=B5 =D0=B0=D1=83=D0=BA=D1=86=D0=B8=D0=BE=D0=BD=D0=BD=D0=BE=D0=B9 = =D0=B4=D0=BE=D0=BA=D1=83=D0=BC=D0=B5=D0=BD=D1=82=D0=B0=D1=86=D0=B8=D0=B8,= =D0=BF=D0=BE=D0=B4=D0=B3=D0=BE=D1=82=D0=BE=D0=B2=D0=BA=D0=B0 = =D1=82=D0=B5=D1=85=D0=BD=D0=B8=D1=87=D0=B5=D1=81=D0=BA=D0=BE=D0=B9 = =D1=87=D0=B0=D1=81=D1=82=D0=B8. = =D0=A2=D0=B8=D0=BF=D0=B8=D1=87=D0=BD=D1=8B=D0=B5 = =D0=BE=D1=88=D0=B8=D0=B1=D0=BA=D0=B8 = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D1=87=D0=B8=D0=BA=D0=BE=D0=B2 = =D0=BF=D1=80=D0=B8 =D0=BF=D0=BE=D0=B4=D0=B3=D0=BE=D1=82=D0=BE=D0=B2=D0=BA=D0=B5 = =D0=B0=D1=83=D0=BA=D1=86=D0=B8=D0=BE=D0=BD=D0=BD=D0=BE=D0=B9 = =D0=B4=D0=BE=D0=BA=D1=83=D0=BC=D0=B5=D0=BD=D1=82=D0=B0=D1=86=D0=B8=D0=B8.= =D0=9F=D0=BE=D1=80=D1=8F=D0=B4=D0=BE=D0=BA = =D1=80=D0=B0=D0=B1=D0=BE=D1=82=D1=8B =D0=BD=D0=B0 = =D1=84=D0=B5=D0=B4=D0=B5=D1=80=D0=B0=D0=BB=D1=8C=D0=BD=D1=8B=D1=85 = =D1=8D=D0=BB=D0=B5=D0=BA=D1=82=D1=80=D0=BE=D0=BD=D0=BD=D1=8B=D1=85 =D1=82=D0=BE=D1=80=D0=B3=D0=BE=D0=B2=D1=8B=D1=85 = =D0=BF=D0=BB=D0=BE=D1=89=D0=B0=D0=B4=D0=BA=D0=B0=D1=85. = =D0=A0=D0=B0=D0=B7=D0=BC=D0=B5=D1=89=D0=B5=D0=BD=D0=B8=D0=B5 = =D0=B8=D0=BD=D1=84=D0=BE=D1=80=D0=BC=D0=B0=D1=86=D0=B8=D0=B8 = =D0=BD=D0=B0 = =D0=BE=D0=B1=D1=89=D0=B5=D1=80=D0=BE=D1=81=D1=81=D0=B8=D0=B9=D1=81=D0=BA=D0= =BE=D0=BC = =D0=BE=D1=84=D0=B8=D1=86=D0=B8=D0=B0=D0=BB=D1=8C=D0=BD=D0=BE=D0=BC = =D1=81=D0=B0=D0=B9=D1=82=D0=B5. =D0=A0=D0=B0=D0=B7=D0=BC=D0=B5=D1=80 =D0=B8 = =D0=BF=D0=BE=D1=80=D1=8F=D0=B4=D0=BE=D0=BA = =D0=BF=D1=80=D0=B5=D0=B4=D0=BE=D1=81=D1=82=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D0= =B8=D1=8F = =D0=BE=D0=B1=D0=B5=D1=81=D0=BF=D0=B5=D1=87=D0=B5=D0=BD=D0=B8=D0=B5 = =D0=B7=D0=B0=D1=8F=D0=B2=D0=BE=D0=BA, =D1=84=D0=BE=D1=80=D0=BC=D1=8B = =D0=B8 =D0=BF=D0=BE=D1=80=D1=8F=D0=B4=D0=BE=D0=BA = =D0=BF=D1=80=D0=B5=D0=B4=D0=BE=D1=81=D1=82=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D0= =B8=D1=8F =D0=BE=D0=B1=D0=B5=D1=81=D0=BF=D0=B5=D1=87=D0=B5=D0=BD=D0=B8=D1=8F = =D0=B3=D0=BE=D1=81=D1=83=D0=B4=D0=B0=D1=80=D1=81=D1=82=D0=B2=D0=B5=D0=BD=D0= =BD=D0=BE=D0=B3=D0=BE = (=D0=BC=D1=83=D0=BD=D0=B8=D1=86=D0=B8=D0=BF=D0=B0=D0=BB=D1=8C=D0=BD=D0=BE= =D0=B3=D0=BE) =D0=BA=D0=BE=D0=BD=D1=82=D1=80=D0=B0=D0=BA=D1=82=D0=B0. = =D0=9F=D0=BE=D1=80=D1=8F=D0=B4=D0=BE=D0=BA = =D0=BF=D0=BE=D0=B4=D0=B0=D1=87=D0=B8 = =D0=B7=D0=B0=D1=8F=D0=B2=D0=BE=D0=BA =D0=BF=D1=80=D0=B8 =D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D0=B4=D0=B5=D0=BD=D0=B8=D0=B8 = =D1=8D=D0=BB=D0=B5=D0=BA=D1=82=D1=80=D0=BE=D0=BD=D0=BD=D0=BE=D0=B3=D0=BE = =D0=B0=D1=83=D0=BA=D1=86=D0=B8=D0=BE=D0=BD=D0=B0. = =D0=9F=D0=BE=D1=80=D1=8F=D0=B4=D0=BE=D0=BA = =D1=80=D0=B0=D1=81=D1=81=D0=BC=D0=BE=D1=82=D1=80=D0=B5=D0=BD=D0=B8=D1=8F = =D0=B8 =D0=BE=D1=82=D0=BA=D0=BB=D0=BE=D0=BD=D0=B5=D0=BD=D0=B8=D1=8F = =D0=B0=D1=83=D0=BA=D1=86=D0=B8=D0=BE=D0=BD=D0=BD=D0=BE=D0=B9 =D0=BA=D0=BE=D0=BC=D0=B8=D1=81=D1=81=D0=B8=D0=B5=D0=B9 = =D0=BF=D0=B5=D1=80=D0=B2=D1=8B=D1=85 = =D1=87=D0=B0=D1=81=D1=82=D0=B5=D0=B9 = =D0=B7=D0=B0=D1=8F=D0=B2=D0=BE=D0=BA. = =D0=94=D0=BE=D0=BF=D1=83=D1=81=D0=BA =D0=BA = =D1=83=D1=87=D0=B0=D1=81=D1=82=D0=B8=D1=8E =D0=B2 = =D1=8D=D0=BB=D0=B5=D0=BA=D1=82=D1=80=D0=BE=D0=BD=D0=BD=D0=BE=D0=BC = =D0=B0=D1=83=D0=BA=D1=86=D0=B8=D0=BE=D0=BD=D0=B5. = =D0=9E=D1=81=D0=BE=D0=B1=D0=B5=D0=BD=D0=BD=D0=BE=D1=81=D1=82=D0=B8 =D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D0=B4=D0=B5=D0=BD=D0=B8=D1=8F = =D1=8D=D0=BB=D0=B5=D0=BA=D1=82=D1=80=D0=BE=D0=BD=D0=BD=D0=BE=D0=B3=D0=BE = =D0=B0=D1=83=D0=BA=D1=86=D0=B8=D0=BE=D0=BD=D0=B0 =D0=BD=D0=B0 = =D0=BF=D0=BE=D0=BD=D0=B8=D0=B6=D0=B5=D0=BD=D0=B8=D0=B5, = =D0=BF=D0=BE=D1=88=D0=B0=D0=B3=D0=BE=D0=B2=D1=8B=D0=B5 = =D0=B4=D0=B5=D0=B9=D1=81=D1=82=D0=B2=D0=B8=D1=8F = =D1=83=D1=87=D0=B0=D1=81=D1=82=D0=BD=D0=B8=D0=BA=D0=BE=D0=B2. =D0=94=D0=BE=D0=BF=D0=BE=D0=BB=D0=BD=D0=B8=D1=82=D0=B5=D0=BB=D1=8C=D0=BD=D1= =8B=D0=B9 =D1=82=D0=BE=D1=80=D0=B3. = =D0=9F=D0=BE=D1=80=D1=8F=D0=B4=D0=BE=D0=BA = =D0=BE=D0=BF=D1=80=D0=B5=D0=B4=D0=B5=D0=BB=D0=B5=D0=BD=D0=B8=D1=8F = =D0=BF=D0=BE=D0=B1=D0=B5=D0=B4=D0=B8=D1=82=D0=B5=D0=BB=D1=8F =D0=B8 = =D1=84=D0=BE=D1=80=D0=BC=D0=B8=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D0=B5 = =D0=BF=D1=80=D0=BE=D1=82=D0=BE=D0=BA=D0=BE=D0=BB=D0=B0. =D0=9F=D0=BE=D1=81=D0=BB=D0=B5=D0=B4=D1=81=D1=82=D0=B2=D0=B8=D1=8F = =D0=BF=D1=80=D0=B8=D0=B7=D0=BD=D0=B0=D0=BD=D0=B8=D1=8F = =D1=8D=D0=BB=D0=B5=D0=BA=D1=82=D1=80=D0=BE=D0=BD=D0=BD=D0=BE=D0=B3=D0=BE = =D0=B0=D1=83=D0=BA=D1=86=D0=B8=D0=BE=D0=BD=D0=B0 = =D0=BD=D0=B5=D1=81=D0=BE=D1=81=D1=82=D0=BE=D1=8F=D0=B2=D1=88=D0=B8=D0=BC=D1= =81=D1=8F, =D0=B4=D0=B5=D0=B9=D1=81=D1=82=D0=B2=D0=B8=D1=8F = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D1=87=D0=B8=D0=BA=D0=BE=D0=B2. =D0=A0=D0=B0=D1=81=D1=81=D0=BC=D0=BE=D1=82=D1=80=D0=B5=D0=BD=D0=B8=D1=8F = =D0=B0=D1=83=D0=BA=D1=86=D0=B8=D0=BE=D0=BD=D0=BD=D0=BE=D0=B9 = =D0=BA=D0=BE=D0=BC=D0=B8=D1=81=D1=81=D0=B8=D0=B5=D0=B9 = =D0=B2=D1=82=D0=BE=D1=80=D1=8B=D1=85 = =D1=87=D0=B0=D1=81=D1=82=D0=B5=D0=B9 = =D0=B7=D0=B0=D1=8F=D0=B2=D0=BE=D0=BA. = =D0=9F=D0=BE=D0=B4=D0=B3=D0=BE=D1=82=D0=BE=D0=B2=D0=BA=D0=B0 = =D0=B8=D1=82=D0=BE=D0=B3=D0=BE=D0=B2=D0=BE=D0=B3=D0=BE = =D0=BF=D1=80=D0=BE=D1=82=D0=BE=D0=BA=D0=BE=D0=BB=D0=B0. =D0=9E=D1=81=D0=BE=D0=B1=D0=B5=D0=BD=D0=BD=D0=BE=D1=81=D1=82=D0=B8 = =D0=B7=D0=B0=D0=BA=D0=BB=D1=8E=D1=87=D0=B5=D0=BD=D0=B8=D1=8F = =D0=B3=D0=BE=D1=81=D1=83=D0=B4=D0=B0=D1=80=D1=81=D1=82=D0=B2=D0=B5=D0=BD=D0= =BD=D0=BE=D0=B3=D0=BE =D0=B8 = =D0=BC=D1=83=D0=BD=D0=B8=D1=86=D0=B8=D0=BF=D0=B0=D0=BB=D1=8C=D0=BD=D0=BE=D0= =B3=D0=BE =D0=BA=D0=BE=D0=BD=D1=82=D1=80=D0=B0=D0=BA=D1=82=D0=B0 =D1=81 = =D0=BF=D0=BE=D0=BC=D0=BE=D1=89=D1=8C=D1=8E =D0=AD=D0=A6=D0=9F, =D0=BF=D0=BE=D0=B4=D0=B3=D0=BE=D1=82=D0=BE=D0=B2=D0=BA=D0=B0 = =D0=BF=D1=80=D0=BE=D1=82=D0=BE=D0=BA=D0=BE=D0=BB=D0=B0 = =D1=80=D0=B0=D0=B7=D0=BD=D0=BE=D0=B3=D0=BB=D0=B0=D1=81=D0=B8=D0=B9. = =D0=9E=D1=81=D0=BD=D0=BE=D0=B2=D0=BD=D1=8B=D0=B5 = =D0=BE=D1=88=D0=B8=D0=B1=D0=BA=D0=B8. = =D0=9F=D1=80=D0=B8=D1=87=D0=B8=D0=BD=D1=8B = =D0=BE=D1=82=D0=BA=D0=BB=D0=BE=D0=BD=D0=B5=D0=BD=D0=B8=D1=8F 1 =D0=B8 2 = =D1=87=D0=B0=D1=81=D1=82=D0=B5=D0=B9 =D0=B7=D0=B0=D1=8F=D0=B2=D0=BE=D0=BA. = =D0=9F=D1=80=D0=B0=D0=BA=D1=82=D0=B8=D0=BA=D0=B0 =D0=A4=D0=90=D0=A1 = =D0=BF=D0=BE = =D0=BE=D0=B1=D0=B6=D0=B0=D0=BB=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8E = =D0=B4=D0=B5=D0=B9=D1=81=D1=82=D0=B2=D0=B8=D0=B9 = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D1=87=D0=B8=D0=BA=D0=BE=D0=B2. 3. =D0=9E=D1=81=D0=BE=D0=B1=D0=B5=D0=BD=D0=BD=D0=BE=D1=81=D1=82=D0=B8 = =D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D0=B4=D0=B5=D0=BD=D0=B8=D1=8F = =D0=B7=D0=B0=D0=BA=D1=83=D0=BF=D0=BE=D0=BA = =D0=B7=D0=B0=D0=BF=D1=80=D0=BE=D1=81=D0=BE=D0=BC = =D0=BA=D0=BE=D1=82=D0=B8=D1=80=D0=BE=D0=B2=D0=BE=D0=BA = =D1=86=D0=B5=D0=BD. =D0=9F=D1=80=D0=B0=D0=BA=D1=82=D0=B8=D0=BA=D0=B0 = =D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D0=B4=D0=B5=D0=BD=D0=B8=D1=8F =D0=BF=D1=80=D0=BE=D1=86=D0=B5=D0=B4=D1=83=D1=80=D1=8B, = =D1=82=D0=B8=D0=BF=D0=B8=D1=87=D0=BD=D1=8B=D0=B5 = =D0=BE=D1=88=D0=B8=D0=B1=D0=BA=D0=B8 = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D1=87=D0=B8=D0=BA=D0=BE=D0=B2, = =D0=BF=D0=BE=D1=81=D1=82=D0=B0=D0=B2=D1=89=D0=B8=D0=BA=D0=BE=D0=B2 = (=D0=BF=D0=BE=D0=B4=D1=80=D1=8F=D0=B4=D1=87=D0=B8=D0=BA=D0=BE=D0=B2). 4. =D0=9F=D1=80=D0=B0=D0=BA=D1=82=D0=B8=D0=BA=D0=B0 = =D0=BF=D0=BE=D0=B4=D0=B3=D0=BE=D1=82=D0=BE=D0=B2=D0=BA=D0=B8, = =D0=B7=D0=B0=D0=BA=D0=BB=D1=8E=D1=87=D0=B5=D0=BD=D0=B8=D1=8F, = =D0=B8=D1=81=D0=BF=D0=BE=D0=BB=D0=BD=D0=B5=D0=BD=D0=B8=D1=8F =D0=B8 = =D1=80=D0=B0=D1=81=D1=82=D0=BE=D1=80=D0=B6=D0=B5=D0=BD=D0=B8=D1=8F = =D0=B3=D0=BE=D1=81=D1=83=D0=B4=D0=B0=D1=80=D1=81=D1=82=D0=B2=D0=B5=D0=BD=D0= =BD=D1=8B=D1=85 =D0=B8 =D0=BC=D1=83=D0=BD=D0=B8=D1=86=D0=B8=D0=BF=D0=B0=D0=BB=D1=8C=D0=BD=D1=8B=D1= =85 =D0=BA=D0=BE=D0=BD=D1=82=D1=80=D0=B0=D0=BA=D1=82=D0=BE=D0=B2. = =D0=9E=D1=81=D0=BD=D0=BE=D0=B2=D0=BD=D1=8B=D0=B5 = =D0=BE=D0=B1=D1=8F=D0=B7=D0=B0=D1=82=D0=B5=D0=BB=D1=8C=D0=BD=D1=8B=D0=B5 = =D1=80=D0=B0=D0=B7=D0=B4=D0=B5=D0=BB=D1=8B, = =D0=BF=D1=80=D0=B5=D1=82=D0=B5=D0=BD=D0=B7=D0=B8=D0=BE=D0=BD=D0=BD=D0=B0=D1= =8F =D1=80=D0=B0=D0=B1=D0=BE=D1=82=D0=B0. =D0=9C=D0=B5=D1=85=D0=B0=D0=BD=D0=B8=D0=B7=D0=BC=D1=8B = =D0=B7=D0=B0=D1=89=D0=B8=D1=82=D1=8B =D0=BE=D1=82 = =D0=BD=D0=B5=D0=B4=D0=BE=D0=B1=D1=80=D0=BE=D1=81=D0=BE=D0=B2=D0=B5=D1=81=D1= =82=D0=BD=D1=8B=D1=85 =D0=B4=D0=B5=D0=B9=D1=81=D1=82=D0=B2=D0=B8=D0=B9 = =D1=81=D1=82=D0=BE=D1=80=D0=BE=D0=BD. = =D0=9A=D0=BE=D0=BD=D1=82=D1=80=D0=BE=D0=BB=D1=8C = =D0=BA=D0=B0=D1=87=D0=B5=D1=81=D1=82=D0=B2=D0=B0 = =D0=BF=D0=BE=D1=81=D1=82=D0=B0=D0=B2=D0=BB=D1=8F=D0=B5=D0=BC=D0=BE=D0=B3=D0= =BE =D1=82=D0=BE=D0=B2=D0=B0=D1=80=D0=B0, =D1=83=D1=81=D0=BB=D1=83=D0=B3, = =D1=80=D0=B0=D0=B1=D0=BE=D1=82. 5. =D0=97=D0=B0=D0=BA=D0=BB=D1=8E=D1=87=D0=B5=D0=BD=D0=B8=D0=B5 = =D0=B1=D0=B5=D1=81=D0=BA=D0=BE=D0=BD=D0=BA=D1=83=D1=80=D1=81=D0=BD=D1=8B=D1= =85 =D0=B4=D0=BE=D0=B3=D0=BE=D0=B2=D0=BE=D1=80=D0=BE=D0=B2; = =D0=B0=D0=BD=D0=B0=D0=BB=D0=B8=D0=B7 = =D1=80=D1=8B=D0=BD=D0=BE=D1=87=D0=BD=D1=8B=D1=85 = (=D1=81=D1=80=D0=B5=D0=B4=D0=BD=D0=B8=D1=85) =D0=BD=D0=B0 = =D0=BF=D1=80=D0=BE=D0=B4=D1=83=D0=BA=D1=86=D0=B8=D1=8E, = =D1=80=D0=B0=D0=B1=D0=BE=D1=82=D1=8B, =D1=83=D1=81=D0=BB=D1=83=D0=B3=D0=B8 =D0=BF=D0=BE = =D0=BF=D1=80=D1=8F=D0=BC=D1=8B=D0=BC = =D0=B4=D0=BE=D0=B3=D0=BE=D0=B2=D0=BE=D1=80=D0=B0=D0=BC. = =D0=9E=D0=B1=D0=B7=D0=BE=D1=80 = =D0=BE=D1=81=D0=BD=D0=BE=D0=B2=D0=BD=D1=8B=D1=85 = =D0=BD=D0=B0=D1=80=D1=83=D1=88=D0=B5=D0=BD=D0=B8=D0=B9 = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D1=87=D0=B8=D0=BA=D0=BE=D0=B2. = =D0=92=D0=B5=D0=B4=D0=B5=D0=BD=D0=B8=D0=B5 = =D0=A0=D0=B5=D0=B5=D1=81=D1=82=D1=80=D0=B0 =D0=B3=D0=BE=D1=81=D1=83=D0=B4=D0=B0=D1=80=D1=81=D1=82=D0=B2=D0=B5=D0=BD=D0= =BD=D1=8B=D1=85 = (=D0=BC=D1=83=D0=BD=D0=B8=D1=86=D0=B8=D0=BF=D0=B0=D0=BB=D1=8C=D0=BD=D1=8B= =D1=85) =D0=BA=D0=BE=D0=BD=D1=82=D1=80=D0=B0=D0=BA=D1=82=D0=BE=D0=B2 = =D0=B8 =D0=A0=D0=B5=D0=B5=D1=81=D1=82=D1=80=D0=B0 = =D0=B7=D0=B0=D0=BA=D1=83=D0=BF=D0=BE=D0=BA. 6. =D0=A2=D1=80=D0=B5=D0=B1=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8F = =D0=A4=D0=B5=D0=B4=D0=B5=D1=80=D0=B0=D0=BB=D1=8C=D0=BD=D0=BE=D0=B3=D0=BE = =D0=B7=D0=B0=D0=BA=D0=BE=D0=BD=D0=B0 N261 "=D0=9E=D0=B1 = =D1=8D=D0=BD=D0=B5=D1=80=D0=B3=D0=BE=D1=81=D0=B1=D0=B5=D1=80=D0=B5=D0=B6=D0= =B5=D0=BD=D0=B8=D0=B8 =D0=B8 = =D0=BF=D0=BE=D0=B2=D1=8B=D1=88=D0=B5=D0=BD=D0=B8=D0=B8 =D1=8D=D0=BD=D0=B5=D1=80=D0=B3=D0=B5=D1=82=D0=B8=D1=87=D0=B5=D1=81=D0=BA=D0= =BE=D0=B9 = =D1=8D=D1=84=D1=84=D0=B5=D0=BA=D1=82=D0=B8=D0=B2=D0=BD=D0=BE=D1=81=D1=82=D0= =B8" =D0=BF=D1=80=D0=B8 = =D0=BE=D1=81=D1=83=D1=89=D0=B5=D1=81=D1=82=D0=B2=D0=BB=D0=B5=D0=BD=D0=B8=D0= =B8 = =D0=B3=D0=BE=D1=81=D1=83=D0=B4=D0=B0=D1=80=D1=81=D1=82=D0=B2=D0=B5=D0=BD=D0= =BD=D1=8B=D1=85 =D0=B8 = =D0=BC=D1=83=D0=BD=D0=B8=D1=86=D0=B8=D0=BF=D0=B0=D0=BB=D1=8C=D0=BD=D1=8B=D1= =85 =D0=B7=D0=B0=D0=BA=D1=83=D0=BF=D0=BE=D0=BA. = =D0=9E=D1=82=D0=B2=D0=B5=D1=82=D1=81=D1=82=D0=B2=D0=B5=D0=BD=D0=BD=D0=BE=D1= =81=D1=82=D1=8C = =D0=B4=D0=BE=D0=BB=D0=B6=D0=BD=D0=BE=D1=81=D1=82=D0=BD=D1=8B=D1=85 = =D0=BB=D0=B8=D1=86 =D0=BF=D0=BE =D0=9A=D0=BE=D0=90=D0=9F. 7. =D0=9D=D0=BE=D0=B2=D1=8B=D0=B9 = =D0=BF=D0=B5=D1=80=D0=B5=D1=87=D0=B5=D0=BD=D1=8C = =D0=BE=D0=B4=D0=BD=D0=BE=D0=B8=D0=BC=D0=B5=D0=BD=D0=BD=D1=8B=D1=85 = =D0=B2=D0=B8=D0=B4=D0=BE=D0=B2 = =D0=BF=D1=80=D0=BE=D0=B4=D1=83=D0=BA=D1=86=D0=B8=D0=B8, = =D0=BF=D0=BE=D1=80=D1=8F=D0=B4=D0=BE=D0=BA = =D0=B8=D1=81=D0=BF=D0=BE=D0=BB=D1=8C=D0=B7=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1= =8F, "=D1=80=D0=B0=D0=B7=D0=B1=D0=B8=D0=B2=D0=BA=D0=B0" =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D0=BE=D0=B2, = =D0=BE=D1=81=D0=BE=D0=B1=D0=B5=D0=BD=D0=BD=D0=BE=D1=81=D1=82=D0=B8 = =D1=84=D0=BE=D1=80=D0=BC=D0=B8=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8F = =D0=BB=D0=BE=D1=82=D0=BE=D0=B2 = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D1=87=D0=B8=D0=BA=D0=B0=D0=BC=D0=B8, = =D1=82=D1=80=D0=B5=D0=B1=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8F = =D0=B0=D0=BD=D1=82=D0=B8=D0=BC=D0=BE=D0=BD=D0=BE=D0=BF=D0=BE=D0=BB=D1=8C=D0= =BD=D0=BE=D0=B3=D0=BE =D0=B7=D0=B0=D0=BA=D0=BE=D0=BD=D0=BE=D0=B4=D0=B0=D1=82=D0=B5=D0=BB=D1=8C=D1= =81=D1=82=D0=B2=D0=B0 =D0=A4=D0=97-135 =D0=BF=D1=80=D0=B8 = =D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D0=B4=D0=B5=D0=BD=D0=B8=D0=B8 = =D1=82=D0=BE=D1=80=D0=B3=D0=BE=D0=B2. 8. =D0=A0=D0=B0=D0=B7=D0=BC=D0=B5=D1=89=D0=B5=D0=BD=D0=B8=D0=B5 = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D0=B0 =D0=BF=D1=83=D1=82=D0=B5=D0=BC = =D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D0=B4=D0=B5=D0=BD=D0=B8=D1=8F = =D0=BA=D0=BE=D0=BD=D0=BA=D1=83=D1=80=D1=81=D0=B0. = =D0=9F=D0=BE=D0=B4=D0=B3=D0=BE=D1=82=D0=BE=D0=B2=D0=BA=D0=B0 = =D0=B7=D0=B0=D1=8F=D0=B2=D0=BA=D0=B8 =D0=BD=D0=B0 = =D1=83=D1=87=D0=B0=D1=81=D1=82=D0=B8=D0=B5 =D0=B2 = =D0=BA=D0=BE=D0=BD=D0=BA=D1=83=D1=80=D1=81=D0=B5. =D0=9E=D1=81=D0=BD=D0=BE=D0=B2=D0=BD=D1=8B=D0=B5 = =D0=BE=D1=88=D0=B8=D0=B1=D0=BA=D0=B8 =D0=BF=D1=80=D0=B8 = =D1=81=D0=BE=D1=81=D1=82=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D0=B8=D0=B8 = =D0=B7=D0=B0=D1=8F=D0=B2=D0=BE=D0=BA. = =D0=94=D0=BE=D0=BF=D1=83=D1=81=D1=82=D0=B8=D0=BC=D1=8B=D0=B5 = =D1=82=D1=80=D0=B5=D0=B1=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8F =D0=BA = =D0=A3=D0=A0=D0=97. = =D0=9E=D1=81=D0=BD=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D0=B5 =D0=B4=D0=BE=D0=BF=D1=83=D1=81=D0=BA=D0=B0/=D0=BE=D1=82=D0=BA=D0=B0=D0=B7= =D0=B0 =D0=B2 =D0=B4=D0=BE=D0=BF=D1=83=D1=81=D0=BA=D0=B5 =D0=BA = =D1=83=D1=87=D0=B0=D1=81=D1=82=D0=B8=D1=8E =D0=B2 = =D0=BA=D0=BE=D0=BD=D0=BA=D1=83=D1=80=D1=81=D0=B5. = =D0=9F=D1=80=D0=B0=D0=BA=D1=82=D0=B8=D1=87=D0=B5=D1=81=D0=BA=D0=BE=D0=B5 = =D0=BF=D1=80=D0=B8=D0=BC=D0=B5=D0=BD=D0=B5=D0=BD=D0=B8=D0=B5 = =D0=BF=D0=BE=D1=81=D1=82=D0=B0=D0=BD=D0=BE=D0=B2=D0=BB=D0=B5=D0=BD=D0=B8=D1= =8F =D0=9F=D1=80=D0=B0=D0=B2=D0=B8=D1=82=D0=B5=D0=BB=D1=8C=D1=81=D1=82=D0=B2=D0= =B0 =D0=A0=D0=A4 =D0=BE=D1=82 10 = =D1=81=D0=B5=D0=BD=D1=82=D1=8F=D0=B1=D1=80=D1=8F 2009 =D0=B3. = N722.=D0=9E=D1=81=D0=BE=D0=B1=D0=B5=D0=BD=D0=BD=D0=BE=D1=81=D1=82=D0=B8 = =D0=BE=D0=B1=D0=B6=D0=B0=D0=BB=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8F = =D1=80=D0=B5=D0=B7=D1=83=D0=BB=D1=8C=D1=82=D0=B0=D1=82=D0=BE=D0=B2 =D0=BA=D0=BE=D0=BD=D0=BA=D1=83=D1=80=D1=81=D0=B0. 9. =D0=9E=D1=81=D0=BE=D0=B1=D0=B5=D0=BD=D0=BD=D0=BE=D1=81=D1=82=D0=B8 = =D1=80=D0=B0=D0=B7=D0=BC=D0=B5=D1=89=D0=B5=D0=BD=D0=B8=D1=8F = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D0=B0 =D1=83 = =D1=81=D1=83=D0=B1=D1=8A=D0=B5=D0=BA=D1=82=D0=BE=D0=B2 = =D0=BC=D0=B0=D0=BB=D0=BE=D0=B3=D0=BE = =D0=BF=D1=80=D0=B5=D0=B4=D0=BF=D1=80=D0=B8=D0=BD=D0=B8=D0=BC=D0=B0=D1=82=D0= =B5=D0=BB=D1=8C=D1=81=D1=82=D0=B2=D0=B0. 10. =D0=A0=D0=B5=D0=B5=D1=81=D1=82=D1=80 = =D0=BD=D0=B5=D0=B4=D0=BE=D0=B1=D1=80=D0=BE=D1=81=D0=BE=D0=B2=D0=B5=D1=81=D1= =82=D0=BD=D1=8B=D1=85 = =D0=BF=D0=BE=D1=81=D1=82=D0=B0=D0=B2=D1=89=D0=B8=D0=BA=D0=BE=D0=B2 = (=D0=A0=D0=9D=D0=9F). = =D0=A0=D0=B5=D0=B0=D0=BB=D0=B8=D0=B7=D0=B0=D1=86=D0=B8=D1=8F = =D0=B0=D0=BD=D1=82=D0=B8=D0=B4=D0=B5=D0=BC=D0=BF=D0=B8=D0=BD=D0=B3=D0=BE=D0= =B2=D1=8B=D1=85 =D0=BC=D0=B5=D1=80 =D0=B2 =D0=B3=D0=BE=D1=81=D1=83=D0=B4=D0=B0=D1=80=D1=81=D1=82=D0=B2=D0=B5=D0=BD=D0= =BD=D0=BE=D0=BC =D0=B8 = =D0=BC=D1=83=D0=BD=D0=B8=D1=86=D0=B8=D0=BF=D0=B0=D0=BB=D1=8C=D0=BD=D0=BE=D0= =BC =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D0=B5. 11. =D0=A2=D0=B8=D0=BF=D0=B8=D1=87=D0=BD=D1=8B=D0=B5 = =D0=BE=D1=88=D0=B8=D0=B1=D0=BA=D0=B8 = =D0=97=D0=B0=D0=BA=D0=B0=D0=B7=D1=87=D0=B8=D0=BA=D0=BE=D0=B2, = =D0=A3=D0=BF=D0=BE=D0=BB=D0=BD=D0=BE=D0=BC=D0=BE=D1=87=D0=B5=D0=BD=D0=BD=D1= =8B=D1=85 =D0=BE=D1=80=D0=B3=D0=B0=D0=BD=D0=BE=D0=B2 =D0=BF=D1=80=D0=B8 = =D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D0=B4=D0=B5=D0=BD=D0=B8=D0=B8 = =D0=B7=D0=B0=D0=BA=D1=83=D0=BF=D0=BE=D1=87=D0=BD=D1=8B=D1=85 =D0=BF=D1=80=D0=BE=D1=86=D0=B5=D0=B4=D1=83=D1=80. = =D0=9F=D1=80=D0=B0=D0=BA=D1=82=D0=B8=D0=BA=D0=B0 = =D0=BE=D1=81=D1=83=D1=89=D0=B5=D1=81=D1=82=D0=B2=D0=BB=D0=B5=D0=BD=D0=B8=D1= =8F =D0=BA=D0=BE=D0=BD=D1=82=D1=80=D0=BE=D0=BB=D1=8F =D0=A4=D0=90=D0=A1 = =D0=A0=D0=BE=D1=81=D1=81=D0=B8=D0=B8. 12. =D0=9E=D0=B1=D0=B6=D0=B0=D0=BB=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D0=B5 = =D0=B4=D0=B5=D0=B9=D1=81=D1=82=D0=B2=D0=B8=D0=B9/ = =D0=B1=D0=B5=D0=B7=D0=B4=D0=B5=D0=B9=D1=81=D1=82=D0=B2=D0=B8=D1=8F = =D0=97=D0=B0=D0=BA=D0=B0=D0=B7=D1=87=D0=B8=D0=BA=D0=B0, = =D0=A3=D0=BF=D0=BE=D0=BB=D0=BD=D0=BE=D0=BC=D0=BE=D1=87=D0=B5=D0=BD=D0=BD=D0= =BE=D0=B3=D0=BE =D0=BE=D1=80=D0=B3=D0=B0=D0=BD=D0=B0, = =D0=B0=D1=83=D0=BA=D1=86=D0=B8=D0=BE=D0=BD=D0=BD=D0=BE=D0=B9 =D0=BA=D0=BE=D0=BC=D0=B8=D1=81=D1=81=D0=B8=D0=B8 =D0=B8 = =D0=9E=D0=BF=D0=B5=D1=80=D0=B0=D1=82=D0=BE=D1=80=D0=B0 = =D0=AD=D0=A2=D0=9F. 13. = =D0=9F=D0=BB=D0=B0=D0=BD=D0=B8=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D0=B5 = =D1=83=D1=87=D0=B0=D1=81=D1=82=D0=B8=D1=8F =D0=B2 = =D1=80=D0=B0=D0=B7=D0=BC=D0=B5=D1=89=D0=B5=D0=BD=D0=B8=D1=8F=D1=85 = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D0=BE=D0=B2. 14. =D0=90=D0=BB=D0=B3=D0=BE=D1=80=D0=B8=D1=82=D0=BC = =D0=B2=D1=8B=D0=B1=D0=BE=D1=80=D0=B0 = =D1=81=D0=BF=D0=BE=D1=81=D0=BE=D0=B1=D0=B0 = =D1=80=D0=B0=D0=B7=D0=BC=D0=B5=D1=89=D0=B5=D0=BD=D0=B8=D1=8F = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D0=B0. = =D0=9D=D0=B0=D0=BB=D0=B8=D1=87=D0=B8=D0=B5 = =D0=BE=D1=81=D0=BD=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D0=B9 = =D1=80=D0=B0=D0=B7=D0=BC=D0=B5=D1=89=D0=B5=D0=BD=D0=B8=D1=8F = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D0=BE=D0=B2 =D1=83 =D0=B5=D0=B4=D0=B8=D0=BD=D1=81=D1=82=D0=B2=D0=B5=D0=BD=D0=BD=D0=BE=D0=B3=D0= =BE =D0=BF=D0=BE=D1=81=D1=82=D0=B0=D0=B2=D1=89=D0=B8=D0=BA=D0=B0. 15. =D0=9F=D1=80=D0=B0=D0=BA=D1=82=D0=B8=D0=BA=D0=B0 = =D0=BA=D0=BE=D0=BD=D1=82=D1=80=D0=BE=D0=BB=D1=8F =D0=B7=D0=B0 = =D1=81=D0=BE=D0=B1=D0=BB=D1=8E=D0=B4=D0=B5=D0=BD=D0=B8=D0=B5=D0=BC = =D0=B7=D0=B0=D0=BA=D0=BE=D0=BD=D0=BE=D0=B4=D0=B0=D1=82=D0=B5=D0=BB=D1=8C=D1= =81=D1=82=D0=B2=D0=B0 =D0=BE = =D1=80=D0=B0=D0=B7=D0=BC=D0=B5=D1=89=D0=B5=D0=BD=D0=B8=D0=B8 = =D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D0=BE=D0=B2. 16. =D0=A0=D0=B0=D0=B1=D0=BE=D1=82=D0=B0 =D0=BD=D0=B0 = =D0=9E=D0=B1=D1=89=D0=B5=D1=80=D0=BE=D1=81=D1=81=D0=B8=D0=B9=D1=81=D0=BA=D0= =BE=D0=BC = =D0=BE=D1=84=D0=B8=D1=86=D0=B8=D0=B0=D0=BB=D1=8C=D0=BD=D0=BE=D0=BC = =D1=81=D0=B0=D0=B9=D1=82=D0=B5 =D0=B4=D0=BB=D1=8F = =D0=BE=D0=B1=D0=B5=D1=81=D0=BF=D0=B5=D1=87=D0=B5=D0=BD=D0=B8=D1=8F = =D0=B3=D0=BE=D1=81=D1=83=D0=B4=D0=B0=D1=80=D1=81=D1=82=D0=B2=D0=B5=D0=BD=D0= =BD=D1=8B=D1=85 =D0=B8 =D0=BC=D1=83=D0=BD=D0=B8=D1=86=D0=B8=D0=BF=D0=B0=D0=BB=D1=8C=D0=BD=D1=8B=D1= =85 =D0=B7=D0=B0=D0=BA=D1=83=D0=BF=D0=BE=D0=BA. =D0=A1=D1=82=D0=BE=D0=B8=D0=BC=D0=BE=D1=81=D1=82=D1=8C = =D1=83=D1=87=D0=B0=D1=81=D1=82=D0=B8=D1=8F: 17500 = =D1=80=D1=83=D0=B1=D0=BB=D0=B5=D0=B9. =D0=9C=D0=B5=D1=81=D1=82=D0=BE = =D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D0=B4=D0=B5=D0=BD=D0=B8=D1=8F: =D0=BC. = =D0=91=D0=B0=D1=83=D0=BC=D0=B0=D0=BD=D1=81=D0=BA=D0=B0=D1=8F, = =D1=83=D0=BB. = =D0=91=D0=B0=D1=83=D0=BC=D0=B0=D0=BD=D1=81=D0=BA=D0=B0=D1=8F, =D0=B4.6, = =D0=B1=D0=B8=D0=B7=D0=BD=D0=B5=D1=81 =D1=86=D0=B5=D0=BD=D1=82=D1=80 = "=D0=92=D0=B8=D0=BA=D1=82=D0=BE=D1=80=D0=B8=D1=8F = =D0=9F=D0=BB=D0=B0=D0=B7=D0=B0". =D0=92 =D1=81=D1=82=D0=BE=D0=B8=D0=BC=D0=BE=D1=81=D1=82=D1=8C = =D0=B2=D1=85=D0=BE=D0=B4=D0=B8=D1=82 = =D0=BC=D0=B5=D1=82=D0=BE=D0=B4=D0=B8=D1=87=D0=B5=D1=81=D0=BA=D0=B8=D0=B9 = =D0=BC=D0=B0=D1=82=D0=B5=D1=80=D0=B8=D0=B0=D0=BB, = =D0=BE=D0=B1=D0=B5=D0=B4=D1=8B, = =D0=BA=D0=BE=D1=84=D0=B5-=D0=BF=D0=B0=D1=83=D0=B7=D1=8B, = =D1=81=D0=B5=D1=80=D1=82=D0=B8=D1=84=D0=B8=D0=BA=D0=B0=D1=82. From owner-freebsd-doc@FreeBSD.ORG Fri Feb 17 19:20:11 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 91DD41065673 for ; Fri, 17 Feb 2012 19:20:11 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 546FB8FC0A for ; Fri, 17 Feb 2012 19:20:11 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q1HJKB6T065483 for ; Fri, 17 Feb 2012 19:20:11 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q1HJKBpZ065482; Fri, 17 Feb 2012 19:20:11 GMT (envelope-from gnats) Resent-Date: Fri, 17 Feb 2012 19:20:11 GMT Resent-Message-Id: <201202171920.q1HJKBpZ065482@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Artur Skonecki Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 40FDD10657C2 for ; Fri, 17 Feb 2012 19:10:25 +0000 (UTC) (envelope-from skonecka@volt.iem.pw.edu.pl) Received: from volt.iem.pw.edu.pl (volt.iem.pw.edu.pl [194.29.146.3]) by mx1.freebsd.org (Postfix) with SMTP id C031A8FC12 for ; Fri, 17 Feb 2012 19:10:14 +0000 (UTC) Received: by volt.iem.pw.edu.pl (Postfix, from userid 6006) id 53149A6693F; Fri, 17 Feb 2012 19:54:00 +0100 (CET) Message-Id: <20120217185400.53149A6693F@volt.iem.pw.edu.pl> Date: Fri, 17 Feb 2012 19:54:00 +0100 (CET) From: Artur Skonecki To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/165249: Multibyte characters in manpages still not displaying properly. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Artur Skonecki List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 17 Feb 2012 19:20:11 -0000 >Number: 165249 >Category: docs >Synopsis: Multibyte characters in manpages still not displaying properly. >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Fri Feb 17 19:20:10 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Artur Skonecki >Release: FreeBSD 9.0-STABLE amd64 >Organization: >Environment: System: FreeBSD volt.iem.pw.edu.pl 9.0-STABLE FreeBSD 9.0-STABLE #0: Tue Feb 7 21:12:58 CET 2012 ato@volt.iem.pw.edu.pl:/tmp/obj/usr/src/sys/VOLT amd64 >Description: National characters are not displaying properly ( or not displaying at all, depending on $LANG ) when viewed with man. $ LESSCHARSET="UTF-8" PAGER=less LANG="de_DE.UTF-8" man -d man -- Using architecture: amd64:amd64 -- Using pager: less -- Using manual sections: 1:1aout:8:2:3:n:4:5:6:7:9:l -- Searching PATH for man directories -- Adding /usr/local/man to manpath -- Adding /usr/share/man to manpath -- Adding default manpath entries -- Adding /usr/share/openssl/man to manpath -- Parsing config file: /usr/local/etc/man.d/perl5.14.2.conf -- Adding /usr/local/lib/perl5/5.14.2/man to manpath -- Adding /usr/local/lib/perl5/5.14.2/perl/man to manpath -- Parsing config file: /usr/local/etc/man.d/pl-man-doc.conf -- Using manual path: /usr/local/man:/usr/share/man:/usr/share/openssl/man:/usr/local/lib/perl5/5.14.2/man:/usr/local/lib/perl5/5.14.2/perl/man -- Using locale paths: de_DE.UTF-8:de.UTF-8:de:en.UTF-8:. -- Using standard page width -- Searching for man -- Found manpage /usr/local/man/de/man1/man.1 -- Skipping catpage: not found or old -- Command: /usr/bin/zcat -f /usr/local/man/de/man1/man.1 | tbl | groff -S -P-h -Wall -mtty-char -man -Tascii -P-c | less >How-To-Repeat: Try browsing preinstalled manpages for different languages. For example: LANG="de_DE.UTF-8" man man LANG="fr_FR.UTF-8" man man >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri Feb 17 19:20:18 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 48A36106567B for ; Fri, 17 Feb 2012 19:20:18 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 218F98FC14 for ; Fri, 17 Feb 2012 19:20:18 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q1HJKI27065586 for ; Fri, 17 Feb 2012 19:20:18 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q1HJKIdT065585; Fri, 17 Feb 2012 19:20:18 GMT (envelope-from gnats) Resent-Date: Fri, 17 Feb 2012 19:20:18 GMT Resent-Message-Id: <201202171920.q1HJKIdT065585@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Stefan Lasiewski Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0DB73106566C for ; Fri, 17 Feb 2012 19:18:45 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id ED5078FC13 for ; Fri, 17 Feb 2012 19:18:44 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q1HJIim6086980 for ; Fri, 17 Feb 2012 19:18:44 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id q1HJIiN2086979; Fri, 17 Feb 2012 19:18:44 GMT (envelope-from nobody) Message-Id: <201202171918.q1HJIiN2086979@red.freebsd.org> Date: Fri, 17 Feb 2012 19:18:44 GMT From: Stefan Lasiewski To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/165250: "5.5.4.3 Upgrading Ports using Portmanager" should be clearer about flags X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 17 Feb 2012 19:20:18 -0000 >Number: 165250 >Category: docs >Synopsis: "5.5.4.3 Upgrading Ports using Portmanager" should be clearer about flags >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Fri Feb 17 19:20:17 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Stefan Lasiewski >Release: freebsd-8.2 >Organization: LBNL >Environment: FreeBSD host.example.gov 8.2-RELEASE FreeBSD 8.2-RELEASE #0: Thu Feb 17 02:41:51 UTC 2011 root@mason.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC amd64 >Description: The documentation at http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html#PORTMANAGER says the following: "All the installed ports can be upgraded using this simple command: # portmanager -u You can add the -ui flag to get asked for confirmation of every step Portmanager will perform." This documentation is a bit vague and seems to be implying that I can try `portmanager -ui`. However, that returns an error: # portmanager -ui rParseCommandLine 0.4.1_9 error: /usr/ports/-ui is not a valid port directory rParseCommandLine 0.4.1_9 info:either you have used an invalid command line switch as the first option or you are trying to update a non existent port path, see man portmanager(1) MGPMrCommandLine 0.4.1_9 error: rParseCommandLine returned errorCode 1 The correct flags are `portmanager -u -ui`: # portmanager -u -ui ------------------------------------------------------------------------ portmanager 0.4.1_9: Collecting installed port data ------------------------------------------------------------------------ ... >How-To-Repeat: >Fix: Can you please make the documentation clearly state that the proper flags should be `-u -ui` and not `-ui`. Perhaps the following is more clear: Old: "You can add the -ui flag to get asked for confirmation of every step Portmanager will perform." New: "You can add the -ui ('portmanager -u -ui')flag to get asked for confirmation of every step Portmanager will perform." >Release-Note: >Audit-Trail: >Unformatted: