From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 03:09:54 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 4FDFE106564A for ; Mon, 2 Jan 2012 03:09:54 +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 1226A8FC0A for ; Mon, 2 Jan 2012 03:09:53 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q0239rpV061263 for ; Sun, 1 Jan 2012 20:09:53 -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 q0239rjw061260 for ; Sun, 1 Jan 2012 20:09:53 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Sun, 1 Jan 2012 20:09:53 -0700 (MST) From: Warren Block To: doc@freebsd.org Message-ID: 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]); Sun, 01 Jan 2012 20:09:53 -0700 (MST) Cc: Subject: RFC: modifying the doc CSS 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, 02 Jan 2012 03:09:54 -0000 Feedback welcome on some proposed modifications to the default DocBook CSS (/usr/doc/share/misc/docbook.css). Samples for side-by-side comparison: Existing: http://www.wonkity.com/~wblock/porters-handbook-orig/book.html Proposed: http://www.wonkity.com/~wblock/porters-handbook/book.html The proposed CSS: http://www.wonkity.com/~wblock/porters-handbook/docbook.css Changes: Left-align table headers. Add rounded border corners. Fix uneven margin spacing on notes and other blockquotes. Remove padding entries from various blockquotes. Reduce "body blockquote" line-spacing: from 1.5 to 1.3 so lines don't look double-spaced. Set line-height: 1.1 in programlistings so descenders have a little clearance. From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 06:30:19 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 9132E106564A for ; Mon, 2 Jan 2012 06:30: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 65AEA8FC14 for ; Mon, 2 Jan 2012 06:30:19 +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 q026UJCO013555 for ; Mon, 2 Jan 2012 06:30:19 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q026UJ1f013554; Mon, 2 Jan 2012 06:30:19 GMT (envelope-from gnats) Date: Mon, 2 Jan 2012 06:30:19 GMT Message-Id: <201201020630.q026UJ1f013554@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Benjamin Kaduk Cc: Subject: Re: docs/163742: [patch] document failok mount(8) option X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Benjamin Kaduk List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 02 Jan 2012 06:30:19 -0000 The following reply was made to PR docs/163742; it has been noted by GNATS. From: Benjamin Kaduk To: Garrett Cooper Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/163742: [patch] document failok mount(8) option Date: Mon, 2 Jan 2012 01:27:59 -0500 (EST) On Sat, 31 Dec 2011, Garrett Cooper wrote: >> Description: > The failok option isn't documented in mount(8). As noted in the sbin/mount/mount.c: > > 730 } else if (strcmp(p, "failok") == 0) { > 731 /* > 732 * "failok" is used to prevent certain file > 733 * systems from being causing the system to > 734 * drop into single user mode in the boot > 735 * cycle, and is not a real mount option. > 736 */ > 737 continue; > r222832 also introduced (some) documentation of failok in fstab.5 -- do you feel that this is insufficient and it also needs to be documented in mount.8? > The attached patch documents the missing option. >> How-To-Repeat: > >> Fix: > > > Patch attached with submission follows: > > Index: sbin/mount/mount.8 > =================================================================== > --- sbin/mount/mount.8 (revision 228846) > +++ sbin/mount/mount.8 (working copy) > @@ -145,6 +145,13 @@ > .Fl u > flag, this is the same as specifying the options currently in effect for > the mounted file system. > +.It Cm failok > +This option is used to prevent certain file systems from dropping into > +single-user mode when booting up; it is used internally in > +.Xr mount 8 > +and thus is not a true > +.Xr mount 2 > +flag. It seems hard to phrase this in an unconfusing manner. I would probably say "this option is used to indicate that if an error occurs during the mounting of a file system, the boot process should continue on normally. This is in contrast to the normal behavior where a mount error will cause the system to drop into single-user mode." -Ben From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 07:40:15 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 637861065670 for ; Mon, 2 Jan 2012 07:40:15 +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 468288FC14 for ; Mon, 2 Jan 2012 07:40:15 +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 q027eEZv005608 for ; Mon, 2 Jan 2012 07:40:14 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q027eEpf005607; Mon, 2 Jan 2012 07:40:14 GMT (envelope-from gnats) Date: Mon, 2 Jan 2012 07:40:14 GMT Message-Id: <201201020740.q027eEpf005607@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Benjamin Kaduk Cc: Subject: Re: docs/163646: update man ehci(4) to mention options USB_DEBUG X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Benjamin Kaduk List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 02 Jan 2012 07:40:15 -0000 The following reply was made to PR docs/163646; it has been noted by GNATS. From: Benjamin Kaduk To: Momchil Ivanov Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/163646: update man ehci(4) to mention options USB_DEBUG Date: Mon, 2 Jan 2012 02:32:14 -0500 (EST) This message is in MIME format. The first part should be readable text, while the remaining parts are likely unreadable without MIME-aware tools. ---559023410-1096159132-1325489534=:882 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed On Tue, 27 Dec 2011, Momchil Ivanov wrote: > >> Description: > The man page of ehci(4) mentions "LOADER TUNABLES" but they are only available after compiling the kernel with "options USB_DEBUG", which is not mentioned. The man page should make it clear that one needs to recompile the kernel with that option or these sysctls should be made availabe without "options USB_DEBUG". Probably the easiest way would be to update the man page and also mention that the sysctl hw.usb.ehci.lostintrbug is highly probable to solve problems with slow devices or ones that get stalled regularly. > > For more information refer to the following thread [1]. > > 1: http://lists.freebsd.org/pipermail/freebsd-usb/2011-December/010940.html I think that the attached patch should suffice (inline for convenience, too, since it's short): --- ehci.4.orig 2012-01-02 02:04:25.000000000 -0500 +++ ehci.4 2012-01-02 02:28:13.000000000 -0500 @@ -29,7 +29,7 @@ .\" .\" $FreeBSD: head/share/man/man4/ehci.4 219004 2011-02-24 18:08:23Z hselasky $ .\" -.Dd February 24, 2011 +.Dd January 2, 2012 .Dt EHCI 4 .Os .Sh NAME @@ -80,7 +80,11 @@ device driver first appeared in .Fx 5.1 . .Sh LOADER TUNABLES -Tunables can be set at the +When the kernel has been compiled with +.Cd options USB_DEBUG , +some tunables become available that affect the behavior of +.Nm . +These tunables can be set at the .Xr loader 8 prompt before booting the kernel or stored in .Xr loader.conf 5 . -Ben Kaduk ---559023410-1096159132-1325489534=:882 Content-Type: TEXT/PLAIN; charset=US-ASCII; name=ehci.4.diff.txt Content-Transfer-Encoding: BASE64 Content-ID: Content-Description: Content-Disposition: attachment; filename=ehci.4.diff.txt LS0tIGVoY2kuNC5vcmlnCTIwMTItMDEtMDIgMDI6MDQ6MjUuMDAwMDAwMDAw IC0wNTAwDQorKysgZWhjaS40CTIwMTItMDEtMDIgMDI6Mjg6MTMuMDAwMDAw MDAwIC0wNTAwDQpAQCAtMjksNyArMjksNyBAQA0KIC5cIg0KIC5cIiAkRnJl ZUJTRDogaGVhZC9zaGFyZS9tYW4vbWFuNC9laGNpLjQgMjE5MDA0IDIwMTEt MDItMjQgMTg6MDg6MjNaIGhzZWxhc2t5ICQNCiAuXCINCi0uRGQgRmVicnVh cnkgMjQsIDIwMTENCisuRGQgSmFudWFyeSAyLCAyMDEyDQogLkR0IEVIQ0kg NA0KIC5Pcw0KIC5TaCBOQU1FDQpAQCAtODAsNyArODAsMTEgQEANCiBkZXZp Y2UgZHJpdmVyIGZpcnN0IGFwcGVhcmVkIGluDQogLkZ4IDUuMSAuDQogLlNo IExPQURFUiBUVU5BQkxFUw0KLVR1bmFibGVzIGNhbiBiZSBzZXQgYXQgdGhl DQorV2hlbiB0aGUga2VybmVsIGhhcyBiZWVuIGNvbXBpbGVkIHdpdGgNCisu Q2Qgb3B0aW9ucyBVU0JfREVCVUcgLA0KK3NvbWUgdHVuYWJsZXMgYmVjb21l IGF2YWlsYWJsZSB0aGF0IGFmZmVjdCB0aGUgYmVoYXZpb3Igb2YNCisuTm0g Lg0KK1RoZXNlIHR1bmFibGVzIGNhbiBiZSBzZXQgYXQgdGhlDQogLlhyIGxv YWRlciA4DQogcHJvbXB0IGJlZm9yZSBib290aW5nIHRoZSBrZXJuZWwgb3Ig c3RvcmVkIGluDQogLlhyIGxvYWRlci5jb25mIDUgLg0K ---559023410-1096159132-1325489534=:882-- From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 07:40:19 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 5104C106564A for ; Mon, 2 Jan 2012 07:40: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 33B408FC08 for ; Mon, 2 Jan 2012 07:40:19 +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 q027eJkP005640 for ; Mon, 2 Jan 2012 07:40:19 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q027eJCX005639; Mon, 2 Jan 2012 07:40:19 GMT (envelope-from gnats) Date: Mon, 2 Jan 2012 07:40:19 GMT Message-Id: <201201020740.q027eJCX005639@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Benjamin Kaduk Cc: Subject: Re: docs/163742: [patch] document failok mount(8) option X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Benjamin Kaduk List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 02 Jan 2012 07:40:19 -0000 The following reply was made to PR docs/163742; it has been noted by GNATS. From: Benjamin Kaduk To: Garrett Cooper Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/163742: [patch] document failok mount(8) option Date: Mon, 2 Jan 2012 02:36:45 -0500 (EST) This message is in MIME format. The first part should be readable text, while the remaining parts are likely unreadable without MIME-aware tools. ---559023410-854845245-1325489805=:882 Content-Type: TEXT/PLAIN; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: QUOTED-PRINTABLE On Sun, 1 Jan 2012, Garrett Cooper wrote: > On Sun, Jan 1, 2012 at 10:27 PM, Benjamin Kaduk wrote: >> On Sat, 31 Dec 2011, Garrett Cooper wrote: >> >>>> Description: >>> >>> The failok option isn't documented in mount(8). As noted in the >>> sbin/mount/mount.c: >>> >>> 730 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 } else if (strcmp(p= , "failok") =3D=3D 0) { >>> 731 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 /* >>> 732 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0= * "failok" is used to prevent certain >>> file >>> 733 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0= * systems from being causing the >>> system to >>> 734 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0= * drop into single user mode in the >>> boot >>> 735 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0= * cycle, and is not a real mount >>> option. >>> 736 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0= */ >>> 737 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 con= tinue; >>> >> >> >> r222832 also introduced (some) documentation of failok in fstab.5 -- do = you >> feel that this is insufficient and it also needs to be documented in >> mount.8? > > I look at mount*(8) before I look at fstab(5) as fstab(5) is far from > complete. I'm sure I'm not the only one. > > That and I can actually use it via mount -o on the commandline makes > more sense for it to be in mount(8) than fstab(5). > >>> The attached patch documents the missing option. > > ... > >> It seems hard to phrase this in an unconfusing manner. >> I would probably say "this option is used to indicate that if an error >> occurs during the mounting of a file system, the boot process should >> continue on normally. =A0This is in contrast to the normal behavior wher= e a >> mount error will cause the system to drop into single-user mode." > > I didn't really wordsmith the original text too much, as you noticed > above -- and quite frankly I wasn't happy with the text anyhow. > > The proposed sentences above get the meaning across, but in a bit > roundabout manner. What about this instead? > > 'In the event that mounting a filesystem via rc fails, standard > behavior is that the user is dropped into the 'administrative shell' > to diagnose the mount failure. The failok option allows mount failures > to pass. > > This option should be used on non-boot/-runtime critical filesystems.' No major objections. The "non-boot/-runtime" is a bit awkward, so I might= =20 prefer "should be used on file systems which are not critical for boot or= =20 runtime usage." Thanks, Ben ---559023410-854845245-1325489805=:882-- From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 07:50:13 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 DB48C1065677 for ; Mon, 2 Jan 2012 07:50:13 +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 AF8058FC15 for ; Mon, 2 Jan 2012 07:50:13 +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 q027oD09015004 for ; Mon, 2 Jan 2012 07:50:13 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q027oDIK014998; Mon, 2 Jan 2012 07:50:13 GMT (envelope-from gnats) Date: Mon, 2 Jan 2012 07:50:13 GMT Message-Id: <201201020750.q027oDIK014998@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Garrett Cooper Cc: Subject: Re: docs/163742: [patch] document failok mount(8) option X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Garrett Cooper List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 02 Jan 2012 07:50:13 -0000 The following reply was made to PR docs/163742; it has been noted by GNATS. From: Garrett Cooper To: Benjamin Kaduk Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/163742: [patch] document failok mount(8) option Date: Sun, 1 Jan 2012 23:22:23 -0800 On Sun, Jan 1, 2012 at 10:27 PM, Benjamin Kaduk wrote: > On Sat, 31 Dec 2011, Garrett Cooper wrote: > >>> Description: >> >> The failok option isn't documented in mount(8). As noted in the >> sbin/mount/mount.c: >> >> 730 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 } else if (strcmp(p,= "failok") =3D=3D 0) { >> 731 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 /* >> 732 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0*= "failok" is used to prevent certain >> file >> 733 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0*= systems from being causing the >> system to >> 734 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0*= drop into single user mode in the >> boot >> 735 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0*= cycle, and is not a real mount >> option. >> 736 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0*= / >> 737 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 cont= inue; >> > > > r222832 also introduced (some) documentation of failok in fstab.5 -- do y= ou > feel that this is insufficient and it also needs to be documented in > mount.8? I look at mount*(8) before I look at fstab(5) as fstab(5) is far from complete. I'm sure I'm not the only one. That and I can actually use it via mount -o on the commandline makes more sense for it to be in mount(8) than fstab(5). >> The attached patch documents the missing option. ... > It seems hard to phrase this in an unconfusing manner. > I would probably say "this option is used to indicate that if an error > occurs during the mounting of a file system, the boot process should > continue on normally. =A0This is in contrast to the normal behavior where= a > mount error will cause the system to drop into single-user mode." I didn't really wordsmith the original text too much, as you noticed above -- and quite frankly I wasn't happy with the text anyhow. The proposed sentences above get the meaning across, but in a bit roundabout manner. What about this instead? 'In the event that mounting a filesystem via rc fails, standard behavior is that the user is dropped into the 'administrative shell' to diagnose the mount failure. The failok option allows mount failures to pass. This option should be used on non-boot/-runtime critical filesystems.' Thanks! -Garrett From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 08:00:31 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 68723106566B for ; Mon, 2 Jan 2012 08:00:31 +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 4CACB8FC13 for ; Mon, 2 Jan 2012 08:00:31 +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 q0280VSw024037 for ; Mon, 2 Jan 2012 08:00:31 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q0280UgD024033; Mon, 2 Jan 2012 08:00:30 GMT (envelope-from gnats) Date: Mon, 2 Jan 2012 08:00:30 GMT Message-Id: <201201020800.q0280UgD024033@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Garrett Cooper Cc: Subject: Re: docs/163742: [patch] document failok mount(8) option X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Garrett Cooper List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 02 Jan 2012 08:00:31 -0000 The following reply was made to PR docs/163742; it has been noted by GNATS. From: Garrett Cooper To: Benjamin Kaduk Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/163742: [patch] document failok mount(8) option Date: Sun, 1 Jan 2012 23:50:35 -0800 On Sun, Jan 1, 2012 at 11:36 PM, Benjamin Kaduk wrote: > On Sun, 1 Jan 2012, Garrett Cooper wrote: > >> On Sun, Jan 1, 2012 at 10:27 PM, Benjamin Kaduk wrote: >>> >>> On Sat, 31 Dec 2011, Garrett Cooper wrote: >>> >>>>> Description: >>>> >>>> >>>> The failok option isn't documented in mount(8). As noted in the >>>> sbin/mount/mount.c: >>>> >>>> 730 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 } else if (strcmp(= p, "failok") =3D=3D 0) { >>>> 731 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 /* >>>> 732 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 = =A0* "failok" is used to prevent >>>> certain >>>> file >>>> 733 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 = =A0* systems from being causing the >>>> system to >>>> 734 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 = =A0* drop into single user mode in the >>>> boot >>>> 735 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 = =A0* cycle, and is not a real mount >>>> option. >>>> 736 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 = =A0*/ >>>> 737 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 co= ntinue; >>>> >>> >>> >>> r222832 also introduced (some) documentation of failok in fstab.5 -- do >>> you >>> feel that this is insufficient and it also needs to be documented in >>> mount.8? >> >> >> I look at mount*(8) before I look at fstab(5) as fstab(5) is far from >> complete. I'm sure I'm not the only one. >> >> That and I can actually use it via mount -o on the commandline makes >> more sense for it to be in mount(8) than fstab(5). >> >>>> The attached patch documents the missing option. >> >> >> ... >> >>> It seems hard to phrase this in an unconfusing manner. >>> I would probably say "this option is used to indicate that if an error >>> occurs during the mounting of a file system, the boot process should >>> continue on normally. =A0This is in contrast to the normal behavior whe= re a >>> mount error will cause the system to drop into single-user mode." >> >> >> I didn't really wordsmith the original text too much, as you noticed >> above -- and quite frankly I wasn't happy with the text anyhow. >> >> The proposed sentences above get the meaning across, but in a bit >> roundabout manner. What about this instead? >> >> 'In the event that mounting a filesystem via rc fails, standard >> behavior is that the user is dropped into the 'administrative shell' >> to diagnose the mount failure. The failok option allows mount failures >> to pass. >> >> This option should be used on non-boot/-runtime critical filesystems.' > > > No major objections. =A0The "non-boot/-runtime" is a bit awkward, so I mi= ght > prefer "should be used on file systems which are not critical for boot or > runtime usage." Ok. I'll whip up a new patch and submit it via reply-to with alpine. -Garrett From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 10:20:10 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 F17471065670 for ; Mon, 2 Jan 2012 10:20:10 +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 CA3978FC0A for ; Mon, 2 Jan 2012 10:20: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 q02AKASN059561 for ; Mon, 2 Jan 2012 10:20:10 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q02AKAek059560; Mon, 2 Jan 2012 10:20:10 GMT (envelope-from gnats) Resent-Date: Mon, 2 Jan 2012 10:20:10 GMT Resent-Message-Id: <201201021020.q02AKAek059560@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, Poul-Henning Kamp Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BABFF1065676 for ; Mon, 2 Jan 2012 10:17:04 +0000 (UTC) (envelope-from phk@critter.freebsd.dk) Received: from phk.freebsd.dk (phk.freebsd.dk [130.225.244.222]) by mx1.freebsd.org (Postfix) with ESMTP id 778268FC0C for ; Mon, 2 Jan 2012 10:17:04 +0000 (UTC) Received: from critter.freebsd.dk (critter.freebsd.dk [192.168.61.3]) by phk.freebsd.dk (Postfix) with ESMTP id 203BC5DE7 for ; Mon, 2 Jan 2012 10:00:28 +0000 (UTC) Received: from critter.freebsd.dk (localhost [127.0.0.1]) by critter.freebsd.dk (8.14.5/8.14.5) with ESMTP id q02A0RCQ082306 for ; Mon, 2 Jan 2012 10:00:27 GMT (envelope-from phk@critter.freebsd.dk) Received: (from phk@localhost) by critter.freebsd.dk (8.14.5/8.14.5/Submit) id q02A0RYs082305; Mon, 2 Jan 2012 10:00:27 GMT (envelope-from phk) Message-Id: <201201021000.q02A0RYs082305@critter.freebsd.dk> Date: Mon, 2 Jan 2012 10:00:27 GMT From: Poul-Henning Kamp To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/163771: getnameinfo(3) man-page detail X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Poul-Henning Kamp List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 02 Jan 2012 10:20:11 -0000 >Number: 163771 >Category: docs >Synopsis: getnameinfo(3) man-page detail >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: Mon Jan 02 10:20:10 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Poul-Henning Kamp >Release: FreeBSD 10.0-CURRENT amd64 >Organization: >Environment: System: FreeBSD critter.freebsd.dk 10.0-CURRENT FreeBSD 10.0-CURRENT #2 r228722M: Tue Dec 20 00:18:47 UTC 2011 root@critter.freebsd.dk:/usr/obj/freebsd/head/sys/CRITTER amd64 >Description: the getnameinfo(3) manpage references draft-ietf-ipv6-scoping-arch-02.txt I think that should be RFC 4007 now ? This may be a change that needs to be pushed around ISC ? >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 11:04:21 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 5D1D11065670 for ; Mon, 2 Jan 2012 11:04:21 +0000 (UTC) (envelope-from zeising@daemonic.se) Received: from mail.lysator.liu.se (mail.lysator.liu.se [IPv6:2001:6b0:17:f0a0::3]) by mx1.freebsd.org (Postfix) with ESMTP id CBAE38FC13 for ; Mon, 2 Jan 2012 11:04:20 +0000 (UTC) Received: from mail.lysator.liu.se (localhost [127.0.0.1]) by mail.lysator.liu.se (Postfix) with ESMTP id AC90E40006 for ; Mon, 2 Jan 2012 12:04:18 +0100 (CET) Received: by mail.lysator.liu.se (Postfix, from userid 1004) id A1AE240007; Mon, 2 Jan 2012 12:04:18 +0100 (CET) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on bernadotte.lysator.liu.se X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=none autolearn=disabled version=3.3.1 X-Spam-Score: 0.0 Received: from mx.daemonic.se (mx.daemonic.se [IPv6:2001:470:dca9:0:1::3]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mail.lysator.liu.se (Postfix) with ESMTPSA id 33A0A40006; Mon, 2 Jan 2012 12:04:16 +0100 (CET) Received: from mailscanner.daemonic.se (mailscanner.daemonic.se [IPv6:2001:470:dca9:0:1::6]) by mx.daemonic.se (Postfix) with ESMTPS id 40FFD119C1B; Mon, 2 Jan 2012 12:04:15 +0100 (CET) X-Virus-Scanned: amavisd-new at daemonic.se Received: from mx.daemonic.se ([IPv6:2001:470:dca9:0:1::3]) (using TLS with cipher CAMELLIA256-SHA) by mailscanner.daemonic.se (mailscanner.daemonic.se [2001:470:dca9:0:1::6]) (amavisd-new, port 10025) with ESMTPS id 2y5sssMBgyKa; Mon, 2 Jan 2012 12:04:12 +0100 (CET) Received: from mail.daemonic.se (mail.daemonic.se [IPv6:2001:470:dca9:0:1::4]) by mx.daemonic.se (Postfix) with ESMTPS id DE757119C17; Mon, 2 Jan 2012 12:04:12 +0100 (CET) Received: from tifa.daemonic.se (78-69-168-131-no84.tbcn.telia.com [78.69.168.131]) by mail.daemonic.se (Postfix) with ESMTPSA id C718C12B209; Mon, 2 Jan 2012 12:04:12 +0100 (CET) Received: from tifa.daemonic.se (localhost [127.0.0.1]) by tifa.daemonic.se (Postfix) with ESMTP id D813A38; Mon, 2 Jan 2012 12:04:11 +0100 (CET) Message-ID: <4F018F2B.4020505@daemonic.se> Date: Mon, 02 Jan 2012 12:04:11 +0100 From: Niclas Zeising User-Agent: Mutt/1.5.21 MIME-Version: 1.0 To: Warren Block References: In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Scanned: ClamAV using ClamSMTP Cc: doc@freebsd.org Subject: Re: RFC: modifying the doc CSS 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, 02 Jan 2012 11:04:21 -0000 On 01/02/12 04:09, Warren Block wrote: > Feedback welcome on some proposed modifications to the default DocBook > CSS (/usr/doc/share/misc/docbook.css). > > Samples for side-by-side comparison: > > Existing: http://www.wonkity.com/~wblock/porters-handbook-orig/book.html > Proposed: http://www.wonkity.com/~wblock/porters-handbook/book.html > > The proposed CSS: > http://www.wonkity.com/~wblock/porters-handbook/docbook.css > > > Changes: > > Left-align table headers. > > Add rounded border corners. > > Fix uneven margin spacing on notes and other blockquotes. > > Remove padding entries from various blockquotes. > > Reduce "body blockquote" line-spacing: from 1.5 to 1.3 so lines don't > look double-spaced. > > Set line-height: 1.1 in programlistings so descenders have a little > clearance. It looks good in my opinion. Regards! -- Niclas Zeising From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 11:06: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 EB3B1106564A for ; Mon, 2 Jan 2012 11:06:06 +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 D81348FC17 for ; Mon, 2 Jan 2012 11:06: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 q02B66tb004327 for ; Mon, 2 Jan 2012 11:06:06 GMT (envelope-from owner-bugmaster@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q02B66k0004325 for freebsd-doc@FreeBSD.org; Mon, 2 Jan 2012 11:06:06 GMT (envelope-from owner-bugmaster@FreeBSD.org) Date: Mon, 2 Jan 2012 11:06:06 GMT Message-Id: <201201021106.q02B66k0004325@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, 02 Jan 2012 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/163771 doc getnameinfo(3) man-page detail o docs/163742 doc [patch] document failok mount(8) option o docs/163723 doc [patch] books/porters-handbook: add note regarding bre o docs/163646 doc update man ehci(4) to mention options USB_DEBUG o docs/163576 doc zfs(8) sync property not noted in the manpage 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 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/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 () 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 212 problems total. From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 11:52:07 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 BECFD106564A for ; Mon, 2 Jan 2012 11:52:07 +0000 (UTC) (envelope-from remko@elvandar.org) Received: from mailgate.jr-hosting.nl (mail.jr-hosting.nl [IPv6:2a01:4f8:141:5061::25]) by mx1.freebsd.org (Postfix) with ESMTP id 4978A8FC08 for ; Mon, 2 Jan 2012 11:52:07 +0000 (UTC) Received: from [IPv6:2001:470:d701::515b:9a07:b09:bf4f] (unknown [IPv6:2001:470:d701:0:515b:9a07:b09:bf4f]) by mailgate.jr-hosting.nl (Postfix) with ESMTPSA id 782683F44F; Mon, 2 Jan 2012 12:52:05 +0100 (CET) Mime-Version: 1.0 (Apple Message framework v1251.1) From: Remko Lodder In-Reply-To: <4F018F2B.4020505@daemonic.se> Date: Mon, 2 Jan 2012 12:52:04 +0100 Message-Id: References: <4F018F2B.4020505@daemonic.se> To: Niclas Zeising X-Mailer: Apple Mail (2.1251.1) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: doc@freebsd.org Subject: Re: RFC: modifying the doc CSS 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, 02 Jan 2012 11:52:07 -0000 > It looks good in my opinion. > Regards! +1; > -- > Niclas Zeising > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > -- /"\ With kind regards, | remko@elvandar.org \ / Remko Lodder | remko@FreeBSD.org X FreeBSD | http://www.evilcoder.org / \ The Power to Serve | Quis custodiet ipsos custodes From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 12:10: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 DBE6F106564A for ; Mon, 2 Jan 2012 12:10: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 B04F98FC12 for ; Mon, 2 Jan 2012 12:10: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 q02CABqC065690 for ; Mon, 2 Jan 2012 12:10:11 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q02CABQO065688; Mon, 2 Jan 2012 12:10:11 GMT (envelope-from gnats) Date: Mon, 2 Jan 2012 12:10:11 GMT Message-Id: <201201021210.q02CABQO065688@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Garrett Cooper Cc: Subject: Re: docs/144537: Missing _mdconfig_list and _mdconfig2_list explanation in rc.conf(5) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Garrett Cooper List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 02 Jan 2012 12:10:11 -0000 The following reply was made to PR docs/144537; it has been noted by GNATS. From: Garrett Cooper To: bug-followup@FreeBSD.org, unavailable@trash-mail.net Cc: Subject: Re: docs/144537: Missing _mdconfig_list and _mdconfig2_list explanation in rc.conf(5) Date: Mon, 2 Jan 2012 04:02:15 -0800 Please refer to conf/122477 for a patch that does what you want. Thanks, -Garrett From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 13:48:38 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 09415106566B; Mon, 2 Jan 2012 13:48:38 +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 D36278FC0C; Mon, 2 Jan 2012 13:48:37 +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 q02Dmb7e059000; Mon, 2 Jan 2012 13:48:37 GMT (envelope-from linimon@freefall.freebsd.org) Received: (from linimon@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q02DmbL9058996; Mon, 2 Jan 2012 13:48:37 GMT (envelope-from linimon) Date: Mon, 2 Jan 2012 13:48:37 GMT Message-Id: <201201021348.q02DmbL9058996@freefall.freebsd.org> To: unavailable@trash-mail.net, linimon@FreeBSD.org, freebsd-doc@FreeBSD.org From: linimon@FreeBSD.org Cc: Subject: Re: docs/144537: Missing _mdconfig_list and _mdconfig2_list explanation in rc.conf(5) 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, 02 Jan 2012 13:48:38 -0000 Synopsis: Missing _mdconfig_list and _mdconfig2_list explanation in rc.conf(5) State-Changed-From-To: open->feedback State-Changed-By: linimon State-Changed-When: Mon Jan 2 13:47:22 UTC 2012 State-Changed-Why: Does the patch in conf/122477 address your concerns? If so, I would like to close this PR. http://www.freebsd.org/cgi/query-pr.cgi?pr=144537 From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 15:31:01 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 C2D76106566C; Mon, 2 Jan 2012 15:31:01 +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 9973B8FC12; Mon, 2 Jan 2012 15:31:01 +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 q02FV18t055922; Mon, 2 Jan 2012 15:31:01 GMT (envelope-from eadler@freefall.freebsd.org) Received: (from eadler@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q02FV1xX055914; Mon, 2 Jan 2012 15:31:01 GMT (envelope-from eadler) Date: Mon, 2 Jan 2012 15:31:01 GMT Message-Id: <201201021531.q02FV1xX055914@freefall.freebsd.org> To: eadler@FreeBSD.org, freebsd-doc@FreeBSD.org, eadler@FreeBSD.org From: eadler@FreeBSD.org Cc: Subject: Re: docs/155989: [patch] Fix offset in boot.config(5) 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, 02 Jan 2012 15:31:01 -0000 Synopsis: [patch] Fix offset in boot.config(5) Responsible-Changed-From-To: freebsd-doc->eadler Responsible-Changed-By: eadler Responsible-Changed-When: Mon Jan 2 15:31:00 UTC 2012 Responsible-Changed-Why: I'll take it. http://www.freebsd.org/cgi/query-pr.cgi?pr=155989 From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 15:36:26 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 D8A72106566B for ; Mon, 2 Jan 2012 15:36:26 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-lpp01m010-f54.google.com (mail-lpp01m010-f54.google.com [209.85.215.54]) by mx1.freebsd.org (Postfix) with ESMTP id 6156C8FC15 for ; Mon, 2 Jan 2012 15:36:25 +0000 (UTC) Received: by lahl5 with SMTP id l5so8357045lah.13 for ; Mon, 02 Jan 2012 07:36:25 -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=lDoB7AgklcRCAhloWelhNboxXw3xxiVWLI20fDObBRU=; b=tVZ55aUOie03VWJMm5SvlP70TqE71bc6PTiDt1d0KJ1D+p5g7V3It6aHMsGlVSQDQw H9LaL8lQ9G+Gdy3ck8q7vSvTkPQbSEggQvU78VhTAZtlzbL18I7vJokcaqr5fcW1odZo NRJqAemTTXa4kuO/F4gwJ0FweN7qaMe2EisiQ= Received: by 10.152.103.71 with SMTP id fu7mr38742791lab.31.1325517076156; Mon, 02 Jan 2012 07:11:16 -0800 (PST) MIME-Version: 1.0 Received: by 10.152.129.8 with HTTP; Mon, 2 Jan 2012 07:10:45 -0800 (PST) In-Reply-To: References: <4F018F2B.4020505@daemonic.se> From: Eitan Adler Date: Mon, 2 Jan 2012 10:10:45 -0500 Message-ID: To: Remko Lodder Content-Type: text/plain; charset=UTF-8 Cc: Niclas Zeising , doc@freebsd.org Subject: Re: RFC: modifying the doc CSS 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, 02 Jan 2012 15:36:26 -0000 On Mon, Jan 2, 2012 at 6:52 AM, Remko Lodder wrote: > >> It looks good in my opinion. >> Regards! ++ -- Eitan Adler From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 23:06:12 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 21B91106564A for ; Mon, 2 Jan 2012 23:06:12 +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 D4D4E8FC27 for ; Mon, 2 Jan 2012 23:06:11 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q02N6BvP004681 for ; Mon, 2 Jan 2012 16:06:11 -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 q02N6BwY004678 for ; Mon, 2 Jan 2012 16:06:11 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Mon, 2 Jan 2012 16:06:11 -0700 (MST) From: Warren Block To: doc@freebsd.org Message-ID: 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]); Mon, 02 Jan 2012 16:06:11 -0700 (MST) Cc: Subject: Deciphering a Porter's Handbook paragraph 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, 02 Jan 2012 23:06:12 -0000 http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/book.html#PORTING-PREFIX ------ # make clean; make package PREFIX=/var/tmp/`make -V PORTNAME` If anything is installed outside of PREFIX, the package creation process will complain that it cannot find the files. ------ Okay so far. ------ This does not test for the existence of internal references, or correct use of LOCALBASE for references to files from other ports. ------ I want to rewrite that to be more specific about what "this" refers to: This simple test does not check for incorrect internal references or the correct use of LOCALBASE for references to files from other ports. That seems a bit better. Now for the good one: ------ Testing the installation in /var/tmp/`make -V PORTNAME` to do that while you have it installed would do that. ------ What? Testing the installation... how? Does "installation" mean already-installed files, or does it mean the user is supposed to do an installation? What does "that" in "to do that" refer to? What does the last "that" refer to? I think it may mean: To test for those problems, run the program from the temporary installation in /var/tmp/`make -V PORTNAME` and verify that it operates correctly. The complete rewritten paragraph: This simple test does not check for incorrect internal references or the correct use of LOCALBASE for references to files from other ports. To test for those problems, run the program from the temporary installation in /var/tmp/`make -V PORTNAME` and verify that it operates correctly. Please, someone help me encromulate this. From owner-freebsd-doc@FreeBSD.ORG Tue Jan 3 00:40: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 CBEB81065672; Tue, 3 Jan 2012 00:40:56 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 9E4C78FC0C; Tue, 3 Jan 2012 00:40: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 q030eusD066621; Tue, 3 Jan 2012 00:40:56 GMT (envelope-from wblock@freefall.freebsd.org) Received: (from wblock@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q030euE0066612; Tue, 3 Jan 2012 00:40:56 GMT (envelope-from wblock) Date: Tue, 3 Jan 2012 00:40:56 GMT Message-Id: <201201030040.q030euE0066612@freefall.freebsd.org> To: wblock@FreeBSD.org, freebsd-doc@FreeBSD.org, wblock@FreeBSD.org From: wblock@FreeBSD.org Cc: Subject: Re: docs/163723: [patch] books/porters-handbook: add note regarding breakage of README.html 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: Tue, 03 Jan 2012 00:40:56 -0000 Synopsis: [patch] books/porters-handbook: add note regarding breakage of README.html Responsible-Changed-From-To: freebsd-doc->wblock Responsible-Changed-By: wblock Responsible-Changed-When: Tue Jan 3 00:37:36 UTC 2012 Responsible-Changed-Why: Take. http://www.freebsd.org/cgi/query-pr.cgi?pr=163723 From owner-freebsd-doc@FreeBSD.ORG Tue Jan 3 08:24:58 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 5A2B01065672 for ; Tue, 3 Jan 2012 08:24:58 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-5.mit.edu (DMZ-MAILSEC-SCANNER-5.MIT.EDU [18.7.68.34]) by mx1.freebsd.org (Postfix) with ESMTP id E7DE18FC24 for ; Tue, 3 Jan 2012 08:24:57 +0000 (UTC) X-AuditID: 12074422-b7fd66d0000008f9-41-4f02b7d3cfdf Received: from mailhub-auth-1.mit.edu ( [18.9.21.35]) by dmz-mailsec-scanner-5.mit.edu (Symantec Messaging Gateway) with SMTP id FA.80.02297.3D7B20F4; Tue, 3 Jan 2012 03:09:55 -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 q0389tIK013396; Tue, 3 Jan 2012 03:09:55 -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 q0389rUn028265 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Tue, 3 Jan 2012 03:09:54 -0500 (EST) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id q0389qcD018589; Tue, 3 Jan 2012 03:09:52 -0500 (EST) Date: Tue, 3 Jan 2012 03:09:52 -0500 (EST) From: Benjamin Kaduk To: Warren Block In-Reply-To: Message-ID: References: User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrBIsWRmVeSWpSXmKPExsUixCmqrHt5O5O/wbE1RhZTP+5ktfh1ysOB yWPGp/ksHkc6HjEGMEVx2aSk5mSWpRbp2yVwZSw5E1PQKVVx8c089gbGayJdjJwcEgImEusO b2WGsMUkLtxbz9bFyMUhJLCPUeLEiRtQznpGif3fNjOCVAkJ7GeSON6hDWHXS7TsucUEYrMI aElsX97EAmKzCahIzHyzEaiZg0NEQFVi7xlrkDCzgLDE6Ut3GUHCwgJmEn/Px4KEOQVsJU7t +cEKYvMK2Eu8nHMIapONRPPZbWDTRQV0JFbvn8ICUSMocXLmExaIkZYS5/5cZ5vAKDgLSWoW ktQCRqZVjLIpuVW6uYmZOcWpybrFyYl5ealFuqZ6uZkleqkppZsYQQHK7qK0g/HnQaVDjAIc jEo8vJYPGP2FWBPLiitzDzFKcjApifLWbmXyF+JLyk+pzEgszogvKs1JLT7EKMHBrCTCK7ka KMebklhZlVqUD5OS5mBREudV13rnJySQnliSmp2aWpBaBJOV4eBQkuCNAkaikGBRanpqRVpm TglCmomDE2Q4D9DwcJAa3uKCxNzizHSI/ClGRSlxXi2QhABIIqM0D64XlkBeMYoDvSLM6wtS xQNMPnDdr4AGMwENdjr6zw9ocEkiQkqqgdHIcsmbhUX+j42O/slaemb2mzzf6Vdj1AK/yd/3 cpzJ+fxD5jXmNobLk6oWC0hovVpjcF2zYH3TtGXuH115ZH4v4WLL/KTAoLqDkdtkxbW5tu+2 OjROPy9mdU1Uf/riqF19V+c+7SyWkZnB8+jGfMuYJz8r1LYtnf6gdt/t9gPvra15PleUWuQo sRRnJBpqMRcVJwIA+pMlEPsCAAA= Cc: doc@freebsd.org Subject: Re: Deciphering a Porter's Handbook paragraph 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: Tue, 03 Jan 2012 08:24:58 -0000 On Mon, 2 Jan 2012, Warren Block wrote: > http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/book.html#PORTING-PREFIX ------ The value of PREFIX will be set to LOCALBASE (default /usr/local). If USE_LINUX_PREFIX is set, PREFIX will be LINUXBASE (default /compat/linux). ------ I don't think we've yet said something like: LOCALBASE should be set to where existing ports have already been installed (the ``base directory'' of where the ``local additions'' to the system have been made); it is uncommon for having PREFIX != LOCALBASE in normal usage. We probably should say something like that. > > ------ > # make clean; make package PREFIX=/var/tmp/`make -V PORTNAME` > > If anything is installed outside of PREFIX, the package creation > process will complain that it cannot find the files. > ------ > > Okay so far. > > ------ > This does not test for the existence of internal references, or > correct use of LOCALBASE for references to files from other ports. > ------ > > I want to rewrite that to be more specific about what "this" refers to: > > This simple test does not check for incorrect internal references > or the correct use of LOCALBASE for references to files from other > ports. > > That seems a bit better. Now for the good one: Maybe, but only a little bit. I think the point it is trying to make is that a port might install a shell script that has a hardcoded path '/usr/local/...' in it, and just generating the package does not try to (say) execute that script, and so the error would be undetected. Likewise, it does not check that calls to dependencies refer to LOCALBASE (as opposed to just PREFIX or even a hardcoded /usr/local). I'm not convinced that it's intuitively clear what "correct internal references" are to the ordinary reader. > > ------ > Testing the installation in /var/tmp/`make -V PORTNAME` to do that > while you have it installed would do that. > ------ > > What? Testing the installation... how? Does "installation" mean > already-installed files, or does it mean the user is supposed to do an > installation? What does "that" in "to do that" refer to? What does the last > "that" refer to? > > I think it may mean: > > To test for those problems, run the program from the temporary > installation in /var/tmp/`make -V PORTNAME` and verify that it > operates correctly. Er, yes, that. > > The complete rewritten paragraph: > > This simple test does not check for incorrect internal references > or the correct use of LOCALBASE for references to files from other > ports. To test for those problems, run the program from the temporary > installation in /var/tmp/`make -V PORTNAME` and verify that it > operates correctly. > > Please, someone help me encromulate this. Just so long as we can eschew obfuscation at the same time. That seems basically correct, though I might try to expand "incorrect internal references" a bit. I might also s/To test for these problems/To verify that the port has correct references/ or something kind of like that, since "to test for these problems ... verify that it operates correctly" feels like correct operation implies that the problems are present, which is of course just silly. -Ben Kaduk From owner-freebsd-doc@FreeBSD.ORG Tue Jan 3 11:19:00 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 210EB1065673 for ; Tue, 3 Jan 2012 11:19:00 +0000 (UTC) (envelope-from manas@hush.ai) Received: from smtp12.hushmail.com (smtp12.hushmail.com [65.39.178.135]) by mx1.freebsd.org (Postfix) with ESMTP id 08BDA8FC1E for ; Tue, 3 Jan 2012 11:18:59 +0000 (UTC) Received: from smtp12.hushmail.com (localhost.localdomain [127.0.0.1]) by smtp12.hushmail.com (Postfix) with SMTP id 7EBBFC0661 for ; Tue, 3 Jan 2012 10:47:03 +0000 (UTC) X-Hush-Verified-Domain: hush.ai Received: from smtp.hushmail.com (w6.hushmail.com [65.39.178.92]) by smtp12.hushmail.com (Postfix) with ESMTP for ; Tue, 3 Jan 2012 10:47:01 +0000 (UTC) Received: by smtp.hushmail.com (Postfix, from userid 99) id 4A64AA6E40; Tue, 3 Jan 2012 10:47:01 +0000 (UTC) MIME-Version: 1.0 Date: Tue, 03 Jan 2012 05:47:01 -0500 To: freebsd-doc@freebsd.org From: "Manas B" Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="UTF-8" Message-Id: <20120103104701.4A64AA6E40@smtp.hushmail.com> Subject: FreeBSD Handbook 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: Tue, 03 Jan 2012 11:19:00 -0000 Hello, I just wanted to thank the creators and maintainers of the FreeBSD Handbook. I am new to this operating system and I have learnt a great amount through this well-written handbook. Please know that your excellent work is appreciated by many enthusiasts all over the world. Happy new year, Manas B From owner-freebsd-doc@FreeBSD.ORG Tue Jan 3 13:53: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 BCD53106564A for ; Tue, 3 Jan 2012 13:53:27 +0000 (UTC) (envelope-from sonic2000gr@gmail.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 513658FC12 for ; Tue, 3 Jan 2012 13:53:26 +0000 (UTC) Received: by werb13 with SMTP id b13so14222339wer.13 for ; Tue, 03 Jan 2012 05:53:26 -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:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; bh=WZYk58kKZDbmC2wjVmRmOSZz2ZDfpsb1yIUtCxDRZRM=; b=qWQpqdUQXWjXmkFyQi3Bb/6Zc1hGTf4qQnQjy93oaC0z8EPgGYyYSovBfR2lxa71xm 6iYbaic3EuS4HhtsSYaAlcSx6Gvy7U27aLkw3nqr+Wb9DyOEKnLAywFt18o3y6L4+Gvr PlGincKLfVv9zADU/c2UlVTKfggbipTPKpQnI= Received: by 10.216.138.159 with SMTP id a31mr34038092wej.20.1325598805995; Tue, 03 Jan 2012 05:53:25 -0800 (PST) Received: from [192.168.0.150] (athedsl-4364788.home.otenet.gr. [79.130.9.228]) by mx.google.com with ESMTPS id di5sm127314752wib.3.2012.01.03.05.53.23 (version=TLSv1/SSLv3 cipher=OTHER); Tue, 03 Jan 2012 05:53:24 -0800 (PST) Message-ID: <4F030852.6040304@gmail.com> Date: Tue, 03 Jan 2012 15:53:22 +0200 From: Manolis Kiagias User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.1; en-US; rv:1.9.2.18) Gecko/20110616 Thunderbird/3.1.11 MIME-Version: 1.0 To: Manas B References: <20120103104701.4A64AA6E40@smtp.hushmail.com> In-Reply-To: <20120103104701.4A64AA6E40@smtp.hushmail.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Cc: freebsd-doc@freebsd.org Subject: Re: FreeBSD Handbook 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: Tue, 03 Jan 2012 13:53:27 -0000 On 3/1/2012 12:47 μμ, Manas B wrote: > Hello, > > I just wanted to thank the creators and maintainers of the FreeBSD Handbook. I am new to this operating system and I have learnt a great amount through this well-written handbook. Please know that your excellent work is appreciated by many enthusiasts all over the world. > > Happy new year, > Manas B > Thank you! The appreciation of the people actually using the documentation is what keeps us going. Welcome to FreeBSD and enjoy your new OS :) From owner-freebsd-doc@FreeBSD.ORG Tue Jan 3 17:12: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 13B07106566B for ; Tue, 3 Jan 2012 17:12:27 +0000 (UTC) (envelope-from papowell@astart.com) Received: from astart2.astart.com (99-111-96-109.uvs.sndgca.sbcglobal.net [99.111.96.109]) by mx1.freebsd.org (Postfix) with ESMTP id E1BEF8FC14 for ; Tue, 3 Jan 2012 17:12:26 +0000 (UTC) Received: from laptop_81.private (localhost [127.0.0.1]) by astart2.astart.com (8.14.4/8.14.4) with ESMTP id q03Gn261052691 for ; Tue, 3 Jan 2012 08:49:03 -0800 (PST) (envelope-from papowell@astart.com) Message-ID: <4F03317E.7060101@astart.com> Date: Tue, 03 Jan 2012 08:49:02 -0800 From: Patrick Powell Organization: Astart Technologies User-Agent: Mozilla/5.0 (X11; U; FreeBSD amd64; en-US; rv:1.9.2.15) Gecko/20110312 Thunderbird/3.1.9 MIME-Version: 1.0 To: freebsd-doc@freebsd.org References: <20120103104701.4A64AA6E40@smtp.hushmail.com> <4F030852.6040304@gmail.com> In-Reply-To: <4F030852.6040304@gmail.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Subject: Re: FreeBSD Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: papowell@astart.com List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 03 Jan 2012 17:12:27 -0000 On 01/03/12 05:53, Manolis Kiagias wrote: > On 3/1/2012 12:47 μμ, Manas B wrote: >> Hello, >> >> I just wanted to thank the creators and maintainers of the FreeBSD >> Handbook. I am new to this operating system and I have learnt a great >> amount through this well-written handbook. Please know that your >> excellent work is appreciated by many enthusiasts all over the world. >> >> Happy new year, >> Manas B >> > > Thank you! The appreciation of the people actually using the > documentation is what keeps us going. Welcome to FreeBSD and enjoy > your new OS :) > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > Let me echo the thanks to the Doc Team. -- Patrick Powell Astart Technologies papowell@astart.com 1530 Jamacha Road, Suite X, Network and System San Diego, CA 92019 Consulting 858-874-6543 Web Site: www.astart.com From owner-freebsd-doc@FreeBSD.ORG Tue Jan 3 20:25: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 21B121065678 for ; Tue, 3 Jan 2012 20:25:45 +0000 (UTC) (envelope-from samantha@onlineengineeringdegree.org) Received: from bestonlineschool.org (bestonlineschool.org [205.186.146.23]) by mx1.freebsd.org (Postfix) with ESMTP id A7A758FC13 for ; Tue, 3 Jan 2012 20:25:44 +0000 (UTC) Received: (qmail 21719 invoked from network); 3 Jan 2012 11:59:04 -0800 Received: from c-76-30-217-41.hsd1.tx.comcast.net (HELO AmyEvans) (76.30.217.41) by bestonlineschool.org with SMTP; 3 Jan 2012 11:59:04 -0800 Date: Tue, 3 Jan 2012 13:59:05 -0600 (CST) From: Samantha Rhodes To: Webmaster Message-ID: <14718376.4678.1325620745834.JavaMail.Amy@AmyEvans> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="----=_Part_4514_7532793.1325620713544" Cc: Subject: Engineering Question 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: Tue, 03 Jan 2012 20:25:45 -0000 ------=_Part_4514_7532793.1325620713544 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit Hi Webmaster, I am proud to finally share my education site called http://www.onlineengineeringdegree.org with you! Searching for a degree program in Engineering was a difficult process for me. I created http://www.onlineengineeringdegree.org to make sure others do not have the same experience! On my homepage is a list of Engineering degree programs broken down by campus as well as detailed information about the degree and possible career choices. Would you help me reach prospective students with this beneficial site by adding it to your resources of http://freebsd.csie.nctu.edu.tw/www.freebsd.org/data/ja/ports/cad.html? Please let me know if there is anything else you need from me in order to add my link. Thanks for taking a look! Regards, Samantha Rhodes ------=_Part_4514_7532793.1325620713544-- From owner-freebsd-doc@FreeBSD.ORG Tue Jan 3 20:25: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 159781065676 for ; Tue, 3 Jan 2012 20:25:45 +0000 (UTC) (envelope-from marcus@computergamedesign.org) Received: from bestonlineschool.org (bestonlineschool.org [205.186.146.23]) by mx1.freebsd.org (Postfix) with ESMTP id A78388FC12 for ; Tue, 3 Jan 2012 20:25:44 +0000 (UTC) Received: (qmail 31896 invoked from network); 3 Jan 2012 12:14:28 -0800 Received: from c-98-197-199-241.hsd1.tx.comcast.net (HELO ChaseGugenheim) (98.197.199.241) by bestonlineschool.org with SMTP; 3 Jan 2012 12:14:28 -0800 Date: Tue, 3 Jan 2012 14:14:28 -0600 (CST) From: Marcus Morris To: Webmaster Message-ID: <16997162.2654.1325621668547.JavaMail."Chase Gugenheim"@ChaseGugenheim> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="----=_Part_2455_15795469.1325621656230" X-Mailman-Approved-At: Tue, 03 Jan 2012 20:38:53 +0000 Cc: Subject: Computer Question 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: Tue, 03 Jan 2012 20:25:45 -0000 ------=_Part_2455_15795469.1325621656230 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit Hi Webmaster , I created a new computer game design site called http://www.computergamedesign.org. This has been a personal project of mine that I've finally gotten to a stage that it's "presentable", and thus I'd like to submit my website for your review and potential inclusion in the resource section of your site: http://freebsd.isu.edu.tw/ja/ports/tcl84.html I created http://www.computergamedesign.org as a resource for new designers to find in-depth and unbiased information about a computer game design degree. Currently, I think its the only site that lists everything you need to know about finding the right school. I'm hoping that after you take a look, you'll think its a valuable enough resource to include a link to my site in your list of resources. I'd appreciate the opportunity to have my link listed on your site. Thank you for taking a look Marcus Morris ------=_Part_2455_15795469.1325621656230-- From owner-freebsd-doc@FreeBSD.ORG Wed Jan 4 01:28:33 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 71C79106564A for ; Wed, 4 Jan 2012 01:28:33 +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 2CD378FC12 for ; Wed, 4 Jan 2012 01:28:32 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q041SWET018652; Tue, 3 Jan 2012 18:28:32 -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 q041SWRD018649; Tue, 3 Jan 2012 18:28:32 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Tue, 3 Jan 2012 18:28:32 -0700 (MST) From: Warren Block To: Benjamin Kaduk In-Reply-To: Message-ID: References: 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]); Tue, 03 Jan 2012 18:28:32 -0700 (MST) Cc: doc@freebsd.org Subject: Re: Deciphering a Porter's Handbook paragraph 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, 04 Jan 2012 01:28:33 -0000 On Tue, 3 Jan 2012, Benjamin Kaduk wrote: > I don't think we've yet said something like: > LOCALBASE should be set to where existing ports have already been installed > (the ``base directory'' of where the ``local additions'' to the system have > been made); it is uncommon for having PREFIX != LOCALBASE in normal usage. > We probably should say something like that. ISWYM, but am going to delay on that for a bit to try to address the existing problems before adding information. The more I looked at section 9.4, the more I wanted to rework it. Here is the original: http://www.wonkity.com/~wblock/porters-handbook-orig/book.html#PORTING-PREFIX Here is a first pass at some improvements: http://www.wonkity.com/~wblock/porters-prefix/book.html#PORTING-PREFIX I removed the reference to LOCALBASE sometimes being /opt. Maybe it is, but that's covered under the "custom path". There are also the references to /usr/X11R6 and imake. Are those still relevant? Then there's this: The variable PREFIX can be reassigned in your Makefile or in the user's environment. However, it is strongly discouraged for individual ports to set the variable explicitly in the Makefiles. "You absolutely should not press this big shiny button right here." Or is that trying to say you can set PREFIX in make.conf or as an environment variable, but don't set it in the *port's* Makefile? Instead: PREFIX should not be set explicitly in a port's Makefile. Users installing the port may have reassigned PREFIX, and the port should respect that. From owner-freebsd-doc@FreeBSD.ORG Wed Jan 4 06:16:10 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 6FE021065670 for ; Wed, 4 Jan 2012 06:16:10 +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 090288FC14 for ; Wed, 4 Jan 2012 06:16:09 +0000 (UTC) X-AuditID: 1209190c-b7fad6d000000920-eb-4f03eea8b9a9 Received: from mailhub-auth-4.mit.edu ( [18.7.62.39]) by dmz-mailsec-scanner-1.mit.edu (Symantec Messaging Gateway) with SMTP id 1D.1D.02336.8AEE30F4; Wed, 4 Jan 2012 01:16:09 -0500 (EST) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-4.mit.edu (8.13.8/8.9.2) with ESMTP id q046G8hW016569; Wed, 4 Jan 2012 01:16:08 -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 q046G6Rm026724 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 4 Jan 2012 01:16:08 -0500 (EST) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id q046G63B006418; Wed, 4 Jan 2012 01:16:06 -0500 (EST) Date: Wed, 4 Jan 2012 01:16:06 -0500 (EST) From: Benjamin Kaduk To: Warren Block In-Reply-To: Message-ID: References: User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrGIsWRmVeSWpSXmKPExsUixG6nrrvyHbO/Qe9GZoupH3eyWvw65eHA 5DHj03wWjyMdjxgDmKK4bFJSczLLUov07RK4Mv5cOsJW8EGgYv3lwAbGDbxdjJwcEgImEvN/ /WCHsMUkLtxbzwZiCwnsY5TYuKami5ELyF7PKHF92yEWCGc/k8SNS0dZIarqJSbNaWQEsVkE tCT23rwEZrMJqEjMfLMRaBIHh4iAqsTeM9YgYWYBYYnTl+4ygoSFBcwk/p6PBTE5BewkLn0R ATF5Bewlvi8PgZi9iFFixwRJEFtUQEdi9f4pLCA2r4CgxMmZT1ggBlpKnPtznW0Co+AsJKlZ SFILGJlWMcqm5Fbp5iZm5hSnJusWJyfm5aUW6Rrq5WaW6KWmlG5iBAUnpyTPDsY3B5UOMQpw MCrx8P7awuwvxJpYVlyZe4hRkoNJSZTX9Q1QiC8pP6UyI7E4I76oNCe1+BCjBAezkgjvUlWg HG9KYmVValE+TEqag0VJnFdF652fkEB6YklqdmpqQWoRTFaGg0NJgvftW6BGwaLU9NSKtMyc EoQ0EwcnyHAeoOHC70CGFxck5hZnpkPkTzEqSonzfgJpFgBJZJTmwfXCkscrRnGgV4R534BU 8QATD1z3K6DBTECDd2wHG1ySiJCSamDMWdulUjjd7bxHynwlT48s++QyyVjTF6Wsh46v15u/ LLr7KYucnNYXt7Yr8btXhjWrqxwRmsbE1VHnPW3DzoXuC+PXHj5Tdz09r2hWUZD6pwW7vjfN 9QnXy5iocsenKOP6qU0Ha3h93pqYl8yuWXi0jLdFRbuxYe+zzhcbb1lfTLbXZYzTm67EUpyR aKjFXFScCAC4m9WX+QIAAA== Cc: doc@freebsd.org Subject: Re: Deciphering a Porter's Handbook paragraph 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, 04 Jan 2012 06:16:10 -0000 On Tue, 3 Jan 2012, Warren Block wrote: > On Tue, 3 Jan 2012, Benjamin Kaduk wrote: > >> I don't think we've yet said something like: >> LOCALBASE should be set to where existing ports have already been installed >> (the ``base directory'' of where the ``local additions'' to the system have >> been made); it is uncommon for having PREFIX != LOCALBASE in normal usage. >> We probably should say something like that. > > ISWYM, but am going to delay on that for a bit to try to address the existing > problems before adding information. > > The more I looked at section 9.4, the more I wanted to rework it. Here is the > original: > http://www.wonkity.com/~wblock/porters-handbook-orig/book.html#PORTING-PREFIX > > Here is a first pass at some improvements: > http://www.wonkity.com/~wblock/porters-prefix/book.html#PORTING-PREFIX Sure seems like an improvement, but it's easier to compare in the form of a diff, I think. > > I removed the reference to LOCALBASE sometimes being /opt. Maybe it is, but > that's covered under the "custom path". Fine by me; people who want to use /opt almost certainly already know about /opt ... > > There are also the references to /usr/X11R6 and imake. Are those still > relevant? /usr/X11R6 is dead. devel/imake still exists, so I wouldn't be surprised if some ports used it. > > Then there's this: > > The variable PREFIX can be reassigned in your Makefile or in the > user's environment. However, it is strongly discouraged for > individual ports to set the variable explicitly in the Makefiles. > > "You absolutely should not press this big shiny button right here." > Or is that trying to say you can set PREFIX in make.conf or as an environment > variable, but don't set it in the *port's* Makefile? > Instead: > > PREFIX should not be set explicitly in a port's Makefile. Users > installing the port may have reassigned PREFIX, and the port should > respect that. That's my understanding. PREFIX does seem more like a make.conf thing than a command-line thing, to me, so it might be worth mentioning make.conf explicitly. -Ben From owner-freebsd-doc@FreeBSD.ORG Wed Jan 4 14:08:46 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 DF227106566C for ; Wed, 4 Jan 2012 14:08:46 +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 9D6148FC12 for ; Wed, 4 Jan 2012 14:08:46 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q04E8jBO025422; Wed, 4 Jan 2012 07:08:45 -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 q04E8j8i025419; Wed, 4 Jan 2012 07:08:45 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Wed, 4 Jan 2012 07:08:45 -0700 (MST) From: Warren Block To: Benjamin Kaduk In-Reply-To: Message-ID: References: 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, 04 Jan 2012 07:08:45 -0700 (MST) Cc: doc@freebsd.org Subject: Re: Deciphering a Porter's Handbook paragraph 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, 04 Jan 2012 14:08:47 -0000 Existing: http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/porting-prefix.html Proposed: http://www.wonkity.com/~wblock/porters-prefix/book.html#PORTING-PREFIX diff: http://www.wonkity.com/~wblock/porters-prefix/patch-porters-prefix.diff I'll start a new thread on the ports mailing list for feedback, too. Thanks! From owner-freebsd-doc@FreeBSD.ORG Wed Jan 4 21:50: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 B73E7106568C for ; Wed, 4 Jan 2012 21:50: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 EFD9B8FC1D for ; Wed, 4 Jan 2012 21:50: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 q04LoAUf020812 for ; Wed, 4 Jan 2012 21:50:10 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q04LoAsO020811; Wed, 4 Jan 2012 21:50:10 GMT (envelope-from gnats) Resent-Date: Wed, 4 Jan 2012 21:50:10 GMT Resent-Message-Id: <201201042150.q04LoAsO020811@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, Jason Helfman Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 2FD501065675 for ; Wed, 4 Jan 2012 21:41:41 +0000 (UTC) (envelope-from jgh@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 1E87C8FC0A for ; Wed, 4 Jan 2012 21:41:41 +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 q04LffUF020011 for ; Wed, 4 Jan 2012 21:41:41 GMT (envelope-from jgh@freefall.freebsd.org) Received: (from jgh@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q04LfesX020010; Wed, 4 Jan 2012 21:41:40 GMT (envelope-from jgh) Message-Id: <201201042141.q04LfesX020010@freefall.freebsd.org> Date: Wed, 4 Jan 2012 21:41:40 GMT From: Jason Helfman To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/163821: article/freebsd-update-server: correct patch process X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Jason Helfman List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 04 Jan 2012 21:50:11 -0000 >Number: 163821 >Category: docs >Synopsis: article/freebsd-update-server: correct patch process >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: Wed Jan 04 21:50:10 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Jason Helfman >Release: FreeBSD 8.2-STABLE i386 >Organization: >Environment: >Description: I found that patches get corrupted when using fetch -o on a patch file for building binary updates Fully rendered article is here: http://people.freebsd.org/~jgh/article/freebsd-update-server/article.html >How-To-Repeat: >Fix: Index: article.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/articles/freebsd-update-server/article.sgml,v retrieving revision 1.6 diff -u -r1.6 article.sgml --- article.sgml 24 Dec 2011 22:33:28 -0000 1.6 +++ article.sgml 4 Jan 2012 21:33:50 -0000 @@ -581,12 +581,6 @@ &prompt.user; cd /usr/local/freebsd-update-server/patches/7.1-RELEASE/; mv bind.patch 7-SA-09:12.bind - or: - - - &prompt.user; cd /usr/local/freebsd-update-server/patches/7.1-RELEASE/; fetch -o 7-SA-09:12.bind http://security.FreeBSD.org/patches/SA-09:12/bind.patch - - When running a patch level build, it is assumed that previous patches are in place. When a patch build is run, it will run all >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Thu Jan 5 11:10:08 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 A4834106566C for ; Thu, 5 Jan 2012 11:10:08 +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 7CDD28FC15 for ; Thu, 5 Jan 2012 11:10: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 q05BA8O3090378 for ; Thu, 5 Jan 2012 11:10:08 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q05BA8AY090377; Thu, 5 Jan 2012 11:10:08 GMT (envelope-from gnats) Resent-Date: Thu, 5 Jan 2012 11:10:08 GMT Resent-Message-Id: <201201051110.q05BA8AY090377@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, Oliver Hartmann Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 68A791065677 for ; Thu, 5 Jan 2012 11:00:22 +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 396B98FC2B for ; Thu, 5 Jan 2012 11:00:22 +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 q05B0MFM052900 for ; Thu, 5 Jan 2012 11:00:22 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id q05B0Lob052899; Thu, 5 Jan 2012 11:00:21 GMT (envelope-from nobody) Message-Id: <201201051100.q05B0Lob052899@red.freebsd.org> Date: Thu, 5 Jan 2012 11:00:21 GMT From: Oliver Hartmann To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/163830: device smbios: missing documentation, no manpage 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, 05 Jan 2012 11:10:08 -0000 >Number: 163830 >Category: docs >Synopsis: device smbios: missing documentation, no manpage >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 Jan 05 11:10:08 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Oliver Hartmann >Release: FreeBSD 10.0/amd64 and FreeBSD 9.0-STABLE/amd64 >Organization: FU Berlin >Environment: >Description: Mssing a manpage entry for kernel option device smbios which is explained to be a DMI/SMBIOS entry point in amd64/NOTES. No further informations available, not known whether this option is prerequisite for any readings of the DMI by userland software. >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Thu Jan 5 17:02:44 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 BF10A106566B for ; Thu, 5 Jan 2012 17:02:44 +0000 (UTC) (envelope-from claudiu.vasadi@gmail.com) Received: from mail-lpp01m010-f54.google.com (mail-lpp01m010-f54.google.com [209.85.215.54]) by mx1.freebsd.org (Postfix) with ESMTP id 3E2F88FC16 for ; Thu, 5 Jan 2012 17:02:43 +0000 (UTC) Received: by lahl5 with SMTP id l5so314988lah.13 for ; Thu, 05 Jan 2012 09:02:43 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:date:message-id:subject:from:to:content-type; bh=v3DFMcwYCdfupGsEskORcrSRnw7Sd08ZfT0sF44p4X8=; b=wTTqkFfio7gtC9CKp+kaq/FCc5h9ztFr2pE93Op3G3ZlH6KxB55+FT5gHbyuYKhk07 kd72UWEdGJ8iheJIMb4ocAZnDyndTYyohIpoSGwJG9NOA5/k8CUAdMTKcJHcvxhekNWb liV1rgPQsloPglCJ+MCOgeDuwl4VUVFRcse+Q= MIME-Version: 1.0 Received: by 10.152.131.202 with SMTP id oo10mr979726lab.40.1325781620971; Thu, 05 Jan 2012 08:40:20 -0800 (PST) Received: by 10.152.20.202 with HTTP; Thu, 5 Jan 2012 08:40:20 -0800 (PST) Date: Thu, 5 Jan 2012 17:40:20 +0100 Message-ID: From: claudiu vasadi To: freebsd-doc@freebsd.org Content-Type: text/plain; charset=ISO-8859-1 X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Subject: Missing "zfs diff" entry in "man zfs" 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, 05 Jan 2012 17:02:44 -0000 Hi guys, I was unable to find a "zfs diff" entry in "manual pages for "zfs" while running 8.2 amd64, r226179, zfs V28. Is this a bug or was the section never written ? -- Best regards, Claudiu Vasadi From owner-freebsd-doc@FreeBSD.ORG Thu Jan 5 17:14:52 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 7E113106567D for ; Thu, 5 Jan 2012 17:14:52 +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 2E48C8FC1A for ; Thu, 5 Jan 2012 17:14:51 +0000 (UTC) Received: (qmail 58170 invoked by uid 0); 5 Jan 2012 12:14:51 -0500 Received: from unknown (HELO glenbarber.us) (75.146.225.65) by 0 with SMTP; 5 Jan 2012 12:14:51 -0500 Date: Thu, 5 Jan 2012 12:14:49 -0500 From: Glen Barber To: claudiu vasadi Message-ID: <20120105171449.GB1899@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: Missing "zfs diff" entry in "man zfs" 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, 05 Jan 2012 17:14:52 -0000 On Thu, Jan 05, 2012 at 05:40:20PM +0100, claudiu vasadi wrote: > Hi guys, > > I was unable to find a "zfs diff" entry in "manual pages for "zfs" while > running 8.2 amd64, r226179, zfs V28. > Is this a bug or was the section never written ? > The zfs(1M) manual is from the upstream OpenSolaris documentation. 'zfs diff' is missing from their documentation as well, it seems. Glen From owner-freebsd-doc@FreeBSD.ORG Thu Jan 5 17:42:25 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 08EDE106564A for ; Thu, 5 Jan 2012 17:42:25 +0000 (UTC) (envelope-from amvandemore@gmail.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 985368FC13 for ; Thu, 5 Jan 2012 17:42:24 +0000 (UTC) Received: by wgbdr11 with SMTP id dr11so861411wgb.31 for ; Thu, 05 Jan 2012 09:42:23 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:date:message-id:subject:from:to:content-type; bh=WwY+DxiuLHdOyUXJa6Pq5JK6G3376gU17ROwD1vr4yk=; b=fRUKM6mWMXiI/7zaO629IFlFX9piU8uun3SX65tC7qJU0kotwm+N0zdFBseWjCcIEM 8Gbl9NMDB3eo8minj/jXfzBZH0MzvpWBYudYVdq7rFgo9ht2VZzG1D/8G4TVIEPotJFl b33W6CprPYNlzXggtvUn6L1I6cOxBuR9sg7zY= MIME-Version: 1.0 Received: by 10.180.88.97 with SMTP id bf1mr1337328wib.10.1325783824115; Thu, 05 Jan 2012 09:17:04 -0800 (PST) Received: by 10.223.157.198 with HTTP; Thu, 5 Jan 2012 09:17:03 -0800 (PST) Date: Thu, 5 Jan 2012 11:17:03 -0600 Message-ID: From: Adam Vande More To: doc@freebsd.org Content-Type: text/plain; charset=ISO-8859-1 X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: Subject: Suggestion for Handbook 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, 05 Jan 2012 17:42:25 -0000 This page contain info on creating a disk image: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/disks-virtual.html Of course the dd method works, but it might be better to use truncate(1) instead of dd because it creates sparse files and is nearly as universal as dd. E.g. "truncate -s 5k file.img" -- Adam Vande More From owner-freebsd-doc@FreeBSD.ORG Thu Jan 5 18:00:27 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 8F793106564A for ; Thu, 5 Jan 2012 18:00:27 +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 703FB8FC0A for ; Thu, 5 Jan 2012 18:00:27 +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 q05I0RTA069123 for ; Thu, 5 Jan 2012 18:00:27 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q05I0RIK069118; Thu, 5 Jan 2012 18:00:27 GMT (envelope-from gnats) Date: Thu, 5 Jan 2012 18:00:27 GMT Message-Id: <201201051800.q05I0RIK069118@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Garrett Cooper Cc: Subject: Re: docs/163830: device smbios: missing documentation, no manpage X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Garrett Cooper List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 05 Jan 2012 18:00:27 -0000 The following reply was made to PR docs/163830; it has been noted by GNATS. From: Garrett Cooper To: Oliver Hartmann Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/163830: device smbios: missing documentation, no manpage Date: Thu, 5 Jan 2012 09:55:48 -0800 On Thu, Jan 5, 2012 at 3:00 AM, Oliver Hartmann wrote: > >>Number: =A0 =A0 =A0 =A0 163830 >>Category: =A0 =A0 =A0 docs >>Synopsis: =A0 =A0 =A0 device smbios: missing documentation, no manpage >>Confidential: =A0 no >>Severity: =A0 =A0 =A0 non-critical >>Priority: =A0 =A0 =A0 medium >>Responsible: =A0 =A0freebsd-doc >>State: =A0 =A0 =A0 =A0 =A0open >>Quarter: >>Keywords: >>Date-Required: >>Class: =A0 =A0 =A0 =A0 =A0doc-bug >>Submitter-Id: =A0 current-users >>Arrival-Date: =A0 Thu Jan 05 11:10:08 UTC 2012 >>Closed-Date: >>Last-Modified: >>Originator: =A0 =A0 Oliver Hartmann >>Release: =A0 =A0 =A0 =A0FreeBSD 10.0/amd64 and FreeBSD 9.0-STABLE/amd64 >>Organization: > FU Berlin >>Environment: >>Description: > Mssing a manpage entry for kernel option > > device smbios > > which is explained to be a DMI/SMBIOS entry point in amd64/NOTES. No furt= her informations available, not known whether this option is prerequisite f= or any readings of the DMI by userland software. In short, no. Many SMBIOS applications like dmidecode poke directly at /dev/mem . Thanks. -Garrett From owner-freebsd-doc@FreeBSD.ORG Thu Jan 5 20:30:15 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 438E6106566C for ; Thu, 5 Jan 2012 20:30:15 +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 176118FC12 for ; Thu, 5 Jan 2012 20:30:15 +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 q05KUE97005875 for ; Thu, 5 Jan 2012 20:30:14 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q05KUEiF005874; Thu, 5 Jan 2012 20:30:14 GMT (envelope-from gnats) Date: Thu, 5 Jan 2012 20:30:14 GMT Message-Id: <201201052030.q05KUEiF005874@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Garrett Cooper Cc: Subject: Re: docs/144537: Missing _mdconfig_list and _mdconfig2_list explanation in rc.conf(5) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Garrett Cooper List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 05 Jan 2012 20:30:15 -0000 The following reply was made to PR docs/144537; it has been noted by GNATS. From: Garrett Cooper To: bug-followup Cc: Subject: Re: docs/144537: Missing _mdconfig_list and _mdconfig2_list explanation in rc.conf(5) Date: Thu, 5 Jan 2012 12:21:44 -0800 On Mon, Jan 2, 2012 at 4:02 AM, Garrett Cooper wrote: > Please refer to conf/122477 for a patch that does what you want. The OP's email address bounces. Please dupe this against one of the other mdconfig rc.d bugs because the issues are the same (the one I suggested might suffice). Thanks! -Garrett From owner-freebsd-doc@FreeBSD.ORG Fri Jan 6 21:30:13 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 CA4931065678 for ; Fri, 6 Jan 2012 21:30:13 +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 8C94A8FC13 for ; Fri, 6 Jan 2012 21:30:13 +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 q06LUD17024070 for ; Fri, 6 Jan 2012 21:30:13 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q06LUDkM024067; Fri, 6 Jan 2012 21:30:13 GMT (envelope-from gnats) Resent-Date: Fri, 6 Jan 2012 21:30:13 GMT Resent-Message-Id: <201201062130.q06LUDkM024067@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, Schaich@FreeBSD.org, Alonso Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D17A41065670 for ; Fri, 6 Jan 2012 21:28:06 +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 C0EC48FC1C for ; Fri, 6 Jan 2012 21:28:06 +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 q06LS6Pn002142 for ; Fri, 6 Jan 2012 21:28:06 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id q06LS6dK002139; Fri, 6 Jan 2012 21:28:06 GMT (envelope-from nobody) Message-Id: <201201062128.q06LS6dK002139@red.freebsd.org> Date: Fri, 6 Jan 2012 21:28:06 GMT From: Schaich@FreeBSD.org, Alonso To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/163877: apm(4) is not installed 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, 06 Jan 2012 21:30:13 -0000 >Number: 163877 >Category: docs >Synopsis: apm(4) is not installed >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 Jan 06 21:30:13 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Schaich, Alonso >Release: 9-STABLE >Organization: >Environment: FreeBSD harmony.localnet.edu 9.0-STABLE FreeBSD 9.0-STABLE #2 r229560: Thu Jan 5 08:29:51 CET 2012 alonso@harmony.localnet.edu:/usr/obj/usr/src/sys/GENERIC amd64 >Description: APM(8) refers to APM(4) in it's SEE ALSO section. However APM(4) was not installed here. I assume that this is due to APM(4) being in share/man/man4/man4.i386/apm.4 i.e. it probably only gets installed on i386. >How-To-Repeat: man apm (on amd64) >Fix: easiest solution probably is to sed- or patch-away the references to APM(4) in usr.sbin/apm/apm.8 out during installation on non-i386. patch is attached. usr.sbin/apm/Makefile needs still to be modified, as I don't know how to do arch checks Patch attached with submission follows: diff --recursive a/usr.sbin/apm/apm.8 b/usr.sbin/apm/apm.8 78,80d77 < See < .Xr apm 4 < for details. 133d129 < .Xr apm 4 , >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri Jan 6 21:41:46 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 360BF106566C for ; Fri, 6 Jan 2012 21:41:46 +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 DA3FB8FC14 for ; Fri, 6 Jan 2012 21:41:43 +0000 (UTC) Received: (qmail 96081 invoked by uid 0); 6 Jan 2012 16:41:43 -0500 Received: from unknown (HELO glenbarber.us) (75.146.225.65) by 0 with SMTP; 6 Jan 2012 16:41:43 -0500 Date: Fri, 6 Jan 2012 16:41:41 -0500 From: Glen Barber To: alonsoschaich@gmx.de Message-ID: <20120106214141.GD2064@glenbarber.us> References: <201201062128.q06LS6dK002139@red.freebsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <201201062128.q06LS6dK002139@red.freebsd.org> X-Operating-System: FreeBSD 10.0-CURRENT amd64 User-Agent: Mutt/1.5.21 (2010-09-15) Cc: freebsd-doc@FreeBSD.org, bug-followup@FreeBSD.org Subject: Re: docs/163877: apm(4) is not installed 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, 06 Jan 2012 21:41:46 -0000 On Fri, Jan 06, 2012 at 09:28:06PM +0000, Schaich@FreeBSD.org wrote: > >Environment: > FreeBSD harmony.localnet.edu 9.0-STABLE FreeBSD 9.0-STABLE #2 r229560: Thu Jan 5 08:29:51 CET 2012 alonso@harmony.localnet.edu:/usr/obj/usr/src/sys/GENERIC amd64 > >Description: > APM(8) refers to APM(4) in it's SEE ALSO section. However APM(4) was not installed here. > I assume that this is due to APM(4) being in > share/man/man4/man4.i386/apm.4 > i.e. it probably only gets installed on i386. I believe apm(4) is an i386-specific device. At least, since very old r6411: ------------------------------------------------------------------------ r6411 | wollman | 1995-02-14 20:20:03 -0500 (Tue, 14 Feb 1995) | 2 lines Move apm(4) to i386 section, since it is i386-specific. ------------------------------------------------------------------------ Glen From owner-freebsd-doc@FreeBSD.ORG Fri Jan 6 21:50:10 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 623BE10657CB for ; Fri, 6 Jan 2012 21:50:10 +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 248048FC1B for ; Fri, 6 Jan 2012 21:50: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 q06LoA4X043399 for ; Fri, 6 Jan 2012 21:50:10 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q06LoArg043398; Fri, 6 Jan 2012 21:50:10 GMT (envelope-from gnats) Resent-Date: Fri, 6 Jan 2012 21:50:10 GMT Resent-Message-Id: <201201062150.q06LoArg043398@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, Eugen Konkov Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C11731065672 for ; Fri, 6 Jan 2012 21:41:34 +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 AF8DC8FC08 for ; Fri, 6 Jan 2012 21:41:34 +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 q06LfYkX019998 for ; Fri, 6 Jan 2012 21:41:34 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id q06LfYsd019997; Fri, 6 Jan 2012 21:41:34 GMT (envelope-from nobody) Message-Id: <201201062141.q06LfYsd019997@red.freebsd.org> Date: Fri, 6 Jan 2012 21:41:34 GMT From: Eugen Konkov To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/163879: handbook do not say about how to force to not compile sources for some device 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, 06 Jan 2012 21:50:10 -0000 >Number: 163879 >Category: docs >Synopsis: handbook do not say about how to force to not compile sources for some device >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 Jan 06 21:50:09 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Eugen Konkov >Release: >Organization: ISP FreeLine >Environment: >Description: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-config.html handbook do not say about how to force to not compile sources for some device. that is implicit that comment option or remove it to disable device from compiling. The general format of a configuration file is quite simple. Each line contains a keyword and one or more arguments. For simplicity, most lines only contain one argument. Anything following a # is considered a comment and ignored. ++++addthis line+++++ here must be description how to not compile 'device' ++++addthisline++++ The following sections describe each keyword, in the order they are listed in GENERIC. For an exhaustive list of architecture dependent options and devices, see the NOTES file in the same directory as the GENERIC file. For architecture independent options, see /usr/src/sys/conf/NOTES. >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri Jan 6 21:50: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 D5B7410657C3 for ; Fri, 6 Jan 2012 21:50: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 C57268FC1D for ; Fri, 6 Jan 2012 21:50: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 q06LoBtw043404 for ; Fri, 6 Jan 2012 21:50:11 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q06LoBDe043403; Fri, 6 Jan 2012 21:50:11 GMT (envelope-from gnats) Date: Fri, 6 Jan 2012 21:50:11 GMT Message-Id: <201201062150.q06LoBDe043403@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Glen Barber Cc: Subject: Re: docs/163877: apm(4) is not installed X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Glen Barber List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 06 Jan 2012 21:50:11 -0000 The following reply was made to PR docs/163877; it has been noted by GNATS. From: Glen Barber To: alonsoschaich@gmx.de Cc: bug-followup@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/163877: apm(4) is not installed Date: Fri, 6 Jan 2012 16:41:41 -0500 On Fri, Jan 06, 2012 at 09:28:06PM +0000, Schaich@FreeBSD.org wrote: > >Environment: > FreeBSD harmony.localnet.edu 9.0-STABLE FreeBSD 9.0-STABLE #2 r229560: Thu Jan 5 08:29:51 CET 2012 alonso@harmony.localnet.edu:/usr/obj/usr/src/sys/GENERIC amd64 > >Description: > APM(8) refers to APM(4) in it's SEE ALSO section. However APM(4) was not installed here. > I assume that this is due to APM(4) being in > share/man/man4/man4.i386/apm.4 > i.e. it probably only gets installed on i386. I believe apm(4) is an i386-specific device. At least, since very old r6411: ------------------------------------------------------------------------ r6411 | wollman | 1995-02-14 20:20:03 -0500 (Tue, 14 Feb 1995) | 2 lines Move apm(4) to i386 section, since it is i386-specific. ------------------------------------------------------------------------ Glen From owner-freebsd-doc@FreeBSD.ORG Fri Jan 6 22:30:13 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 948001065687 for ; Fri, 6 Jan 2012 22:30:13 +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 81CEB8FC1C for ; Fri, 6 Jan 2012 22:30:13 +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 q06MUDOc078851 for ; Fri, 6 Jan 2012 22:30:13 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q06MUD2T078846; Fri, 6 Jan 2012 22:30:13 GMT (envelope-from gnats) Date: Fri, 6 Jan 2012 22:30:13 GMT Message-Id: <201201062230.q06MUD2T078846@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: =?windows-1251?B?yu7t/Oru4iDF4uPl7ejp?= Cc: Subject: Re: docs/163879: handbook do not say about how to force to not compile sources for some device X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: =?windows-1251?B?yu7t/Oru4iDF4uPl7ejp?= List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 06 Jan 2012 22:30:13 -0000 The following reply was made to PR docs/163879; it has been noted by GNATS. From: =?windows-1251?B?yu7t/Oru4iDF4uPl7ejp?= To: bug-followup@FreeBSD.org, kes-kes@yandex.ru Cc: Subject: Re: docs/163879: handbook do not say about how to force to not compile sources for some device Date: Sat, 7 Jan 2012 00:21:11 +0200 even more if I comment out 'device et' or try 'nodevice et' and if_et.c contain: #cat /usr/src/sys/dev/et/if_et.c aldsfjadl;fadjf NO COMPILEABLE CODE HERE I can not build kernel at all PS. I am not sure, but I think that this must be another PR because this part is not related to 'doc' so I open new one: http://www.freebsd.org/cgi/query-pr.cgi?pr=163880 From owner-freebsd-doc@FreeBSD.ORG Sat Jan 7 05:17: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 E9F8E1065677 for ; Sat, 7 Jan 2012 05:17:48 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-6.mit.edu (DMZ-MAILSEC-SCANNER-6.MIT.EDU [18.7.68.35]) by mx1.freebsd.org (Postfix) with ESMTP id 883848FC14 for ; Sat, 7 Jan 2012 05:17:48 +0000 (UTC) X-AuditID: 12074423-b7f9c6d0000008c3-f1-4f07d57bb331 Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) by dmz-mailsec-scanner-6.mit.edu (Symantec Messaging Gateway) with SMTP id 05.5E.02243.B75D70F4; Sat, 7 Jan 2012 00:17:47 -0500 (EST) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id q075HlCr026371; Sat, 7 Jan 2012 00:17:47 -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 q075Hjhh008697 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sat, 7 Jan 2012 00:17:47 -0500 (EST) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id q075Hj2e014422; Sat, 7 Jan 2012 00:17:45 -0500 (EST) Date: Sat, 7 Jan 2012 00:17:44 -0500 (EST) From: Benjamin Kaduk To: Adam Vande More In-Reply-To: Message-ID: References: User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrDIsWRmVeSWpSXmKPExsUixCmqrVt9ld3f4Mg0BYu9C+YzW0z9uJPV gcljxqf5LB47Z91lD2CK4rJJSc3JLEst0rdL4MqY2zyNpeAha8WGxw/ZGxhPsHQxcnJICJhI TGq+zwRhi0lcuLeerYuRi0NIYB+jxLVNp5lBEkIC6xklWi/4QST2M0ms/LuGESJRL7F/81pW EJtFQEvi8r9rYA1sAioSM99sZAOxRQS0Jdp2fALbwCwgLHH60l2wXmGgmqPdp8FsToFAiX/7 v4LV8ArYSzQdf8gEMT9A4u60y2AzRQV0JFbvn8ICUSMocXLmExaImZYS5/5cZ5vAKDgLSWoW ktQCRqZVjLIpuVW6uYmZOcWpybrFyYl5ealFumZ6uZkleqkppZsYQYHK7qK8g/HPQaVDjAIc jEo8vC+12P2FWBPLiitzDzFKcjApifLeugwU4kvKT6nMSCzOiC8qzUktPsQowcGsJML73Bco x5uSWFmVWpQPk5LmYFES59XQeucnJJCeWJKanZpakFoEk5Xh4FCS4D15BahRsCg1PbUiLTOn BCHNxMEJMpwHaPh+kBre4oLE3OLMdIj8KUZFKXHecyAJAZBERmkeXC8skbxiFAd6RZj3KEgV DzAJwXW/AhrMBDQ4SoQFZHBJIkJKqoHx2tcfZ8Nupe3/ERoioi519uFuSdNW3oLFs0Nnfzb7 2BgTERrw+uXptSyaK5SO69v8SZGdbNdVu4xlRdua8sOMdwOmOYq835BdeIqxeInFC+carilR 9R+dK2a4faktlt38ofxnXrqexr8tPbZCrsaXD3oWNCrpzzD1vLz77XPd1FUhCb6vLvkrsRRn JBpqMRcVJwIAwELch/8CAAA= Cc: doc@freebsd.org Subject: Re: Suggestion for Handbook 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: Sat, 07 Jan 2012 05:17:49 -0000 On Thu, 5 Jan 2012, Adam Vande More wrote: > This page contain info on creating a disk image: > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/disks-virtual.html > > Of course the dd method works, but it might be better to use truncate(1) > instead of dd because it creates sparse files and is nearly as universal as > dd. > > E.g. "truncate -s 5k file.img" I think dd would be preferred precisely because it does not use sparse files -- all blocks for the image will be allocated. If a sparse file was used, and the physical disk became close to full, then when the system goes to make a write to the image and the backing file cannot be grown, things are unlikely to fail gracefully. -Ben Kaduk From owner-freebsd-doc@FreeBSD.ORG Sat Jan 7 08:11:11 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 43048106564A; Sat, 7 Jan 2012 08:11:11 +0000 (UTC) (envelope-from ryusuke@FreeBSD.org) Received: from castle.jp.FreeBSD.org (castle.jp.FreeBSD.org [IPv6:2001:218:422:1::15]) by mx1.freebsd.org (Postfix) with ESMTP id 8D7B68FC08; Sat, 7 Jan 2012 08:11:10 +0000 (UTC) Received: from localhost (localhost [::1]) by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) with ESMTP/inet6 id q078B9O77457; Sat, 7 Jan 2012 17:11:09 +0900 (JST) (envelope-from ryusuke@FreeBSD.org) Date: Sat, 07 Jan 2012 17:11:03 +0900 (JST) Message-Id: <20120107.171103.193758902.ryusuke@jp.FreeBSD.org> To: freebsd-doc@FreeBSD.org From: Ryusuke SUZUKI X-Mailer: Mew version 6.1 on Emacs 22.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Sat_Jan__7_17_11_03_2012_364)--" Content-Transfer-Encoding: 7bit Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/159650: Call for review : Description of crash dump (developers-handbook) 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: Sat, 07 Jan 2012 08:11:11 -0000 ----Security_Multipart(Sat_Jan__7_17_11_03_2012_364)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Hello, Last year, I took PR/159650. This PR is related to the crash dump. http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/159650 As you know, "dumpdev" variable of rc.conf file is "AUTO" in HEAD, but changed to "NO" on the stable branches. References RELENG_9 : http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.394.2.2 RELENG_8 : http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.358.2.2 RELENG_6 : http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.252.2.17 However, developers-handbook "10.1.1 Configuring the Dump Device" only says "AUTO is the default as of FreeBSD 6.0." http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug.html#CONFIG-DUMPDEV We should update this sentence. And I also would like to mention the crash dump menu of the bsdinstall, recently kensmith@ added http://docs.freebsd.org/cgi/getmsg.cgi?fetch=1485239+0+archive/2011/svn-src-all/20111204.svn-src-all Please review the follwoing patch: Index: chapter.sgml =================================================================== RCS file: /home/ryusuke/work/cvs-doc/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml,v retrieving revision 1.80 diff -u -r1.80 chapter.sgml --- chapter.sgml 2 Dec 2010 14:53:45 -0000 1.80 +++ chapter.sgml 7 Jan 2012 06:54:34 -0000 @@ -76,8 +76,13 @@ &man.rc.conf.5; to the path of the swap device (the recommended way to extract a kernel dump) or AUTO to use the first configured swap - device. AUTO is the default as of - &os; 6.0. + device. The defualt for dumpdev is + AUTO in HEAD, and changed to + NO on RELENG_* branches (exceptionally, + it leave AUTO in RELENG_7). + On &os; 9.0-RELEASE and later versions, + bsdinstall will prompt if crash dumps + should be enabled on the target system during the install process. Check /etc/fstab or &man.swapinfo.8; for a list of swap devices. Regards, Ryusuke ----Security_Multipart(Sat_Jan__7_17_11_03_2012_364)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (FreeBSD) iEYEABECAAYFAk8H/hcACgkQG5rRvmPSlyTPQQCgg44r+bIGEhkj+275D+Wnh1bo 8OYAnitwXwAElyASJBUHs7lrCGmhmggN =NIsP -----END PGP SIGNATURE----- ----Security_Multipart(Sat_Jan__7_17_11_03_2012_364)---- From owner-freebsd-doc@FreeBSD.ORG Sat Jan 7 11:38:18 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 60361106566B for ; Sat, 7 Jan 2012 11:38:18 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from mxout1.bln1.prohost.de (mxout1.bln1.prohost.de [213.160.84.47]) by mx1.freebsd.org (Postfix) with ESMTP id E82098FC12 for ; Sat, 7 Jan 2012 11:38:17 +0000 (UTC) Received: from Benedicts-Macbook-Pro.local (p4FC735AB.dip.t-dialin.net [79.199.53.171]) (authenticated bits=0) by mx1.bln1.prohost.de (8.14.1/8.14.1) with ESMTP id q07BcFbI020180 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sat, 7 Jan 2012 12:38:15 +0100 Message-ID: <4F082EA7.1010705@FreeBSD.org> Date: Sat, 07 Jan 2012 12:38:15 +0100 From: Benedict Reuschling Organization: The FreeBSD Project User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.7; rv:8.0) Gecko/20111105 Thunderbird/8.0 MIME-Version: 1.0 To: freebsd-doc@FreeBSD.org References: <20120107.171103.193758902.ryusuke@jp.FreeBSD.org> In-Reply-To: <20120107.171103.193758902.ryusuke@jp.FreeBSD.org> X-Enigmail-Version: 1.3.4 OpenPGP: id=4A819348 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-Null-Tag: 89ad10ab3bac5f6d1240ffe9cd92ecb2 Cc: Subject: Re: docs/159650: Call for review : Description of crash dump (developers-handbook) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: bcr@FreeBSD.org List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 07 Jan 2012 11:38:18 -0000 -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hello, Am 07.01.12 09:11, schrieb Ryusuke SUZUKI: > Hello, > > Last year, I took PR/159650. This PR is related to the crash dump. > http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/159650 > > > As you know, "dumpdev" variable of rc.conf file is "AUTO" in HEAD, > but changed to "NO" on the stable branches. > > References > RELENG_9 : http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.394.2.2 > RELENG_8 : http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.358.2.2 > RELENG_6 : http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.252.2.17 > > > However, developers-handbook "10.1.1 Configuring the Dump Device" only says > > "AUTO is the default as of FreeBSD 6.0." > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug.html#CONFIG-DUMPDEV > > > We should update this sentence. Yes, we should. > > And I also would like to mention the crash dump menu of the bsdinstall, > recently kensmith@ added > http://docs.freebsd.org/cgi/getmsg.cgi?fetch=1485239+0+archive/2011/svn-src-all/20111204.svn-src-all > > Please review the follwoing patch: I've made a few corrections inline below. > > Index: chapter.sgml > =================================================================== > RCS file: /home/ryusuke/work/cvs-doc/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml,v > retrieving revision 1.80 > diff -u -r1.80 chapter.sgml > --- chapter.sgml 2 Dec 2010 14:53:45 -0000 1.80 > +++ chapter.sgml 7 Jan 2012 06:54:34 -0000 > @@ -76,8 +76,13 @@ > &man.rc.conf.5; to the path of the swap device (the > recommended way to extract a kernel dump) or > AUTO to use the first configured swap > - device. AUTO is the default as of > - &os; 6.0. > + device. The defualt for dumpdev is s/defualt/default > + AUTO in HEAD, and changed to > + NO on RELENG_* branches (exceptionally, > + it leave AUTO in RELENG_7). Not sure what you mean by "leave" here, it does not sound right. Did you miss a word? You probably meant something like "... it is set to AUTO in RELENG_7. > + On &os; 9.0-RELEASE and later versions, > + bsdinstall will prompt if crash dumps > + should be enabled on the target system during the install process. > > Check /etc/fstab or > &man.swapinfo.8; for a list of swap devices. > The rest looks good to me. Regards Benedict Reuschling FreeBSD Documentation Committer The FreeBSD Documentation Project FreeBSD German Documentation Project - https://doc.bsdgroup.de -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.8 (Darwin) Comment: GPGTools - http://gpgtools.org Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iEYEARECAAYFAk8ILqcACgkQTSZQLkqBk0gQOQCfVTnlVgZHP2KhBSuhkfZSNO3M USEAoJwplZk3ivvGSnxCC5rNYiQJPOKS =FN80 -----END PGP SIGNATURE----- From owner-freebsd-doc@FreeBSD.ORG Sat Jan 7 15:38:36 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 DCB2D106566C; Sat, 7 Jan 2012 15:38:36 +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 AD09B8FC12; Sat, 7 Jan 2012 15:38:36 +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 q07FcaBK064105; Sat, 7 Jan 2012 15:38:36 GMT (envelope-from linimon@freefall.freebsd.org) Received: (from linimon@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q07Fcax4064101; Sat, 7 Jan 2012 15:38:36 GMT (envelope-from linimon) Date: Sat, 7 Jan 2012 15:38:36 GMT Message-Id: <201201071538.q07Fcax4064101@freefall.freebsd.org> To: unavailable@trash-mail.net, linimon@FreeBSD.org, freebsd-doc@FreeBSD.org From: linimon@FreeBSD.org Cc: Subject: Re: docs/144537: Missing _mdconfig_list and _mdconfig2_list explanation in rc.conf(5) 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: Sat, 07 Jan 2012 15:38:36 -0000 Synopsis: Missing _mdconfig_list and _mdconfig2_list explanation in rc.conf(5) State-Changed-From-To: feedback->closed State-Changed-By: linimon State-Changed-When: Sat Jan 7 15:37:40 UTC 2012 State-Changed-Why: Submitter's email address bounces, so cannot confirm this is fixed by conf/122477. http://www.freebsd.org/cgi/query-pr.cgi?pr=144537 From owner-freebsd-doc@FreeBSD.ORG Sat Jan 7 16:05:23 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 BBABE1065673; Sat, 7 Jan 2012 16:05:23 +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 6FDCA8FC1E; Sat, 7 Jan 2012 16:05:23 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q07FQX3q060821; Sat, 7 Jan 2012 08:26:33 -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 q07FQXWR060818; Sat, 7 Jan 2012 08:26:33 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Sat, 7 Jan 2012 08:26:33 -0700 (MST) From: Warren Block To: Ryusuke SUZUKI , Benedict Reuschling In-Reply-To: <4F082EA7.1010705@FreeBSD.org> Message-ID: References: <20120107.171103.193758902.ryusuke@jp.FreeBSD.org> <4F082EA7.1010705@FreeBSD.org> 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]); Sat, 07 Jan 2012 08:26:33 -0700 (MST) Cc: freebsd-doc@freebsd.org Subject: Re: docs/159650: Call for review : Description of crash dump (developers-handbook) 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: Sat, 07 Jan 2012 16:05:23 -0000 On Sat, 7 Jan 2012, Benedict Reuschling wrote: > Am 07.01.12 09:11, schrieb Ryusuke SUZUKI: >> Hello, >> >> Last year, I took PR/159650. This PR is related to the crash dump. >> http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/159650 >> >> >> As you know, "dumpdev" variable of rc.conf file is "AUTO" in HEAD, >> but changed to "NO" on the stable branches. >> >> References >> RELENG_9 : http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.394.2.2 >> RELENG_8 : http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.358.2.2 >> RELENG_6 : http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.252.2.17 >> >> >> However, developers-handbook "10.1.1 Configuring the Dump Device" only says >> >> "AUTO is the default as of FreeBSD 6.0." >> >> http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug.html#CONFIG-DUMPDEV >> >> >> We should update this sentence. > > Yes, we should. >> >> And I also would like to mention the crash dump menu of the bsdinstall, >> recently kensmith@ added >> http://docs.freebsd.org/cgi/getmsg.cgi?fetch=1485239+0+archive/2011/svn-src-all/20111204.svn-src-all >> >> Please review the follwoing patch: > I've made a few corrections inline below. > >> >> Index: chapter.sgml >> =================================================================== >> RCS file: /home/ryusuke/work/cvs-doc/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml,v >> retrieving revision 1.80 >> diff -u -r1.80 chapter.sgml >> --- chapter.sgml 2 Dec 2010 14:53:45 -0000 1.80 >> +++ chapter.sgml 7 Jan 2012 06:54:34 -0000 >> @@ -76,8 +76,13 @@ >> &man.rc.conf.5; to the path of the swap device (the >> recommended way to extract a kernel dump) or >> AUTO to use the first configured swap >> - device. AUTO is the default as of >> - &os; 6.0. >> + device. The defualt for dumpdev is > s/defualt/default > >> + AUTO in HEAD, and changed to >> + NO on RELENG_* branches (exceptionally, >> + it leave AUTO in RELENG_7). > Not sure what you mean by "leave" here, it does not sound right. Did you > miss a word? You probably meant something like "... it is set to > AUTO in RELENG_7. I think: NO on RELENG_* branches (except for RELENG_7, which was left set to AUTO). Those tags maybe ought to be , I'm not sure. >> + On &os; 9.0-RELEASE and later versions, >> + bsdinstall will prompt if crash dumps The "if" can be read two ways. Suggestion: bsdinstall will ask whether crash dumps >> + should be enabled on the target system during the install process.