From owner-freebsd-doc@FreeBSD.ORG  Sun Dec 18 10:36:20 2011
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 2F10F106566C
	for <freebsd-doc@freebsd.org>; Sun, 18 Dec 2011 10:36:19 +0000 (UTC)
	(envelope-from pluknet@gmail.com)
Received: from mail-tul01m020-f182.google.com (mail-tul01m020-f182.google.com
	[209.85.214.182])
	by mx1.freebsd.org (Postfix) with ESMTP id ED19C8FC0C
	for <freebsd-doc@freebsd.org>; Sun, 18 Dec 2011 10:36:18 +0000 (UTC)
Received: by obbwd18 with SMTP id wd18so1786449obb.13
	for <freebsd-doc@freebsd.org>; Sun, 18 Dec 2011 02:36:18 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=mime-version:in-reply-to:references:date:message-id:subject:from:to
	:cc:content-type:content-transfer-encoding;
	bh=8Bm6kVkOFN61ADX6Y4+FI4XslAM5fdRIBSusYpb3tiU=;
	b=cUsd+KHDup9qgCGc9JvYpAvbKEahpspGq2FvdHNnymXwmhEeode2dJ8UnhnMJWCLO1
	1nTGsGDjRNF8T+gLPIFQuBTPNJCJ/Xjkiyi6oZelCQrAUMB7aMPl8MwwysEP9P7YbFUQ
	iQkHd5v1SRh/BLqOAa1laGbf6MZJeorqNkbJo=
MIME-Version: 1.0
Received: by 10.182.217.3 with SMTP id ou3mr7806841obc.15.1324204578218; Sun,
	18 Dec 2011 02:36:18 -0800 (PST)
Received: by 10.182.142.101 with HTTP; Sun, 18 Dec 2011 02:36:18 -0800 (PST)
In-Reply-To: <alpine.BSF.2.00.1112171718430.58132@woozle.rinet.ru>
References: <alpine.BSF.2.00.1112151212280.24823@woozle.rinet.ru>
	<CAE-mSO+_K87Js24QQwy_2W7LpNyF3q79M131ZpxhhFAoS8CcQw@mail.gmail.com>
	<alpine.BSF.2.00.1112171718430.58132@woozle.rinet.ru>
Date: Sun, 18 Dec 2011 13:36:18 +0300
Message-ID: <CAE-mSOKbmVYh1zFen+L3dmt+Pn564Ci83cBHpVz7Cz3L6d8AZw@mail.gmail.com>
From: Sergey Kandaurov <pluknet@gmail.com>
To: Dmitry Morozovsky <marck@rinet.ru>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
Cc: freebsd-doc@freebsd.org
Subject: Re: Adding entity to books formatting
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: Sun, 18 Dec 2011 10:36:20 -0000

On 17 December 2011 17:20, Dmitry Morozovsky <marck@rinet.ru> wrote:
> On Sat, 17 Dec 2011, Sergey Kandaurov wrote:
>
>> > I need an advice from dsl-fu-knowledgeable perswon ;)
>> >
>> > Prodded by glebius@, I'm trying to add new entity svnref to generate a=
 link to
>> > svnweb.
>> >
>> > My quick patch stopped with an erro, while generating seems-to-be-corr=
ect
>> > content:
>> >
>> > -- 8< --
>> > marck@woozle:~/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook> gre=
p -6i
>> > svnref freebsd-versions.html
>> >>Dec 12, 2011</TD
>> >><TD
>> >>10-CURRENT after defining boolean true/false in sys/types.h,
>> > =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0sizeof(bool) may had change=
d (rev <A
>> > HREF=3D"http://svnweb.freebsd.org/base?view=3Drevision&amp;revision=3D=
228444"
>> >><TT
>> > CLASS=3D"SVNREF"
>> >>228444</TT
>> >></A
>> >>).
>> > =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0<TT
>> > CLASS=3D"FILENAME"
>> >>foofile</TT
>>
>> You most probably need to modify share/sgml/freebsd41.dtd as well.
>> Something like these lines:
>>
>> +<!ELEMENT SVNRef - - ((%cptr.char.mix;)+)>
>> +<!ATTLIST SVNRef
>> + =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0%common.attrib;
>> +>
>> +
>>
>> Hope this helps.
>
> Thanks!
>
> Not exactly ;) -- now it's recognized but specifically disallowed:

Eh, sure. You also need to add it to local.tech.char.class.
Sorry, I forgot to mention this previously. See also how devicename
is implemented. A complete diff below on top of your changes, and
it should work now (it works for me):

doc/share/sgml/freebsd41.dtd or doc/share/sgml/freebsd.dtd ?
What DTD file is actually used is not clear for me. I chose freebsd41.dtd

@@ -26,7 +26,7 @@
 <!-- Entities for element classes and mixtures ...........................=
 -->

 <!-- Character level classes -->
-<!ENTITY % local.tech.char.class
"|HostID|Username|Groupname|Devicename|MakeTarget|MakeVar">
+<!ENTITY % local.tech.char.class
"|HostID|Username|Groupname|Devicename|MakeTarget|MakeVar|SVNRef">

 <!ENTITY % local.cptr.char.mix "|CO">

@@ -116,6 +116,11 @@
                 %common.attrib;
 >

+<!ELEMENT SVNRef - - ((%cptr.char.mix;)+)>
+<!ATTLIST SVNRef
+                %common.attrib;
+>
+
 <!-- The content model for <filename> was changed between DocBook 3.1 and
      4.1.  Specifically, <envar> was disallowed.  There's a suggestion fro=
m
      the DocBook maintainers that this may have been a mistake.  In the

--=20
wbr,
pluknet

From owner-freebsd-doc@FreeBSD.ORG  Sun Dec 18 12:51:26 2011
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 9F283106566B
	for <freebsd-doc@freebsd.org>; Sun, 18 Dec 2011 12:51:26 +0000 (UTC)
	(envelope-from marck@rinet.ru)
Received: from woozle.rinet.ru (woozle.rinet.ru [195.54.192.68])
	by mx1.freebsd.org (Postfix) with ESMTP id 1F6208FC08
	for <freebsd-doc@freebsd.org>; Sun, 18 Dec 2011 12:51:25 +0000 (UTC)
Received: from localhost (localhost [127.0.0.1])
	by woozle.rinet.ru (8.14.4/8.14.4) with ESMTP id pBICpO6K075383;
	Sun, 18 Dec 2011 16:51:24 +0400 (MSK) (envelope-from marck@rinet.ru)
Date: Sun, 18 Dec 2011 16:51:24 +0400 (MSK)
From: Dmitry Morozovsky <marck@rinet.ru>
To: Sergey Kandaurov <pluknet@gmail.com>
In-Reply-To: <CAE-mSOKbmVYh1zFen+L3dmt+Pn564Ci83cBHpVz7Cz3L6d8AZw@mail.gmail.com>
Message-ID: <alpine.BSF.2.00.1112181646040.65858@woozle.rinet.ru>
References: <alpine.BSF.2.00.1112151212280.24823@woozle.rinet.ru>
	<CAE-mSO+_K87Js24QQwy_2W7LpNyF3q79M131ZpxhhFAoS8CcQw@mail.gmail.com>
	<alpine.BSF.2.00.1112171718430.58132@woozle.rinet.ru>
	<CAE-mSOKbmVYh1zFen+L3dmt+Pn564Ci83cBHpVz7Cz3L6d8AZw@mail.gmail.com>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
X-NCC-RegID: ru.rinet
X-OpenPGP-Key-ID: 6B691B03
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
	(woozle.rinet.ru [0.0.0.0]); Sun, 18 Dec 2011 16:51:24 +0400 (MSK)
Cc: freebsd-doc@freebsd.org
Subject: Re: Adding entity to books formatting
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: Sun, 18 Dec 2011 12:51:26 -0000

On Sun, 18 Dec 2011, Sergey Kandaurov wrote:

> >> > I need an advice from dsl-fu-knowledgeable perswon ;)

[snip]

> > Not exactly ;) -- now it's recognized but specifically disallowed:
> 
> Eh, sure. You also need to add it to local.tech.char.class.

> Sorry, I forgot to mention this previously. See also how devicename
> is implemented. A complete diff below on top of your changes, and
> it should work now (it works for me):

Thanks a lot! I tried to track other elements definitions, but miss the whole 
track here and there. Time to refresh DTD skills ;-)


-- 
Sincerely,
D.Marck                                     [DM5020, MCK-RIPE, DM3-RIPN]
[ FreeBSD committer:                                 marck@FreeBSD.org ]
------------------------------------------------------------------------
*** Dmitry Morozovsky --- D.Marck --- Wild Woozle --- marck@rinet.ru ***
------------------------------------------------------------------------

From owner-freebsd-doc@FreeBSD.ORG  Sun Dec 18 18:13:27 2011
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 501A7106566C
	for <freebsd-doc@FreeBSD.org>; Sun, 18 Dec 2011 18:13:27 +0000 (UTC)
	(envelope-from chance@itu.int)
Received: from maq01.crcrj.org.br (maq01.crcrj.org.br [201.76.178.54])
	by mx1.freebsd.org (Postfix) with ESMTP id E507B8FC15
	for <freebsd-doc@FreeBSD.org>; Sun, 18 Dec 2011 18:13:26 +0000 (UTC)
Received: by maq01.crcrj.org.br (Postfix, from userid 100)
	id DB433649372; Sun, 18 Dec 2011 15:43:52 -0200 (BRST)
X-Spam-Checker-Version: SpamAssassin 3.2.4 (2008-01-01) on maq01.crcrj.org.br
X-Spam-Level: ***
X-Spam-Status: No, score=3.1 required=6.8 tests=AWL, BAYES_00,
	FH_DATE_PAST_20XX, 
	HTML_MESSAGE, HTML_MIME_NO_HTML_TAG, MIME_HTML_ONLY, MIME_QP_LONG_LINE,
	RDNS_NONE, 
	SPF_HELO_SOFTFAIL,SPF_SOFTFAIL autolearn=no version=3.2.4
Received: from itu.int (unknown [69.162.119.107])
	by maq01.crcrj.org.br (Postfix) with ESMTP id 5210264936D
	for <freebsd-doc@FreeBSD.org>; Sun, 18 Dec 2011 15:43:47 -0200 (BRST)
From: International Telecomunication Union <chance@itu.int>
To: freebsd-doc@FreeBSD.org
Date: 18 Dec 2011 15:55:28 -0200
Message-ID: <20111218155528.0424679F0F1395D9@itu.int>
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
Content-Type: text/plain; charset="iso-8859-1"
X-Content-Filtered-By: Mailman/MimeDel 2.1.5
Cc: 
Subject: Amaizing chance
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: Sun, 18 Dec 2011 18:13:27 -0000


   [1]3D"International 

   [2]International
   Telecomunication
   Union

International Call-In Prize Giveaway=

   3D"As

Want to Win $10 000? Need money?
Enter to Win $10 000 to use how= ever you want!

How To Enter

   Each day from Thursday December 1st through to Saturday December 31= ,
   you will have the chance to win $10 000 in cash. You can have as many
   chan= ces as you want. Simply call any of the numbers below. If you
   are the person= number 1000 to call that number you get $10 000 cash.

   *Please read all the terms and conditions on the botttomof this pag= e
   before calling!

   +996312973000
   +996312973001
   +996312973002
   +996312973003
   +996312973004
   +996312973005
   +996312973006
   +996312973007
   +996312973008
   +996312973009
   +996312973010
   +996312973011
   +996312973012
   +996312973013
   +996312973014
   +996312973015
   +996312973016
   +996312973017
   +996312973018
   +996312973019

   +996312973020
   +996312973021
   +996312973022
   +996312973023
   +996312973024
   +996312973025
   +996312973026
   +996312973027
   +996312973028
   +996312973029
   +996312973030
   +996312973031
   +996312973032
   +996312973033
   +996312973034
   +996312973035
   +996312973036
   +996312973037
   +996312973038
   +996312973039

   +996312973040
   +996312973041
   +996312973042
   +996312973043
   +996312973044
   +996312973045
   +996312973046
   +996312973047
   +996312973048
   +996312973049
   +996312973050
   +996312973051
   +996312973052
   +996312973053
   +996312973054
   +996312973055
   +996312973056
   +996312973057
   +996312973058
   +996312973059

   +996312973060
   +996312973061
   +996312973062
   +996312973063
   +996312973064
   +996312973065
   +996312973066
   +996312973067
   +996312973068
   +996312973069
   +996312973070
   +996312973071
   +996312973072
   +996312973073
   +996312973074
   +996312973075
   +996312973076
   +996312973077
   +996312973078
   +996312973079

   +996312973080
   +996312973081
   +996312973082
   +996312973083
   +996312973084
   +996312973085
   +996312973086
   +996312973087
   +996312973088
   +996312973089
   +996312973090
   +996312973091
   +996312973092
   +996312973093
   +996312973094
   +996312973095
   +996312973096
   +996312973097
   +996312973098
   +996312973099

REMEMBER: YOU could be the winner= on any number and you can call as many
times as you want! You are guarantee= d to win as long as you are the person
number 1000 to call!


   Sponsored by:
   3D"" 3D"" 3D"" 3D"" 3D"" 3D"" 3D=
   3D"" 3D"" 3D"" 3D"" [home_3b.jpg"] 3D"" 3D"" 3D"" 3D"" 3D"" 3D"" 3D""
   3D"" 3D"= 

   By calling any of the numbers abov= e, you are accepting these terms
   and you will be automatically entered into = the International Call-In
   Prize Giveaway. International Call-In Prize Giveaw= ay is open only to
   legal residents of any country who are at least 18 years = of age.
   International Call-In Prize Giveaway is void in Puerto Rico. Offer v=
   oid where otherwise prohibited by law. Winners are responsible for
   taxes on = all prizes. No purchase necessary to play or win. Copyright
   � 2011 Inte= rnational Telecomunication Union. All Rights Reserved.

   *You agree to call only from your phone number. If you are the winn=
   er a person from our staff will contact you within moments from your
   call to= the number you called from to ask you for your details. Do
   not call from ph= one lines you do not own. Every call is charged
   $0.12/minute. You DO NOT hav= e to hold the line more than 1 minute.

References

   1. 3D"http://www.itu.int/ITU-D/ict/=
   2. =3D"http://www.itu.int/ITU-D/ict/index.html"

From owner-freebsd-doc@FreeBSD.ORG  Fri Dec 16 11:04:06 2011
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 216F51065676
	for <doc@freebsd.org>; Fri, 16 Dec 2011 11:04:06 +0000 (UTC)
	(envelope-from dracula.eyes@gmail.com)
Received: from mail-iy0-f182.google.com (mail-iy0-f182.google.com
	[209.85.210.182])
	by mx1.freebsd.org (Postfix) with ESMTP id E3AD88FC12
	for <doc@freebsd.org>; Fri, 16 Dec 2011 11:04:05 +0000 (UTC)
Received: by iadj38 with SMTP id j38so88603iad.13
	for <doc@freebsd.org>; Fri, 16 Dec 2011 03:04:05 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=message-id:date:from:user-agent:mime-version:to:subject
	:content-type:content-transfer-encoding;
	bh=0jUjjSXPvVrxITjT26OqiEKw6Hy/ydQgPgzLVWIafNQ=;
	b=wL5AE1BVaqS1x6YHusYuGTXbCERhVc2q98PXUHij3gD9jFQNar4hLv5kttlsq3v/27
	XNzSo68i0WSSzEbMyOtSaWZFxcKcGi7TZ2eUaAZozh2hs67xK0CwecZk638xzgj6In08
	zzpUPkx6VyBsr/Pom+TLv7JTF5DeZPs81ZJJE=
Received: by 10.50.236.5 with SMTP id uq5mr8065534igc.47.1324031835748;
	Fri, 16 Dec 2011 02:37:15 -0800 (PST)
Received: from [192.168.27.222] ([222.66.23.57])
	by mx.google.com with ESMTPS id h9sm4697839ibh.11.2011.12.16.02.37.09
	(version=SSLv3 cipher=OTHER); Fri, 16 Dec 2011 02:37:12 -0800 (PST)
Message-ID: <4EEB1F51.3010905@gmail.com>
Date: Fri, 16 Dec 2011 18:37:05 +0800
From: Joseph Wu <dracula.eyes@gmail.com>
User-Agent: Mozilla/5.0 (X11; Linux x86_64;
	rv:8.0) Gecko/20111124 Thunderbird/8.0
MIME-Version: 1.0
To: doc@FreeBSD.org
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
X-Mailman-Approved-At: Sun, 18 Dec 2011 22:09:45 +0000
Cc: 
Subject: a document bug
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: Fri, 16 Dec 2011 11:04:06 -0000

此文档少写一步，宿主机需要添加虚机的ip。
如以下：
ifconfig_bce1="inet 192.168.2.9  netmask 255.255.255.0"
ifconfig_bce1_alias0="inet 192.168.2.11 netmask 255.255.255.0" #jail1
ifconfig_bce1_alias1="inet 192.168.2.12 netmask 255.255.255.0" #jail2
ifconfig_bce1_alias2="inet 192.168.2.14 netmask 255.255.255.0" #jail3

-- 
-----
Joseph Wu
MP:18602128084 Phone:021-22880231
E-Mail:dracula.eyes@gmail.com


From owner-freebsd-doc@FreeBSD.ORG  Mon Dec 19 11:06:07 2011
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 7C7F9106566B
	for <freebsd-doc@FreeBSD.org>; Mon, 19 Dec 2011 11:06:07 +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 69A688FC15
	for <freebsd-doc@FreeBSD.org>; Mon, 19 Dec 2011 11:06:07 +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 pBJB670Y010164
	for <freebsd-doc@FreeBSD.org>; Mon, 19 Dec 2011 11:06:07 GMT
	(envelope-from owner-bugmaster@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.14.5/8.14.5/Submit) id pBJB66f9010162
	for freebsd-doc@FreeBSD.org; Mon, 19 Dec 2011 11:06:06 GMT
	(envelope-from owner-bugmaster@FreeBSD.org)
Date: Mon, 19 Dec 2011 11:06:06 GMT
Message-Id: <201112191106.pBJB66f9010162@freefall.freebsd.org>
X-Authentication-Warning: freefall.freebsd.org: gnats set sender to
	owner-bugmaster@FreeBSD.org using -f
From: FreeBSD bugmaster <bugmaster@FreeBSD.org>
To: FreeBSD doc list <freebsd-doc@FreeBSD.org>
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 <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: Mon, 19 Dec 2011 11:06:07 -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/163408  doc        Committers Guide; article still talks about manual rem
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        Document some undocumented zpool import options
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/161588  doc        Missing "-l name" option from pw(8) USER section
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/159551  doc        [patch] ports(7) makes no mention of LOCALBASE
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/158378  doc        cpio/bsdcpio(1) man page does not document -0 and --nu
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/157337  doc        [handbook] [patch] Indentation changes to network serv
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/155989  doc        [patch] Fix offset in boot.config(5)
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/144537  doc        Missing _mdconfig_list and _mdconfig2_list explanation
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
o docs/127908  doc        [patch] readdir(3) error documentation
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.
a docs/30008   doc        [patch] French softupdates document should be translat
o docs/27605   doc        [patch] Cross-document references (<olink>)
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 <emphasis> tags in the sourc

208 problems total.


From owner-freebsd-doc@FreeBSD.ORG  Tue Dec 20 23:23:02 2011
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 6C496106566C
	for <doc@freebsd.org>; Tue, 20 Dec 2011 23:23:02 +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 0FDBF8FC17
	for <doc@freebsd.org>; Tue, 20 Dec 2011 23:23:01 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
	by wonkity.com (8.14.5/8.14.5) with ESMTP id pBKNAR4l011602
	for <doc@freebsd.org>; Tue, 20 Dec 2011 16:10:27 -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 pBKNARcT011599
	for <doc@freebsd.org>; Tue, 20 Dec 2011 16:10:27 -0700 (MST)
	(envelope-from wblock@wonkity.com)
Date: Tue, 20 Dec 2011 16:10:27 -0700 (MST)
From: Warren Block <wblock@wonkity.com>
To: doc@freebsd.org
Message-ID: <alpine.BSF.2.00.1112201539500.11243@wonkity.com>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
	(wonkity.com [127.0.0.1]); Tue, 20 Dec 2011 16:10:27 -0700 (MST)
Cc: 
Subject: igor: Checking FreeBSD documents
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: Tue, 20 Dec 2011 23:23:02 -0000

The many rules for man pages and DocBook are a bit much to remember when 
months can pass between working on the various types.  My mentors Glen 
Barber and Benedict Reuschling have been very good at catching this kind 
of thing, but repetitive tasks are what computers are supposed to do for 
us.

After not finding much to do automated checking, I slapped together a
Perl program called "igor" that does some of this.  At present it checks
all types of files for repeated words ("is is"), common spelling
mistakes collected from FreeBSD documents, FreeBSD obsolete features
(just "cvsup" so far), bad phrases ("the to"), and bad whitespace (blank
lines with whitespace or lines with trailing whitespace).  Oh, and
there's a separate style check that makes some subjective suggestions.

mdoc(7) documents are also tested for document date, sentences starting
on a new line, and document structure (Dd, Dt, Os, Sh NAME, Nm, Nd,
Sh SYNOPSIS, Sh DESCRIPTION occurring in the right order and with
parameters).

DocBook SGML documents are also tested for correct indentation (a
terrible hack even when compared to the surrounding code), indentation
whitespace, title capitalization, matching open and close tags,
straggling tags, and long lines.

Default is to run all tests, but specifying an individual test runs just
that one.

Output is in plain ASCII, or better yet, marked with ANSI color
sequences that help to identify errors visually (usable with 'less -R').

igor handles compressed man pages, and shows filenames when run on
multiple files.  It also accepts input on stdin.

Typical usage:

   igor -h
   igor -R -D ifconfig.8.gz | less -RS
   igor -R -D /usr/share/man/man1/*.gz | less -RS
   igor -R chapter.sgml | less -RS

igor is really more of a proof-of-concept than a finished program.
There are more tests that could be done, and existing tests could be
done better.

Still, it's useful as-is.  Maybe presenting it will spur someone to
point out a smarter, better, or faster way of doing these tests.  Or
rewrite it entirely.

The current version of igor is here:

http://www.wonkity.com/~wblock/igor/igor

Perl 5.10 minimum, no dependencies, no port, no warranty.  Please 
upgrade if you have an earlier version, many changes and improvements 
have happened in the last few days.

My thanks to Glen Barber and Benedict Reuschling for their tremendous 
patience and help.

From owner-freebsd-doc@FreeBSD.ORG  Wed Dec 21 03:23:33 2011
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 0911C106564A
	for <doc@freebsd.org>; Wed, 21 Dec 2011 03:23:33 +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 A88368FC16
	for <doc@freebsd.org>; Wed, 21 Dec 2011 03:23:32 +0000 (UTC)
Received: (qmail 55044 invoked by uid 0); 20 Dec 2011 22:11:37 -0500
Received: from unknown (HELO glenbarber.us) (76.124.49.145)
	by 0 with SMTP; 20 Dec 2011 22:11:37 -0500
Date: Tue, 20 Dec 2011 22:11:35 -0500
From: Glen Barber <gjb@FreeBSD.org>
To: Warren Block <wblock@wonkity.com>
Message-ID: <20111221031135.GA1194@glenbarber.us>
References: <alpine.BSF.2.00.1112201539500.11243@wonkity.com>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="a8Wt8u1KmwUX3Y2C"
Content-Disposition: inline
In-Reply-To: <alpine.BSF.2.00.1112201539500.11243@wonkity.com>
X-Operating-System: FreeBSD 9.0-PRERELEASE amd64
User-Agent: Mutt/1.5.21 (2010-09-15)
Cc: doc@freebsd.org
Subject: Re: igor: Checking FreeBSD documents
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: Wed, 21 Dec 2011 03:23:33 -0000


--a8Wt8u1KmwUX3Y2C
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

On Tue, Dec 20, 2011 at 04:10:27PM -0700, Warren Block wrote:
> Still, it's useful as-is.

Very much agreed, as I've used it several times, and found things
I'd have forgotten about.

I've said it before, and I'll say it again - great job on this, and
thank you for taking the time to writing something to solve this.

Glen


--a8Wt8u1KmwUX3Y2C
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.18 (FreeBSD)

iQEcBAEBCAAGBQJO8U5nAAoJEFJPDDeguUajTXYH/0UPA93ohS4nbuulgZawUUs0
aWykOCbLwdiaO0Ml2Si/1RgDkOe6WLtlpMSN6v2SKVZMYl/cIZPWI4NVec1m09Sb
95HYCKHRNwonLV8yyGj42rCQEVErzjvC6Wl3JDjFK6LSIlfKrd/AiNsxeslsmm16
lOloMSBylM/Hw4ZSFM41algGGZ7udoz5rjz8WOp66mzwAhWa/c1kbsXvIJf4FTMU
JFDPIgKduh37530TWKmA/ofhuL2FUwpz+iABoREe9MbLob8ConF4Qz1fWy9a7SJO
dsFciqsRv2TFCMw4MuJtwq4ETvWEpvXGgqaYIMfAuMsF6ffdvv0weSaYi0PD0Xg=
=5Naz
-----END PGP SIGNATURE-----

--a8Wt8u1KmwUX3Y2C--

From owner-freebsd-doc@FreeBSD.ORG  Thu Dec 22 03:01:47 2011
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 7D1DF1065673;
	Thu, 22 Dec 2011 03:01:47 +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 514E88FC0A;
	Thu, 22 Dec 2011 03:01:47 +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 pBM31lZR049049;
	Thu, 22 Dec 2011 03:01:47 GMT
	(envelope-from eadler@freefall.freebsd.org)
Received: (from eadler@localhost)
	by freefall.freebsd.org (8.14.5/8.14.5/Submit) id pBM31lEx049043;
	Thu, 22 Dec 2011 03:01:47 GMT (envelope-from eadler)
Date: Thu, 22 Dec 2011 03:01:47 GMT
Message-Id: <201112220301.pBM31lEx049043@freefall.freebsd.org>
To: eadler@FreeBSD.org, freebsd-doc@FreeBSD.org, eadler@FreeBSD.org
From: eadler@FreeBSD.org
Cc: 
Subject: Re: docs/161588: Missing "-l name" option from pw(8) USER section
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, 22 Dec 2011 03:01:47 -0000

Synopsis: Missing "-l name" option from pw(8) USER section

Responsible-Changed-From-To: freebsd-doc->eadler
Responsible-Changed-By: eadler
Responsible-Changed-When: Thu Dec 22 03:01:46 UTC 2011
Responsible-Changed-Why: 
I'll take it - keep in mind .Dd has to be changed too

http://www.freebsd.org/cgi/query-pr.cgi?pr=161588

From owner-freebsd-doc@FreeBSD.ORG  Thu Dec 22 03:30:11 2011
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 0DAC31065673
	for <freebsd-doc@hub.freebsd.org>; Thu, 22 Dec 2011 03:30: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 DF6A28FC14
	for <freebsd-doc@hub.freebsd.org>; Thu, 22 Dec 2011 03:30:10 +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 pBM3UAJ6071002
	for <freebsd-doc@freefall.freebsd.org>; Thu, 22 Dec 2011 03:30:10 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.14.5/8.14.5/Submit) id pBM3UAS1070998;
	Thu, 22 Dec 2011 03:30:10 GMT (envelope-from gnats)
Resent-Date: Thu, 22 Dec 2011 03:30:10 GMT
Resent-Message-Id: <201112220330.pBM3UAS1070998@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,
	Sahil Tandon <sahil@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id B7310106564A;
	Thu, 22 Dec 2011 03:24:43 +0000 (UTC)
	(envelope-from sahil@spartan.hamla.org)
Received: from spartan.hamla.org (spartan.hamla.org [206.251.255.30])
	by mx1.freebsd.org (Postfix) with ESMTP id A1DC78FC08;
	Thu, 22 Dec 2011 03:24:42 +0000 (UTC)
Received: by spartan.hamla.org (Postfix, from userid 1001)
	id 95137170FE; Wed, 21 Dec 2011 22:09:33 -0500 (EST)
Message-Id: <20111222030933.95137170FE@spartan.hamla.org>
Date: Wed, 21 Dec 2011 22:09:33 -0500 (EST)
From: Sahil Tandon <sahil@FreeBSD.org>
To: FreeBSD-gnats-submit@FreeBSD.org
X-Send-Pr-Version: 3.113
Cc: gjb@FreeBSD.org
Subject: docs/163522: [PATCH] New mailing list:
	freebsd-ports-announce@freebsd.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: Sahil Tandon <sahil@FreeBSD.org>
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, 22 Dec 2011 03:30:11 -0000


>Number:         163522
>Category:       docs
>Synopsis:       [PATCH] New mailing list: freebsd-ports-announce@freebsd.org
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Dec 22 03:30:10 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Sahil Tandon
>Release:        FreeBSD 8.2-STABLE i386
>Organization:
>Environment:

	
>Description:
Per request from portmgr@, as communicated to postmaster@ by
Thomas Abthorpe (tabthorpe@), we have created a new Mailman-managed
public mailing list.  This PR contains a patch to update the
relevant sections of the online documentation; please adjust and
canonicalize as necessary.
>How-To-Repeat:
	
>Fix:

	



--- patch.txt begins here ---
Index: en_US.ISO8859-1/books/handbook/eresources/chapter.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/eresources/chapter.sgml,v
retrieving revision 1.215
diff -u -r1.215 chapter.sgml
--- en_US.ISO8859-1/books/handbook/eresources/chapter.sgml	21 Oct 2011 17:57:41 -0000	1.215
+++ en_US.ISO8859-1/books/handbook/eresources/chapter.sgml	13 Dec 2011 23:57:16 -0000
@@ -439,6 +439,11 @@
 	    </row>
 
 	    <row>
+	      <entry>&a.ports-announce.name;</entry>
+	      <entry>Important news and instructions about the Ports Collection</entry>
+	    </row>
+
+	    <row>
 	      <entry>&a.ports-bugs.name;</entry>
 	      <entry>Discussion of the ports bugs/PRs</entry>
 	    </row>
@@ -1523,6 +1528,21 @@
 	</varlistentry>
 
 	<varlistentry>
+	  <term>&a.ports-announce.name;</term>
+          
+	  <listitem>
+	    <para><emphasis>Important news and instructions about the FreeBSD
+		<quote>ports collection</quote></emphasis></para>
+            
+	    <para>Important news for developers, porters, and users of the <quote>ports
+	      collection</quote> (<filename>/usr/ports</filename>), including 
+	      architecture/infrastructure changes, new capabilities, critical upgrade
+	      instructions, and release engineering information.  This is a low-volume
+	      mailing list, intended for announcements.</para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
 	  <term>&a.ports-bugs.name;</term>
 
 	  <listitem>
Index: en_US.ISO8859-1/share/sgml/mailing-lists.ent
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/share/sgml/mailing-lists.ent,v
retrieving revision 1.86
diff -u -r1.86 mailing-lists.ent
--- en_US.ISO8859-1/share/sgml/mailing-lists.ent	21 Oct 2011 16:49:38 -0000	1.86
+++ en_US.ISO8859-1/share/sgml/mailing-lists.ent	13 Dec 2011 23:57:16 -0000
@@ -339,6 +339,10 @@
 <!ENTITY a.ports "<ulink url='&a.ports.url;'>FreeBSD ports mailing list</ulink>">
 <!ENTITY a.ports.name "<ulink url='&a.ports.url;'>freebsd-ports</ulink>">
 
+<!ENTITY a.ports-announce.url "&a.mailman.listinfo;/freebsd-ports-announce">
+<!ENTITY a.ports-announce "<ulink url='&a.ports-announce.url;'>FreeBSD ports announce mailing list</ulink>">
+<!ENTITY a.ports-announce.name "<ulink url='&a.ports-announce.url;'>freebsd-ports-announce</ulink>">
+
 <!ENTITY a.ports-bugs.url "&a.mailman.listinfo;/freebsd-ports-bugs">
 <!ENTITY a.ports-bugs "<ulink url='&a.ports-bugs.url;'>FreeBSD ports bugs mailing list</ulink>">
 <!ENTITY a.ports-bugs.name "<ulink url='&a.ports-bugs.url;'>freebsd-ports-bugs</ulink>">
--- patch.txt ends here ---

>Release-Note:
>Audit-Trail:
>Unformatted:

From owner-freebsd-doc@FreeBSD.ORG  Thu Dec 22 03:34:35 2011
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 5000A1065670;
	Thu, 22 Dec 2011 03:34:35 +0000 (UTC) (envelope-from gjb@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
	[IPv6:2001:4f8:fff6::28])
	by mx1.freebsd.org (Postfix) with ESMTP id 227A48FC0C;
	Thu, 22 Dec 2011 03:34:35 +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 pBM3YZMR081183;
	Thu, 22 Dec 2011 03:34:35 GMT
	(envelope-from gjb@freefall.freebsd.org)
Received: (from gjb@localhost)
	by freefall.freebsd.org (8.14.5/8.14.5/Submit) id pBM3YYQW081179;
	Thu, 22 Dec 2011 03:34:34 GMT (envelope-from gjb)
Date: Thu, 22 Dec 2011 03:34:34 GMT
Message-Id: <201112220334.pBM3YYQW081179@freefall.freebsd.org>
To: gjb@FreeBSD.org, freebsd-doc@FreeBSD.org, gjb@FreeBSD.org
From: gjb@FreeBSD.org
Cc: 
Subject: Re: docs/163522: [PATCH] New mailing list:
	freebsd-ports-announce@freebsd.org
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, 22 Dec 2011 03:34:35 -0000

Synopsis: [PATCH] New mailing list: freebsd-ports-announce@freebsd.org

Responsible-Changed-From-To: freebsd-doc->gjb
Responsible-Changed-By: gjb
Responsible-Changed-When: Thu Dec 22 03:34:13 UTC 2011
Responsible-Changed-Why: 
I'll take it.


http://www.freebsd.org/cgi/query-pr.cgi?pr=163522

From owner-freebsd-doc@FreeBSD.ORG  Thu Dec 22 11:00:32 2011
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 53A0810656B0
	for <freebsd-doc@hub.freebsd.org>; Thu, 22 Dec 2011 11:00:32 +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 E2F738FC16
	for <freebsd-doc@hub.freebsd.org>; Thu, 22 Dec 2011 11:00:25 +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 pBMB0Pah020882
	for <freebsd-doc@freefall.freebsd.org>; Thu, 22 Dec 2011 11:00:25 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.14.5/8.14.5/Submit) id pBMB0Pgu020881;
	Thu, 22 Dec 2011 11:00:25 GMT (envelope-from gnats)
Resent-Date: Thu, 22 Dec 2011 11:00:25 GMT
Resent-Message-Id: <201112221100.pBMB0Pgu020881@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,
	Garrett Cooper <yanegomi@gmail.com>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 1220C1065673
	for <freebsd-gnats-submit@FreeBSD.org>;
	Thu, 22 Dec 2011 10:54:17 +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 EAF1F8FC0A
	for <freebsd-gnats-submit@FreeBSD.org>;
	Thu, 22 Dec 2011 10:54:16 +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 pBMAsGGB041189
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 22 Dec 2011 10:54:16 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id pBMAsG1E041180;
	Thu, 22 Dec 2011 10:54:16 GMT (envelope-from nobody)
Message-Id: <201112221054.pBMAsG1E041180@red.freebsd.org>
Date: Thu, 22 Dec 2011 10:54:16 GMT
From: Garrett Cooper <yanegomi@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-3.1
Cc: 
Subject: docs/163527: [patch] Update tuning(7) a bit
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, 22 Dec 2011 11:00:32 -0000


>Number:         163527
>Category:       docs
>Synopsis:       [patch] Update tuning(7) a bit
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Dec 22 11:00:25 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Garrett Cooper
>Release:        9.0-RC2
>Organization:
n/a
>Environment:
FreeBSD bayonetta.local 9.0-RC2 FreeBSD 9.0-RC2 #0: Sun Nov 13 21:17:31 PST 2011     gcooper@bayonetta.local:/usr/obj/store/freebsd/stable/9/sys/BAYONETTA  amd64
>Description:
- Some of the defaults in tuning(7) haven't been updated following the changes made to the networking stack and UFS in 9.x .
- The manpage still references sysinstall.
- The manpage is lacking a suggestion to increase kern.ipc.nmbclusters, and in fact the recommended defaults are way too low for cxgb(4), igb(4), and a handful of other network cards (the default today on 8.x/9.x is 25600).

The attached patch improves upon those items.
>How-To-Repeat:

>Fix:


Patch attached with submission follows:

Index: share/man/man7/tuning.7
===================================================================
--- share/man/man7/tuning.7	(revision 228662)
+++ share/man/man7/tuning.7	(working copy)
@@ -101,7 +101,9 @@
 depends on the kind of temporary file usage you think you will need.
 128M is
 the minimum we recommend.
-Also note that sysinstall will create a
+Also note that
+.Xr bsdinstall 8
+will create a
 .Pa /tmp
 directory.
 Dedicating a partition for temporary file storage is important for
@@ -219,7 +221,7 @@
 .Pp
 .Fx
 performs best when using 8K or 16K file system block sizes.
-The default file system block size is 16K,
+The default file system block size is 32K,
 which provides best performance for most applications,
 with the exception of those that perform random access on large files
 (such as database server software).
@@ -286,7 +288,7 @@
 option to
 .Xr newfs 8 ,
 and
-.Xr sysinstall 8
+.Xr bsdinstall 8
 will typically enable softupdates automatically for non-root file systems).
 Softupdates drastically improves meta-data performance, mainly file
 creation and deletion.
@@ -525,8 +527,8 @@
 to pre-read if the heuristics algorithm decides that the reads are
 issued sequentially.
 It is used by the UFS, ext2fs and msdosfs file systems.
-With the default UFS block size of 16 KiB, a setting of 32 will allow
-speculatively reading up to 512 KiB.
+With the default UFS block size of 32 KiB, a setting of 32 will allow
+speculatively reading up to 1 MiB.
 This setting may be increased to get around disk I/O latencies, especially
 where these latencies are large such as in virtual machine emulated
 environments.
@@ -566,8 +568,8 @@
 applications.
 They control the amount of send and receive buffer space
 allowed for any given TCP connection.
-The default sending buffer is 32K; the default receiving buffer
-is 64K.
+The default sending buffer is 128K; the default receiving buffer
+is 256K.
 You can often
 improve bandwidth utilization by increasing the default at the cost of
 eating up more kernel memory for each connection.
@@ -873,6 +875,15 @@
 Under no circumstances
 should you specify an arbitrarily high value for this parameter, it could
 lead to a boot-time crash.
+Please note that some drivers, require larger values, and in some cases the
+interfaces will hang on probe, e.g. dual-port (in some configurations) or
+quad-port
+.Xr igb 4 ,
+or cause system panics, e.g.
+.Xr cxgb 4 ,
+if you set
+.Va kern.ipc.nmbclusters
+to something less than 50000 and 75000, respectively.
 The
 .Fl m
 option to
@@ -1041,6 +1052,7 @@
 .Xr hier 7 ,
 .Xr ports 7 ,
 .Xr boot 8 ,
+.Xr bsdinstall 8 ,
 .Xr bsdlabel 8 ,
 .Xr ccdconfig 8 ,
 .Xr config 8 ,
@@ -1055,7 +1067,6 @@
 .Xr newfs 8 ,
 .Xr route 8 ,
 .Xr sysctl 8 ,
-.Xr sysinstall 8 ,
 .Xr tunefs 8
 .Sh HISTORY
 The


>Release-Note:
>Audit-Trail:
>Unformatted:

From owner-freebsd-doc@FreeBSD.ORG  Thu Dec 22 11:40:09 2011
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 072EE106564A
	for <freebsd-doc@hub.freebsd.org>; Thu, 22 Dec 2011 11:40:09 +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 DE67E8FC0A
	for <freebsd-doc@hub.freebsd.org>; Thu, 22 Dec 2011 11:40:08 +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 pBMBe8Jx061588
	for <freebsd-doc@freefall.freebsd.org>; Thu, 22 Dec 2011 11:40:08 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.14.5/8.14.5/Submit) id pBMBe8qv061587;
	Thu, 22 Dec 2011 11:40:08 GMT (envelope-from gnats)
Date: Thu, 22 Dec 2011 11:40:08 GMT
Message-Id: <201112221140.pBMBe8qv061587@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: Garrett Cooper <yanegomi@gmail.com>
Cc: 
Subject: docs/163527: [patch] Update tuning(7) a bit
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: Garrett Cooper <yanegomi@gmail.com>
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, 22 Dec 2011 11:40:09 -0000

The following reply was made to PR docs/163527; it has been noted by GNATS.

From: Garrett Cooper <yanegomi@gmail.com>
To: bug-followup <bug-followup@freebsd.org>
Cc:  
Subject: docs/163527: [patch] Update tuning(7) a bit
Date: Thu, 22 Dec 2011 03:32:58 -0800

 --f46d044470bf8c8fa004b4aca9d9
 Content-Type: text/plain; charset=ISO-8859-1
 Content-Transfer-Encoding: quoted-printable
 
 =A0 =A0 =A0 =A0I just reread the proposed addition to kern.ipc.nmbclusters =
 and
 cringed at my grammar. The proposed change isn't fantastic either
 (still draft quality in my mind), but it's better than the first
 proposed change.
 Thanks,
 -Garrett
 
 --f46d044470bf8c8fa004b4aca9d9
 Content-Type: TEXT/PLAIN; charset=US-ASCII; name="update-tuning-manpage.patch.txt"
 Content-Disposition: attachment; filename="update-tuning-manpage.patch.txt"
 Content-Transfer-Encoding: base64
 Content-ID: <alpine.BSF.2.00.1112220310360.19043@toaster.local>
 X-Attachment-Id: db257b2d21c828d8_0.1
 
 SW5kZXg6IHNoYXJlL21hbi9tYW43L3R1bmluZy43DQo9PT09PT09PT09PT09PT09PT09PT09PT09
 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQotLS0gc2hhcmUvbWFu
 L21hbjcvdHVuaW5nLjcJKHJldmlzaW9uIDIyODY2MikNCisrKyBzaGFyZS9tYW4vbWFuNy90dW5p
 bmcuNwkod29ya2luZyBjb3B5KQ0KQEAgLTEwMSw3ICsxMDEsOSBAQA0KIGRlcGVuZHMgb24gdGhl
 IGtpbmQgb2YgdGVtcG9yYXJ5IGZpbGUgdXNhZ2UgeW91IHRoaW5rIHlvdSB3aWxsIG5lZWQuDQog
 MTI4TSBpcw0KIHRoZSBtaW5pbXVtIHdlIHJlY29tbWVuZC4NCi1BbHNvIG5vdGUgdGhhdCBzeXNp
 bnN0YWxsIHdpbGwgY3JlYXRlIGENCitBbHNvIG5vdGUgdGhhdA0KKy5YciBic2RpbnN0YWxsIDgN
 Cit3aWxsIGNyZWF0ZSBhDQogLlBhIC90bXANCiBkaXJlY3RvcnkuDQogRGVkaWNhdGluZyBhIHBh
 cnRpdGlvbiBmb3IgdGVtcG9yYXJ5IGZpbGUgc3RvcmFnZSBpcyBpbXBvcnRhbnQgZm9yDQpAQCAt
 MjE5LDcgKzIyMSw3IEBADQogLlBwDQogLkZ4DQogcGVyZm9ybXMgYmVzdCB3aGVuIHVzaW5nIDhL
 IG9yIDE2SyBmaWxlIHN5c3RlbSBibG9jayBzaXplcy4NCi1UaGUgZGVmYXVsdCBmaWxlIHN5c3Rl
 bSBibG9jayBzaXplIGlzIDE2SywNCitUaGUgZGVmYXVsdCBmaWxlIHN5c3RlbSBibG9jayBzaXpl
 IGlzIDMySywNCiB3aGljaCBwcm92aWRlcyBiZXN0IHBlcmZvcm1hbmNlIGZvciBtb3N0IGFwcGxp
 Y2F0aW9ucywNCiB3aXRoIHRoZSBleGNlcHRpb24gb2YgdGhvc2UgdGhhdCBwZXJmb3JtIHJhbmRv
 bSBhY2Nlc3Mgb24gbGFyZ2UgZmlsZXMNCiAoc3VjaCBhcyBkYXRhYmFzZSBzZXJ2ZXIgc29mdHdh
 cmUpLg0KQEAgLTI4Niw3ICsyODgsNyBAQA0KIG9wdGlvbiB0bw0KIC5YciBuZXdmcyA4ICwNCiBh
 bmQNCi0uWHIgc3lzaW5zdGFsbCA4DQorLlhyIGJzZGluc3RhbGwgOA0KIHdpbGwgdHlwaWNhbGx5
 IGVuYWJsZSBzb2Z0dXBkYXRlcyBhdXRvbWF0aWNhbGx5IGZvciBub24tcm9vdCBmaWxlIHN5c3Rl
 bXMpLg0KIFNvZnR1cGRhdGVzIGRyYXN0aWNhbGx5IGltcHJvdmVzIG1ldGEtZGF0YSBwZXJmb3Jt
 YW5jZSwgbWFpbmx5IGZpbGUNCiBjcmVhdGlvbiBhbmQgZGVsZXRpb24uDQpAQCAtNTI1LDggKzUy
 Nyw4IEBADQogdG8gcHJlLXJlYWQgaWYgdGhlIGhldXJpc3RpY3MgYWxnb3JpdGhtIGRlY2lkZXMg
 dGhhdCB0aGUgcmVhZHMgYXJlDQogaXNzdWVkIHNlcXVlbnRpYWxseS4NCiBJdCBpcyB1c2VkIGJ5
 IHRoZSBVRlMsIGV4dDJmcyBhbmQgbXNkb3NmcyBmaWxlIHN5c3RlbXMuDQotV2l0aCB0aGUgZGVm
 YXVsdCBVRlMgYmxvY2sgc2l6ZSBvZiAxNiBLaUIsIGEgc2V0dGluZyBvZiAzMiB3aWxsIGFsbG93
 DQotc3BlY3VsYXRpdmVseSByZWFkaW5nIHVwIHRvIDUxMiBLaUIuDQorV2l0aCB0aGUgZGVmYXVs
 dCBVRlMgYmxvY2sgc2l6ZSBvZiAzMiBLaUIsIGEgc2V0dGluZyBvZiAzMiB3aWxsIGFsbG93DQor
 c3BlY3VsYXRpdmVseSByZWFkaW5nIHVwIHRvIDEgTWlCLg0KIFRoaXMgc2V0dGluZyBtYXkgYmUg
 aW5jcmVhc2VkIHRvIGdldCBhcm91bmQgZGlzayBJL08gbGF0ZW5jaWVzLCBlc3BlY2lhbGx5DQog
 d2hlcmUgdGhlc2UgbGF0ZW5jaWVzIGFyZSBsYXJnZSBzdWNoIGFzIGluIHZpcnR1YWwgbWFjaGlu
 ZSBlbXVsYXRlZA0KIGVudmlyb25tZW50cy4NCkBAIC01NjYsOCArNTY4LDggQEANCiBhcHBsaWNh
 dGlvbnMuDQogVGhleSBjb250cm9sIHRoZSBhbW91bnQgb2Ygc2VuZCBhbmQgcmVjZWl2ZSBidWZm
 ZXIgc3BhY2UNCiBhbGxvd2VkIGZvciBhbnkgZ2l2ZW4gVENQIGNvbm5lY3Rpb24uDQotVGhlIGRl
 ZmF1bHQgc2VuZGluZyBidWZmZXIgaXMgMzJLOyB0aGUgZGVmYXVsdCByZWNlaXZpbmcgYnVmZmVy
 DQotaXMgNjRLLg0KK1RoZSBkZWZhdWx0IHNlbmRpbmcgYnVmZmVyIGlzIDEyOEs7IHRoZSBkZWZh
 dWx0IHJlY2VpdmluZyBidWZmZXINCitpcyAyNTZLLg0KIFlvdSBjYW4gb2Z0ZW4NCiBpbXByb3Zl
 IGJhbmR3aWR0aCB1dGlsaXphdGlvbiBieSBpbmNyZWFzaW5nIHRoZSBkZWZhdWx0IGF0IHRoZSBj
 b3N0IG9mDQogZWF0aW5nIHVwIG1vcmUga2VybmVsIG1lbW9yeSBmb3IgZWFjaCBjb25uZWN0aW9u
 Lg0KQEAgLTg3Myw2ICs4NzUsMTUgQEANCiBVbmRlciBubyBjaXJjdW1zdGFuY2VzDQogc2hvdWxk
 IHlvdSBzcGVjaWZ5IGFuIGFyYml0cmFyaWx5IGhpZ2ggdmFsdWUgZm9yIHRoaXMgcGFyYW1ldGVy
 LCBpdCBjb3VsZA0KIGxlYWQgdG8gYSBib290LXRpbWUgY3Jhc2guDQorUGxlYXNlIG5vdGUgdGhh
 dCBzb21lIGRyaXZlcnMgcmVxdWlyZSBsYXJnZXIgdmFsdWVzLCBhbmQgaW4gc29tZSBjYXNlcyB0
 aGUNCitpbnRlcmZhY2VzIG5vdCBmdW5jdGlvbjsgc29tZSBkcml2ZXJzIGFyZSBrbm93biB0byBo
 YW5nIG9uDQorcHJvYmUvY29uZmlndXJhdGlvbiwgZS5nLiBzb21lIGR1YWwtcG9ydCBvciBxdWFk
 LXBvcnQNCisuWHIgaWdiIDQgLA0KK2NhcmRzLCBvciBjYXVzZSBzeXN0ZW0gcGFuaWNzLCBlLmcu
 DQorLlhyIGN4Z2IgNCAsDQoraWYgeW91IHNldA0KKy5WYSBrZXJuLmlwYy5ubWJjbHVzdGVycw0K
 K3RvIHNvbWV0aGluZyBsZXNzIHRoYW4gNTAwMDAgYW5kIDc1MDAwLCByZXNwZWN0aXZlbHkuDQog
 VGhlDQogLkZsIG0NCiBvcHRpb24gdG8NCkBAIC0xMDQxLDYgKzEwNTIsNyBAQA0KIC5YciBoaWVy
 IDcgLA0KIC5YciBwb3J0cyA3ICwNCiAuWHIgYm9vdCA4ICwNCisuWHIgYnNkaW5zdGFsbCA4ICwN
 CiAuWHIgYnNkbGFiZWwgOCAsDQogLlhyIGNjZGNvbmZpZyA4ICwNCiAuWHIgY29uZmlnIDggLA0K
 QEAgLTEwNTUsNyArMTA2Nyw2IEBADQogLlhyIG5ld2ZzIDggLA0KIC5YciByb3V0ZSA4ICwNCiAu
 WHIgc3lzY3RsIDggLA0KLS5YciBzeXNpbnN0YWxsIDggLA0KIC5YciB0dW5lZnMgOA0KIC5TaCBI
 SVNUT1JZDQogVGhlDQo=
 --f46d044470bf8c8fa004b4aca9d9--

From owner-freebsd-doc@FreeBSD.ORG  Fri Dec 23 20:20:19 2011
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 E62A610656F9
	for <freebsd-doc@hub.freebsd.org>; Fri, 23 Dec 2011 20:20:19 +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 34B448FC20
	for <freebsd-doc@hub.freebsd.org>; Fri, 23 Dec 2011 20: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 pBNKKIFF035150
	for <freebsd-doc@freefall.freebsd.org>; Fri, 23 Dec 2011 20: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 pBNKKIug035149;
	Fri, 23 Dec 2011 20:20:18 GMT (envelope-from gnats)
Resent-Date: Fri, 23 Dec 2011 20:20:18 GMT
Resent-Message-Id: <201112232020.pBNKKIug035149@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,
	Garrett Cooper <yanegomi@gmail.com>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id C0BB3106566B
	for <freebsd-gnats-submit@FreeBSD.org>;
	Fri, 23 Dec 2011 20:17: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 AF8B18FC08
	for <freebsd-gnats-submit@FreeBSD.org>;
	Fri, 23 Dec 2011 20:17: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 pBNKHAdd058042
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 23 Dec 2011 20:17:10 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id pBNKHAgS058041;
	Fri, 23 Dec 2011 20:17:10 GMT (envelope-from nobody)
Message-Id: <201112232017.pBNKHAgS058041@red.freebsd.org>
Date: Fri, 23 Dec 2011 20:17:10 GMT
From: Garrett Cooper <yanegomi@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-3.1
Cc: 
Subject: docs/163576: zfs(8) sync property not noted in the manpage
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: Fri, 23 Dec 2011 20:20:20 -0000


>Number:         163576
>Category:       docs
>Synopsis:       zfs(8) sync property not noted in the manpage
>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 Dec 23 20:20:17 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Garrett Cooper
>Release:        10-CURRENT
>Organization:
n/a
>Environment:
FreeBSD streetfighter.ixsystems.com 10.0-CURRENT FreeBSD 10.0-CURRENT #0 r227801: Mon Nov 21 14:04:39 PST 2011     root@streetfighter.ixsystems.com:/usr/obj/usr/src/sys/STREETFIGHTER  amd64
>Description:
The sync property isn't discussed in the zfs(8) manpage.

The sync property allows administrators to turn off write synchronization at the "filesystem" level (in reality the ZIL level according to /sys/cddl/contrib/opensolaris/uts/common/fs/zfs/dmu_objset.c), which might improve performance in some scenarios.

Just like setting checksum=off though, it should be highly discouraged option to tweak because with standard setups and with some disk technologies (*ATA and some big HDD vendors, I'm looking at you ;)..), this could result in catastrophic data loss in the event where enough drives become unavailable, there's a system (software/hardware) failure, or power outage.
>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:
>Unformatted:

From owner-freebsd-doc@FreeBSD.ORG  Fri Dec 23 21:10:12 2011
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 89F1A106564A
	for <freebsd-doc@hub.freebsd.org>; Fri, 23 Dec 2011 21: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 5E92F8FC1B
	for <freebsd-doc@hub.freebsd.org>; Fri, 23 Dec 2011 21: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 pBNLACsA080043
	for <freebsd-doc@freefall.freebsd.org>; Fri, 23 Dec 2011 21: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 pBNLACww080040;
	Fri, 23 Dec 2011 21:10:12 GMT (envelope-from gnats)
Date: Fri, 23 Dec 2011 21:10:12 GMT
Message-Id: <201112232110.pBNLACww080040@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: Garrett Cooper <yanegomi@gmail.com>
Cc: 
Subject: Re: docs/163527: [patch] Update tuning(7) a bit
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: Garrett Cooper <yanegomi@gmail.com>
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: Fri, 23 Dec 2011 21:10:12 -0000

The following reply was made to PR docs/163527; it has been noted by GNATS.

From: Garrett Cooper <yanegomi@gmail.com>
To: bug-followup@FreeBSD.org, yanegomi@gmail.com
Cc:  
Subject: Re: docs/163527: [patch] Update tuning(7) a bit
Date: Fri, 23 Dec 2011 13:09:25 -0800

     I let some of my tweaks leak into the suggested changes: in
 reality, net.inet.tcp.{recv,send}space haven't changed to those new
 defaults. tuning(7) is being updated per
 http://wiki.freebsd.org/SystemTuning , so I'd just close this PR
 because the actual formulated recommended defaults will be determined
 there and seriously reviewed, compared to what I did here.
 Thanks!
 -Garrett

From owner-freebsd-doc@FreeBSD.ORG  Fri Dec 23 22:59:06 2011
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 F09F3106564A;
	Fri, 23 Dec 2011 22:59:06 +0000 (UTC)
	(envelope-from linimon@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
	[IPv6:2001:4f8:fff6::28])
	by mx1.freebsd.org (Postfix) with ESMTP id C79BE8FC15;
	Fri, 23 Dec 2011 22:59:06 +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 pBNMx6Vj080616;
	Fri, 23 Dec 2011 22:59:06 GMT
	(envelope-from linimon@freefall.freebsd.org)
Received: (from linimon@localhost)
	by freefall.freebsd.org (8.14.5/8.14.5/Submit) id pBNMx6Q9080612;
	Fri, 23 Dec 2011 22:59:06 GMT (envelope-from linimon)
Date: Fri, 23 Dec 2011 22:59:06 GMT
Message-Id: <201112232259.pBNMx6Q9080612@freefall.freebsd.org>
To: yanegomi@gmail.com, linimon@FreeBSD.org, freebsd-doc@FreeBSD.org
From: linimon@FreeBSD.org
Cc: 
Subject: Re: docs/163527: [patch] Update tuning(7) a bit
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: Fri, 23 Dec 2011 22:59:07 -0000

Synopsis: [patch] Update tuning(7) a bit

State-Changed-From-To: open->closed
State-Changed-By: linimon
State-Changed-When: Fri Dec 23 22:58:03 UTC 2011
State-Changed-Why: 
Closed at submitter's request.  The wording of the page is
currently being discussed on the wiki.

http://www.freebsd.org/cgi/query-pr.cgi?pr=163527