From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 01:49:17 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1FE0016A4CE; Sun, 18 Jul 2004 01:49:17 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id F181E43D39; Sun, 18 Jul 2004 01:49:16 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i6I1nGP7027175; Sun, 18 Jul 2004 01:49:16 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6I1nG12027171; Sun, 18 Jul 2004 01:49:16 GMT (envelope-from keramida) Date: Sun, 18 Jul 2004 01:49:16 GMT From: Giorgos Keramidas Message-Id: <200407180149.i6I1nG12027171@freefall.freebsd.org> To: so14k@so14k.com, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/69216: [patch] fix erraneous caps X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 01:49:17 -0000 Synopsis: [patch] fix erraneous caps State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Sun Jul 18 01:48:47 GMT 2004 State-Changed-Why: Committed, thanks. Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Sun Jul 18 01:48:47 GMT 2004 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=69216 From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 01:50:23 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 108C216A4CE for ; Sun, 18 Jul 2004 01:50:23 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id DF7E443D31 for ; Sun, 18 Jul 2004 01:50:22 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6I1oMCH027262 for ; Sun, 18 Jul 2004 01:50:22 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6I1oMnc027261; Sun, 18 Jul 2004 01:50:22 GMT (envelope-from gnats) Resent-Date: Sun, 18 Jul 2004 01:50:22 GMT Resent-Message-Id: <200407180150.i6I1oMnc027261@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, Warren Block Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8BA3C16A4CE for ; Sun, 18 Jul 2004 01:41:54 +0000 (GMT) Received: from wonkity.com (wonkity.com [65.173.111.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2F40643D2F for ; Sun, 18 Jul 2004 01:41:52 +0000 (GMT) (envelope-from wblock@wonkity.com) Received: from speedy.wonkity.com (speedy [10.0.0.7]) by wonkity.com (8.12.11/8.12.11) with ESMTP id i6I1fpZ2084738 for ; Sat, 17 Jul 2004 19:41:51 -0600 (MDT) (envelope-from wblock@speedy.wonkity.com) Received: from speedy.wonkity.com (speedy.wonkity.com [127.0.0.1]) by speedy.wonkity.com (8.12.11/8.12.11) with ESMTP id i6I1fpgV001309 for ; Sat, 17 Jul 2004 19:41:51 -0600 (MDT) (envelope-from wblock@speedy.wonkity.com) Received: (from wblock@localhost) by speedy.wonkity.com (8.12.11/8.12.11/Submit) id i6I1fpRP001136; Sat, 17 Jul 2004 19:41:51 -0600 (MDT) (envelope-from wblock) Message-Id: <200407180141.i6I1fpRP001136@speedy.wonkity.com> Date: Sat, 17 Jul 2004 19:41:51 -0600 (MDT) From: Warren Block To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69220: PATCH-Fix misplaced acronym tags in Disks chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Warren Block List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 01:50:23 -0000 >Number: 69220 >Category: docs >Synopsis: PATCH-Fix misplaced acronym tags in Disks chapter >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Jul 18 01:50:22 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Warren Block >Release: FreeBSD 4.10-STABLE i386 >Organization: >Environment: System: FreeBSD speedy 4.10-STABLE FreeBSD 4.10-STABLE #0: Thu May 27 20:32:57 MDT 2004 root@speedy:/usr/obj/usr/src/sys/SPEEDY i386 >Description: Acronym tags in the Disks chapter are misplaced. >How-To-Repeat: Search for "Promise ATA RAID" in the Disks chapter. >Fix: Apply this patch: --- /usr/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml Sat Jul 17 06:22:17 2004 +++ chapter.sgml Sat Jul 17 19:35:52 2004 @@ -644,7 +644,7 @@ array. Using an on-card BIOS, the card controls most of the disk operations - itself. The following is a brief setup description using a Promise IDE RAID + itself. The following is a brief setup description using a Promise IDE RAID controller. When this card is installed and the system is started up, it displays a prompt requesting information. Follow the instructions to enter the card's setup screen. From here, you have the ability to >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 01:53:34 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1FD7C16A4CE; Sun, 18 Jul 2004 01:53:34 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id F377C43D31; Sun, 18 Jul 2004 01:53:33 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i6I1rXjm027433; Sun, 18 Jul 2004 01:53:33 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6I1rXkv027429; Sun, 18 Jul 2004 01:53:33 GMT (envelope-from keramida) Date: Sun, 18 Jul 2004 01:53:33 GMT From: Giorgos Keramidas Message-Id: <200407180153.i6I1rXkv027429@freefall.freebsd.org> To: joel@automatvapen.se, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/69202: [PATCH] Add Firefox to list of browsers in handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 01:53:34 -0000 Synopsis: [PATCH] Add Firefox to list of browsers in handbook State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Sun Jul 18 01:52:38 GMT 2004 State-Changed-Why: Committed, thanks! The changes should appear online in a few hours. Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Sun Jul 18 01:52:38 GMT 2004 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=69202 From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 01:57:26 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 26F0216A4CE; Sun, 18 Jul 2004 01:57:26 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0547843D31; Sun, 18 Jul 2004 01:57:26 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i6I1vPOH027542; Sun, 18 Jul 2004 01:57:25 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6I1vPmU027538; Sun, 18 Jul 2004 01:57:25 GMT (envelope-from keramida) Date: Sun, 18 Jul 2004 01:57:25 GMT From: Giorgos Keramidas Message-Id: <200407180157.i6I1vPmU027538@freefall.freebsd.org> To: wblock@wonkity.com, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/69220: PATCH-Fix misplaced acronym tags in Disks chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 01:57:26 -0000 Synopsis: PATCH-Fix misplaced acronym tags in Disks chapter State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Sun Jul 18 01:56:58 GMT 2004 State-Changed-Why: Committed, thanks! The changes should appear online in a few hours. Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Sun Jul 18 01:56:58 GMT 2004 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=69220 From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 02:10:27 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 57C2716A4CE for ; Sun, 18 Jul 2004 02:10:27 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 33F6143D4C for ; Sun, 18 Jul 2004 02:10:27 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6I2ARiZ031679 for ; Sun, 18 Jul 2004 02:10:27 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6I2ARb6031678; Sun, 18 Jul 2004 02:10:27 GMT (envelope-from gnats) Date: Sun, 18 Jul 2004 02:10:27 GMT Message-Id: <200407180210.i6I2ARb6031678@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Giorgos Keramidas Subject: Re: docs/69086: Porters Handbook: How to convert from CR/LF to LF using REINPLACE_CMD X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Giorgos Keramidas List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 02:10:27 -0000 The following reply was made to PR docs/69086; it has been noted by GNATS. From: Giorgos Keramidas To: Alexey Dokuchaev , "David O'Brien" Cc: bug-followup@FreeBSD.org, freebsd-ports@FreeBSD.org Subject: Re: docs/69086: Porters Handbook: How to convert from CR/LF to LF using REINPLACE_CMD Date: Sun, 18 Jul 2004 05:04:00 +0300 On 2004-07-15 14:01, Alexey Dokuchaev wrote: > I therefore suggest including this in Porter's Handbook, as in > attached patch. This looks like a very nice way to filter the sources to me. I'm not very experienced with the way our ports system works though. Do the people on freebsd-ports agree about this change? In particular, since he seems to be the most active ports committer that updates the porters-handbook, does David O'Brien agree with this addition? > Index: book.sgml > =================================================================== > RCS file: /home/pub/ftp/pub/FreeBSD/development/FreeBSD-CVS//doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v > retrieving revision 1.461 > diff -u -r1.461 book.sgml > --- book.sgml 12 Jul 2004 08:24:15 -0000 1.461 > +++ book.sgml 15 Jul 2004 06:55:26 -0000 > @@ -681,6 +681,24 @@ > lines!); define USE_AUTOCONF_VER=213 and take the > diffs of configure.in. > > + Quite often, there is a situation when ported software, being > + primarily developed on Windows, uses CR/LF convention for most of its > + source files. This may cause problems with further patching, compiler > + warnings, scipts execution (/bin/sh^M not found), > + etc. To quickly convert those files from CR/LF to just LF, you can do > + something like this: > + > + USE_REINPLACE= yes > + > +post-extract: > + @${FIND} -E ${WRKDIR} -type f -iregex ".*\.(c|cpp|h|txt)" \ > + -exec ${REINPLACE_CMD} -e 's/[[:cntrl:]]*$$//' '{}' \; > + > + Of course, if you need to process each and every file, > + above can be omitted. Be aware that this > + piece of code will strip all trailing control characters from each > + line of processed file (except \n). > + > Also, if you had to delete a file, then you can do it in the > post-extract target rather than as part of > the patch. Once you are happy with the resulting diff, please split From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 02:28:23 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id EE7DB16A4CE; Sun, 18 Jul 2004 02:28:23 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id CD9B043D1F; Sun, 18 Jul 2004 02:28:23 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i6I2SNJD032137; Sun, 18 Jul 2004 02:28:23 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6I2SNdL032133; Sun, 18 Jul 2004 02:28:23 GMT (envelope-from keramida) Date: Sun, 18 Jul 2004 02:28:23 GMT From: Giorgos Keramidas Message-Id: <200407180228.i6I2SNdL032133@freefall.freebsd.org> To: alex@kapran.bitmcnit.bryansk.su, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/26943: [patch] description of :C modifier is misplaced in make.1 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 02:28:24 -0000 Synopsis: [patch] description of :C modifier is misplaced in make.1 State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Sun Jul 18 02:26:45 GMT 2004 State-Changed-Why: Some of the suggestions made in this PR had already been committed. I've edited the part that describes :C to make it independent of :S. Thanks for submitting this and my apologies for taking that long to handle the PR! Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Sun Jul 18 02:26:45 GMT 2004 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=26943 From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 02:44:37 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8F69D16A4CE; Sun, 18 Jul 2004 02:44:37 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6E66F43D39; Sun, 18 Jul 2004 02:44:37 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i6I2ibss033575; Sun, 18 Jul 2004 02:44:37 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6I2ibg0033571; Sun, 18 Jul 2004 02:44:37 GMT (envelope-from keramida) Date: Sun, 18 Jul 2004 02:44:37 GMT From: Giorgos Keramidas Message-Id: <200407180244.i6I2ibg0033571@freefall.freebsd.org> To: fox@vader.aacc.cc.md.us, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/66539: [patch] share/man/man4/netgraph.4 inconsistent field name X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 02:44:37 -0000 Synopsis: [patch] share/man/man4/netgraph.4 inconsistent field name State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Sun Jul 18 02:42:54 GMT 2004 State-Changed-Why: Committed. Thanks for catching this. Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Sun Jul 18 02:42:54 GMT 2004 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=66539 From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 03:30:22 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9373E16A4CE for ; Sun, 18 Jul 2004 03:30:22 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6BF4043D55 for ; Sun, 18 Jul 2004 03:30:22 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6I3UMM9038490 for ; Sun, 18 Jul 2004 03:30:22 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6I3UMWt038479; Sun, 18 Jul 2004 03:30:22 GMT (envelope-from gnats) Resent-Date: Sun, 18 Jul 2004 03:30:22 GMT Resent-Message-Id: <200407180330.i6I3UMWt038479@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, Warren Block Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id CBF7616A4CE for ; Sun, 18 Jul 2004 03:21:02 +0000 (GMT) Received: from wonkity.com (wonkity.com [65.173.111.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 71E5C43D46 for ; Sun, 18 Jul 2004 03:21:02 +0000 (GMT) (envelope-from wblock@wonkity.com) Received: from speedy.wonkity.com (speedy [10.0.0.7]) by wonkity.com (8.12.11/8.12.11) with ESMTP id i6I3L1u2019335 for ; Sat, 17 Jul 2004 21:21:01 -0600 (MDT) (envelope-from wblock@speedy.wonkity.com) Received: from speedy.wonkity.com (speedy.wonkity.com [127.0.0.1]) by speedy.wonkity.com (8.12.11/8.12.11) with ESMTP id i6I3L1pW056860 for ; Sat, 17 Jul 2004 21:21:01 -0600 (MDT) (envelope-from wblock@speedy.wonkity.com) Received: (from wblock@localhost) by speedy.wonkity.com (8.12.11/8.12.11/Submit) id i6I3L1E5056859; Sat, 17 Jul 2004 21:21:01 -0600 (MDT) (envelope-from wblock) Message-Id: <200407180321.i6I3L1E5056859@speedy.wonkity.com> Date: Sat, 17 Jul 2004 21:21:01 -0600 (MDT) From: Warren Block To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69221: PATCH-Misuse of acronym tags in PPP chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Warren Block List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 03:30:22 -0000 >Number: 69221 >Category: docs >Synopsis: PATCH-Misuse of acronym tags in PPP chapter >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Jul 18 03:30:21 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Warren Block >Release: FreeBSD 4.10-STABLE i386 >Organization: >Environment: System: FreeBSD speedy 4.10-STABLE FreeBSD 4.10-STABLE #0: Thu May 27 20:32:57 MDT 2004 root@speedy:/usr/obj/usr/src/sys/SPEEDY i386 >Description: Acronym tags are used in place of devicename tags in the PPP chapter. >How-To-Repeat: Search for COM2. >Fix: Apply this patch: --- /usr/doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml Fri Jul 9 12:06:15 2004 +++ chapter.sgml Sat Jul 17 21:17:04 2004 @@ -1799,7 +1799,7 @@ which will create the serial devices for your system. When matching up sio modem is on sio1 or - COM2 if you are in DOS, then your + COM2 if you are in DOS, then your modem device would be /dev/cuaa1. >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 04:50:29 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4FCC916A4CE for ; Sun, 18 Jul 2004 04:50:29 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1D99943D55 for ; Sun, 18 Jul 2004 04:50:29 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6I4oQo5058685 for ; Sun, 18 Jul 2004 04:50:26 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6I4oQsN058684; Sun, 18 Jul 2004 04:50:26 GMT (envelope-from gnats) Resent-Date: Sun, 18 Jul 2004 04:50:26 GMT Resent-Message-Id: <200407180450.i6I4oQsN058684@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, Warren Block Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 086E016A4CE for ; Sun, 18 Jul 2004 04:40:58 +0000 (GMT) Received: from wonkity.com (wonkity.com [65.173.111.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id A4D7243D41 for ; Sun, 18 Jul 2004 04:40:57 +0000 (GMT) (envelope-from wblock@wonkity.com) Received: from speedy.wonkity.com (speedy [10.0.0.7]) by wonkity.com (8.12.11/8.12.11) with ESMTP id i6I4evIu019429 for ; Sat, 17 Jul 2004 22:40:57 -0600 (MDT) (envelope-from wblock@speedy.wonkity.com) Received: from speedy.wonkity.com (speedy.wonkity.com [127.0.0.1]) by speedy.wonkity.com (8.12.11/8.12.11) with ESMTP id i6I4evuj057290 for ; Sat, 17 Jul 2004 22:40:57 -0600 (MDT) (envelope-from wblock@speedy.wonkity.com) Received: (from wblock@localhost) by speedy.wonkity.com (8.12.11/8.12.11/Submit) id i6I4evCo057289; Sat, 17 Jul 2004 22:40:57 -0600 (MDT) (envelope-from wblock) Message-Id: <200407180440.i6I4evCo057289@speedy.wonkity.com> Date: Sat, 17 Jul 2004 22:40:57 -0600 (MDT) From: Warren Block To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Warren Block List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 04:50:29 -0000 >Number: 69225 >Category: docs >Synopsis: PATCH-Serial comms chapter has wrong acronym for Transmit Data >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Jul 18 04:50:25 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Warren Block >Release: FreeBSD 4.10-STABLE i386 >Organization: >Environment: System: FreeBSD speedy 4.10-STABLE FreeBSD 4.10-STABLE #0: Thu May 27 20:32:57 MDT 2004 root@speedy:/usr/obj/usr/src/sys/SPEEDY i386 >Description: Serial comms chapter acronym for serial transmit data line is wrong, fix for tenses. >How-To-Repeat: Search for SD in the serial comms chapter. >Fix: Apply this patch: --- /usr/doc/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml Sat Jul 17 06:22:19 2004 +++ chapter.sgml Sat Jul 17 22:37:04 2004 @@ -978,11 +978,11 @@ - Transmitted Data (SD) + Transmit Data (TD) - Received Data (RD) + Receive Data (RD) >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 07:31:53 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 502F416A4CE for ; Sun, 18 Jul 2004 07:31:53 +0000 (GMT) Received: from hotmail.com (bay2-dav12.bay2.hotmail.com [65.54.246.116]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4588E43D3F for ; Sun, 18 Jul 2004 07:31:53 +0000 (GMT) (envelope-from nefar@hotmail.com) Received: from mail pickup service by hotmail.com with Microsoft SMTPSVC; Sun, 18 Jul 2004 00:31:53 -0700 Received: from 64.142.12.240 by bay2-dav12.bay2.hotmail.com with DAV; Sun, 18 Jul 2004 07:31:52 +0000 X-Originating-IP: [64.142.12.240] X-Originating-Email: [nefar@hotmail.com] X-Sender: nefar@hotmail.com From: "Daniel" To: Date: Sun, 18 Jul 2004 00:32:21 -0700 MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 5.50.4522.1200 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1409 Message-ID: X-OriginalArrivalTime: 18 Jul 2004 07:31:53.0203 (UTC) FILETIME=[4BE0B430:01C46C99] Subject: 23.5 Automatic Network Configuration (DHCP) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 07:31:53 -0000 Hi, This section mentions net/isc-dhcp3-server, however, there is no such port, the port seems to have changed names to net/isc-dhcp3 only. Please update the documentation accordingly. Daniel From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 10:02:28 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E18D616A4CE; Sun, 18 Jul 2004 10:02:28 +0000 (GMT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id CF7B143D41; Sun, 18 Jul 2004 10:02:27 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) i6IA2PbZ084959; Sun, 18 Jul 2004 12:02:25 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.11/8.12.11/Submit) id i6IA2PBi084958; Sun, 18 Jul 2004 12:02:25 +0200 (CEST) (envelope-from marc) Date: Sun, 18 Jul 2004 12:02:25 +0200 From: Marc Fonvieille To: Murray Stokely Message-ID: <20040718100224.GA84500@abigail.blackend.org> References: <20040713074042.GA5126@abigail.blackend.org> <20040713170624.GU29928@submonkey.net> <20040713181500.GA10935@abigail.blackend.org> <20040715071709.GB55440@hub.freebsd.org> <20040715073027.GA725@zaphod.nitro.dk> <20040715083333.GA62713@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040715083333.GA62713@hub.freebsd.org> User-Agent: Mutt/1.4.2.1i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.10-PRERELEASE cc: Ceri Davies cc: doc@FreeBSD.org cc: "Simon L. Nielsen" Subject: Re: Mouseover definitions for acronyms (was Re: RFC: initialisms and FDP) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 10:02:29 -0000 On Thu, Jul 15, 2004 at 08:33:33AM +0000, Murray Stokely wrote: > Ok this is working now. Thanks to Simon for explaining how to do the > mouseovers in HTML4. I think that the little dotted underlines will > get distracting in a chapter filled with acronyms. > > For the advanced networking chapter anyway, it might look best if the > first occurence of an acronym is rendered with a link to the glossary, > and the first three are rendered with the mouseover. > > I'm not really sure, it's largely up to individual sense of > aesthetic. What do others think? > [...] Well for me "it looks weird", I mean I see too much dotted underlines :) just look at the 23.4.2 section for example... or some titles. Many different acronyms in one text could lead to something "difficult" to read. I think rendering the first three ones should be enough, if one needs to know the meaning of NIS, it's at the beginning of the text not at the end. Now an "innocent" question: if we use first four acronyms (1 for the glossary, the rest for the mouseover thing), do we need to tag the remaining ones (with an entity or tags)? I'm thinking about a section not a whole chapter. Marc From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 10:32:48 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 430D116A4CE for ; Sun, 18 Jul 2004 10:32:48 +0000 (GMT) Received: from q.closedsrc.org (ip233.gte244.dsl-acs2.sea.iinet.com [209.20.244.233]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0704243D1D for ; Sun, 18 Jul 2004 10:32:48 +0000 (GMT) (envelope-from question+fbsddoc@closedsrc.org) Received: by q.closedsrc.org (Postfix, from userid 1001) id A092F4507E; Sun, 18 Jul 2004 03:32:31 -0700 (PDT) Date: Sun, 18 Jul 2004 03:32:31 -0700 From: Linh Pham To: Daniel Message-ID: <20040718103231.GA94344@q.internal.closedsrc.org> References: Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="2fHTh5uZTiUOsy+g" Content-Disposition: inline In-Reply-To: Organization: closedsrc.org Mail-Copies-To: poster X-PGP-Key: http://closedsrc.org/~question/pubkey.asc User-Agent: Mutt/1.5.6i cc: doc@FreeBSD.org Subject: Re: 23.5 Automatic Network Configuration (DHCP) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 10:32:48 -0000 --2fHTh5uZTiUOsy+g Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004-07-18 00:32 -0700, Daniel wrote: # This section mentions net/isc-dhcp3-server, however, there is no such por= t, # the port seems to have changed names to net/isc-dhcp3 only. Please update # the documentation accordingly. net/isc-dhcp3-server, net/isc-dhcp3-client and net/isc-dhcp3-relay were created in the Ports collection about 5 months ago as noted in the CVS tree for net/isc-dhcp3-server: http://www.freebsd.org/cgi/cvsweb.cgi/ports/net/isc-dhcp3-server/ You may want to update your Ports collection on your system by following the instructions in the Handbook. --=20 Linh Pham question+fbsddoc@closedsrc.org Webmaster and FreeBSD Geek http://closedsrc.org Apprentice Manager Editor and Writer http://www.daemonnews.org Q->Worf: Eat any good books lately? | Humans =3D Ugly Bags of Mostly Water --2fHTh5uZTiUOsy+g Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA+lG/whofDeWkDMIRAtt+AKCZz5yHOxEz7b6nIq4oLkKwaf+gIACdFH4J DVsypCIuMciP1xRxLGLOLiY= =UkFI -----END PGP SIGNATURE----- --2fHTh5uZTiUOsy+g-- From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 11:35:30 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3F4FB16A4CE for ; Sun, 18 Jul 2004 11:35:30 +0000 (GMT) Received: from mail.elvandar.org (cust.94.120.adsl.cistron.nl [195.64.94.120]) by mx1.FreeBSD.org (Postfix) with ESMTP id 99D4C43D2D for ; Sun, 18 Jul 2004 11:35:29 +0000 (GMT) (envelope-from remko@elvandar.org) Received: from [10.0.2.122] (nimrod.elvandar.intranet [10.0.2.122]) by mail.elvandar.org (Postfix) with ESMTP id E9EEC10685E for ; Sun, 18 Jul 2004 13:35:26 +0200 (CEST) Message-ID: <40FA6080.2040702@elvandar.org> Date: Sun, 18 Jul 2004 13:35:28 +0200 From: Remko Lodder X-Accept-Language: en-us, en MIME-Version: 1.0 To: doc@freebsd.org Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Scanned: by amavisd-new at elvandar.org Subject: Question about the introduction chapter: X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 11:35:30 -0000 Hi, While reviewing the FreeBSD Dutch Documentation Project files, i came across a entry in the introduction chapter.. " The committers list The committers are the people who have write access to the CVS tree, and are authorized to make modifications to the FreeBSD source (the term ``committer'' comes from the cvs(1) commit command, which is used to bring new changes into the CVS repository). The best way of making submissions for review by the committers list is to use the send-pr(1) command. If something appears to be jammed in the system, then you may also reach them by sending mail to the FreeBSD committer's mailing list. " All the 'FreeBSD x mailing list' items resolve to a pointing towards the http://lists.freebsd.org/mailman/listinfo/x location. Only the entry above has 'FreeBSD committer's mailing list' which is defined as &a.committers; in the chapter.sgml. Shouldn't that expand to a thingy as well? Or is it being done on purpose that the Commiters mailing list is not 'ed? Could someone explain it to me? And if it need to be changed i am willing to send-pr it, so it does not get lost in the huge pile :-) Cheers! -- Kind regards, Remko Lodder |remko@elvandar.org Reporter DSINet |remko@dsinet.org Projectleader Mostly-Harmless |remko@mostly-harmless.nl From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 12:00:52 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id CD22416A4CE for ; Sun, 18 Jul 2004 12:00:52 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 970FE43D45 for ; Sun, 18 Jul 2004 12:00:52 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6IC0qW6026357 for ; Sun, 18 Jul 2004 12:00:52 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6IC0qBJ026356; Sun, 18 Jul 2004 12:00:52 GMT (envelope-from gnats) Date: Sun, 18 Jul 2004 12:00:52 GMT Message-Id: <200407181200.i6IC0qBJ026356@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Giorgos Keramidas Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Giorgos Keramidas List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 12:00:52 -0000 The following reply was made to PR docs/69225; it has been noted by GNATS. From: Giorgos Keramidas To: Warren Block Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data Date: Sun, 18 Jul 2004 14:53:35 +0300 On 2004-07-17 22:40, Warren Block wrote: > --- /usr/doc/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml Sat Jul 17 06:22:19 2004 > +++ chapter.sgml Sat Jul 17 22:37:04 2004 > @@ -978,11 +978,11 @@ > > > > - Transmitted Data (SD) > + Transmit Data (TD) > Actually, the LED that shows transmit line activity in my modem is labelled "SD". Perhaps, we should change the description text to "Sent Data" instead? - Giorgos From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 12:59:17 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 048E216A4CE; Sun, 18 Jul 2004 12:59:17 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id F24CA43D1D; Sun, 18 Jul 2004 12:59:16 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i6ICxG5o032591; Sun, 18 Jul 2004 12:59:16 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6ICxGUb032587; Sun, 18 Jul 2004 12:59:16 GMT (envelope-from keramida) Date: Sun, 18 Jul 2004 12:59:16 GMT From: Giorgos Keramidas Message-Id: <200407181259.i6ICxGUb032587@freefall.freebsd.org> To: wblock@wonkity.com, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/69221: PATCH-Misuse of acronym tags in PPP chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 12:59:17 -0000 Synopsis: PATCH-Misuse of acronym tags in PPP chapter State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Sun Jul 18 12:56:47 GMT 2004 State-Changed-Why: Fixed, thanks. I also took the time to fix other uses of tags marking up COM[0-9] strings and added a few missing tags elsewhere. The changes should appear online in a few hours. The affected revisions of the files are: Revision Changes Path 1.17 +2 -2 doc/en_US.ISO8859-1/articles/console-server/article.sgml 1.10 +7 -7 doc/en_US.ISO8859-1/articles/serial-uart/article.sgml 1.633 +1 -1 doc/en_US.ISO8859-1/books/faq/book.sgml 1.133 +5 -5 doc/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml 1.140 +2 -2 doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml 1.91 +1 -1 doc/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Sun Jul 18 12:56:47 GMT 2004 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=69221 From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 13:00:38 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1D48F16A4D1 for ; Sun, 18 Jul 2004 13:00:38 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7534643D48 for ; Sun, 18 Jul 2004 13:00:26 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6ID0QAk032697 for ; Sun, 18 Jul 2004 13:00:26 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6ID0QXA032696; Sun, 18 Jul 2004 13:00:26 GMT (envelope-from gnats) Date: Sun, 18 Jul 2004 13:00:26 GMT Message-Id: <200407181300.i6ID0QXA032696@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Marc Fonvieille Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Marc Fonvieille List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 13:00:38 -0000 The following reply was made to PR docs/69225; it has been noted by GNATS. From: Marc Fonvieille To: Giorgos Keramidas Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data Date: Sun, 18 Jul 2004 14:54:39 +0200 On Sun, Jul 18, 2004 at 12:00:52PM +0000, Giorgos Keramidas wrote: > On 2004-07-17 22:40, Warren Block wrote: > > --- /usr/doc/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml Sat Jul 17 06:22:19 2004 > > +++ chapter.sgml Sat Jul 17 22:37:04 2004 > > @@ -978,11 +978,11 @@ > > > > > > > > - Transmitted Data (SD) > > + Transmit Data (TD) > > > > Actually, the LED that shows transmit line activity in my modem is > labelled "SD". Perhaps, we should change the description text to "Sent > Data" instead? > SD is on the modem, the text is talking about a RS232 cable: "A standard RS-232C serial cable should suffice as long as all of the normal signals are wired:" I'd change SD for TD which is the correct term in our case (or TxD, but in this case RD must be changed for RxD). TD is the data transmitted by the DTE (our computer) to the DCE (modem), RD is data to DTE from DCE. These descriptions come from a time where half duplex was common. s/Transmitted/Transmit/ etc. is not mandatory, in fact both versions are used. So I'd keep the description but I'd s/SD/TD which is correct. Marc From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 13:10:28 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 21B8F16A4CE for ; Sun, 18 Jul 2004 13:10:28 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0407443D41 for ; Sun, 18 Jul 2004 13:10:28 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6IDARoI036893 for ; Sun, 18 Jul 2004 13:10:27 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6IDARDF036892; Sun, 18 Jul 2004 13:10:27 GMT (envelope-from gnats) Date: Sun, 18 Jul 2004 13:10:27 GMT Message-Id: <200407181310.i6IDARDF036892@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Giorgos Keramidas Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Giorgos Keramidas List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 13:10:28 -0000 The following reply was made to PR docs/69225; it has been noted by GNATS. From: Giorgos Keramidas To: Marc Fonvieille Cc: bug-followup@FreeBSD.org Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data Date: Sun, 18 Jul 2004 16:04:53 +0300 On 2004-07-18 14:54, Marc Fonvieille wrote: > [snip] > So I'd keep the description but I'd s/SD/TD which is correct. Cool! Thanks for the explanation too, I didn't read the original text very carefully and this was much needed. Go for it :) From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 13:21:46 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id D141516A4CF; Sun, 18 Jul 2004 13:21:46 +0000 (GMT) Date: Sun, 18 Jul 2004 13:21:46 +0000 From: Murray Stokely To: Marc Fonvieille Message-ID: <20040718132146.GA83265@hub.freebsd.org> References: <20040713074042.GA5126@abigail.blackend.org> <20040713170624.GU29928@submonkey.net> <20040713181500.GA10935@abigail.blackend.org> <20040715071709.GB55440@hub.freebsd.org> <20040715073027.GA725@zaphod.nitro.dk> <20040715083333.GA62713@hub.freebsd.org> <20040718100224.GA84500@abigail.blackend.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040718100224.GA84500@abigail.blackend.org> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: Ceri Davies cc: doc@FreeBSD.org cc: "Simon L. Nielsen" Subject: Re: Mouseover definitions for acronyms (was Re: RFC: initialisms and FDP) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 13:21:46 -0000 On Sun, Jul 18, 2004 at 12:02:25PM +0200, Marc Fonvieille wrote: > Well for me "it looks weird", I mean I see too much dotted underlines :) > just look at the 23.4.2 section for example... or some titles. Many > different acronyms in one text could lead to something "difficult" to > read. > I think rendering the first three ones should be enough, if one needs to > know the meaning of NIS, it's at the beginning of the text not at the > end. Agreed. > Now an "innocent" question: if we use first four acronyms (1 for the > glossary, the rest for the mouseover thing), do we need to tag the > remaining ones (with an entity or tags)? I'm thinking about a > section not a whole chapter. We could handle this in either the stylesheets or in the SGML files. I personally think that there is no need to add the tags throughout the chapter -- just the first four will suffice. - Murray From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 13:29:03 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A936316A4CE; Sun, 18 Jul 2004 13:29:03 +0000 (GMT) Received: from wonkity.com (wonkity.com [65.173.111.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 28DE643D1F; Sun, 18 Jul 2004 13:28:59 +0000 (GMT) (envelope-from wblock@wonkity.com) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.12.11/8.12.11) with ESMTP id i6IDSuWw020994; Sun, 18 Jul 2004 07:28:56 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.12.11/8.12.11/Submit) with ESMTP id i6IDSuPf020991; Sun, 18 Jul 2004 07:28:56 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Sun, 18 Jul 2004 07:28:56 -0600 (MDT) From: Warren Block To: Marc Fonvieille In-Reply-To: <200407181300.i6ID0QXA032696@freefall.freebsd.org> Message-ID: <20040718071535.V20959@wonkity.com> References: <200407181300.i6ID0QXA032696@freefall.freebsd.org> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-1.5.3 (wonkity.com [127.0.0.1]); Sun, 18 Jul 2004 07:28:56 -0600 (MDT) cc: keramida@ceid.upatras.gr cc: freebsd-doc@freebsd.org Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 13:29:03 -0000 On Sun, 18 Jul 2004, Marc Fonvieille wrote: > On Sun, Jul 18, 2004 at 12:00:52PM +0000, Giorgos Keramidas wrote: > > On 2004-07-17 22:40, Warren Block wrote: > > > --- /usr/doc/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml Sat Jul 17 06:22:19 2004 > > > +++ chapter.sgml Sat Jul 17 22:37:04 2004 > > > @@ -978,11 +978,11 @@ > > > > > > > > > > > > - Transmitted Data (SD) > > > + Transmit Data (TD) > > > > > > > Actually, the LED that shows transmit line activity in my modem is > > labelled "SD". Perhaps, we should change the description text to "Sent > > Data" instead? > > SD is on the modem, the text is talking about a RS232 cable: "A standard > RS-232C serial cable should suffice as long as all of the normal signals > are wired:" > > I'd change SD for TD which is the correct term in our case (or TxD, but > in this case RD must be changed for RxD). TD is the data transmitted by > the DTE (our computer) to the DCE (modem), RD is data to DTE from DCE. > These descriptions come from a time where half duplex was common. > s/Transmitted/Transmit/ etc. is not mandatory, in fact both versions are > used. You're right, but I'd never seen the "Transmitted" form until a web search this morning. > So I'd keep the description but I'd s/SD/TD which is correct. Now that I look at it more, TxD/RxD are used earlier in the chapter, and are the more correct way to go. I think these are probably how they are listed in the EIA spec. As for the description changes, I suggest those changes for consistency with the other pin descriptions. If you have Transmitted Data, you should also have Data Terminal Readied, Carrier Detected, Signal Grounded (okay, maybe not that one 8-). -Warren Block * Rapid City, South Dakota USA From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 14:09:10 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2D51016A4CE; Sun, 18 Jul 2004 14:09:10 +0000 (GMT) Received: from sccrmhc11.comcast.net (sccrmhc11.comcast.net [204.127.202.55]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6F18243D48; Sun, 18 Jul 2004 14:09:09 +0000 (GMT) (envelope-from zettel@acm.org) Received: from [192.168.0.6] (bgp966574bgs.derbrn01.mi.comcast.net[68.41.108.205]) by comcast.net (sccrmhc11) with ESMTP id <2004071814090801100svjhfe>; Sun, 18 Jul 2004 14:09:08 +0000 From: Leonard Zettel To: freebsd-doc@freebsd.org Date: Sun, 18 Jul 2004 10:09:59 -0400 User-Agent: KMail/1.6.2 References: <20040713074042.GA5126@abigail.blackend.org> <20040715083333.GA62713@hub.freebsd.org> <20040718100224.GA84500@abigail.blackend.org> In-Reply-To: <20040718100224.GA84500@abigail.blackend.org> MIME-Version: 1.0 Content-Disposition: inline Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Message-Id: <200407181009.59919.zettel@acm.org> cc: Ceri Davies cc: doc@freebsd.org cc: "Simon L. Nielsen" Subject: Re: Mouseover definitions for acronyms (was Re: RFC: initialisms and FDP) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 14:09:10 -0000 On Sunday 18 July 2004 06:02 am, Marc Fonvieille wrote: > On Thu, Jul 15, 2004 at 08:33:33AM +0000, Murray Stokely wrote: > > Ok this is working now. Thanks to Simon for explaining how to do the > > mouseovers in HTML4. I think that the little dotted underlines will > > get distracting in a chapter filled with acronyms. > > > > For the advanced networking chapter anyway, it might look best if the > > first occurence of an acronym is rendered with a link to the glossary, > > and the first three are rendered with the mouseover. > > > > I'm not really sure, it's largely up to individual sense of > > aesthetic. What do others think? > > [...] > > Well for me "it looks weird", I mean I see too much dotted underlines :) > just look at the 23.4.2 section for example... or some titles. Many > different acronyms in one text could lead to something "difficult" to > read. > I think rendering the first three ones should be enough, if one needs to > know the meaning of NIS, it's at the beginning of the text not at the > end. > In my opinion, the best thing to do with acronyms is minimize their use. Remembering what NIS means puts an extra distracting burden on the reader, especially if they are already struggling to assimilate a lot of new concepts, which is likely the case, or they wouldn't be reading the material in the first place. I am willing to concede that in some cases usage has extended to the point where the acronym *is* the word (ftp comes to mind). Natheless, I think the best policy is to consider an acronym guilty until proven innocent. -LenZ- > Now an "innocent" question: if we use first four acronyms (1 for the > glossary, the rest for the mouseover thing), do we need to tag the > remaining ones (with an entity or tags)? I'm thinking about a > section not a whole chapter. > > Marc > _______________________________________________ > 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" From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 14:09:10 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2D51016A4CE; Sun, 18 Jul 2004 14:09:10 +0000 (GMT) Received: from sccrmhc11.comcast.net (sccrmhc11.comcast.net [204.127.202.55]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6F18243D48; Sun, 18 Jul 2004 14:09:09 +0000 (GMT) (envelope-from zettel@acm.org) Received: from [192.168.0.6] (bgp966574bgs.derbrn01.mi.comcast.net[68.41.108.205]) by comcast.net (sccrmhc11) with ESMTP id <2004071814090801100svjhfe>; Sun, 18 Jul 2004 14:09:08 +0000 From: Leonard Zettel To: freebsd-doc@freebsd.org Date: Sun, 18 Jul 2004 10:09:59 -0400 User-Agent: KMail/1.6.2 References: <20040713074042.GA5126@abigail.blackend.org> <20040715083333.GA62713@hub.freebsd.org> <20040718100224.GA84500@abigail.blackend.org> In-Reply-To: <20040718100224.GA84500@abigail.blackend.org> MIME-Version: 1.0 Content-Disposition: inline Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Message-Id: <200407181009.59919.zettel@acm.org> cc: Ceri Davies cc: doc@freebsd.org cc: "Simon L. Nielsen" Subject: Re: Mouseover definitions for acronyms (was Re: RFC: initialisms and FDP) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 14:09:10 -0000 On Sunday 18 July 2004 06:02 am, Marc Fonvieille wrote: > On Thu, Jul 15, 2004 at 08:33:33AM +0000, Murray Stokely wrote: > > Ok this is working now. Thanks to Simon for explaining how to do the > > mouseovers in HTML4. I think that the little dotted underlines will > > get distracting in a chapter filled with acronyms. > > > > For the advanced networking chapter anyway, it might look best if the > > first occurence of an acronym is rendered with a link to the glossary, > > and the first three are rendered with the mouseover. > > > > I'm not really sure, it's largely up to individual sense of > > aesthetic. What do others think? > > [...] > > Well for me "it looks weird", I mean I see too much dotted underlines :) > just look at the 23.4.2 section for example... or some titles. Many > different acronyms in one text could lead to something "difficult" to > read. > I think rendering the first three ones should be enough, if one needs to > know the meaning of NIS, it's at the beginning of the text not at the > end. > In my opinion, the best thing to do with acronyms is minimize their use. Remembering what NIS means puts an extra distracting burden on the reader, especially if they are already struggling to assimilate a lot of new concepts, which is likely the case, or they wouldn't be reading the material in the first place. I am willing to concede that in some cases usage has extended to the point where the acronym *is* the word (ftp comes to mind). Natheless, I think the best policy is to consider an acronym guilty until proven innocent. -LenZ- > Now an "innocent" question: if we use first four acronyms (1 for the > glossary, the rest for the mouseover thing), do we need to tag the > remaining ones (with an entity or tags)? I'm thinking about a > section not a whole chapter. > > Marc > _______________________________________________ > 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" From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 14:10:12 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 436F616A4CE for ; Sun, 18 Jul 2004 14:10:12 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 234EF43D41 for ; Sun, 18 Jul 2004 14:10:12 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6IEACRJ043227 for ; Sun, 18 Jul 2004 14:10:12 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6IEABVQ043226; Sun, 18 Jul 2004 14:10:12 GMT (envelope-from gnats) Resent-Date: Sun, 18 Jul 2004 14:10:12 GMT Resent-Message-Id: <200407181410.i6IEABVQ043226@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, Remko Lodder Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id CBC4716A4CE for ; Sun, 18 Jul 2004 14:03:27 +0000 (GMT) Received: from www.freebsd.org (www.freebsd.org [216.136.204.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id C845E43D46 for ; Sun, 18 Jul 2004 14:03:27 +0000 (GMT) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.12.11/8.12.11) with ESMTP id i6IE3RuK050377 for ; Sun, 18 Jul 2004 14:03:27 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.12.11/8.12.11/Submit) id i6IE3RLS050376; Sun, 18 Jul 2004 14:03:27 GMT (envelope-from nobody) Message-Id: <200407181403.i6IE3RLS050376@www.freebsd.org> Date: Sun, 18 Jul 2004 14:03:27 GMT From: Remko Lodder To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-2.3 Subject: docs/69240: cleanup of the x11 chapter from the handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 14:10:12 -0000 >Number: 69240 >Category: docs >Synopsis: cleanup of the x11 chapter from the handbook >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Jul 18 14:10:11 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Remko Lodder >Release: 5.2.1-p9 >Organization: >Environment: FreeBSD dartagnan.thethreemusketiers.nl 5.2.1-RELEASE-p9 FreeBSD 5.2.1-RELEASE-p9 #0: Sun Jul 4 21:00:38 CEST 2004 root@dartagnan.thethreemusketiers.nl:/usr/obj/usr/src/sys/DARTAGNAN i386 >Description: While reviewing the FreeBSD Dutch Documentation Project files i came across some 'faults' that i think need to be corrected. I changed some XFree86 references to &xfree86; as used througout the text. I also changed kdm to KDM since that was also used. Besides that i did the same to XDM (xdm to XDM). And there were references to xdm. I changed that to XDM. >How-To-Repeat: Just look at the documentation and/or the patch >Fix: checkout http://www.evilcoder.org/freebsd/patches/x11.diff for a patch that should correct the above problem. >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 14:40:21 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E657916A4CE for ; Sun, 18 Jul 2004 14:40:21 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id DDBDA43D48 for ; Sun, 18 Jul 2004 14:40:21 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6IEeLT0045073 for ; Sun, 18 Jul 2004 14:40:21 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6IEeLEK045072; Sun, 18 Jul 2004 14:40:21 GMT (envelope-from gnats) Resent-Date: Sun, 18 Jul 2004 14:40:21 GMT Resent-Message-Id: <200407181440.i6IEeLEK045072@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, Joel Dahl Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 06D3916A4CE for ; Sun, 18 Jul 2004 14:36:42 +0000 (GMT) Received: from www.freebsd.org (www.freebsd.org [216.136.204.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id DF0D143D46 for ; Sun, 18 Jul 2004 14:36:41 +0000 (GMT) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.12.11/8.12.11) with ESMTP id i6IEaf1D067120 for ; Sun, 18 Jul 2004 14:36:41 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.12.11/8.12.11/Submit) id i6IEafCh067119; Sun, 18 Jul 2004 14:36:41 GMT (envelope-from nobody) Message-Id: <200407181436.i6IEafCh067119@www.freebsd.org> Date: Sun, 18 Jul 2004 14:36:41 GMT From: Joel Dahl To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-2.3 Subject: docs/69241: [PATCH] Adds text about firefox that was missing in my latest patch X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 14:40:22 -0000 >Number: 69241 >Category: docs >Synopsis: [PATCH] Adds text about firefox that was missing in my latest patch >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Jul 18 14:40:21 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Joel Dahl >Release: 5.2.1 >Organization: n/a >Environment: FreeBSD dude.automatvapen.se 5.2.1-RELEASE-p9 FreeBSD 5.2.1-RELEASE-p9 #1: Sat Jul 10 16:52:28 CEST 2004 root@dude.automatvapen.se:/usr/obj/usr/src/sys/WORKSTATION i386 >Description: I missed one section in my latest patch. Sorry. :) >How-To-Repeat: n/a >Fix: http://www.automatvapen.se/freebsd/patches/doc_firefox2.diff >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 14:49:41 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 045E916A4CE; Sun, 18 Jul 2004 14:49:41 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id DC1A943D2D; Sun, 18 Jul 2004 14:49:40 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i6IEneNb045386; Sun, 18 Jul 2004 14:49:40 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6IEneIY045382; Sun, 18 Jul 2004 14:49:40 GMT (envelope-from keramida) Date: Sun, 18 Jul 2004 14:49:40 GMT From: Giorgos Keramidas Message-Id: <200407181449.i6IEneIY045382@freefall.freebsd.org> To: remko@elvandar.org, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/69240: cleanup of the x11 chapter from the handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 14:49:41 -0000 Synopsis: cleanup of the x11 chapter from the handbook State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Sun Jul 18 14:49:09 GMT 2004 State-Changed-Why: Committed, thanks! The changes should become visible online in a few hours. Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Sun Jul 18 14:49:09 GMT 2004 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=69240 From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 14:53:32 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4701E16A4CE; Sun, 18 Jul 2004 14:53:32 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2C63043D2D; Sun, 18 Jul 2004 14:53:32 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i6IErWvJ045707; Sun, 18 Jul 2004 14:53:32 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6IErWaV045703; Sun, 18 Jul 2004 14:53:32 GMT (envelope-from keramida) Date: Sun, 18 Jul 2004 14:53:32 GMT From: Giorgos Keramidas Message-Id: <200407181453.i6IErWaV045703@freefall.freebsd.org> To: joel@automatvapen.se, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/69241: [PATCH] Adds text about firefox that was missing in my latest patch X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 14:53:32 -0000 Synopsis: [PATCH] Adds text about firefox that was missing in my latest patch State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Sun Jul 18 14:52:34 GMT 2004 State-Changed-Why: Cool, thanks! I've just committed the diff you sent. The changes will, as usual, appear online after the next scheduled web build, in a few hours. Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Sun Jul 18 14:52:34 GMT 2004 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=69241 From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 14:58:50 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 383C616A4CE for ; Sun, 18 Jul 2004 14:58:50 +0000 (GMT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5CE2543D46 for ; Sun, 18 Jul 2004 14:58:49 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) i6IEwj7R088354; Sun, 18 Jul 2004 16:58:45 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.11/8.12.11/Submit) id i6IEwiW2088353; Sun, 18 Jul 2004 16:58:44 +0200 (CEST) (envelope-from marc) Date: Sun, 18 Jul 2004 16:58:44 +0200 From: Marc Fonvieille To: Warren Block Message-ID: <20040718145844.GE84500@abigail.blackend.org> References: <200407181300.i6ID0QXA032696@freefall.freebsd.org> <20040718071535.V20959@wonkity.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040718071535.V20959@wonkity.com> User-Agent: Mutt/1.4.2.1i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.10-PRERELEASE cc: keramida@ceid.upatras.gr cc: freebsd-doc@freebsd.org Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 14:58:50 -0000 On Sun, Jul 18, 2004 at 07:28:56AM -0600, Warren Block wrote: > > > >I'd change SD for TD which is the correct term in our case (or TxD, but > >in this case RD must be changed for RxD). TD is the data transmitted by > >the DTE (our computer) to the DCE (modem), RD is data to DTE from DCE. > >These descriptions come from a time where half duplex was common. > >s/Transmitted/Transmit/ etc. is not mandatory, in fact both versions are > >used. > > You're right, but I'd never seen the "Transmitted" form until a web > search this morning. > I just read ITU-T V.24 recommendation (which is identical to RS232 for signal description and names), they use Transmitted and Received data. > >So I'd keep the description but I'd s/SD/TD which is correct. > > Now that I look at it more, TxD/RxD are used earlier in the chapter, and > are the more correct way to go. I think these are probably how they are > listed in the EIA spec. > [...] I don't know for TxD/RxD, I don't have access to any recommendation stating it's TxD not TD. Marc From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 15:15:08 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 96DB516A4CF; Sun, 18 Jul 2004 15:15:08 +0000 (GMT) Received: from wonkity.com (wonkity.com [65.173.111.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 41B1F43D31; Sun, 18 Jul 2004 15:15:08 +0000 (GMT) (envelope-from wblock@wonkity.com) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.12.11/8.12.11) with ESMTP id i6IFF29E021210; Sun, 18 Jul 2004 09:15:02 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.12.11/8.12.11/Submit) with ESMTP id i6IFEwAQ021204; Sun, 18 Jul 2004 09:14:58 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Sun, 18 Jul 2004 09:14:58 -0600 (MDT) From: Warren Block To: Leonard Zettel In-Reply-To: <200407181009.59919.zettel@acm.org> Message-ID: <20040718090746.D21197@wonkity.com> References: <20040713074042.GA5126@abigail.blackend.org> <20040718100224.GA84500@abigail.blackend.org> <200407181009.59919.zettel@acm.org> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-1.5.3 (wonkity.com [127.0.0.1]); Sun, 18 Jul 2004 09:15:02 -0600 (MDT) cc: freebsd-doc@freebsd.org cc: doc@freebsd.org cc: Ceri Davies cc: "Simon L. Nielsen" Subject: Re: Mouseover definitions for acronyms (was Re: RFC: initialisms and FDP) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 15:15:08 -0000 On Sun, 18 Jul 2004, Leonard Zettel wrote: > In my opinion, the best thing to do with acronyms is minimize their use. > Remembering what NIS means puts an extra distracting burden on > the reader, especially if they are already struggling to assimilate a > lot of new concepts, which is likely the case, or they wouldn't > be reading the material in the first place. Acronyms and other forms of jargon have a purpose; for instance, an acronym is one "thing" to remember, rather than a phrase. > I am willing to concede that in some cases usage has extended to > the point where the acronym *is* the word (ftp comes to mind). Many of the acronyms for the glossary are like that. While I like the mouseover idea, I don't understand the need for multiple ones. Why not just have the first occurrence of a term be both a link to the glossary and also have the mouseover definition? (I say this having learned the hard way with tags. More than one is visually distracting.) -Warren Block * Rapid City, South Dakota USA From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 15:15:08 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 96DB516A4CF; Sun, 18 Jul 2004 15:15:08 +0000 (GMT) Received: from wonkity.com (wonkity.com [65.173.111.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 41B1F43D31; Sun, 18 Jul 2004 15:15:08 +0000 (GMT) (envelope-from wblock@wonkity.com) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.12.11/8.12.11) with ESMTP id i6IFF29E021210; Sun, 18 Jul 2004 09:15:02 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.12.11/8.12.11/Submit) with ESMTP id i6IFEwAQ021204; Sun, 18 Jul 2004 09:14:58 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Sun, 18 Jul 2004 09:14:58 -0600 (MDT) From: Warren Block To: Leonard Zettel In-Reply-To: <200407181009.59919.zettel@acm.org> Message-ID: <20040718090746.D21197@wonkity.com> References: <20040713074042.GA5126@abigail.blackend.org> <20040718100224.GA84500@abigail.blackend.org> <200407181009.59919.zettel@acm.org> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-1.5.3 (wonkity.com [127.0.0.1]); Sun, 18 Jul 2004 09:15:02 -0600 (MDT) cc: freebsd-doc@freebsd.org cc: doc@freebsd.org cc: Ceri Davies cc: "Simon L. Nielsen" Subject: Re: Mouseover definitions for acronyms (was Re: RFC: initialisms and FDP) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 15:15:08 -0000 On Sun, 18 Jul 2004, Leonard Zettel wrote: > In my opinion, the best thing to do with acronyms is minimize their use. > Remembering what NIS means puts an extra distracting burden on > the reader, especially if they are already struggling to assimilate a > lot of new concepts, which is likely the case, or they wouldn't > be reading the material in the first place. Acronyms and other forms of jargon have a purpose; for instance, an acronym is one "thing" to remember, rather than a phrase. > I am willing to concede that in some cases usage has extended to > the point where the acronym *is* the word (ftp comes to mind). Many of the acronyms for the glossary are like that. While I like the mouseover idea, I don't understand the need for multiple ones. Why not just have the first occurrence of a term be both a link to the glossary and also have the mouseover definition? (I say this having learned the hard way with tags. More than one is visually distracting.) -Warren Block * Rapid City, South Dakota USA From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 19:35:46 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 640E716A4CE for ; Sun, 18 Jul 2004 19:35:46 +0000 (GMT) Received: from av5-1-sn3.vrr.skanova.net (av5-1-sn3.vrr.skanova.net [81.228.9.113]) by mx1.FreeBSD.org (Postfix) with ESMTP id C0CCC43D31 for ; Sun, 18 Jul 2004 19:35:43 +0000 (GMT) (envelope-from joel@automatvapen.se) Received: by av5-1-sn3.vrr.skanova.net (Postfix, from userid 502) id EE0F037E99; Sun, 18 Jul 2004 21:35:42 +0200 (CEST) Received: from smtp4-1-sn2.hy.skanova.net (smtp4-1-sn2.hy.skanova.net [81.228.8.92]) by av5-1-sn3.vrr.skanova.net (Postfix) with ESMTP id DBCB737E63 for ; Sun, 18 Jul 2004 21:35:42 +0200 (CEST) Received: from [62.20.170.145] (t2o55p25.telia.com [62.20.170.145]) by smtp4-1-sn2.hy.skanova.net (Postfix) with ESMTP id C76AE37E48 for ; Sun, 18 Jul 2004 21:35:41 +0200 (CEST) From: Joel Dahl To: freebsd-doc@freebsd.org Content-Type: text/plain Message-Id: <1090179366.627.2.camel@dude.automatvapen.se> Mime-Version: 1.0 X-Mailer: Ximian Evolution 1.4.6 Date: Sun, 18 Jul 2004 21:36:06 +0200 Content-Transfer-Encoding: 7bit Subject: Add text about Dragonfly to explaining-bsd-article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 19:35:46 -0000 Dragonfly has recently reached 1.0, and is seriously entering the scene. /usr/share/doc/en_US.ISO8859-1/articles/explaining-bsd/article.html covers FreeBSD, NetBSD, OpenBSD, BSD/OS and Mac OS X very briefly, how about adding some information about Dragonfly to it? I could easily write something for someone to review. Any objections? :) From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 21:30:19 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id ACEC016A4CE for ; Sun, 18 Jul 2004 21:30:19 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8952643D45 for ; Sun, 18 Jul 2004 21:30:19 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6ILUJp6005096 for ; Sun, 18 Jul 2004 21:30:19 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6ILUJN9005094; Sun, 18 Jul 2004 21:30:19 GMT (envelope-from gnats) Resent-Date: Sun, 18 Jul 2004 21:30:19 GMT Resent-Message-Id: <200407182130.i6ILUJN9005094@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, Brad Davis Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 815AC16A4CE for ; Sun, 18 Jul 2004 21:28:41 +0000 (GMT) Received: from valentine.liquidneon.com (valentine.liquidneon.com [216.38.206.180]) by mx1.FreeBSD.org (Postfix) with ESMTP id 37D7243D48 for ; Sun, 18 Jul 2004 21:28:41 +0000 (GMT) (envelope-from bdavis@house.so14k.com) Received: from localhost (localhost [127.0.0.1]) by valentine.liquidneon.com (Postfix) with ESMTP id 6816C8D0 for ; Sun, 18 Jul 2004 15:28:40 -0600 (MDT) Received: from valentine.liquidneon.com ([216.38.206.180]) by localhost (valentine.liquidneon.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 25071-02 for ; Sun, 18 Jul 2004 15:28:40 -0600 (MDT) Received: from mccaffrey.house.so14k.com (c-24-8-51-173.client.comcast.net [24.8.51.173]) by valentine.liquidneon.com (Postfix) with ESMTP id 1B93C5BD for ; Sun, 18 Jul 2004 15:28:40 -0600 (MDT) Received: by mccaffrey.house.so14k.com (Postfix, from userid 1001) id 503A96EA; Sun, 18 Jul 2004 15:28:39 -0600 (MDT) Message-Id: <20040718212839.503A96EA@mccaffrey.house.so14k.com> Date: Sun, 18 Jul 2004 15:28:39 -0600 (MDT) From: Brad Davis To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69249: [patch] Update Opera listing, to reflect the native version. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Brad Davis List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 21:30:19 -0000 >Number: 69249 >Category: docs >Synopsis: [patch] Update Opera listing, to reflect the native version. >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Jul 18 21:30:18 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Brad Davis >Release: FreeBSD 4.10-STABLE i386 >Organization: >Environment: System: FreeBSD mccaffrey.house.so14k.com 4.10-STABLE FreeBSD 4.10-STABLE #0: Fri May 28 08:02:41 MDT 2004 root@mccaffrey.house.so14k.com:/usr/obj/usr/src/sys/MCCAFFREY i386 >Description: Update the Opera listing to reflect that we now have a native FreeBSD version. >How-To-Repeat: >Fix: Apply the following patch --- doc-ori/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml Sun Jul 18 08:52:18 2004 +++ doc/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml Sun Jul 18 15:25:48 2004 @@ -151,7 +151,7 @@ Opera light light - FreeBSD version: None. Linux version: Linux Binary Compatibility and + FreeBSD and Linux version avaliable. The Linux version depends on: linux-openmotif >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 21:42:40 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4468416A4CE for ; Sun, 18 Jul 2004 21:42:40 +0000 (GMT) Received: from frodo.otenet.gr (frodo.otenet.gr [195.170.0.12]) by mx1.FreeBSD.org (Postfix) with ESMTP id 698DB43D49 for ; Sun, 18 Jul 2004 21:42:39 +0000 (GMT) (envelope-from keramida@freebsd.org) Received: from gothmog.gr (patr530-b181.otenet.gr [212.205.244.189]) by frodo.otenet.gr (8.12.10/8.12.10) with ESMTP id i6ILgX3E022607; Mon, 19 Jul 2004 00:42:34 +0300 Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.12.11/8.12.11) with ESMTP id i6ILgWWI000894; Mon, 19 Jul 2004 00:42:32 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from giorgos@localhost) by gothmog.gr (8.12.11/8.12.11/Submit) id i6ILgWHm000893; Mon, 19 Jul 2004 00:42:32 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Mon, 19 Jul 2004 00:42:32 +0300 From: Giorgos Keramidas To: Joel Dahl Message-ID: <20040718214232.GA801@gothmog.gr> References: <1090179366.627.2.camel@dude.automatvapen.se> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1090179366.627.2.camel@dude.automatvapen.se> cc: freebsd-doc@freebsd.org Subject: Re: Add text about Dragonfly to explaining-bsd-article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 21:42:40 -0000 On 2004-07-18 21:36, Joel Dahl wrote: > Dragonfly has recently reached 1.0, and is seriously entering the scene. > /usr/share/doc/en_US.ISO8859-1/articles/explaining-bsd/article.html > covers FreeBSD, NetBSD, OpenBSD, BSD/OS and Mac OS X very briefly, how > about adding some information about Dragonfly to it? I could easily > write something for someone to review. Any objections? :) I think I can do that. Mail us your suggestion to this list and I'm sure if I don't have the time to review your text when you post it someone else will do. Giorgos From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 21:46:24 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 74B0216A4CE; Sun, 18 Jul 2004 21:46:24 +0000 (GMT) Received: from zaphod.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id DC37643D67; Sun, 18 Jul 2004 21:46:23 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id 8BF4A119E6; Sun, 18 Jul 2004 23:46:21 +0200 (CEST) Date: Sun, 18 Jul 2004 23:46:21 +0200 From: "Simon L. Nielsen" To: Marc Fonvieille Message-ID: <20040718214620.GA741@zaphod.nitro.dk> References: <20040713074042.GA5126@abigail.blackend.org> <20040713170624.GU29928@submonkey.net> <20040713181500.GA10935@abigail.blackend.org> <20040715071709.GB55440@hub.freebsd.org> <20040715073027.GA725@zaphod.nitro.dk> <20040715083333.GA62713@hub.freebsd.org> <20040718100224.GA84500@abigail.blackend.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="PNTmBPCT7hxwcZjr" Content-Disposition: inline In-Reply-To: <20040718100224.GA84500@abigail.blackend.org> User-Agent: Mutt/1.5.6i cc: Ceri Davies cc: Murray Stokely cc: doc@FreeBSD.org Subject: Re: Mouseover definitions for acronyms (was Re: RFC: initialisms and FDP) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 21:46:24 -0000 --PNTmBPCT7hxwcZjr Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.07.18 12:02:25 +0200, Marc Fonvieille wrote: > On Thu, Jul 15, 2004 at 08:33:33AM +0000, Murray Stokely wrote: > > Ok this is working now. Thanks to Simon for explaining how to do the > > mouseovers in HTML4. I think that the little dotted underlines will > > get distracting in a chapter filled with acronyms. > >=20 > > For the advanced networking chapter anyway, it might look best if the > > first occurence of an acronym is rendered with a link to the glossary, > > and the first three are rendered with the mouseover. > >=20 > > I'm not really sure, it's largely up to individual sense of > > aesthetic. What do others think? > >=20 > [...] >=20 > Well for me "it looks weird", I mean I see too much dotted underlines :) Yes, I think the dotted lines should just be removed from the output with the CSS stylesheet. For our use, I just find it distracting. > just look at the 23.4.2 section for example... or some titles. Many > different acronyms in one text could lead to something "difficult" to > read. > I think rendering the first three ones should be enough, if one needs to > know the meaning of NIS, it's at the beginning of the text not at the > end. > > Now an "innocent" question: if we use first four acronyms (1 for the > glossary, the rest for the mouseover thing), do we need to tag the > remaining ones (with an entity or tags)? I'm thinking about a > section not a whole chapter. How about this: The first instance is expanded to (random example) "FTP (File Transfer Protocol)" where some part is a link to the glossary, if there is an entry. All other instances a marked up using the HTML tag with a title attribute, but we don't show underlines. Then it's not distracting, and if the reader moves the mouse over the word it's expandend. Doing something special for the first three seems a bit odd to me. How many tags we mark up with DocBook is then another matter... I think that would should mark up the first couple (at least) so you will get the expansion and mouseover on some. With the redering I described before I think it would be prefered if all instances were marked up, but I don't think it's worth the CVS/SGML bloat. BTW, I actually have the DSSSL code to do most of what I describe above - I'm just working on code to link to the Glossary.. It's a bit more tricky since I have to check if a acronym is described in the Glossary first... --=20 Simon L. Nielsen FreeBSD Documentation Team --PNTmBPCT7hxwcZjr Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA+u+sh9pcDSc1mlERAv2QAKCYrwSvaoerQVvizQ5mk8PX2OIm2QCgtKD5 5rI/hFuuANi8sUADaRXcZXM= =CGV8 -----END PGP SIGNATURE----- --PNTmBPCT7hxwcZjr-- From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 22:00:48 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C8DD716A4D0 for ; Sun, 18 Jul 2004 22:00:48 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id A946743D3F for ; Sun, 18 Jul 2004 22:00:48 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6IM0mSf007834 for ; Sun, 18 Jul 2004 22:00:48 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6IM0mKp007833; Sun, 18 Jul 2004 22:00:48 GMT (envelope-from gnats) Resent-Date: Sun, 18 Jul 2004 22:00:48 GMT Resent-Message-Id: <200407182200.i6IM0mKp007833@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, Brad Davis Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7F52A16A4CE for ; Sun, 18 Jul 2004 21:51:14 +0000 (GMT) Received: from valentine.liquidneon.com (valentine.liquidneon.com [216.38.206.180]) by mx1.FreeBSD.org (Postfix) with ESMTP id 60F9143D41 for ; Sun, 18 Jul 2004 21:51:14 +0000 (GMT) (envelope-from bdavis@house.so14k.com) Received: from localhost (localhost [127.0.0.1]) by valentine.liquidneon.com (Postfix) with ESMTP id 037278DE for ; Sun, 18 Jul 2004 15:51:14 -0600 (MDT) Received: from valentine.liquidneon.com ([216.38.206.180]) by localhost (valentine.liquidneon.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 25184-05 for ; Sun, 18 Jul 2004 15:51:13 -0600 (MDT) Received: from mccaffrey.house.so14k.com (c-24-8-51-173.client.comcast.net [24.8.51.173]) by valentine.liquidneon.com (Postfix) with ESMTP id 978975BD for ; Sun, 18 Jul 2004 15:51:13 -0600 (MDT) Received: by mccaffrey.house.so14k.com (Postfix, from userid 1001) id 5DA8A65B; Sun, 18 Jul 2004 15:51:13 -0600 (MDT) Message-Id: <20040718215113.5DA8A65B@mccaffrey.house.so14k.com> Date: Sun, 18 Jul 2004 15:51:13 -0600 (MDT) From: Brad Davis To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69250: [patch] s/firebird/firefox/ X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Brad Davis List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 22:00:49 -0000 >Number: 69250 >Category: docs >Synopsis: [patch] s/firebird/firefox/ >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Jul 18 22:00:48 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Brad Davis >Release: FreeBSD 4.10-STABLE i386 >Organization: >Environment: System: FreeBSD mccaffrey.house.so14k.com 4.10-STABLE FreeBSD 4.10-STABLE #0: Fri May 28 08:02:41 MDT 2004 root@mccaffrey.house.so14k.com:/usr/obj/usr/src/sys/MCCAFFREY i386 >Description: Remove the references to Firebird in fbsd-from-scratch >How-To-Repeat: >Fix: Apply the following patch: --- doc-ori/en_US.ISO8859-1/articles/fbsd-from-scratch/stage_2.conf.default Wed Jan 21 12:39:26 2004 +++ doc/en_US.ISO8859-1/articles/fbsd-from-scratch/stage_2.conf.default Sun Jul 18 15:41:29 2004 @@ -34,7 +34,7 @@ www apache2 www weblint www amaya -www mozilla-firebird +www firefox www mozilla make WITHOUT_MAILNEWS=yes WITHOUT_COMPOSER=yes WITHOUT_LDAP=yes WITHOUT_CHATZILLA=yes WITHOUT_XMLTERM=yes install www checkbot www privoxy --- doc-ori/en_US.ISO8859-1/articles/fbsd-from-scratch/stage_3.mk Wed Jan 21 12:39:26 2004 +++ doc/en_US.ISO8859-1/articles/fbsd-from-scratch/stage_3.mk Sun Jul 18 15:44:05 2004 @@ -15,7 +15,7 @@ message: @echo "Please use one of the following targets:" @echo "config_apache" - @echo "config_firebird" + @echo "config_firefox" @echo "config_inn" @echo "config_javaplugin" @echo "config_nullplugin" @@ -31,7 +31,7 @@ all: \ config_apache \ - config_firebird \ + config_firefox \ config_inn \ config_javaplugin \ config_nullplugin \ @@ -68,9 +68,9 @@ /usr/local/etc/rc.d/apache2.sh start; \ fi -config_firebird: +config_firefox: # Make this group wheel writable to allow extensions being installed. - chmod -R g+w /usr/X11R6/lib/firebird/lib/mozilla-1.5/chrome + chmod -R g+w /usr/X11R6/lib/firefox/lib/mozilla-1.5/chrome config_inn: pw usermod -n news -d /usr/local/news -s /bin/sh @@ -150,8 +150,8 @@ fi config_javaplugin: - # Mozilla Firebird: - cd /usr/X11R6/lib/firebird/lib/mozilla-1.5/plugins; \ + # Mozilla Firefox: + cd /usr/X11R6/lib/firefox/lib/mozilla-1.5/plugins; \ ln -fs /usr/local/jdk1.4.2/jre/plugin/i386/ns610/libjavaplugin_oji.so # Plain Mozilla: cd /usr/X11R6/lib/mozilla/plugins; \ >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 22:05:36 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B219916A4CE; Sun, 18 Jul 2004 22:05:36 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 69B7243D46; Sun, 18 Jul 2004 22:05:36 +0000 (GMT) (envelope-from simon@FreeBSD.org) Received: from freefall.freebsd.org (simon@localhost [127.0.0.1]) i6IM5aEF011773; Sun, 18 Jul 2004 22:05:36 GMT (envelope-from simon@freefall.freebsd.org) Received: (from simon@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6IM5a2l011769; Sun, 18 Jul 2004 22:05:36 GMT (envelope-from simon) Date: Sun, 18 Jul 2004 22:05:36 GMT From: "Simon L. Nielsen" Message-Id: <200407182205.i6IM5a2l011769@freefall.freebsd.org> To: simon@FreeBSD.org, freebsd-doc@FreeBSD.org, schweikh@FreeBSD.org Subject: Re: docs/69250: [patch] s/firebird/firefox/ X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 22:05:36 -0000 Synopsis: [patch] s/firebird/firefox/ Responsible-Changed-From-To: freebsd-doc->schweikh Responsible-Changed-By: simon Responsible-Changed-When: Sun Jul 18 22:04:53 GMT 2004 Responsible-Changed-Why: Over to article author. http://www.freebsd.org/cgi/query-pr.cgi?pr=69250 From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 22:30:21 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A693D16A4CE for ; Sun, 18 Jul 2004 22:30:21 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9821143D31 for ; Sun, 18 Jul 2004 22:30:21 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6IMULRE013222 for ; Sun, 18 Jul 2004 22:30:21 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6IMULOK013221; Sun, 18 Jul 2004 22:30:21 GMT (envelope-from gnats) Resent-Date: Sun, 18 Jul 2004 22:30:21 GMT Resent-Message-Id: <200407182230.i6IMULOK013221@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, Brad Davis Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3C43716A4CE for ; Sun, 18 Jul 2004 22:20:45 +0000 (GMT) Received: from valentine.liquidneon.com (valentine.liquidneon.com [216.38.206.180]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1DBEA43D46 for ; Sun, 18 Jul 2004 22:20:45 +0000 (GMT) (envelope-from bdavis@house.so14k.com) Received: from localhost (localhost [127.0.0.1]) by valentine.liquidneon.com (Postfix) with ESMTP id 94A358DE for ; Sun, 18 Jul 2004 16:20:44 -0600 (MDT) Received: from valentine.liquidneon.com ([216.38.206.180]) by localhost (valentine.liquidneon.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 25184-08 for ; Sun, 18 Jul 2004 16:20:44 -0600 (MDT) Received: from mccaffrey.house.so14k.com (c-24-8-51-173.client.comcast.net [24.8.51.173]) by valentine.liquidneon.com (Postfix) with ESMTP id 429DA5BD for ; Sun, 18 Jul 2004 16:20:44 -0600 (MDT) Received: by mccaffrey.house.so14k.com (Postfix, from userid 1001) id DFCED65B; Sun, 18 Jul 2004 16:20:43 -0600 (MDT) Message-Id: <20040718222043.DFCED65B@mccaffrey.house.so14k.com> Date: Sun, 18 Jul 2004 16:20:43 -0600 (MDT) From: Brad Davis To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69252: [patch] Add entry about Konq to the list of browsers X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Brad Davis List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 22:30:21 -0000 >Number: 69252 >Category: docs >Synopsis: [patch] Add entry about Konq to the list of browsers >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Jul 18 22:30:21 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Brad Davis >Release: FreeBSD 4.10-STABLE i386 >Organization: >Environment: System: FreeBSD mccaffrey.house.so14k.com 4.10-STABLE FreeBSD 4.10-STABLE #0: Fri May 28 08:02:41 MDT 2004 root@mccaffrey.house.so14k.com:/usr/obj/usr/src/sys/MCCAFFREY i386 >Description: Add entry about Konq to the list of browsers. >How-To-Repeat: >Fix: Apply the following patch --- doc-ori/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml Sun Jul 18 08:52:18 2004 +++ doc/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml Sun Jul 18 16:16:37 2004 @@ -394,6 +394,24 @@ &prompt.root; cd /usr/ports/www/firefox &prompt.root; make install clean + + Konqueror + + Konqueror + + + Konqueror is part of KDE but it can + also be used outside of KDE by installing + x11/kdebase3. + Konqueror is much more than a browser, + it is also a File Manager and a Universal Viewer. + + Konqueror also comes with a set of plugins, + avaliable in misc/konq-plugins. + + Konqueror also supports Flash and a How To + is avaliable at . + >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 22:38:39 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id AC76A16A4CE for ; Sun, 18 Jul 2004 22:38:39 +0000 (GMT) Received: from wonkity.com (wonkity.com [65.173.111.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5425243D4C for ; Sun, 18 Jul 2004 22:38:39 +0000 (GMT) (envelope-from wblock@wonkity.com) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.12.11/8.12.11) with ESMTP id i6IMccrq022022 for ; Sun, 18 Jul 2004 16:38:38 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.12.11/8.12.11/Submit) with ESMTP id i6IMcc85022019 for ; Sun, 18 Jul 2004 16:38:38 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Sun, 18 Jul 2004 16:38:38 -0600 (MDT) From: Warren Block To: doc@freebsd.org Message-ID: <20040718160745.B21967@wonkity.com> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-1.5.3 (wonkity.com [127.0.0.1]); Sun, 18 Jul 2004 16:38:38 -0600 (MDT) Subject: Glossary Build X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 22:38:39 -0000 I've got a first pass at a what I think Simon was suggesting, a program that builds a custom glossary containing only the terms found in a given directory. glossbuild is a Perl program that scans through SGML files looking for acronym tags. When found, it checks the "global" glossary. If there's a glossentry for the term, it's printed to stdout, as are glossdiv tags. If /usr/doc/en*/share/sgml/glossary/freebsd-glossary.sgml is the "global" glossary, ulinks in the resultant custom glossary will be broken. There are bound to be other issues. Is building a customized glossary for the Handbook in the Handbook directory the way to proceed, or is there a better way? -Warren Block * Rapid City, South Dakota USA From owner-freebsd-doc@FreeBSD.ORG Sun Jul 18 22:50:27 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id DFC2116A4E7 for ; Sun, 18 Jul 2004 22:50:27 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 855C043D90 for ; Sun, 18 Jul 2004 22:50:24 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6IMoOgh014992 for ; Sun, 18 Jul 2004 22:50:24 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6IMoOVq014991; Sun, 18 Jul 2004 22:50:24 GMT (envelope-from gnats) Date: Sun, 18 Jul 2004 22:50:24 GMT Message-Id: <200407182250.i6IMoOVq014991@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Ceri Davies Subject: Re: docs/69252: [patch] Add entry about Konq to the list of browsers X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Ceri Davies List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 22:50:28 -0000 The following reply was made to PR docs/69252; it has been noted by GNATS. From: Ceri Davies To: Brad Davis Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/69252: [patch] Add entry about Konq to the list of browsers Date: Sun, 18 Jul 2004 23:46:33 +0100 On Sun, Jul 18, 2004 at 04:20:43PM -0600, Brad Davis wrote: > > --- doc-ori/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml Sun Jul 18 08:52:18 2004 > +++ doc/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml Sun Jul 18 16:16:37 2004 > @@ -394,6 +394,24 @@ > &prompt.root; cd /usr/ports/www/firefox > &prompt.root; make install clean > > + > + Konqueror > + > + Konqueror > + > + > + Konqueror is part of KDE but it can > + also be used outside of KDE by installing > + x11/kdebase3. > + Konqueror is much more than a browser, > + it is also a File Manager and a Universal Viewer. > + > + Konqueror also comes with a set of plugins, > + avaliable in misc/konq-plugins. > + > + Konqueror also supports Flash and a How To > + is avaliable at . > + > %s/avaliable/available/g Ceri -- It is not tinfoil, it is my new skin. I am a robot. From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 00:30:27 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id F3F6D16A4D2 for ; Mon, 19 Jul 2004 00:30:26 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id B532F43D1D for ; Mon, 19 Jul 2004 00:30:18 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6J0UII1027552 for ; Mon, 19 Jul 2004 00:30:18 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6J0UIxd027551; Mon, 19 Jul 2004 00:30:18 GMT (envelope-from gnats) Date: Mon, 19 Jul 2004 00:30:18 GMT Message-Id: <200407190030.i6J0UIxd027551@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Christian Brueffer Subject: Re: docs/69249: [patch] Update Opera listing, to reflect the native version. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Christian Brueffer List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 00:30:27 -0000 The following reply was made to PR docs/69249; it has been noted by GNATS. From: Christian Brueffer To: Brad Davis Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/69249: [patch] Update Opera listing, to reflect the native version. Date: Mon, 19 Jul 2004 02:21:57 +0200 --hQiwHBbRI9kgIhsi Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable >=20 > --- doc-ori/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml Sun Jul 1= 8 08:52:18 2004 > +++ doc/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml Sun Jul 1= 8 15:25:48 2004 > @@ -151,7 +151,7 @@ > Opera > light > light > - FreeBSD version: None. Linux version: Linux Binary= Compatibility and > + FreeBSD and Linux version avaliable. The Linux versio= n depends on: > linux-openmotif > This removes the mentioning of linux binary compatibility, which is a pretty heavy dependency. How about the following patch? Index: chapter.sgml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /data/ncvs/freebsd/doc/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml,v retrieving revision 1.31 diff -u -r1.31 chapter.sgml --- chapter.sgml 7 Jan 2004 17:10:05 -0000 1.31 +++ chapter.sgml 19 Jul 2004 00:10:08 -0000 @@ -150,8 +150,9 @@ Opera light light - FreeBSD version: None. Linux version: Linux Binary Compatibility and - linux-openmotif + FreeBSD and Linux versions available. The Linux + version depends on Linux Binary Compatibility and + linux-openmotif. - Christian --=20 Christian Brueffer chris@unixpages.org brueffer@FreeBSD.org GPG Key: http://people.freebsd.org/~brueffer/brueffer.key.asc GPG Fingerprint: A5C8 2099 19FF AACA F41B B29B 6C76 178C A0ED 982D --hQiwHBbRI9kgIhsi Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA+xQlbHYXjKDtmC0RAkzcAJ0Z6a1aaU+mcWnu92kfQ7AFGJUB+ACghn0N soLvqb/snxhkhGn0nh95w/0= =Ekzv -----END PGP SIGNATURE----- --hQiwHBbRI9kgIhsi-- From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 00:40:20 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E06FB16A4CE for ; Mon, 19 Jul 2004 00:40:20 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id BD6F743D46 for ; Mon, 19 Jul 2004 00:40:20 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6J0eKwC029062 for ; Mon, 19 Jul 2004 00:40:20 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6J0eKgM029061; Mon, 19 Jul 2004 00:40:20 GMT (envelope-from gnats) Date: Mon, 19 Jul 2004 00:40:20 GMT Message-Id: <200407190040.i6J0eKgM029061@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: "Brad Davis" Subject: Re: docs/69249: [patch] Update Opera listing, to reflect the native version. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Brad Davis List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 00:40:21 -0000 The following reply was made to PR docs/69249; it has been noted by GNATS. From: "Brad Davis" To: "Christian Brueffer" Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/69249: [patch] Update Opera listing, to reflect the native version. Date: Sun, 18 Jul 2004 18:33:40 -0600 (MDT) Looks good to me. Regards, Brad Davis From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 00:49:04 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9975816A4CE; Mon, 19 Jul 2004 00:49:04 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7522D43D64; Mon, 19 Jul 2004 00:49:04 +0000 (GMT) (envelope-from brueffer@FreeBSD.org) Received: from freefall.freebsd.org (brueffer@localhost [127.0.0.1]) i6J0n3F7029298; Mon, 19 Jul 2004 00:49:03 GMT (envelope-from brueffer@freefall.freebsd.org) Received: (from brueffer@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6J0n370029294; Mon, 19 Jul 2004 02:49:03 +0200 (CEST) (envelope-from brueffer) Date: Mon, 19 Jul 2004 02:49:03 +0200 (CEST) From: Christian Brueffer Message-Id: <200407190049.i6J0n370029294@freefall.freebsd.org> To: so14k@so14k.com, brueffer@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/69249: [patch] Update Opera listing, to reflect the native version. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 00:49:04 -0000 Synopsis: [patch] Update Opera listing, to reflect the native version. State-Changed-From-To: open->closed State-Changed-By: brueffer State-Changed-When: Mon Jul 19 02:48:18 CEST 2004 State-Changed-Why: Committed with a slight enhancement. Thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=69249 From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 09:10:09 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8BD2D16A4DC for ; Mon, 19 Jul 2004 09:10:09 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7179243D66 for ; Mon, 19 Jul 2004 09:10:08 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6J9A8TN002034 for ; Mon, 19 Jul 2004 09:10:08 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6J9A8YD002030; Mon, 19 Jul 2004 09:10:08 GMT (envelope-from gnats) Resent-Date: Mon, 19 Jul 2004 09:10:08 GMT Resent-Message-Id: <200407190910.i6J9A8YD002030@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, Alexey Dokuchaev Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E0CF816A4CF for ; Mon, 19 Jul 2004 09:07:32 +0000 (GMT) Received: from mx.nsu.ru (mx.nsu.ru [212.192.164.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6FA4F43D45 for ; Mon, 19 Jul 2004 09:07:31 +0000 (GMT) (envelope-from danfe@regency.nsu.ru) Received: from regency.nsu.ru ([193.124.210.26]) by mx.nsu.ru with esmtp (Exim 4.32) id 1BmUDs-00055n-8y for FreeBSD-gnats-submit@freebsd.org; Mon, 19 Jul 2004 16:14:12 +0700 Received: from regency.nsu.ru (localhost [127.0.0.1]) by regency.nsu.ru (8.12.10/8.12.10) with ESMTP id i6J99Z9k042670 for ; Mon, 19 Jul 2004 16:09:35 +0700 (NOVST) (envelope-from danfe@regency.nsu.ru) Received: (from danfe@localhost) by regency.nsu.ru (8.12.10/8.12.10/Submit) id i6J99Yof042470; Mon, 19 Jul 2004 16:09:34 +0700 (NOVST) (envelope-from danfe) Message-Id: <200407190909.i6J99Yof042470@regency.nsu.ru> Date: Mon, 19 Jul 2004 16:09:34 +0700 (NOVST) From: Alexey Dokuchaev To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69271: Porter's Handbook: hint on proper pkg-message usage X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Alexey Dokuchaev List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 09:10:09 -0000 >Number: 69271 >Category: docs >Synopsis: Porter's Handbook: hint on proper pkg-message usage >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Mon Jul 19 09:10:07 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Alexey Dokuchaev >Release: FreeBSD 4.9-STABLE i386 >Organization: CNIT NSU >Environment: System: FreeBSD regency.nsu.ru 4.9-STABLE FreeBSD 4.9-STABLE #1: Wed Mar 3 13:17:54 NOVT 2004 root@regency.nsu.ru:/usr/src/sys/compile/REGENCY i386 >Description: Sometimes porter might want to alter supplied pkg-message so it reflects the reality better, with information available at run-time. Special care should be taken here, as to ensure coherent pkg-message would go into package. Since it's not that obvious to an average porter, and straightforward solution is, in fact, wrong, I therefore propose the following text to be added to Porter's Handbook (see below). >How-To-Repeat: N/A (but you can see games/fuhquake/Makefile for real-life usage). >Fix: %%% Index: book.sgml =================================================================== RCS file: /home/pub/ftp/pub/FreeBSD/development/FreeBSD-CVS/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v retrieving revision 1.461 diff -u -r1.461 book.sgml --- book.sgml 12 Jul 2004 08:24:15 -0000 1.461 +++ book.sgml 19 Jul 2004 03:47:03 -0000 @@ -4986,6 +5004,22 @@ package, so you should probably display it from the post-install target yourself. + + Sometimes you have your pkg-message semi-ready, + that is, having to substitute some text in it with actual run-time + value. In this case, make sure you preserve modified + pkg-message since you likely need it to make the + package. For example: + + post-install: + @${SED} -e 's|$${DATADIR}|${DATADIR}|g' ${.CURDIR}/pkg-message > ${PKGMESSAGE} + @${CAT} ${PKGMESSAGE} + + Contrary, wrong way would be: + + post-install: + @${SED} -e 's|$${DATADIR}|${DATADIR}|g' ${PKGMESSAGE} + >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 10:03:54 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 95FA516A4CF; Mon, 19 Jul 2004 10:03:54 +0000 (GMT) Date: Mon, 19 Jul 2004 10:03:54 +0000 From: Murray Stokely To: doc@freebsd.org Message-ID: <20040719100354.GA90972@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D Subject: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 10:03:54 -0000 I think the time has come to split up the Handbook. It has grown unchecked for far too long and it has been several years since we last moved chapters out of the Handbook (and into the Developers Handbook in that case). The Handbook is currently organized as 5 distinct DocBook : * Getting Started * Common Tasks * System Administration * Network Communication * Appendices I would like to split the Handbook into a User Handbook and an Administrator Handbook. The first two would belong to the user handbook, the second two would belong to the administrator handbook, and the appendices would be shared with both. That is exactly the split that FreeBSD Mall has been using in Perforce for our third edition Handbook volumes. Volume I is the User Handbook as defined above, and Volume II is the Admin Handbook. I think it makes sense for the Project to accept this work we have done in Perforce back into the main CVS tree. I propose that the User Handbook remain as 'handbook' in CVS, and that the admin chapters be repo-copied to 'books/admin-handbook'. Each of the two books would then be in the more manageable 400-600 page range in printed form. I can perform all of this work, ask for the repo copies, update all cross links between chapters to use new entities to link between volumes, and update the prefaces and frontmatter for both volumes. I can do this in a single day so as to minimize disruption for others working on the Handbook(s). The preface and frontmatter of the index.html at www.freebsd.org/handbook would contain a prominent pointer to the new volume so that people looking for content can still find it easily. Is there any reason not to go ahead with such a split? - Murray From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 10:08:42 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 17E1E16A4CE; Mon, 19 Jul 2004 10:08:42 +0000 (GMT) Received: from hotmail.com (bay16-f21.bay16.hotmail.com [65.54.186.71]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0E2E443D4C; Mon, 19 Jul 2004 10:08:42 +0000 (GMT) (envelope-from javed_atm@hotmail.com) Received: from mail pickup service by hotmail.com with Microsoft SMTPSVC; Mon, 19 Jul 2004 03:08:42 -0700 Received: from 195.33.105.17 by by16fd.bay16.hotmail.msn.com with HTTP; Mon, 19 Jul 2004 10:08:41 GMT X-Originating-IP: [195.33.105.17] X-Originating-Email: [javed_atm@hotmail.com] X-Sender: javed_atm@hotmail.com From: "muhammad javed" To: questions@FreeBSD.org Date: Mon, 19 Jul 2004 10:08:41 +0000 Mime-Version: 1.0 Content-Type: text/plain; format=flowed Message-ID: X-OriginalArrivalTime: 19 Jul 2004 10:08:42.0113 (UTC) FILETIME=[5E702F10:01C46D78] cc: doc@FreeBSD.org Subject: doc X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 10:08:42 -0000 sir my name is javed. i want to learn learn unix opreating stystam .it is possible to send me free book or basics documents. i am great full to you. _________________________________________________________________ Add photos to your messages with MSN 8. Get 2 months FREE*. http://join.msn.com/?page=features/featuredemail From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 10:12:18 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A30A016A4CE; Mon, 19 Jul 2004 10:12:18 +0000 (GMT) Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8D3E043D45; Mon, 19 Jul 2004 10:12:18 +0000 (GMT) (envelope-from linimon@lonesome.com) Received: from [192.160.235.14] (cs242743-143.austin.rr.com [24.27.43.143]) (using TLSv1 with cipher RC4-MD5 (128/128 bits)) (No client certificate requested) by mail.soaustin.net (Postfix) with ESMTP id B92DE148C5; Mon, 19 Jul 2004 05:12:16 -0500 (CDT) From: Mark Linimon Organization: Lonesome Dove Computing Services To: freebsd-doc@freebsd.org Date: Mon, 19 Jul 2004 05:11:27 -0500 User-Agent: KMail/1.6.2 References: <20040719100354.GA90972@hub.freebsd.org> In-Reply-To: <20040719100354.GA90972@hub.freebsd.org> MIME-Version: 1.0 Content-Disposition: inline Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Message-Id: <200407190511.27193.linimon@lonesome.com> cc: Murray Stokely cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 10:12:18 -0000 This doc commiter thinks it sounds good. mcl From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 10:12:18 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A30A016A4CE; Mon, 19 Jul 2004 10:12:18 +0000 (GMT) Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8D3E043D45; Mon, 19 Jul 2004 10:12:18 +0000 (GMT) (envelope-from linimon@lonesome.com) Received: from [192.160.235.14] (cs242743-143.austin.rr.com [24.27.43.143]) (using TLSv1 with cipher RC4-MD5 (128/128 bits)) (No client certificate requested) by mail.soaustin.net (Postfix) with ESMTP id B92DE148C5; Mon, 19 Jul 2004 05:12:16 -0500 (CDT) From: Mark Linimon Organization: Lonesome Dove Computing Services To: freebsd-doc@freebsd.org Date: Mon, 19 Jul 2004 05:11:27 -0500 User-Agent: KMail/1.6.2 References: <20040719100354.GA90972@hub.freebsd.org> In-Reply-To: <20040719100354.GA90972@hub.freebsd.org> MIME-Version: 1.0 Content-Disposition: inline Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Message-Id: <200407190511.27193.linimon@lonesome.com> cc: Murray Stokely cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 10:12:18 -0000 This doc commiter thinks it sounds good. mcl From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 10:28:34 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1E1E216A4CE; Mon, 19 Jul 2004 10:28:34 +0000 (GMT) Received: from eddie.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 89C6F43D31; Mon, 19 Jul 2004 10:28:33 +0000 (GMT) (envelope-from simon@eddie.nitro.dk) Received: by eddie.nitro.dk (Postfix, from userid 1000) id 96D8011846; Mon, 19 Jul 2004 12:28:31 +0200 (CEST) Date: Mon, 19 Jul 2004 12:28:31 +0200 From: "Simon L. Nielsen" To: Murray Stokely Message-ID: <20040719102831.GA33180@eddie.nitro.dk> References: <20040719100354.GA90972@hub.freebsd.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="lrZ03NoBR/3+SXJZ" Content-Disposition: inline In-Reply-To: <20040719100354.GA90972@hub.freebsd.org> User-Agent: Mutt/1.5.6i cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 10:28:34 -0000 --lrZ03NoBR/3+SXJZ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.07.19 10:03:54 +0000, Murray Stokely wrote: > I think the time has come to split up the Handbook. It has grown > unchecked for far too long and it has been several years since we last > moved chapters out of the Handbook (and into the Developers Handbook > in that case). Without having looked closely into which parts go where, I think it makes sense to do a split. > I can perform all of this work, ask for the repo copies, update all > cross links between chapters to use new entities to link between > volumes, and update the prefaces and frontmatter for both volumes. I > can do this in a single day so as to minimize disruption for others > working on the Handbook(s). I would suggest announcing the change a bit in advance and the doing a freeze for commits to the handbook during the change, to avoid making it more difficualt than necessary. > The preface and frontmatter of the > index.html at www.freebsd.org/handbook would contain a prominent > pointer to the new volume so that people looking for content can still > find it easily. Since a lot of people expect just to look in the "Handbook" and people have have direct links into to it, I think the notice of the change should be published so as many people as possible get the heads up. Perhaps even on announce@. Since there exist quite a lot of links directly into the Handbook, I think it would be a good idea to create dummy HTML files, for the section that's going to be moved. They would tell people that the Handbook has been split, and refresh after 10 seconds to the new page, instead of giving people a 404 error. I think it should be fairly trivial to auto generate those HTML files. It would require doing something special with for the build dir on www.FreeBSD.org, but I think it's worth it to avoid confusing users with dead links. --=20 Simon L. Nielsen FreeBSD Documentation Team --lrZ03NoBR/3+SXJZ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA+6JPh9pcDSc1mlERAhduAJ49CVsvvF3DP5WGaJALC27LayADNQCgkiAb M9iqAbI0Nubdlxw06N+0lZk= =yCso -----END PGP SIGNATURE----- --lrZ03NoBR/3+SXJZ-- From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 10:48:04 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1C7CA16A4CE for ; Mon, 19 Jul 2004 10:48:04 +0000 (GMT) Received: from pr93.lublin.sdi.tpnet.pl (pr93.lublin.sdi.tpnet.pl [217.97.36.93]) by mx1.FreeBSD.org (Postfix) with SMTP id 7DC9043D39 for ; Mon, 19 Jul 2004 10:48:02 +0000 (GMT) (envelope-from michal@pasternak.w.lub.pl) Received: (qmail 3171 invoked by uid 1000); 19 Jul 2004 10:48:20 -0000 Date: Mon, 19 Jul 2004 12:48:20 +0200 From: Michal Pasternak To: muhammad javed Message-ID: <20040719104820.GA2903@pasternak.w.lub.pl> References: Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-2 Content-Disposition: inline In-Reply-To: cc: questions@FreeBSD.org cc: doc@FreeBSD.org Subject: Re: doc X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Michal Pasternak List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 10:48:04 -0000 muhammad javed [Mon, Jul 19, 2004 at 10:08:41AM +0000]: > sir > my name is javed. i want to learn learn unix opreating stystam .it is > possible to send me free book or basics documents. i am great full to you. Hello Javed, You can download FreeBSD handbook here: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/index.html FreeBSD FAQ is also interesting: http://www.freebsd.org/doc/en_US.ISO8859-1/books/faq/index.html Check also this section of FreeBSD for newbies: http://www.freebsd.org/projects/newbies.html#unix Another big repository of documentation are Linux HOWTOs - many of them aren't really linux specific: http://www.tldp.org/docs.html#howto Have fun, -- m From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 10:49:41 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id F26F916A4CF; Mon, 19 Jul 2004 10:49:40 +0000 (GMT) Date: Mon, 19 Jul 2004 10:49:40 +0000 From: Murray Stokely To: "Simon L. Nielsen" Message-ID: <20040719104940.GA95183@hub.freebsd.org> References: <20040719100354.GA90972@hub.freebsd.org> <20040719102831.GA33180@eddie.nitro.dk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040719102831.GA33180@eddie.nitro.dk> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 10:49:41 -0000 On Mon, Jul 19, 2004 at 12:28:31PM +0200, Simon L. Nielsen wrote: > I would suggest announcing the change a bit in advance and the doing a > freeze for commits to the handbook during the change, to avoid making it > more difficualt than necessary. Good idea. > Since a lot of people expect just to look in the "Handbook" and people > have have direct links into to it, I think the notice of the change > should be published so as many people as possible get the heads up. > Perhaps even on announce@. Yes I think you are right. We should put a news item up on our front page, and I think it is worth a post to announce@. > instead of giving people a 404 error. I think it should be fairly > trivial to auto generate those HTML files. It would require doing > something special with for the build dir on www.FreeBSD.org, but I think > it's worth it to avoid confusing users with dead links. Yes, that's an excellent idea and I think it's something we could whip up in a perl script or similar. - Murray From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 10:55:43 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 53AF216A51D; Mon, 19 Jul 2004 10:55:43 +0000 (GMT) Received: from shrike.submonkey.net (cpc2-cdif3-6-0-cust204.cdif.cable.ntl.com [81.103.67.204]) by mx1.FreeBSD.org (Postfix) with ESMTP id B01EA43D49; Mon, 19 Jul 2004 10:55:42 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.34; FreeBSD) id 1BmVo5-0004Y9-SO; Mon, 19 Jul 2004 11:55:41 +0100 Date: Mon, 19 Jul 2004 11:55:41 +0100 From: Ceri Davies To: Murray Stokely Message-ID: <20040719105541.GC424@submonkey.net> Mail-Followup-To: Ceri Davies , Murray Stokely , doc@freebsd.org References: <20040719100354.GA90972@hub.freebsd.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="/9DWx/yDrRhgMJTb" Content-Disposition: inline In-Reply-To: <20040719100354.GA90972@hub.freebsd.org> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 10:55:43 -0000 --/9DWx/yDrRhgMJTb Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Jul 19, 2004 at 10:03:54AM +0000, Murray Stokely wrote: > I think the time has come to split up the Handbook. It has grown > unchecked for far too long and it has been several years since we last > moved chapters out of the Handbook (and into the Developers Handbook > in that case). I was thinking that myself. > Is there any reason not to go ahead with such a split? No. Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --/9DWx/yDrRhgMJTb Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA+6itocfcwTS3JF8RAnClAJ9ssel/qn2kntzLMbD+gBBKAqOoTQCfUKJH h0rvyDi7ZuxabQ8hI2uBxh8= =WyaI -----END PGP SIGNATURE----- --/9DWx/yDrRhgMJTb-- From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 11:00:55 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 73CD016A4CE for ; Mon, 19 Jul 2004 11:00:55 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6BD8A43D46 for ; Mon, 19 Jul 2004 11:00:55 +0000 (GMT) (envelope-from owner-bugmaster@freebsd.org) Received: from freefall.freebsd.org (peter@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6JB0t0M014471 for ; Mon, 19 Jul 2004 11:00:55 GMT (envelope-from owner-bugmaster@freebsd.org) Received: (from peter@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6JB0sNQ014463 for freebsd-doc@freebsd.org; Mon, 19 Jul 2004 11:00:54 GMT (envelope-from owner-bugmaster@freebsd.org) Date: Mon, 19 Jul 2004 11:00:54 GMT Message-Id: <200407191100.i6JB0sNQ014463@freefall.freebsd.org> X-Authentication-Warning: freefall.freebsd.org: peter set sender to owner-bugmaster@freebsd.org using -f From: FreeBSD bugmaster To: FreeBSD doc list Subject: Current unassigned doc problem reports X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 11:00:55 -0000 Current FreeBSD problem reports 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. Bugs can be in one of several states: o - open A problem report has been submitted, no sanity checking performed. a - analyzed The problem is understood and a solution is being sought. f - feedback Further work requires additional information from the originator or the community - possibly confirmation of the effectiveness of a proposed solution. p - patched A patch has been committed, but some issues (MFC and / or confirmation from originator) are still open. s - suspended The problem is not being worked on, due to lack of information or resources. This is a prime candidate for somebody who is looking for a project to do. If the problem cannot be solved at all, it will be closed, rather than suspended. c - closed A problem report is closed when any changes have been integrated, documented, and tested -- or when fixing the problem is abandoned. Critical problems Serious problems S Submitted Tracker Resp. Description ------------------------------------------------------------------------------- s [1999/10/04] i386/14135 doc lpt1 nolonger exists after 3.2-RELEASE s [2000/07/19] docs/20028 doc ASCII docs should reflect tags o [2001/05/24] docs/27605 doc Cross-document references () s [2002/03/08] docs/35678 doc docproj Makefiles for web are broken for o [2002/03/21] docs/36168 doc -pthread/_THREAD_SAFE docs missing in gcc o [2002/09/14] docs/42762 doc ppp.8 has no description of $env and ~use o [2002/11/15] docs/45303 doc Bug in PDF DocBook rendering o [2003/11/22] docs/59587 doc rewriting examples (part of documentation o [2003/12/29] docs/60679 doc pthreads documentation does not describe o [2004/01/19] docs/61558 doc New SMC 2602W cards, using the ADM8211, a o [2004/01/20] docs/61605 doc Improve documentation for i386 disk geome o [2004/02/10] docs/62665 doc setting up X display subsystem function i o [2004/03/10] docs/64063 doc Size of block in File System Quota docume 13 problems total. Non-critical problems S Submitted Tracker Resp. Description ------------------------------------------------------------------------------- o [2001/02/02] docs/24786 doc missing FILES descriptions in sa(4) o [2001/07/26] docs/29245 doc top(1) manpage doesn't understand SMP a [2001/08/23] docs/30008 doc This document should be translated, comme p [2001/09/27] docs/30873 doc ``ip'' man page does not specify byte ord o [2001/10/07] docs/31109 doc replace gif images w/ png ones due to pat o [2002/01/05] docs/33589 doc Patch to doc.docbook.mk to post process . o [2002/01/14] docs/33852 doc split(1) man page implies that input file o [2002/01/14] docs/33877 doc Documentet behaviour of SF_flags for non- a [2002/02/16] docs/35011 doc There are no commands called "diskless" o o [2002/02/22] docs/35222 doc mailing list archive URL regexp suboptima o [2002/03/06] docs/35608 doc mt(1) page uses "setmark" without explana o [2002/03/06] docs/35609 doc mt(1) page needs explanation of "long era o [2002/03/06] docs/35612 doc ps(1) page "state" description doesn't me o [2002/03/07] docs/35642 doc lo(4) page maybe should document optional o [2002/03/07] docs/35644 doc lo(4) page presumes familiarity with prin o [2002/03/07] docs/35646 doc cp(1) page needs a "Bugs" section. o [2002/03/07] docs/35648 doc rc.conf; add note about "flags" to both f o [2002/03/08] docs/35686 doc blackhole(4) page seems to contradict its o [2002/03/08] docs/35687 doc /etc/nsmb.conf missing mention of readers o [2002/03/10] docs/35732 doc adduser(8) page has obsolete reference an o [2002/03/16] docs/35943 doc at(1) config files are misplaced in /var/ o [2002/03/16] docs/35953 doc hosts.equiv(5) manual is confusing or wro o [2002/03/28] docs/36432 doc Proposal for doc/share/mk: make folded bo o [2002/03/29] docs/36449 doc symlink(7) manual doesn't mention trailin s [2002/05/07] docs/37843 doc manual for pthread_setschedparam is wrong o [2002/05/18] docs/38225 doc change "CDROM" to "CD-ROM" o [2002/05/25] docs/38556 doc EPS file of beastie, as addition to exist o [2002/05/27] docs/38620 doc Committers Guide and CVS o [2002/05/31] docs/38772 doc firewall_type feature not mentioned on Ha o [2002/06/07] docs/38982 doc developers-hanbook/Jail fix p [2002/06/08] docs/39044 doc The man page for rot13(6) never mentions o [2002/06/13] docs/39213 doc No rc(4) man page o [2002/06/15] docs/39348 doc kenv fetch of hostname requires dhcp/boot o [2002/06/19] docs/39530 doc access(2) man page has unnecessarily broa o [2002/06/25] docs/39824 doc Various tweaks for doc/en_US.ISO8859-1/bo o [2002/07/10] docs/40423 doc Keyboard(4)'s definition of parameters to o [2002/07/11] docs/40443 doc Update books/faq/book.sgml for USB .ko's o [2002/07/21] docs/40851 doc [PATCH] "mergemaster -p" in UPDATING's "C o [2002/07/28] docs/41089 doc pax -B option does not mention interactio o [2002/08/02] docs/41270 doc confusing directions for kernelconfig cha o [2002/08/19] docs/41791 doc Documentation formatting error o [2002/08/20] docs/41807 doc natd -punch_fw "bug" o [2002/08/20] docs/41820 doc Device driver confusion in Handbook (2.3) a [2002/08/27] docs/42058 doc Documentation: Installing Oracle 8i onto o [2002/10/04] docs/43651 doc stab(5) incorrectly states to include jus o [2002/10/09] docs/43861 doc non-trivial typo in wicontrol man page o [2002/10/11] docs/43941 doc Rationale for Upgrade Sequence o [2002/10/15] docs/44074 doc ln(1) manual clarifications [patch] o [2002/10/23] docs/44400 doc ipfw(8) has contradictions in bridged and o [2002/10/24] docs/44435 doc sysctl manpage: add example for tcsh o [2002/10/29] docs/44594 doc Handbook doesn't mention drivers.flp for o [2002/12/02] docs/45940 doc burncd missing info o [2002/12/11] docs/46196 doc Missing return value in (set_)menu_format o [2002/12/16] docs/46291 doc correlation between HZ kernel config para o [2002/12/16] docs/46295 doc please add information to Nvi recovery em o [2003/01/03] docs/46709 doc tables in terminfo.5 are broken o [2003/01/06] docs/46793 doc DEVICE_POLLING can not be used with SMP, o [2003/01/28] docs/47575 doc Clarify requirements for IPFW2 in STABLE o [2003/01/28] docs/47594 doc [PATH] passwd(5) incorrectly states allow o [2003/01/30] docs/47690 doc builtin(1) manpage is wrong about externa o [2003/01/31] docs/47705 doc wc(1) manpage has poor explanations. f [2003/02/02] docs/47818 doc ln(1) manpage is confusing f [2003/02/07] docs/48038 doc [PATCH] add Tips and Tricks section into o [2003/02/28] docs/48767 doc wrong key numbers for left/right windows o [2003/03/06] docs/48980 doc [PATCH] nsgmls -s errors and sect. 3.2.1 o [2003/03/23] docs/50211 doc [PATCH] Fix textfile creation o [2003/04/03] docs/50573 doc return values for res_query/res_search/re o [2003/04/07] docs/50677 doc [PATCH] update doc/en_US.ISO8859-1/books/ o [2003/04/10] docs/50773 doc NFS problems by jumbo frames to mention i o [2003/05/06] docs/51875 doc atkbd(4) adjustment o [2003/05/06] docs/51891 doc DIAGNOSTICS in ed driver manpage don't ma o [2003/05/07] docs/51921 doc ls(1) manpage lacks some information abou o [2003/05/11] docs/52071 doc [PATCH] Add more information about soft u o [2003/05/25] docs/52672 doc Porter's Handbook: couple of corrections o [2003/06/13] docs/53303 doc mount(2) man page error o [2003/06/21] docs/53575 doc Change to Handbook Section 20.9 o [2003/06/21] docs/53596 doc Updates to mt manual page o [2003/06/25] docs/53732 doc quota output and man page do not document o [2003/07/08] docs/54229 doc Complete "See also" section for getipnode o [2003/07/11] docs/54391 doc Document that glob(3) respects LC_COLLATE o [2003/07/13] i386/54451 doc [patch] i386_{get|set}_ldt manual page is o [2003/07/26] docs/54879 doc man 1 jot, -r description o [2003/07/28] docs/54999 doc Documentation Project Primer doesn't conf o [2003/08/12] docs/55482 doc DUMP has access to block devices in a JAI o [2003/08/17] docs/55653 doc chflags.1 - note that not all tools chfla o [2003/09/18] docs/56981 doc man terminfo(5) from libncurses does not o [2003/09/24] docs/57153 doc S_IRWXU missing in fstat(2) man page? o [2003/09/30] docs/57388 doc INSTALL.TXT enhancement: mention ok promp o [2003/10/04] docs/57569 doc error on gensetdefs(8) man page o [2003/10/13] docs/57926 doc amd.conf.5 poorly format as it has both m o [2003/10/13] docs/57974 doc man page apropos for select macros (FD_SE o [2003/10/13] docs/57978 doc Type miss of GPIB in Hardware Notes o [2003/10/16] docs/58111 doc Handbook 12.4.3 Rebuilding ATA RAID1 Arra o [2003/10/28] docs/58615 doc update for Vinum chapter of Handbook: des o [2003/10/30] docs/58710 doc killpg(2) contains an error regarding sen o [2003/11/07] docs/59044 doc doc.docbook.mk does not properly handle a o [2003/11/19] docs/59477 doc Outdated Info Documents at http://docs.fr o [2003/11/21] docs/59565 doc [PATCH] FAQ doesn't cover definition of g o [2003/11/24] docs/59649 doc Outdated 4.4BSD Documents at http://docs. o [2003/11/30] docs/59835 doc ipfw(8) man page does not warn about acce o [2003/12/23] docs/60529 doc resolver(5) man page is badly out of date o [2003/12/24] docs/60544 doc getenv(3) manpage doesn't state the retur o [2004/01/08] docs/61070 doc Installation docs misleading: PResizer i o [2004/01/13] docs/61301 doc [patch] Manpage patch for aue(4) to enabl o [2004/01/20] docs/61624 doc Missing page numbers in pdf version of Ha o [2004/01/21] docs/61667 doc Obsolete documentation on FreeBSD PnP o [2004/01/25] docs/61859 doc Incorrect informaiton about trace command o [2004/01/25] docs/61878 doc LSI megaraid 150-x cards not included in o [2004/02/04] docs/62364 doc Misleading information in the handbook o [2004/02/05] docs/62402 doc easily circumventable Blade150 problem o [2004/02/06] docs/62412 doc one of the diskless boot methods describe o [2004/02/12] docs/62719 doc cross-reference pccardd and devd o [2004/02/12] docs/62724 doc host(1) manpage does not include informat o [2004/02/16] docs/62914 doc Reference development(7) in other parts o o [2004/02/22] docs/63215 doc Wrong prototypes in mi_switch(9) (ref doc o [2004/03/03] docs/63676 doc [patch] Fix some tag errors. o [2004/03/03] docs/63719 doc lptcontrol(8) manpage omits -s from a lis o [2004/03/05] docs/63808 doc No manpage for devfs.conf f [2004/03/16] docs/64342 doc Assumed content of PATH is not defined in o [2004/03/27] docs/64807 doc Handbook section on NAT incomplete o [2004/04/02] docs/65065 doc improper language ntpd man pages o [2004/04/10] docs/65400 doc make.1: better wording in BUGS section o [2004/04/13] docs/65477 doc Installation Instruction fail to mention o [2004/04/14] docs/65530 doc minor improvement to getgrent.3 o [2004/04/15] docs/65570 doc documented -C option not available in mak o [2004/04/22] docs/65895 doc incorrect "omshell" link in "dhclient" ma o [2004/04/26] docs/65988 doc incorrect references to ppp.conf in handb o [2004/04/29] docs/66091 doc ppp(8) docs out-of-date for -CURRENT o [2004/05/04] docs/66264 doc [patch] libexec/rtld/rtld.1 typo fixes no o [2004/05/04] docs/66265 doc [patch] Document what -f and LD_TRACE_LOA o [2004/05/05] docs/66296 doc [patch] contrib/amd/amq/amq.8 uses log_op o [2004/05/07] docs/66343 doc unlisted supported card on man page for w o [2004/05/09] docs/66426 doc handbook update (desktop section): web br o [2004/05/10] docs/66483 doc [patch] share/man/man4/csa.4 grammar nits o [2004/05/17] docs/66768 doc 4_RELENG share/man/man4/ng_one2many.4 MFC o [2004/05/17] docs/66770 doc [patch] share/man/man4/ng_pppoe.4 tyops, o [2004/05/17] docs/66775 doc Clarification that port names should not o [2004/05/23] docs/67078 doc [patch] MFC of a rtld(1) man page is inco o [2004/06/10] docs/67806 doc Let 5.x users know how to boot into singl o [2004/06/13] docs/67893 doc boot.8's -m description is insufficient. o [2004/06/22] docs/68201 doc [patch] pthread_atfork(3) man page o [2004/06/28] docs/68449 doc [patch] src/lib/libstand/libstand.3 nits o [2004/06/28] docs/68453 doc [patch] rc.subr.8 o [2004/07/02] docs/68595 doc [PATCH] add FAQ entry for lock order reve o [2004/07/02] docs/68606 doc Porter's Handbook: document how to write o [2004/07/07] docs/68746 doc Virtual hosts documentaion doesn't make c o [2004/07/09] docs/68843 doc Dates on rc.subr(8) & rc(8) are whack. o [2004/07/09] docs/68845 doc The .At macro produces unexpected results o [2004/07/15] docs/69086 doc Porters Handbook: How to convert from CR/ o [2004/07/18] docs/69225 doc PATCH-Serial comms chapter has wrong acro o [2004/07/18] docs/69252 doc [patch] Add entry about Konq to the list o [2004/07/19] docs/69271 doc Porter's Handbook: hint on proper pkg-mes 152 problems total. From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 11:55:15 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9D9BC16A4CE; Mon, 19 Jul 2004 11:55:15 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 80DEE43D39; Mon, 19 Jul 2004 11:55:15 +0000 (GMT) (envelope-from harti@FreeBSD.org) Received: from freefall.freebsd.org (harti@localhost [127.0.0.1]) i6JBtFHu025306; Mon, 19 Jul 2004 11:55:15 GMT (envelope-from harti@freefall.freebsd.org) Received: (from harti@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6JBtFt8025302; Mon, 19 Jul 2004 11:55:15 GMT (envelope-from harti) Date: Mon, 19 Jul 2004 11:55:15 GMT From: Hartmut Brandt Message-Id: <200407191155.i6JBtFt8025302@freefall.freebsd.org> To: patrick@pine.nl, harti@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/65570: documented -C option not available in make(1) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 11:55:15 -0000 Synopsis: documented -C option not available in make(1) State-Changed-From-To: open->closed State-Changed-By: harti State-Changed-When: Mon Jul 19 11:54:17 GMT 2004 State-Changed-Why: This works in 4.9 and above. 4.8 is frozen except for security patches for which this problem doesn't qualify. http://www.freebsd.org/cgi/query-pr.cgi?pr=65570 From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 12:29:20 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4938016A4CE; Mon, 19 Jul 2004 12:29:20 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 19BA843D2F; Mon, 19 Jul 2004 12:29:20 +0000 (GMT) (envelope-from harti@FreeBSD.org) Received: from freefall.freebsd.org (harti@localhost [127.0.0.1]) i6JCTJm9034971; Mon, 19 Jul 2004 12:29:19 GMT (envelope-from harti@freefall.freebsd.org) Received: (from harti@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6JCTJW7034963; Mon, 19 Jul 2004 12:29:19 GMT (envelope-from harti) Date: Mon, 19 Jul 2004 12:29:19 GMT From: Hartmut Brandt Message-Id: <200407191229.i6JCTJW7034963@freefall.freebsd.org> To: neuhauser@chello.cz, harti@FreeBSD.org, freebsd-doc@FreeBSD.org, harti@FreeBSD.org Subject: Re: docs/65400: make.1: better wording in BUGS section X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 12:29:20 -0000 Synopsis: make.1: better wording in BUGS section State-Changed-From-To: open->feedback State-Changed-By: harti State-Changed-When: Mon Jul 19 12:28:05 GMT 2004 State-Changed-Why: Grab this PR. Also request feedback from the submitter on an enhanced patch. Responsible-Changed-From-To: freebsd-doc->harti Responsible-Changed-By: harti Responsible-Changed-When: Mon Jul 19 12:28:05 GMT 2004 Responsible-Changed-Why: Grab this PR. Also request feedback from the submitter on an enhanced patch. http://www.freebsd.org/cgi/query-pr.cgi?pr=65400 From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 12:38:45 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0DFDB16A4CE for ; Mon, 19 Jul 2004 12:38:45 +0000 (GMT) Received: from bilbo.otenet.gr (bilbo.otenet.gr [195.170.0.13]) by mx1.FreeBSD.org (Postfix) with ESMTP id 49D5B43D3F for ; Mon, 19 Jul 2004 12:38:44 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from orion.daedalusnetworks.priv (aris.bedc.ondsl.gr [62.103.39.226])i6JCcf3B024717 for ; Mon, 19 Jul 2004 15:38:42 +0300 Received: from orion.daedalusnetworks.priv (orion [127.0.0.1]) i6JCf3C8015652 for ; Mon, 19 Jul 2004 15:41:03 +0300 (EEST) (envelope-from keramida@FreeBSD.org) Received: (from keramida@localhost)i6JCf3Xg015651 for doc@freebsd.org; Mon, 19 Jul 2004 15:41:03 +0300 (EEST) (envelope-from keramida@FreeBSD.org) Date: Mon, 19 Jul 2004 15:41:03 +0300 From: Giorgos Keramidas To: doc@FreeBSD.org Message-ID: <20040719124103.GA15495@orion.daedalusnetworks.priv> References: <20040719100354.GA90972@hub.freebsd.org> <20040719105541.GC424@submonkey.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040719105541.GC424@submonkey.net> Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 12:38:45 -0000 On 2004-07-19 11:55, Ceri Davies wrote: > On Mon, Jul 19, 2004 at 10:03:54AM +0000, Murray Stokely wrote: > > > > I think the time has come to split up the Handbook. > > Is there any reason not to go ahead with such a split? > > No. me too I think I still remember the last time this was brought up. I'm still in support of the idea. - Giorgos From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 13:16:16 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id F2DF316A4CE; Mon, 19 Jul 2004 13:16:15 +0000 (GMT) Received: from server.alexdupre.com (host245-49.pool8288.interbusiness.it [82.88.49.245]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0626043D45; Mon, 19 Jul 2004 13:16:15 +0000 (GMT) (envelope-from ale@FreeBSD.org) Received: from [192.168.0.101] (thunder.alexdupre.com [192.168.0.101]) i6JDGCLQ049932; Mon, 19 Jul 2004 15:16:13 +0200 (CEST) (envelope-from ale@FreeBSD.org) Message-ID: <40FBC99C.4090809@FreeBSD.org> Date: Mon, 19 Jul 2004 15:16:12 +0200 From: Alex Dupre User-Agent: Mozilla Thunderbird 0.7.1 (Windows/20040626) X-Accept-Language: en-us, en MIME-Version: 1.0 To: Murray Stokely References: <20040719100354.GA90972@hub.freebsd.org> In-Reply-To: <20040719100354.GA90972@hub.freebsd.org> X-Enigmail-Version: 0.84.2.0 X-Enigmail-Supports: pgp-inline, pgp-mime Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 13:16:16 -0000 Murray Stokely wrote: > Is there any reason not to go ahead with such a split? No, go for me. -- Alex Dupre From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 13:28:40 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3808816A4CE; Mon, 19 Jul 2004 13:28:40 +0000 (GMT) Received: from ms-dienst.rz.rwth-aachen.de (ms-2.rz.RWTH-Aachen.DE [134.130.3.131]) by mx1.FreeBSD.org (Postfix) with ESMTP id C9C2243D3F; Mon, 19 Jul 2004 13:28:39 +0000 (GMT) (envelope-from chris@unixpages.org) Received: from r220-1 (r220-1.rz.RWTH-Aachen.DE [134.130.3.31]) by ms-dienst.rz.rwth-aachen.de (iPlanet Messaging Server 5.2 HotFix 1.12 (built Feb 13 2003)) with ESMTP id <0I1300MHUOVRLT@ms-dienst.rz.rwth-aachen.de>; Mon, 19 Jul 2004 15:16:40 +0200 (MEST) Received: from relay.RWTH-Aachen.DE ([134.130.3.1]) by r220-1 (MailMonitor for SMTP v1.2.2 ) ; Mon, 19 Jul 2004 15:16:39 +0200 (MEST) Received: from haakonia.hitnet.rwth-aachen.de (haakonia.hitnet.RWTH-Aachen.DE [137.226.181.92])i6JDGcmH004616; Mon, 19 Jul 2004 15:16:38 +0200 (MEST) Received: from gondor.middleearth (gondor.middleearth [192.168.1.42]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))(Postfix) with ESMTP id 5B11F2843F; Mon, 19 Jul 2004 15:16:38 +0200 (CEST) Received: by gondor.middleearth (Postfix, from userid 1001) id D9CCB6106; Mon, 19 Jul 2004 15:16:37 +0200 (CEST) Date: Mon, 19 Jul 2004 15:16:37 +0200 From: Christian Brueffer In-reply-to: <20040719100354.GA90972@hub.freebsd.org> To: Murray Stokely Message-id: <20040719131637.GA3752@unixpages.org> MIME-version: 1.0 Content-type: multipart/signed; boundary=EVF5PPMfhYS0aIcm; protocol="application/pgp-signature"; micalg=pgp-sha1 Content-disposition: inline User-Agent: Mutt/1.5.5.1i X-Operating-System: FreeBSD 5.2-CURRENT X-PGP-Key: http://people.freebsd.org/~brueffer/brueffer.key.asc X-PGP-Fingerprint: A5C8 2099 19FF AACA F41B B29B 6C76 178C A0ED 982D References: <20040719100354.GA90972@hub.freebsd.org> cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 13:28:40 -0000 --EVF5PPMfhYS0aIcm Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Jul 19, 2004 at 10:03:54AM +0000, Murray Stokely wrote: >=20 > I would like to split the Handbook into a User Handbook and an > Administrator Handbook. The first two would belong to the > user handbook, the second two would belong to the > administrator handbook, and the appendices would be shared with both. >=20 Sounds good. - Christian --=20 Christian Brueffer chris@unixpages.org brueffer@FreeBSD.org GPG Key: http://people.freebsd.org/~brueffer/brueffer.key.asc GPG Fingerprint: A5C8 2099 19FF AACA F41B B29B 6C76 178C A0ED 982D --EVF5PPMfhYS0aIcm Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA+8m1bHYXjKDtmC0RAmCPAJ4udIBn12Ss3fD8goBcwMjDrJmP2wCgjo+3 tBEBj7XNkb7XhxeOX8zCMSM= =Gv8K -----END PGP SIGNATURE----- --EVF5PPMfhYS0aIcm-- From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 13:32:32 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BBAFE16A4CE; Mon, 19 Jul 2004 13:32:32 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9E89043D53; Mon, 19 Jul 2004 13:32:32 +0000 (GMT) (envelope-from blackend@FreeBSD.org) Received: from freefall.freebsd.org (blackend@localhost [127.0.0.1]) i6JDWWBH058860; Mon, 19 Jul 2004 13:32:32 GMT (envelope-from blackend@freefall.freebsd.org) Received: (from blackend@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6JDWWXn058856; Mon, 19 Jul 2004 13:32:32 GMT (envelope-from blackend) Date: Mon, 19 Jul 2004 13:32:32 GMT From: Marc Fonvieille Message-Id: <200407191332.i6JDWWXn058856@freefall.freebsd.org> To: wblock@wonkity.com, blackend@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 13:32:32 -0000 Synopsis: PATCH-Serial comms chapter has wrong acronym for Transmit Data State-Changed-From-To: open->closed State-Changed-By: blackend State-Changed-When: Mon Jul 19 13:30:04 GMT 2004 State-Changed-Why: I s/SD/TD and s/TxD/TD s/RxD/RD for consistency. I kept the line description with the "ed" since it's the one used in the UTI V24 recommendation. Thanks. http://www.freebsd.org/cgi/query-pr.cgi?pr=69225 From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 13:32:52 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6DD8416A4CE; Mon, 19 Jul 2004 13:32:52 +0000 (GMT) Received: from electra.cse.Buffalo.EDU (electra.cse.Buffalo.EDU [128.205.32.2]) by mx1.FreeBSD.org (Postfix) with ESMTP id EE8DF43D3F; Mon, 19 Jul 2004 13:32:51 +0000 (GMT) (envelope-from kensmith@cse.Buffalo.EDU) Received: from electra.cse.Buffalo.EDU (kensmith@localhost [127.0.0.1]) i6JDWpTH005992; Mon, 19 Jul 2004 09:32:51 -0400 (EDT) Received: (from kensmith@localhost) by electra.cse.Buffalo.EDU (8.12.10/8.12.9/Submit) id i6JDWpt4005991; Mon, 19 Jul 2004 09:32:51 -0400 (EDT) Date: Mon, 19 Jul 2004 09:32:50 -0400 From: Ken Smith To: Murray Stokely Message-ID: <20040719133250.GA5522@electra.cse.Buffalo.EDU> References: <20040719100354.GA90972@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040719100354.GA90972@hub.freebsd.org> User-Agent: Mutt/1.4.1i cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 13:32:52 -0000 On Mon, Jul 19, 2004 at 10:03:54AM +0000, Murray Stokely wrote: > I think the time has come to split up the Handbook. It has grown > unchecked for far too long and it has been several years since we last > moved chapters out of the Handbook (and into the Developers Handbook > in that case). > > The Handbook is currently organized as 5 distinct DocBook : > > * Getting Started > * Common Tasks > * System Administration > * Network Communication > * Appendices > > I would like to split the Handbook into a User Handbook and an > Administrator Handbook. The first two would belong to the > user handbook, the second two would belong to the > administrator handbook, and the appendices would be shared with both. I'm not against doing a split-up at all, and am definitely in favor of the general theme of the split - user docs versus admin docs. My only thought is that if time/energy is available perhaps a closer look at what goes where might be good. My general outlook on life is that "User Docs" == "Stuff that doesn't require root", "Admin Docs" == "Stuff that does require root (or the installation CD)". At first glance if I'm understanding the current split proposal things like "Installing FreeBSD", "Installing Applications", and "Configuring the FreeBSD Kernel" will wind up in the "Users' Docs". Given FreeBSD's history of being skewed somewhat towards developer type folks this isn't a fatal problem and I wouldn't object loudly if we do split it that way. But from a non-developer point of view it's possible those sorts of things should go in the Admin guide. Just my $0.01 (it's not worth $0.02... :-). -- Ken Smith - From there to here, from here to | kensmith@cse.buffalo.edu there, funny things are everywhere. | - Theodore Geisel | From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 13:38:09 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 025E816A4CE; Mon, 19 Jul 2004 13:38:09 +0000 (GMT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id DDAE043D3F; Mon, 19 Jul 2004 13:38:07 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) i6JDc59D031616; Mon, 19 Jul 2004 15:38:06 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.11/8.12.11/Submit) id i6JDc5HE031615; Mon, 19 Jul 2004 15:38:05 +0200 (CEST) (envelope-from marc) Date: Mon, 19 Jul 2004 15:38:05 +0200 From: Marc Fonvieille To: bug-followup@FreeBSD.org Message-ID: <20040719133805.GB22044@abigail.blackend.org> References: <200407191332.i6JDWWXn058856@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200407191332.i6JDWWXn058856@freefall.freebsd.org> User-Agent: Mutt/1.4.2.1i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.10-PRERELEASE cc: freebsd-doc@FreeBSD.org Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 13:38:09 -0000 On Mon, Jul 19, 2004 at 01:32:32PM +0000, Marc Fonvieille wrote: > Synopsis: PATCH-Serial comms chapter has wrong acronym for Transmit Data > > State-Changed-From-To: open->closed > State-Changed-By: blackend > State-Changed-When: Mon Jul 19 13:30:04 GMT 2004 > State-Changed-Why: > I s/SD/TD and s/TxD/TD s/RxD/RD for consistency. > I kept the line description with the "ed" since it's the one used in the > UTI V24 recommendation. Thanks. > grr I meant ITU (International Telecommunication Union). From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 13:40:17 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4744016A4D3 for ; Mon, 19 Jul 2004 13:40:17 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4154843D46 for ; Mon, 19 Jul 2004 13:40:17 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6JDeG4T059179 for ; Mon, 19 Jul 2004 13:40:16 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6JDeGmf059178; Mon, 19 Jul 2004 13:40:16 GMT (envelope-from gnats) Date: Mon, 19 Jul 2004 13:40:16 GMT Message-Id: <200407191340.i6JDeGmf059178@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Marc Fonvieille Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Marc Fonvieille List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 13:40:17 -0000 The following reply was made to PR docs/69225; it has been noted by GNATS. From: Marc Fonvieille To: bug-followup@FreeBSD.org Cc: freebsd-doc@FreeBSD.org Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data Date: Mon, 19 Jul 2004 15:38:05 +0200 On Mon, Jul 19, 2004 at 01:32:32PM +0000, Marc Fonvieille wrote: > Synopsis: PATCH-Serial comms chapter has wrong acronym for Transmit Data > > State-Changed-From-To: open->closed > State-Changed-By: blackend > State-Changed-When: Mon Jul 19 13:30:04 GMT 2004 > State-Changed-Why: > I s/SD/TD and s/TxD/TD s/RxD/RD for consistency. > I kept the line description with the "ed" since it's the one used in the > UTI V24 recommendation. Thanks. > grr I meant ITU (International Telecommunication Union). From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 17:02:15 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1A5A316A4CE; Mon, 19 Jul 2004 17:02:15 +0000 (GMT) Received: from mail.elvandar.org (cust.94.120.adsl.cistron.nl [195.64.94.120]) by mx1.FreeBSD.org (Postfix) with ESMTP id 736E743D46; Mon, 19 Jul 2004 17:02:12 +0000 (GMT) (envelope-from remko@elvandar.org) Received: from [10.0.2.122] (nimrod.elvandar.intranet [10.0.2.122]) by mail.elvandar.org (Postfix) with ESMTP id 19FAD106871; Mon, 19 Jul 2004 19:02:09 +0200 (CEST) Message-ID: <40FBFE92.8030304@elvandar.org> Date: Mon, 19 Jul 2004 19:02:10 +0200 From: Remko Lodder X-Accept-Language: en-us, en MIME-Version: 1.0 To: Murray Stokely References: <20040719100354.GA90972@hub.freebsd.org> In-Reply-To: <20040719100354.GA90972@hub.freebsd.org> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Scanned: by amavisd-new at elvandar.org cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 17:02:15 -0000 Hey Murray, doc@ Murray Stokely wrote: > The Handbook is currently organized as 5 distinct DocBook : > > * Getting Started > * Common Tasks > * System Administration > * Network Communication > * Appendices > > I would like to split the Handbook into a User Handbook and an > Administrator Handbook. The first two would belong to the > user handbook, the second two would belong to the > administrator handbook, and the appendices would be shared with both. > Although i am not a doc committer, i still lead the Dutch Documentation project, and i am a member of a team that gives information to new people (educational). In both views i can totally agree with the split you mention. We can offer the Dutch version to our new people, and if they are more grown up in the world of FreeBSD they can start trying the other book. I think that makes a challenge for them. Given that it's easier to know how one should write documentation in it. User-Handbook, not that difficult, Admin-Handbook more advanced topics... and by refering to eachother you can point users to more advanced topics or stay in the User-Handbook > > I propose that the User Handbook remain as 'handbook' in CVS, and that > the admin chapters be repo-copied to 'books/admin-handbook'. > > Each of the two books would then be in the more manageable 400-600 > page range in printed form. :-) that makes it easier for my doc project and the people that are going to read it :-) > > I can perform all of this work, ask for the repo copies, update all > cross links between chapters to use new entities to link between > volumes, and update the prefaces and frontmatter for both volumes. I > can do this in a single day so as to minimize disruption for others > working on the Handbook(s). The preface and frontmatter of the > index.html at www.freebsd.org/handbook would contain a prominent > pointer to the new volume so that people looking for content can still > find it easily. Great :-), as others state, freeze commits for the time you need.. and afterwards continue working on the _new_ documents :-) > > Is there any reason not to go ahead with such a split? Do it please :-) > > - Murray -- Kind regards, Remko Lodder |remko@elvandar.org Reporter DSINet |remko@dsinet.org Projectleader Mostly-Harmless |remko@mostly-harmless.nl From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 17:28:05 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A1FCE16A4CE; Mon, 19 Jul 2004 17:28:05 +0000 (GMT) Received: from volginfo.ru (ns.volginfo.ru [217.23.84.100]) by mx1.FreeBSD.org (Postfix) with ESMTP id E126843D2F; Mon, 19 Jul 2004 17:28:04 +0000 (GMT) (envelope-from den@FreeBSD.org) Received: from FreeBSD.org (llp-13.vistcom.ru [217.23.84.68]) by volginfo.ru (Postfix) with ESMTP id 5DBFD2010; Mon, 19 Jul 2004 21:28:06 +0400 (MSD) Message-ID: <40FC049D.4010902@FreeBSD.org> Date: Mon, 19 Jul 2004 21:27:57 +0400 From: Denis Peplin User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.6) Gecko/20040205 X-Accept-Language: ru, en-us, en MIME-Version: 1.0 To: Murray Stokely References: <20040719100354.GA90972@hub.freebsd.org> In-Reply-To: <20040719100354.GA90972@hub.freebsd.org> Content-Type: multipart/mixed; boundary="------------030401070005040004010705" cc: Hiroki Sato cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 17:28:05 -0000 This is a multi-part message in MIME format. --------------030401070005040004010705 Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Hello! Murray Stokely wrote: > I can perform all of this work, ask for the repo copies, update all > cross links between chapters to use new entities to link between > volumes, and update the prefaces and frontmatter for both volumes. I > can do this in a single day so as to minimize disruption for others > working on the Handbook(s). The preface and frontmatter of the > index.html at www.freebsd.org/handbook would contain a prominent > pointer to the new volume so that people looking for content can still > find it easily. Currently we have one small problem with links between books - relative and absolute links. For example, in printed version of Handbook I see something like: ../faq/some_url.html Some work was recently done by hrs to solve this issue (Thanks again, Hiroki!), but this work is not completely done. Probably it will be better to solve this issue before handbook splitting rather than after. Initial support for urls entities can be simple (see attachment) --------------030401070005040004010705 Content-Type: text/plain; name="urls.diff" Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="urls.diff" Index: urls.ent =================================================================== RCS file: /home/ncvs/doc/share/sgml/urls.ent,v retrieving revision 1.4 diff -u -r1.4 urls.ent --- urls.ent 7 Jul 2004 11:23:16 -0000 1.4 +++ urls.ent 19 Jul 2004 17:27:02 -0000 @@ -50,3 +50,6 @@ + + + --------------030401070005040004010705-- From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 17:43:16 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 84ADB16A4CE; Mon, 19 Jul 2004 17:43:16 +0000 (GMT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5DF7D43D2F; Mon, 19 Jul 2004 17:43:15 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) i6JHhD0L035314; Mon, 19 Jul 2004 19:43:13 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.11/8.12.11/Submit) id i6JHhD0F035313; Mon, 19 Jul 2004 19:43:13 +0200 (CEST) (envelope-from marc) Date: Mon, 19 Jul 2004 19:43:12 +0200 From: Marc Fonvieille To: Murray Stokely Message-ID: <20040719174312.GC22044@abigail.blackend.org> References: <20040719100354.GA90972@hub.freebsd.org> <20040719102831.GA33180@eddie.nitro.dk> <20040719104940.GA95183@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040719104940.GA95183@hub.freebsd.org> User-Agent: Mutt/1.4.2.1i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.10-PRERELEASE cc: doc@FreeBSD.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 17:43:16 -0000 On Mon, Jul 19, 2004 at 10:49:40AM +0000, Murray Stokely wrote: > On Mon, Jul 19, 2004 at 12:28:31PM +0200, Simon L. Nielsen wrote: > > I would suggest announcing the change a bit in advance and the doing a > > freeze for commits to the handbook during the change, to avoid making it > > more difficualt than necessary. > > Good idea. > > > Since a lot of people expect just to look in the "Handbook" and people > > have have direct links into to it, I think the notice of the change > > should be published so as many people as possible get the heads up. > > Perhaps even on announce@. > > Yes I think you are right. We should put a news item up on our front > page, and I think it is worth a post to announce@. > > > instead of giving people a 404 error. I think it should be fairly > > trivial to auto generate those HTML files. It would require doing > > something special with for the build dir on www.FreeBSD.org, but I think > > it's worth it to avoid confusing users with dead links. > > Yes, that's an excellent idea and I think it's something we could whip > up in a perl script or similar. Indeed countless sites, articles, books use the "old" urls and it'll take times before everything use new links. We had the same problem when the Handbook and faq urls "changed" to doc//books/handbook etc... Another thing, if you do a repocopy of images and remove previous ones for the admin book, this will break localized versions of the Handbook using these images. Maybe we could let some time to translation teams to update their version and remove the images later. Marc From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 18:06:16 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D010216A59A for ; Mon, 19 Jul 2004 18:06:16 +0000 (GMT) Received: from odin.ac.hmc.edu (Odin.AC.HMC.Edu [134.173.32.75]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8F3BB43D4C for ; Mon, 19 Jul 2004 18:06:16 +0000 (GMT) (envelope-from brdavis@odin.ac.hmc.edu) Received: from odin.ac.hmc.edu (IDENT:brdavis@localhost.localdomain [127.0.0.1]) by odin.ac.hmc.edu (8.12.10/8.12.10) with ESMTP id i6JI5uOF028853; Mon, 19 Jul 2004 11:05:56 -0700 Received: (from brdavis@localhost) by odin.ac.hmc.edu (8.12.10/8.12.3/Submit) id i6JI5nUR028849; Mon, 19 Jul 2004 11:05:49 -0700 Date: Mon, 19 Jul 2004 11:05:49 -0700 From: Brooks Davis To: Remko Lodder Message-ID: <20040719180549.GB14144@Odin.AC.HMC.Edu> References: <40FA6080.2040702@elvandar.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="tjCHc7DPkfUGtrlw" Content-Disposition: inline In-Reply-To: <40FA6080.2040702@elvandar.org> User-Agent: Mutt/1.5.4i cc: doc@freebsd.org Subject: Re: Question about the introduction chapter: X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 18:06:17 -0000 --tjCHc7DPkfUGtrlw Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sun, Jul 18, 2004 at 01:35:28PM +0200, Remko Lodder wrote: > All the 'FreeBSD x mailing list' items resolve to a pointing=20 > towards the http://lists.freebsd.org/mailman/listinfo/x location. > Only the entry above has 'FreeBSD committer's mailing list' which is=20 > defined as &a.committers; in the chapter.sgml. Shouldn't that expand to= =20 > a thingy as well? Or is it being done on purpose that the=20 > Commiters mailing list is not 'ed? >=20 > Could someone explain it to me? And if it need to be changed i am=20 > willing to send-pr it, so it does not get lost in the huge pile :-) The committers list is not publicly accessible and is not a mailman list so there's nothing to link to. -- Brooks --=20 Any statement of the form "X is the one, true Y" is FALSE. PGP fingerprint 655D 519C 26A7 82E7 2529 9BF0 5D8E 8BE9 F238 1AD4 --tjCHc7DPkfUGtrlw Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (GNU/Linux) iD8DBQFA/A18XY6L6fI4GtQRAthaAKDR86KtnMnC1L0XoyV9d29zseXJ6wCgx7R6 aIroX0ABEBZBK+/7P1csfvg= =Yy3g -----END PGP SIGNATURE----- --tjCHc7DPkfUGtrlw-- From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 23:55:30 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id EF67016A4CE for ; Mon, 19 Jul 2004 23:55:30 +0000 (GMT) Received: from sccrmhc11.comcast.net (sccrmhc11.comcast.net [204.127.202.55]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9724E43D1D for ; Mon, 19 Jul 2004 23:55:30 +0000 (GMT) (envelope-from zettel@acm.org) Received: from [192.168.0.6] (bgp966574bgs.derbrn01.mi.comcast.net[68.41.108.205]) by comcast.net (sccrmhc11) with ESMTP id <2004071923552901100svvqje>; Mon, 19 Jul 2004 23:55:30 +0000 From: Leonard Zettel To: freebsd-doc@freebsd.org Date: Mon, 19 Jul 2004 19:56:14 -0400 User-Agent: KMail/1.6.2 References: <200406032310.12551.zettel@acm.org> <20040716083713.GD858@straylight.m.ringlet.net> <200407160802.46405.zettel@acm.org> In-Reply-To: <200407160802.46405.zettel@acm.org> MIME-Version: 1.0 Content-Disposition: inline Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Message-Id: <200407191956.14591.zettel@acm.org> Subject: Re: Suggested rewrite of "FreeBSD Documentation Project: SGML" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Jul 2004 23:55:31 -0000 On Friday 16 July 2004 08:02 am, Leonard Zettel wrote: > On Friday 16 July 2004 04:37 am, Peter Pentchev wrote: > > On Thu, Jun 03, 2004 at 11:10:12PM -0400, Leonard Zettel wrote: > > > http://www.lenzettel.com/freebsd/sgml.html > > > > > > Questions, comments, criticisms? > > > > I like it at a first read, but it is somewhat difficult to see exactly > > what changes you have made (the ones in the first couple of sentences > > are obvious). Could you try to check out the FreeBSD Web site sources > > from the CVS repository, edit the www/en/docproj/sgml.sgml file to > > include your changes, and then send us a patch (or at least your version > > of the sgml.sgml file) so we can comment on the changes themselves? :) > > > > Thanks for your efforts so far! > > Thank you for your kind words! As an absolute newbie to FreeBSD, > it has been a real struggle trying to wade through the procedural > thicket to get a modified sgml file. But I'm working on it! > I have downloaded and installed textproc/docproj. I have also gotten a local copy of the documentation tree. Unfortunately, when I do nsgmls -s book.sgml I get a ton of error messages, the first couple of which are: nsgmls:/usr/local/share/sgml/docbook/4.1/dbcent.mod:54:0:E: cannot open "/usr/local/share/sgml/docbook/4.1/iso-amsa.gml" (No such file or directory) nsgmls:/usr/local/share/sgml/docbook/4.1/dbcent.mod:61:0:E: cannot open "/usr/local/share/sgml/docbook/4.1/iso-amsb.gml" (No such file or directory) etc. My surmise is that there are a bunch of necessary files that 1) I don't have or 2) don't have in the expected place. Pointers to remedies would be greatly appreciated. -LenZ- > > G'luck, > > Can always use that - thanks. > -LenZ- > > > Peter > > _______________________________________________ > 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" From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 06:14:21 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 602BD16A4CE for ; Tue, 20 Jul 2004 06:14:21 +0000 (GMT) Received: from www05.intervision.co.il (www05.intervision.co.il [80.244.161.195]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0F86343D1F for ; Tue, 20 Jul 2004 06:14:20 +0000 (GMT) (envelope-from feedback4@plastelina.net) Received: from www05.intervision.co.il (localhost.localdomain [127.0.0.1]) i6K6J6l5012629 for ; Tue, 20 Jul 2004 09:19:06 +0300 Date: Tue, 20 Jul 2004 09:19:06 +0300 Message-Id: <200407200619.i6K6J6l5012629@www05.intervision.co.il> To: doc@freebsd.org From: feedback4@plastelina.net Precedence: junk X-Loop: feedback4@plastelina.net Subject: re-feedback X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Reply-To: feedback4@plastelina.net List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 06:14:21 -0000 Hi Thank you very much for your feedback about our games. it makes it more fun to do more games... Did you play all Plastelina games ??? Play now at: http://www.plastelina.net/games Are you already a Plastelina member ? Be A Member of www.plastelina.net (Becoming a member now, is FREE of charge) and you will get: >>> New free games delivered to your e-mail directly. >>> Solutions for games. >>> Downloads of games. >>> Updates & new features to come. >>> 50% discount for a Player Password. Visit our website for more details: http://www.plastelina.net Thank you & Have a great day!! Plastelina team. From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 10:13:24 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 42BC316A4CE; Tue, 20 Jul 2004 10:13:24 +0000 (GMT) Received: from volginfo.ru (ns.volginfo.ru [217.23.84.100]) by mx1.FreeBSD.org (Postfix) with ESMTP id 77EE843D58; Tue, 20 Jul 2004 10:13:23 +0000 (GMT) (envelope-from den@FreeBSD.org) Received: from FreeBSD.org (llp-13.vistcom.ru [217.23.84.68]) by volginfo.ru (Postfix) with ESMTP id 379A72010; Tue, 20 Jul 2004 14:13:24 +0400 (MSD) Message-ID: <40FCF042.6020102@FreeBSD.org> Date: Tue, 20 Jul 2004 14:13:22 +0400 From: Denis Peplin User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.6) Gecko/20040205 X-Accept-Language: ru, en-us, en MIME-Version: 1.0 To: Ken Smith References: <20040719100354.GA90972@hub.freebsd.org> <20040719133250.GA5522@electra.cse.Buffalo.EDU> In-Reply-To: <20040719133250.GA5522@electra.cse.Buffalo.EDU> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 10:13:24 -0000 Hello! Ken Smith wrote: > On Mon, Jul 19, 2004 at 10:03:54AM +0000, Murray Stokely wrote: > >>I think the time has come to split up the Handbook. It has grown >>unchecked for far too long and it has been several years since we last >>moved chapters out of the Handbook (and into the Developers Handbook >>in that case). >> >>The Handbook is currently organized as 5 distinct DocBook : >> >>* Getting Started >>* Common Tasks >>* System Administration >>* Network Communication >>* Appendices >> >>I would like to split the Handbook into a User Handbook and an >>Administrator Handbook. The first two would belong to the >>user handbook, the second two would belong to the >>administrator handbook, and the appendices would be shared with both. > > > I'm not against doing a split-up at all, and am definitely in favor > of the general theme of the split - user docs versus admin docs. > > My only thought is that if time/energy is available perhaps a closer look > at what goes where might be good. My general outlook on life is that > "User Docs" == "Stuff that doesn't require root", "Admin Docs" == "Stuff > that does require root (or the installation CD)". OK, let start voting! Handbook split will probably require some additional docs moving, for example i vote for: "Configuring the FreeBSD Kernel" - move to admins section (nowadays not every user require this - for example, on my FreeBSD desktop i have GENERIC kernel). Most content from "Linux Binary Compatibility" is advanced topic too (if i want to install common Linux binary, i will install it from ports). And for users handbook: many sections from "Configuration and Tuning", 16.6 Creating and Using Optical Media (CDs), 16.7 Creating and Using Optical Media (DVDs), 21.2 Using User PPP and this list is not near to complete.... From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 10:34:04 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 679EF16A4CF; Tue, 20 Jul 2004 10:34:04 +0000 (GMT) Date: Tue, 20 Jul 2004 10:34:04 +0000 From: Murray Stokely To: Denis Peplin Message-ID: <20040720103404.GA5405@hub.freebsd.org> References: <20040719100354.GA90972@hub.freebsd.org> <40FC049D.4010902@FreeBSD.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <40FC049D.4010902@FreeBSD.org> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: Hiroki Sato cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 10:34:04 -0000 On Mon, Jul 19, 2004 at 09:27:57PM +0400, Denis Peplin wrote: > Currently we have one small problem with links between books - > relative and absolute links. For example, in printed version of > Handbook I see something like: ../faq/some_url.html > > Some work was recently done by hrs to solve this issue (Thanks again, > Hiroki!), but this work is not completely done. > > Probably it will be better to solve this issue before handbook > splitting rather than after. It's true that this work needs to be done, but I don't see why it needs to hold up the handbook split any more than any of the other countless issues on our todo lists. Splitting the handbook won't make it any harder, because I'm going to use an entity to refer to the other book anyway, so we can just update that entity with the preferred absolute/relative link fix as appropriate. In our Perforce repository we've turned all of these relative links into absolute ones. I never merged it to CVS because I was waiting for someone to do something like what Hiroki has done. I can help you and him finish up this great work after the Handbook split. > + > + Cool. - Murray From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 10:34:38 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 46EAF16A4CE; Tue, 20 Jul 2004 10:34:38 +0000 (GMT) Received: from jc.ngo.org.uk (jc.ngo.org.uk [69.55.225.33]) by mx1.FreeBSD.org (Postfix) with ESMTP id EAAF043D1F; Tue, 20 Jul 2004 10:34:36 +0000 (GMT) (envelope-from nik@crf-consulting.co.uk) Received: from crf-consulting.co.uk (82-44-220-218.cable.ubr10.haye.blueyonder.co.uk [82.44.220.218]) by jc.ngo.org.uk (8.12.11/8.12.11) with ESMTP id i6KAYZc0017278; Tue, 20 Jul 2004 03:34:36 -0700 (PDT) (envelope-from nik@crf-consulting.co.uk) Received: from clan.nothing-going-on.org (clan.nothing-going-on.org [192.168.1.20])i6KAYYrK038395; Tue, 20 Jul 2004 11:34:34 +0100 (BST) (envelope-from nik@catkin) Received: from clan.nothing-going-on.org (localhost [127.0.0.1]) i6KAYXQ8065036; Tue, 20 Jul 2004 11:34:33 +0100 (BST) (envelope-from nik@clan.nothing-going-on.org) Received: (from nik@localhost)i6KAYXsO065035; Tue, 20 Jul 2004 11:34:33 +0100 (BST) (envelope-from nik) Date: Tue, 20 Jul 2004 11:34:33 +0100 From: Nik Clayton To: Murray Stokely Message-ID: <20040720103432.GA64597@clan.nothing-going-on.org> References: <20040719100354.GA90972@hub.freebsd.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="liOOAslEiF7prFVr" Content-Disposition: inline In-Reply-To: <20040719100354.GA90972@hub.freebsd.org> User-Agent: Mutt/1.4.2.1i Organization: FreeBSD Project cc: doc@FreeBSD.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 10:34:38 -0000 --liOOAslEiF7prFVr Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Jul 19, 2004 at 10:03:54AM +0000, Murray Stokely wrote: > I think the time has come to split up the Handbook. =20 &deja.vu; Yes, with a reservation. Specifically, is there a description anywhere of what constitutes a user task and what's an admin task? Looking over the existing Handbook, all of the following (notionally in the 'user' section) strike me as being admin tasks: Chapter 4 - Installing Applications Chapter 8 - Configuring the FreeBSD Kernel Chapter 10 - Linux Binary Compatability Last time this sort of thing came up, we discussed making the split along task-oriented lines, potentially leading to several smaller handbooks, rather than the two books that you're suggesting. This has been on the backburner for a *long* time: http://groups.google.com/groups?hl=3Den&lr=3D&ie=3DUTF-8&threadm=3D1999= 0405234615.B6083%40catkin.nothing-going-on.org&rnum=3D9&prev=3D/groups%3Fq%= 3Dfreebsd%2Bhandbook%2Bsplit%2Bclayton%26hl%3Den%26lr%3D%26ie%3DUTF-8%26sel= m%3D19990405234615.B6083%2540catkin.nothing-going-on.org%26rnum%3D9 So consider this one last stab at getting someone to implement that idea. Failing that, your willingness to do the work you've outlined trumps my kvetching from the sidelines :-) N --=20 FreeBSD: The Power to Serve http://www.freebsd.org/ (__) FreeBSD Documentation Project http://www.freebsd.org/docproj/ \\\'',) \/ \= ^ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- .\._/= _) --liOOAslEiF7prFVr Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA/PU4k6gHZCw343URAq/xAJsF71UtnSCnKtaN0zbCydX56KlhHgCfWnaf 6Dz32C4UAhckYtJ4QvvTKlM= =jKec -----END PGP SIGNATURE----- --liOOAslEiF7prFVr-- From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 10:45:01 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 32B4916A4CF; Tue, 20 Jul 2004 10:45:01 +0000 (GMT) Date: Tue, 20 Jul 2004 10:45:01 +0000 From: Murray Stokely To: Nik Clayton Message-ID: <20040720104501.GB5405@hub.freebsd.org> References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040720103432.GA64597@clan.nothing-going-on.org> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: doc@FreeBSD.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 10:45:01 -0000 On Tue, Jul 20, 2004 at 11:34:33AM +0100, Nik Clayton wrote: > &deja.vu; Yea, I was here for many earlier conversations about this. > Yes, with a reservation. Specifically, is there a description > anywhere of what constitutes a user task and what's an admin task? > > Looking over the existing Handbook, all of the following (notionally in > the 'user' section) strike me as being admin tasks: > > Chapter 4 - Installing Applications > Chapter 8 - Configuring the FreeBSD Kernel > Chapter 10 - Linux Binary Compatability I think I'd prefer to work on a definition of user vs admin task. It's true that these are admin tasks, but these are really some of the first things that people need to know about FreeBSD. > Last time this sort of thing came up, we discussed making the split > along task-oriented lines, potentially leading to several smaller > handbooks, rather than the two books that you're suggesting. Yea I remember discussing this with you many times, but I also know that you prefer smaller divisions than I do. > So consider this one last stab at getting someone to implement that > idea. Failing that, your willingness to do the work you've outlined > trumps my kvetching from the sidelines :-) I can't reach that sight right now (in China and not using a proxy -- maybe someone recently posted something about Falung Gong on groups.google.com), but I'm sure I've read it in previous years. I didn't agree with your vision for a series of much smaller handbooks (some the size of a single chapter we have now, less than 100 pages printed) then and I haven't come around to it after several more years of the Handbook growing. Regardless, even if others agree with your vision, then you can look at this as a first step and still get support and do the work for your own further split at some later date. I have done the work in Perforce and am talking about moving us CLOSER to your goal (and all the way to my goal) right now. - Murray From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 11:02:36 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0658D16A4CE; Tue, 20 Jul 2004 11:02:36 +0000 (GMT) Received: from volginfo.ru (ns.volginfo.ru [217.23.84.100]) by mx1.FreeBSD.org (Postfix) with ESMTP id A42AA43D39; Tue, 20 Jul 2004 11:02:35 +0000 (GMT) (envelope-from den@FreeBSD.org) Received: from FreeBSD.org (llp-13.vistcom.ru [217.23.84.68]) by volginfo.ru (Postfix) with ESMTP id 87EAD2010; Tue, 20 Jul 2004 15:02:36 +0400 (MSD) Message-ID: <40FCFBCA.9050409@FreeBSD.org> Date: Tue, 20 Jul 2004 15:02:34 +0400 From: Denis Peplin User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.6) Gecko/20040205 X-Accept-Language: ru, en-us, en MIME-Version: 1.0 To: Murray Stokely References: <20040719100354.GA90972@hub.freebsd.org> <40FC049D.4010902@FreeBSD.org> <20040720103404.GA5405@hub.freebsd.org> In-Reply-To: <20040720103404.GA5405@hub.freebsd.org> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit cc: Hiroki Sato cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 11:02:36 -0000 This will not stop us, modified patch ready Was sent to doc-committers@, also available here: http://people.freebsd.org/~den/misc/tmp/200704_urls.diff Murray Stokely wrote: > On Mon, Jul 19, 2004 at 09:27:57PM +0400, Denis Peplin wrote: > >>Currently we have one small problem with links between books - >>relative and absolute links. For example, in printed version of >>Handbook I see something like: ../faq/some_url.html >> >>Some work was recently done by hrs to solve this issue (Thanks again, >>Hiroki!), but this work is not completely done. >> >>Probably it will be better to solve this issue before handbook >>splitting rather than after. > > > It's true that this work needs to be done, but I don't see why it > needs to hold up the handbook split any more than any of the other > countless issues on our todo lists. Splitting the handbook won't make > it any harder, because I'm going to use an entity to refer to the > other book anyway, so we can just update that entity with the > preferred absolute/relative link fix as appropriate. > > In our Perforce repository we've turned all of these relative links > into absolute ones. I never merged it to CVS because I was waiting > for someone to do something like what Hiroki has done. I can help you > and him finish up this great work after the Handbook split. > > >>+ >>+ > > > Cool. > > - Murray > > From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 12:43:39 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3C81516A4CF; Tue, 20 Jul 2004 12:43:39 +0000 (GMT) Received: from electra.cse.Buffalo.EDU (electra.cse.Buffalo.EDU [128.205.32.2]) by mx1.FreeBSD.org (Postfix) with ESMTP id E572243D1D; Tue, 20 Jul 2004 12:43:38 +0000 (GMT) (envelope-from kensmith@cse.Buffalo.EDU) Received: from electra.cse.Buffalo.EDU (kensmith@localhost [127.0.0.1]) i6KChcTH008674; Tue, 20 Jul 2004 08:43:38 -0400 (EDT) Received: (from kensmith@localhost) by electra.cse.Buffalo.EDU (8.12.10/8.12.9/Submit) id i6KChcDO008673; Tue, 20 Jul 2004 08:43:38 -0400 (EDT) Date: Tue, 20 Jul 2004 08:43:38 -0400 From: Ken Smith To: Murray Stokely Message-ID: <20040720124337.GA8096@electra.cse.Buffalo.EDU> References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> <20040720104501.GB5405@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040720104501.GB5405@hub.freebsd.org> User-Agent: Mutt/1.4.1i cc: doc@freebsd.org cc: Nik Clayton Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 12:43:39 -0000 On Tue, Jul 20, 2004 at 10:45:01AM +0000, Murray Stokely wrote: > > Looking over the existing Handbook, all of the following (notionally in > > the 'user' section) strike me as being admin tasks: > > > > Chapter 4 - Installing Applications > > Chapter 8 - Configuring the FreeBSD Kernel > > Chapter 10 - Linux Binary Compatability > > I think I'd prefer to work on a definition of user vs admin task. > It's true that these are admin tasks, but these are really some of the > first things that people need to know about FreeBSD. One last wimper, then I'll shut up - it's really not worth an argument. :-) IMHO then you're not really interested in a definition of user vs admin task (which is fine). You're interested in clumping things more people are likely to need in the first volume (which is fine). I think what we really need to answer is who we expect Joe Average Handbook Reader to be. If it's a typical-ish home user then your approach definitely makes sense - clump "the first things that people need to know" together and this sort of person is by definition both user and admin so this isn't horrible. If it's a more corporate or otherwise large-site audience this isn't necessarily the best split. If I received a box with media and two books in it for a new OS we were thinking about using I'd grab the admin guide on the way out the door for the day planning to do a little evening reading and I'd be annoyed if it didn't include the Install docs. I'd also be scared that "they" expect normal users to install the OS and applications, one of my reasons for considering this OS is getting away from an environment where users can easily dammage the system... :-) Sounds like you expect Joe Average Handbook Reader to be the home user type, correct? -- Ken Smith - From there to here, from here to | kensmith@cse.buffalo.edu there, funny things are everywhere. | - Theodore Geisel | From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 13:11:23 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id CA4F916A4CE for ; Tue, 20 Jul 2004 13:11:23 +0000 (GMT) Received: from mbox.ibctech.ca (dev.eagle.ca [209.167.58.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0058143D39 for ; Tue, 20 Jul 2004 13:11:22 +0000 (GMT) (envelope-from iaccounts@ibctech.ca) Received: (qmail 78059 invoked by uid 1002); 20 Jul 2004 13:11:22 -0000 Received: from iaccounts@ibctech.ca by pearl.ibctech.ca by uid 89 with qmail-scanner-1.22 (clamscan: 0.73. spamassassin: 2.63. Clear:RC:1(127.0.0.1):. Processed in 1.037636 secs); 20 Jul 2004 13:11:22 -0000 Received: from unknown (HELO webmail.ibctech.ca) (127.0.0.1) by localhost.ibctech.ca with SMTP; 20 Jul 2004 13:11:20 -0000 Received: from 209.167.16.15 (SquirrelMail authenticated user steve@ibctech.ca); by webmail.ibctech.ca with HTTP; Tue, 20 Jul 2004 09:11:21 -0400 (EDT) Message-ID: <3157.209.167.16.15.1090329081.squirrel@209.167.16.15> In-Reply-To: <20040720103432.GA64597@clan.nothing-going-on.org> References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> Date: Tue, 20 Jul 2004 09:11:21 -0400 (EDT) From: "Steve Bertrand" To: "Nik Clayton" User-Agent: SquirrelMail/1.4.3a X-Mailer: SquirrelMail/1.4.3a MIME-Version: 1.0 Content-Type: text/plain;charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Priority: 3 (Normal) Importance: Normal cc: freebsd-doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 13:11:23 -0000 > On Mon, Jul 19, 2004 at 10:03:54AM +0000, Murray Stokely wrote: >> I think the time has come to split up the Handbook. > > &deja.vu; > > Yes, with a reservation. Specifically, is there a description > anywhere of what constitutes a user task and what's an admin task? Is there a way to compile statistics on the most frequently asked user-type questions, and the most common admin-type questions out of the mailing lists? Is there any way to poll our lists/web visitors and ask THEM what THEY think constitutes a user or admin section? Maybe the users/admins of FreeBSD would provide the best feedback and insight to the doc-team so there is some sort of consensus on it. Just my $.02 Steve > > Looking over the existing Handbook, all of the following (notionally in > the 'user' section) strike me as being admin tasks: > > Chapter 4 - Installing Applications > Chapter 8 - Configuring the FreeBSD Kernel > Chapter 10 - Linux Binary Compatability > > Last time this sort of thing came up, we discussed making the split > along task-oriented lines, potentially leading to several smaller > handbooks, rather than the two books that you're suggesting. > > This has been on the backburner for a *long* time: > > http://groups.google.com/groups?hl=en&lr=&ie=UTF-8&threadm=19990405234615.B6083%40catkin.nothing-going-on.org&rnum=9&prev=/groups%3Fq%3Dfreebsd%2Bhandbook%2Bsplit%2Bclayton%26hl%3Den%26lr%3D%26ie%3DUTF-8%26selm%3D19990405234615.B6083%2540catkin.nothing-going-on.org%26rnum%3D9 > > So consider this one last stab at getting someone to implement that > idea. Failing that, your willingness to do the work you've outlined > trumps my kvetching from the sidelines :-) > > N > -- > FreeBSD: The Power to Serve http://www.freebsd.org/ > (__) > FreeBSD Documentation Project http://www.freebsd.org/docproj/ > \\\'',) > \/ > \ ^ > --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- > .\._/_) > From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 13:29:14 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 4DE2916A4CF; Tue, 20 Jul 2004 13:29:14 +0000 (GMT) Date: Tue, 20 Jul 2004 13:29:14 +0000 From: Murray Stokely To: Ken Smith Message-ID: <20040720132914.GA17260@hub.freebsd.org> References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> <20040720104501.GB5405@hub.freebsd.org> <20040720124337.GA8096@electra.cse.Buffalo.EDU> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040720124337.GA8096@electra.cse.Buffalo.EDU> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: doc@freebsd.org cc: Nik Clayton Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 13:29:14 -0000 On Tue, Jul 20, 2004 at 08:43:38AM -0400, Ken Smith wrote: > IMHO then you're not really interested in a definition of user vs admin > task (which is fine). You're interested in clumping things more people > are likely to need in the first volume (which is fine). Yes. > Sounds like you expect Joe Average Handbook Reader to be the home > user type, correct? Yes, when we get to the end goal, maybe something more along the lines that Nik is talking about, then we can have multiple volumes that share some chapters (such as installation) between them. I think that would be ideal. I think that going from one 900 page beheamoth to that ideal in one shot and getting everyone to agree on the contents of the different volumes and the architecture for the whole thing would be a logistical nightmare, so I prefer to take baby steps that we can actually achieve in the short term. When we split up the book it makes the omissions stand out. We have woefully little about setting up and maintaining webservers in our Handbook, which is one of the most common uses of FreeBSD. That kind of gets lost after 10 chapters of installating, the ports tree, unix basics, and X Windows, but it really starts to stand out when you split those basic prerequisites out. I think we'll see more content submissions once we split up the Handbook and make it more accessible. - Murray From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 13:29:47 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 684B816A4CF; Tue, 20 Jul 2004 13:29:47 +0000 (GMT) Date: Tue, 20 Jul 2004 13:29:47 +0000 From: Murray Stokely To: Denis Peplin Message-ID: <20040720132947.GB17260@hub.freebsd.org> References: <20040719100354.GA90972@hub.freebsd.org> <40FC049D.4010902@FreeBSD.org> <20040720103404.GA5405@hub.freebsd.org> <40FCFBCA.9050409@FreeBSD.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <40FCFBCA.9050409@FreeBSD.org> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: Hiroki Sato cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 13:29:47 -0000 On Tue, Jul 20, 2004 at 03:02:34PM +0400, Denis Peplin wrote: > http://people.freebsd.org/~den/misc/tmp/200704_urls.diff Excelent, I'll take a look. You meant 200407_urls.diff perhaps? - Murray From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 13:33:54 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5FFA316A4CE; Tue, 20 Jul 2004 13:33:54 +0000 (GMT) Received: from sccrmhc13.comcast.net (sccrmhc13.comcast.net [204.127.202.64]) by mx1.FreeBSD.org (Postfix) with ESMTP id E94B543D49; Tue, 20 Jul 2004 13:33:53 +0000 (GMT) (envelope-from zettel@acm.org) Received: from [192.168.0.6] (bgp966574bgs.derbrn01.mi.comcast.net[68.41.108.205]) by comcast.net (sccrmhc13) with ESMTP id <2004072013335301600bbupse>; Tue, 20 Jul 2004 13:33:53 +0000 From: Leonard Zettel To: freebsd-doc@freebsd.org Date: Tue, 20 Jul 2004 09:34:35 -0400 User-Agent: KMail/1.6.2 References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> <3157.209.167.16.15.1090329081.squirrel@209.167.16.15> In-Reply-To: <3157.209.167.16.15.1090329081.squirrel@209.167.16.15> MIME-Version: 1.0 Content-Disposition: inline Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Message-Id: <200407200934.35643.zettel@acm.org> cc: Nik Clayton Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 13:33:54 -0000 On Tuesday 20 July 2004 09:11 am, Steve Bertrand wrote: > > On Mon, Jul 19, 2004 at 10:03:54AM +0000, Murray Stokely wrote: > >> I think the time has come to split up the Handbook. > > > > &deja.vu; > > > > Yes, with a reservation. Specifically, is there a description > > anywhere of what constitutes a user task and what's an admin task? > If this outsider may be allowed $.02---- To my mind, an "admin" task is one performed primarily to help/mange users of the system other than one's self. =46rom a human/organizational viewpoint, this is indeed a fundamental dichotomy. At the same time, one could well question whether the tasks of handling FreeBSD really split up along those lines in any fundamental way. -LenZ- =20 > Is there a way to compile statistics on the most frequently asked > user-type questions, and the most common admin-type questions out of the > mailing lists? > > Is there any way to poll our lists/web visitors and ask THEM what THEY > think constitutes a user or admin section? > > Maybe the users/admins of FreeBSD would provide the best feedback and > insight to the doc-team so there is some sort of consensus on it. > > Just my $.02 > > Steve > > > Looking over the existing Handbook, all of the following (notionally in > > the 'user' section) strike me as being admin tasks: > > > > Chapter 4 - Installing Applications > > Chapter 8 - Configuring the FreeBSD Kernel > > Chapter 10 - Linux Binary Compatability > > > > Last time this sort of thing came up, we discussed making the split > > along task-oriented lines, potentially leading to several smaller > > handbooks, rather than the two books that you're suggesting. > > > > This has been on the backburner for a *long* time: > > > > =20 > > http://groups.google.com/groups?hl=3Den&lr=3D&ie=3DUTF-8&threadm=3D1999= 0405234615 > >.B6083%40catkin.nothing-going-on.org&rnum=3D9&prev=3D/groups%3Fq%3Dfreeb= sd%2Bh > >andbook%2Bsplit%2Bclayton%26hl%3Den%26lr%3D%26ie%3DUTF-8%26selm%3D199904= 05 > >234615.B6083%2540catkin.nothing-going-on.org%26rnum%3D9 > > > > So consider this one last stab at getting someone to implement that > > idea. Failing that, your willingness to do the work you've outlined > > trumps my kvetching from the sidelines :-) > > > > N > > -- > > FreeBSD: The Power to Serve http://www.freebsd.org/ > > (__) > > FreeBSD Documentation Project http://www.freebsd.org/docproj/ > > \\\'',) > > \/ > > \ ^ > > --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- > > .\._/_) > > _______________________________________________ > 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" From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 13:43:15 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E304816A4CE; Tue, 20 Jul 2004 13:43:15 +0000 (GMT) Received: from electra.cse.Buffalo.EDU (electra.cse.Buffalo.EDU [128.205.32.2]) by mx1.FreeBSD.org (Postfix) with ESMTP id 90EFB43D5F; Tue, 20 Jul 2004 13:43:15 +0000 (GMT) (envelope-from kensmith@cse.Buffalo.EDU) Received: from electra.cse.Buffalo.EDU (kensmith@localhost [127.0.0.1]) i6KDhDTH010164; Tue, 20 Jul 2004 09:43:14 -0400 (EDT) Received: (from kensmith@localhost) by electra.cse.Buffalo.EDU (8.12.10/8.12.9/Submit) id i6KDhDi3010163; Tue, 20 Jul 2004 09:43:13 -0400 (EDT) Date: Tue, 20 Jul 2004 09:43:13 -0400 From: Ken Smith To: Murray Stokely Message-ID: <20040720134313.GG8096@electra.cse.Buffalo.EDU> References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> <20040720104501.GB5405@hub.freebsd.org> <20040720124337.GA8096@electra.cse.Buffalo.EDU> <20040720132914.GA17260@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040720132914.GA17260@hub.freebsd.org> User-Agent: Mutt/1.4.1i cc: doc@FreeBSD.ORG cc: Ken Smith cc: Nik Clayton Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 13:43:16 -0000 On Tue, Jul 20, 2004 at 01:29:14PM +0000, Murray Stokely wrote: > On Tue, Jul 20, 2004 at 08:43:38AM -0400, Ken Smith wrote: > > IMHO then you're not really interested in a definition of user vs admin > > task (which is fine). You're interested in clumping things more people > > are likely to need in the first volume (which is fine). > > Yes. > > > Sounds like you expect Joe Average Handbook Reader to be the home > > user type, correct? > > Yes, ... Thanks, that clarifies the immediate goals as well as future directions. It all sounds great to me in this context. -- Ken Smith - From there to here, from here to | kensmith@cse.buffalo.edu there, funny things are everywhere. | - Theodore Geisel | From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 13:58:00 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 00BE716A4CE; Tue, 20 Jul 2004 13:58:00 +0000 (GMT) Received: from volginfo.ru (ns.volginfo.ru [217.23.84.100]) by mx1.FreeBSD.org (Postfix) with ESMTP id 49ED543D53; Tue, 20 Jul 2004 13:57:59 +0000 (GMT) (envelope-from den@FreeBSD.org) Received: from FreeBSD.org (llp-13.vistcom.ru [217.23.84.68]) by volginfo.ru (Postfix) with ESMTP id A47742015; Tue, 20 Jul 2004 17:57:54 +0400 (MSD) Message-ID: <40FD24DE.8090008@FreeBSD.org> Date: Tue, 20 Jul 2004 17:57:50 +0400 From: Denis Peplin User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.6) Gecko/20040205 X-Accept-Language: ru, en-us, en MIME-Version: 1.0 To: Murray Stokely References: <20040719100354.GA90972@hub.freebsd.org> <40FC049D.4010902@FreeBSD.org> <20040720103404.GA5405@hub.freebsd.org> <40FCFBCA.9050409@FreeBSD.org> <20040720132947.GB17260@hub.freebsd.org> In-Reply-To: <20040720132947.GB17260@hub.freebsd.org> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit cc: Hiroki Sato cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 13:58:00 -0000 Hello! Murray Stokely wrote: > On Tue, Jul 20, 2004 at 03:02:34PM +0400, Denis Peplin wrote: > >>http://people.freebsd.org/~den/misc/tmp/200704_urls.diff > > > Excelent, I'll take a look. You meant 200407_urls.diff perhaps? no, it was DDMMYY, but some confusing :) From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 14:08:06 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4B35A16A4CE; Tue, 20 Jul 2004 14:08:06 +0000 (GMT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0E69043D55; Tue, 20 Jul 2004 14:08:05 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) i6KE80Jh073315; Tue, 20 Jul 2004 16:08:00 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.11/8.12.11/Submit) id i6KE7x9r073314; Tue, 20 Jul 2004 16:07:59 +0200 (CEST) (envelope-from marc) Date: Tue, 20 Jul 2004 16:07:59 +0200 From: Marc Fonvieille To: Ken Smith Message-ID: <20040720140759.GA69951@abigail.blackend.org> References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> <20040720104501.GB5405@hub.freebsd.org> <20040720124337.GA8096@electra.cse.Buffalo.EDU> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040720124337.GA8096@electra.cse.Buffalo.EDU> User-Agent: Mutt/1.4.2.1i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.10-PRERELEASE cc: Nik Clayton cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 14:08:06 -0000 On Tue, Jul 20, 2004 at 08:43:38AM -0400, Ken Smith wrote: > > One last wimper, then I'll shut up - it's really not worth an argument. :-) > > IMHO then you're not really interested in a definition of user vs admin > task (which is fine). You're interested in clumping things more people > are likely to need in the first volume (which is fine). > > I think what we really need to answer is who we expect Joe Average > Handbook Reader to be. If it's a typical-ish home user then your > approach definitely makes sense - clump "the first things that people > need to know" together and this sort of person is by definition both > user and admin so this isn't horrible. If it's a more corporate or > otherwise large-site audience this isn't necessarily the best split. > If I received a box with media and two books in it for a new OS we > were thinking about using I'd grab the admin guide on the way out > the door for the day planning to do a little evening reading and I'd > be annoyed if it didn't include the Install docs. I'd also be scared > that "they" expect normal users to install the OS and applications, > one of my reasons for considering this OS is getting away from an > environment where users can easily dammage the system... :-) > >From some points of view everything could be in admin part and everything (or quite) could be in user part. It's just a problem of vision of things. It's an endless talk. I did not give my opinion about the split, let's fix that :) I don't really like the split idea, why? Well cause of something I'd call "the FAQ syndrome". Our FAQ answers to 90% of questions you can read on -questions, newsgroups, and other mailing lists, but quite no one read it. It'd even be interesting to compare Web trafic for both of Handbook and FAQ. Why FAQ is not really used/read? It's difficult to answer to that question but I assume cause it's less "famous" and cause the human being is lazy, it's an effort to go read the Handbook, so switching to the FAQ is too much :) and since the FAQ is not linked (and not detailled) from the Handbook, people ignore it. It's not wrong to tell that a lot of people ignore the FAQ exists. (I know there is an old project to link/merge the FAQ in a dynamic way with the Handbook) The more you split a document the more you will fell in a such situation. For the moment http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ gives an "overview" of Handbook sections/chapters, if after the split(s) the Handbook keeps a similar ToC it will be fine, otherwise we will loose a part of the Handbook strengths. Well this is "my personal opinion", and of course I see some advantages in the split, it's why I did not say "No" to the split. I say "Ok but be careful" :) Marc From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 14:32:11 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 0AFC416A4CF; Tue, 20 Jul 2004 14:32:11 +0000 (GMT) Date: Tue, 20 Jul 2004 14:32:11 +0000 From: Murray Stokely To: Marc Fonvieille Message-ID: <20040720143211.GC17260@hub.freebsd.org> References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> <20040720104501.GB5405@hub.freebsd.org> <20040720124337.GA8096@electra.cse.Buffalo.EDU> <20040720140759.GA69951@abigail.blackend.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040720140759.GA69951@abigail.blackend.org> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: Nik Clayton cc: Ken Smith cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 14:32:11 -0000 On Tue, Jul 20, 2004 at 04:07:59PM +0200, Marc Fonvieille wrote: > For the moment > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ > gives an "overview" of Handbook sections/chapters, if after the split(s) > the Handbook keeps a similar ToC it will be fine, otherwise we will > loose a part of the Handbook strengths. > > Well this is "my personal opinion", and of course I see some advantages > in the split, it's why I did not say "No" to the split. I say "Ok but be > careful" :) It would be nice to have a shared table of contents for the online version with : Volume I : User Handbook * Chapter 1 : Introduction * Chapter 2 : Installation ... * Appendix D Volume II : Admin Handbook * Chapter 1 ... We could create something like this with a Perl script during the web build pretty easily. Eventually we would want to do this with olinks and in a single element. - Murray From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 14:47:25 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 17FC516A4CF; Tue, 20 Jul 2004 14:47:25 +0000 (GMT) Date: Tue, 20 Jul 2004 14:47:25 +0000 From: Murray Stokely To: Marc Fonvieille Message-ID: <20040720144725.GE17260@hub.freebsd.org> References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> <20040720104501.GB5405@hub.freebsd.org> <20040720124337.GA8096@electra.cse.Buffalo.EDU> <20040720140759.GA69951@abigail.blackend.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040720140759.GA69951@abigail.blackend.org> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: Nik Clayton cc: Ken Smith cc: doc@freebsd.org Subject: The FAQ (was Re: Creating an Admin Handbook) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 14:47:25 -0000 On Tue, Jul 20, 2004 at 04:07:59PM +0200, Marc Fonvieille wrote: > Why FAQ is not really used/read? It's difficult to answer to that > question but I assume cause it's less "famous" and cause the human being > is lazy, it's an effort to go read the Handbook, so switching to the FAQ > is too much :) and since the FAQ is not linked (and not detailled) from > the Handbook, people ignore it. It's not wrong to tell that a lot of > people ignore the FAQ exists. (I know there is an old project to > link/merge the FAQ in a dynamic way with the Handbook) > The more you split a document the more you will fell in a such > situation. I don't think it's a fair comparison since the FAQ is written in a much less formal style than the rest of our documentation. It is also HUGE for a 'FAQ' and people just aren't used to wading through such a huge list of boring error messages that don't apply to them, and information about pieces of hardware they've never heard of before they get to something that is relevant for them. The FAQ to me just doesn't work well as a static document. I think the FAQ should be the backend for a DocBook aware knowledgebase search tool. Until that time we can at least take comfort in knowing that it is searched with www.freebsd.org/search, although the engine returns an entire HTML page rather than just the relevant DocBook elements as would be ideal. Whenever anything is added to the FAQ that is easy to read, broadly relevant, and well written, (i.e., something you would want to link to), we scoop it up and add it to the Handbook. I don't think that is a bad thing. The FAQ is great for questions about specific hardware models and such, and I like to think that it still does a service to people who find that content through our search engine (or through google). - Murray From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 15:47:19 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3451E16A4CE; Tue, 20 Jul 2004 15:47:19 +0000 (GMT) Received: from jc.ngo.org.uk (jc.ngo.org.uk [69.55.225.33]) by mx1.FreeBSD.org (Postfix) with ESMTP id E7C9E43D46; Tue, 20 Jul 2004 15:47:17 +0000 (GMT) (envelope-from nik@crf-consulting.co.uk) Received: from crf-consulting.co.uk (82-44-220-218.cable.ubr10.haye.blueyonder.co.uk [82.44.220.218]) by jc.ngo.org.uk (8.12.11/8.12.11) with ESMTP id i6KFlA8i054981; Tue, 20 Jul 2004 08:47:11 -0700 (PDT) (envelope-from nik@crf-consulting.co.uk) Received: from clan.nothing-going-on.org (clan.nothing-going-on.org [192.168.1.20])i6KFl9rK041443; Tue, 20 Jul 2004 16:47:09 +0100 (BST) (envelope-from nik@catkin) Received: from clan.nothing-going-on.org (localhost [127.0.0.1]) i6KFl9cN065778; Tue, 20 Jul 2004 16:47:09 +0100 (BST) (envelope-from nik@clan.nothing-going-on.org) Received: (from nik@localhost)i6KFl9A1065777; Tue, 20 Jul 2004 16:47:09 +0100 (BST) (envelope-from nik) Date: Tue, 20 Jul 2004 16:47:08 +0100 From: Nik Clayton To: Marc Fonvieille Message-ID: <20040720154707.GB64597@clan.nothing-going-on.org> References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> <20040720104501.GB5405@hub.freebsd.org> <20040720124337.GA8096@electra.cse.Buffalo.EDU> <20040720140759.GA69951@abigail.blackend.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="bCsyhTFzCvuiizWE" Content-Disposition: inline In-Reply-To: <20040720140759.GA69951@abigail.blackend.org> User-Agent: Mutt/1.4.2.1i Organization: FreeBSD Project cc: Nik Clayton cc: Ken Smith cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 15:47:19 -0000 --bCsyhTFzCvuiizWE Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Jul 20, 2004 at 04:07:59PM +0200, Marc Fonvieille wrote: > of Handbook and FAQ. > Why FAQ is not really used/read? It's difficult to answer to that > question but I assume cause it's less "famous" and cause the human being > is lazy, it's an effort to go read the Handbook, so switching to the FAQ > is too much :)=20 I've said it before, I'll say it again -- the FAQ needs to die. =20 In the same way that each chapter has a "Synopsis", each chapter should have a FAQ section, at the end of the chapter, containing relevant content scooped out from the existing FAQ. Production of a master-FAQ, containing all the FAQ content from the Handbook(s) would then be possible. I had grand plans for this a few years ago. Then, inexplicably, I went and got a life, and free time plummeted. N --=20 FreeBSD: The Power to Serve http://www.freebsd.org/ (__) FreeBSD Documentation Project http://www.freebsd.org/docproj/ \\\'',) \/ \= ^ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- .\._/= _) --bCsyhTFzCvuiizWE Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA/T57k6gHZCw343URApe4AJ42UB5b45CoMJ+9+GBz9EJsgxZ/8QCfUtrh kYRWGWxMZ5Ez4jfwUKUQk94= =hb0d -----END PGP SIGNATURE----- --bCsyhTFzCvuiizWE-- From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 17:25:40 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6A8CC16A4CE; Tue, 20 Jul 2004 17:25:40 +0000 (GMT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 058C143D66; Tue, 20 Jul 2004 17:25:40 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost (acs-24-154-239-141.zoominternet.net [24.154.239.141]) (authenticated bits=0) by pittgoth.com (8.12.11/8.12.11) with ESMTP id i6KHPWKl050985 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Tue, 20 Jul 2004 13:25:33 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Tue, 20 Jul 2004 13:26:04 -0400 From: Tom Rhodes To: Murray Stokely Message-Id: <20040720132604.2f0ced26@localhost> In-Reply-To: <20040720144725.GE17260@hub.freebsd.org> References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> <20040720104501.GB5405@hub.freebsd.org> <20040720124337.GA8096@electra.cse.Buffalo.EDU> <20040720140759.GA69951@abigail.blackend.org> <20040720144725.GE17260@hub.freebsd.org> X-Mailer: Sylpheed-Claws 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd5.2) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org cc: Ken Smith cc: Nik Clayton cc: Marc Fonvieille Subject: Re: The FAQ (was Re: Creating an Admin Handbook) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 17:25:40 -0000 On Tue, 20 Jul 2004 14:47:25 +0000 Murray Stokely wrote: > On Tue, Jul 20, 2004 at 04:07:59PM +0200, Marc Fonvieille wrote: > > Why FAQ is not really used/read? It's difficult to answer to that > > question but I assume cause it's less "famous" and cause the human being > > is lazy, it's an effort to go read the Handbook, so switching to the FAQ > > is too much :) and since the FAQ is not linked (and not detailled) from > > the Handbook, people ignore it. It's not wrong to tell that a lot of > > people ignore the FAQ exists. (I know there is an old project to > > link/merge the FAQ in a dynamic way with the Handbook) > > The more you split a document the more you will fell in a such > > situation. > > I don't think it's a fair comparison since the FAQ is written in a > much less formal style than the rest of our documentation. It is also > HUGE for a 'FAQ' and people just aren't used to wading through such a > huge list of boring error messages that don't apply to them, and > information about pieces of hardware they've never heard of before > they get to something that is relevant for them. Most user *I* have conversations with have stated that they avoid the FAQ completely in favor of the more thorough instruction provided by the handbook. Only after double checking their steps with the handbook will they check the FAQ, google, lists, etc. -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 18:25:52 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1559416A4CE; Tue, 20 Jul 2004 18:25:52 +0000 (GMT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id E429F43D60; Tue, 20 Jul 2004 18:25:50 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) i6KIPkH5076931; Tue, 20 Jul 2004 20:25:46 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.11/8.12.11/Submit) id i6KIPkd3076930; Tue, 20 Jul 2004 20:25:46 +0200 (CEST) (envelope-from marc) Date: Tue, 20 Jul 2004 20:25:45 +0200 From: Marc Fonvieille To: Tom Rhodes Message-ID: <20040720182545.GA76560@abigail.blackend.org> References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> <20040720104501.GB5405@hub.freebsd.org> <20040720124337.GA8096@electra.cse.Buffalo.EDU> <20040720140759.GA69951@abigail.blackend.org> <20040720144725.GE17260@hub.freebsd.org> <20040720132604.2f0ced26@localhost> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040720132604.2f0ced26@localhost> User-Agent: Mutt/1.4.2.1i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.10-PRERELEASE cc: Nik Clayton cc: Murray Stokely cc: doc@FreeBSD.org cc: Ken Smith Subject: Re: The FAQ (was Re: Creating an Admin Handbook) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 18:25:52 -0000 On Tue, Jul 20, 2004 at 01:26:04PM -0400, Tom Rhodes wrote: > On Tue, 20 Jul 2004 14:47:25 +0000 > Murray Stokely wrote: > > > On Tue, Jul 20, 2004 at 04:07:59PM +0200, Marc Fonvieille wrote: > > > Why FAQ is not really used/read? It's difficult to answer to that > > > question but I assume cause it's less "famous" and cause the human being > > > is lazy, it's an effort to go read the Handbook, so switching to the FAQ > > > is too much :) and since the FAQ is not linked (and not detailled) from > > > the Handbook, people ignore it. It's not wrong to tell that a lot of > > > people ignore the FAQ exists. (I know there is an old project to > > > link/merge the FAQ in a dynamic way with the Handbook) > > > The more you split a document the more you will fell in a such > > > situation. > > > > I don't think it's a fair comparison since the FAQ is written in a > > much less formal style than the rest of our documentation. It is also > > HUGE for a 'FAQ' and people just aren't used to wading through such a > > huge list of boring error messages that don't apply to them, and > > information about pieces of hardware they've never heard of before > > they get to something that is relevant for them. > > Most user *I* have conversations with have stated that they > avoid the FAQ completely in favor of the more thorough > instruction provided by the handbook. Only after double > checking their steps with the handbook will they check the > FAQ, google, lists, etc. > I was not clear in my message: of course the FAQ is not a detailled documentation to set up your system etc. it's a FAQ. On this point you cannot compare it with the Handbook. I was talking about the fact people hardly use/read it. A lot of questions asked on the various mailing lists, newsgroups, etc. around the world are still the same and are documented in the FAQ: for example allowing ordinary users to mount a disk, booting with the win2k/xp/etc. loader, recovering a forgotten root password, etc... As I said it "seems" people, when they read a doc, only read the Handbook. I was just "afraid" of the fact splits could give birth of docs too much different, I mean with a an important separation between each book, the reader spending his time switching between books or reading one book only. It's why I think having a general table of contents may be a good idea. Marc Marc From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 18:41:05 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 175C416A4F5; Tue, 20 Jul 2004 18:41:05 +0000 (GMT) Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id E952C43D48; Tue, 20 Jul 2004 18:41:04 +0000 (GMT) (envelope-from linimon@lonesome.com) Received: by mail.soaustin.net (Postfix, from userid 502) id 99745148BF; Tue, 20 Jul 2004 13:41:04 -0500 (CDT) Date: Tue, 20 Jul 2004 13:41:04 -0500 (CDT) From: Mark Linimon X-X-Sender: linimon@pancho To: Nik Clayton In-Reply-To: <20040720154707.GB64597@clan.nothing-going-on.org> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: Ken Smith cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 18:41:05 -0000 I don't know if I agree with merging all the content of the FAQ into the handbook, but I _will_ agree that the FAQ needs to die. It is a complete grab-bag of 'stuff' and as such is pretty close to unreadable. A completely cool project would be to find something that would allow us to grind up the contents of the FAQ, the release notes, the hardware support info in the (4) manpages, and probably other things that I'm forgetting, and spit them out as a knowledge base. Does anyone here know of any other Open Source project that is doing something like that? mcl From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 18:47:15 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6B60B16A4CE for ; Tue, 20 Jul 2004 18:47:15 +0000 (GMT) Received: from mbox.ibctech.ca (dev.eagle.ca [209.167.58.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9FE4343D45 for ; Tue, 20 Jul 2004 18:47:14 +0000 (GMT) (envelope-from steveb@eagle.ca) Received: (qmail 24994 invoked by uid 1002); 20 Jul 2004 18:47:14 -0000 Received: from steveb@eagle.ca by pearl.ibctech.ca by uid 89 with qmail-scanner-1.22 (clamscan: 0.73. spamassassin: 2.63. Clear:RC:1(127.0.0.1):. Processed in 1.026472 secs); 20 Jul 2004 18:47:14 -0000 Received: from unknown (HELO webmail.ibctech.ca) (127.0.0.1) by localhost.ibctech.ca with SMTP; 20 Jul 2004 18:47:12 -0000 Received: from 209.167.16.15 (SquirrelMail authenticated user steve@ibctech.ca); by webmail.ibctech.ca with HTTP; Tue, 20 Jul 2004 14:47:12 -0400 (EDT) Message-ID: <4235.209.167.16.15.1090349232.squirrel@209.167.16.15> In-Reply-To: References: <20040720154707.GB64597@clan.nothing-going-on.org> Date: Tue, 20 Jul 2004 14:47:12 -0400 (EDT) From: "Steve Bertrand" To: "Mark Linimon" User-Agent: SquirrelMail/1.4.3a X-Mailer: SquirrelMail/1.4.3a MIME-Version: 1.0 Content-Type: text/plain;charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Priority: 3 (Normal) Importance: Normal cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 18:47:15 -0000 > I don't know if I agree with merging all the content of the FAQ > into the handbook, but I _will_ agree that the FAQ needs to die. > It is a complete grab-bag of 'stuff' and as such is pretty close > to unreadable. > > A completely cool project would be to find something that would > allow us to grind up the contents of the FAQ, the release notes, > the hardware support info in the (4) manpages, and probably other > things that I'm forgetting, and spit them out as a knowledge base. > > Does anyone here know of any other Open Source project that is > doing something like that? How about a wiki. Spamassassin uses one, and it seems quite intuitive. http://wiki.apache.org/spamassassin/ Steve > > mcl > > _______________________________________________ > 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" > From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 19:09:22 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E82C816A4CE for ; Tue, 20 Jul 2004 19:09:22 +0000 (GMT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8F57743D31 for ; Tue, 20 Jul 2004 19:09:22 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost (acs-24-154-239-141.zoominternet.net [24.154.239.141]) (authenticated bits=0) by pittgoth.com (8.12.11/8.12.11) with ESMTP id i6KJ9IRd051307 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Tue, 20 Jul 2004 15:09:19 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Tue, 20 Jul 2004 15:09:50 -0400 From: Tom Rhodes To: "Steve Bertrand" Message-Id: <20040720150950.41fcce9e@localhost> In-Reply-To: <4235.209.167.16.15.1090349232.squirrel@209.167.16.15> References: <20040720154707.GB64597@clan.nothing-going-on.org> <4235.209.167.16.15.1090349232.squirrel@209.167.16.15> X-Mailer: Sylpheed-Claws 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd5.2) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: Mark Linimon cc: doc@FreeBSD.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 19:09:23 -0000 On Tue, 20 Jul 2004 14:47:12 -0400 (EDT) "Steve Bertrand" wrote: > > I don't know if I agree with merging all the content of the FAQ > > into the handbook, but I _will_ agree that the FAQ needs to die. > > It is a complete grab-bag of 'stuff' and as such is pretty close > > to unreadable. > > > > A completely cool project would be to find something that would > > allow us to grind up the contents of the FAQ, the release notes, > > the hardware support info in the (4) manpages, and probably other > > things that I'm forgetting, and spit them out as a knowledge base. > > > > Does anyone here know of any other Open Source project that is > > doing something like that? > > How about a wiki. Spamassassin uses one, and it seems quite intuitive. > > http://wiki.apache.org/spamassassin/ > > Steve Stupid PHP based faq-o-matic things. -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 19:24:17 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0EF0516A4CE for ; Tue, 20 Jul 2004 19:24:17 +0000 (GMT) Received: from mbox.ibctech.ca (dev.eagle.ca [209.167.58.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id 33B9F43D5A for ; Tue, 20 Jul 2004 19:24:16 +0000 (GMT) (envelope-from steveb@eagle.ca) Received: (qmail 30627 invoked by uid 1002); 20 Jul 2004 19:24:15 -0000 Received: from steveb@eagle.ca by pearl.ibctech.ca by uid 89 with qmail-scanner-1.22 (clamscan: 0.73. spamassassin: 2.63. Clear:RC:1(127.0.0.1):. Processed in 1.029972 secs); 20 Jul 2004 19:24:15 -0000 Received: from unknown (HELO webmail.ibctech.ca) (127.0.0.1) by localhost.ibctech.ca with SMTP; 20 Jul 2004 19:24:14 -0000 Received: from 209.167.16.15 (SquirrelMail authenticated user steve@ibctech.ca); by webmail.ibctech.ca with HTTP; Tue, 20 Jul 2004 15:24:14 -0400 (EDT) Message-ID: <4511.209.167.16.15.1090351454.squirrel@209.167.16.15> In-Reply-To: <20040720150950.41fcce9e@localhost> References: <20040720154707.GB64597@clan.nothing-going-on.org> <4235.209.167.16.15.1090349232.squirrel@209.167.16.15> <20040720150950.41fcce9e@localhost> Date: Tue, 20 Jul 2004 15:24:14 -0400 (EDT) From: "Steve Bertrand" To: "Tom Rhodes" User-Agent: SquirrelMail/1.4.3a X-Mailer: SquirrelMail/1.4.3a MIME-Version: 1.0 Content-Type: text/plain;charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Priority: 3 (Normal) Importance: Normal cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 19:24:17 -0000 > On Tue, 20 Jul 2004 14:47:12 -0400 (EDT) > "Steve Bertrand" wrote: > >> > I don't know if I agree with merging all the content of the FAQ >> > into the handbook, but I _will_ agree that the FAQ needs to die. >> > It is a complete grab-bag of 'stuff' and as such is pretty close >> > to unreadable. >> > >> > A completely cool project would be to find something that would >> > allow us to grind up the contents of the FAQ, the release notes, >> > the hardware support info in the (4) manpages, and probably other >> > things that I'm forgetting, and spit them out as a knowledge base. >> > >> > Does anyone here know of any other Open Source project that is >> > doing something like that? >> >> How about a wiki. Spamassassin uses one, and it seems quite intuitive. >> >> http://wiki.apache.org/spamassassin/ >> >> Steve > > Stupid PHP based faq-o-matic things. Heh. Thanks for the very informative, enlightening and insightful reply to a simple suggestion. Makes for a great discussion, doesn't it? Or is this just a hint that only highly-qualified and extremely experienced persons are allowed to suggest anything here? ...zzzzip ;o) Steve > > -- > Tom Rhodes > _______________________________________________ > 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" > From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 19:49:19 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id EB45016A4CE for ; Tue, 20 Jul 2004 19:49:19 +0000 (GMT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 74C3043D5F for ; Tue, 20 Jul 2004 19:49:19 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost (acs-24-154-239-141.zoominternet.net [24.154.239.141]) (authenticated bits=0) by pittgoth.com (8.12.11/8.12.11) with ESMTP id i6KJnFfd051438 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Tue, 20 Jul 2004 15:49:16 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Tue, 20 Jul 2004 15:49:47 -0400 From: Tom Rhodes To: "Steve Bertrand" Message-Id: <20040720154947.32d6e071@localhost> In-Reply-To: <4511.209.167.16.15.1090351454.squirrel@209.167.16.15> References: <20040720154707.GB64597@clan.nothing-going-on.org> <4235.209.167.16.15.1090349232.squirrel@209.167.16.15> <20040720150950.41fcce9e@localhost> <4511.209.167.16.15.1090351454.squirrel@209.167.16.15> X-Mailer: Sylpheed-Claws 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd5.2) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 19:49:20 -0000 On Tue, 20 Jul 2004 15:24:14 -0400 (EDT) "Steve Bertrand" wrote: > > On Tue, 20 Jul 2004 14:47:12 -0400 (EDT) > > "Steve Bertrand" wrote: > > > >> > I don't know if I agree with merging all the content of the FAQ > >> > into the handbook, but I _will_ agree that the FAQ needs to die. > >> > It is a complete grab-bag of 'stuff' and as such is pretty close > >> > to unreadable. > >> > > >> > A completely cool project would be to find something that would > >> > allow us to grind up the contents of the FAQ, the release notes, > >> > the hardware support info in the (4) manpages, and probably other > >> > things that I'm forgetting, and spit them out as a knowledge base. > >> > > >> > Does anyone here know of any other Open Source project that is > >> > doing something like that? > >> > >> How about a wiki. Spamassassin uses one, and it seems quite intuitive. > >> > >> http://wiki.apache.org/spamassassin/ > >> > >> Steve > > > > Stupid PHP based faq-o-matic things. > > Heh. Thanks for the very informative, enlightening and insightful reply to > a simple suggestion. Makes for a great discussion, doesn't it? And all wikis are PHP? I didn't know that, I thought I was just pointing out the idea of using a 'stupid PHP based faq-o-matic thing' would work also. > > Or is this just a hint that only highly-qualified and extremely > experienced persons are allowed to suggest anything here? Depends, if all wikis are written in PHP then I am the one enlightened. On the other hand, if they aren't then I guess my suggestion still stands: We could use a 'stupid PHP based faq-o-matic'; although it would have to be something we could host on FreeBSD.org ourselves for it not to be devoid of any real use. If we did use something PHP based than I think a database is out of the question. Someone once pointed out to me that the newer versions of MySQL offer mirroring potential but I can't remember who nor have I researched that thought myself. On the other hand, I fear the idea of using plain text files with the entire fopen() function since those files may become massive. Otherwise, thanks for the sarcasm, it was pretty good; to have improved it, you could have made an attempt to find out if wikis only run on PHP and used that to your advantage. :) -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Wed Jul 21 09:20:14 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 91C5116A4D1 for ; Wed, 21 Jul 2004 09:20:14 +0000 (GMT) Received: from fam.ulusiada.pt (mail.fam.ulusiada.pt [193.136.184.3]) by mx1.FreeBSD.org (Postfix) with SMTP id F097D43D45 for ; Wed, 21 Jul 2004 09:20:12 +0000 (GMT) (envelope-from "") Received: (qmail 13659 invoked by uid 502); 21 Jul 2004 09:20:07 -0000 Received: from by mail.fam.ulusiada.pt in 0.117292 secs); 21 Jul 2004 09:20:07 -0000 Date: 21 Jul 2004 09:20:07 -0000 From: "Mail System Anti-Virus Administrator" To: doc@freebsd.org Message-ID: X-Tnz-Problem-Type: 40 MIME-Version: 1.0 Content-type: text/plain cc: lixo@mail.fam.ulusiada.pt Subject: Virus found in sent message "something for you" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 Jul 2004 09:20:14 -0000 Attention: doc@freebsd.org. A Virus was found in an Email message you sent. This Email scanner intercepted it and stopped the entire message reaching it's destination. The Virus was reported to be: W32/Netsky.B@mm Please update your virus scanner or contact your I.T support personnel as soon as possible as you have a virus on your system. Your message was sent with the following envelope: MAIL FROM: doc@freebsd.org RCPT TO: leonelgomes@fam.ulusiada.pt ... and with the following headers: From: doc@freebsd.org To: leonelgomes@fam.ulusiada.pt Subject: something for you Date: Wed, 21 Jul 2004 10:24:16 +0100 The original message is kept in: mail.fam.ulusiada.pt:/var/spool/qmailscan/quarantine where the Mail System Anti-Virus Administrator can further diagnose it. The Email scanner reported the following when it scanned that message: --- ---fprot results --- Virus scanning report - 21. July 2004 10:20 F-PROT 3.11b SIGN.DEF created 20. July 2004 SIGN2.DEF created 20. July 2004 MACRO.DEF created 19. July 2004 Search: /var/spool/qmailscan/mail.fam.ulusiada.pt109040160640413622 /var/spool/qmailscan/working/new/mail.fam.ulusiada.pt109040160640413622 Action: Report only Files: "Dumb" scan of all files Switches: /ARCHIVE /AI /var/spool/qmailscan/mail.fam.ulusiada.pt109040160640413622/jokes.rtf.com Infection: W32/Netsky.B@mm /var/spool/qmailscan/working/new/mail.fam.ulusiada.pt109040160640413622->jokes.zip->jokes.rtf.com Infection: W32/Netsky.B@mm Results of virus scanning: Files: 3 MBRs: 0 Boot sectors: 0 Objects scanned: 5 Infected: 2 Suspicious: 0 Disinfected: 0 Deleted: 0 Renamed: 0 Time: 0:01 --- From owner-freebsd-doc@FreeBSD.ORG Wed Jul 21 09:45:09 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3057A16A4D5; Wed, 21 Jul 2004 09:45:09 +0000 (GMT) Received: from shrike.submonkey.net (cpc2-cdif3-6-0-cust204.cdif.cable.ntl.com [81.103.67.204]) by mx1.FreeBSD.org (Postfix) with ESMTP id A616243D1F; Wed, 21 Jul 2004 09:45:08 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.34; FreeBSD) id 1BnDet-0003Rw-4l; Wed, 21 Jul 2004 10:45:07 +0100 Date: Wed, 21 Jul 2004 10:45:07 +0100 From: Ceri Davies To: Murray Stokely Message-ID: <20040721094506.GW424@submonkey.net> Mail-Followup-To: Ceri Davies , Murray Stokely , Ken Smith , doc@freebsd.org, Nik Clayton References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> <20040720104501.GB5405@hub.freebsd.org> <20040720124337.GA8096@electra.cse.Buffalo.EDU> <20040720132914.GA17260@hub.freebsd.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="PdAWLd+WEPmMbsbx" Content-Disposition: inline In-Reply-To: <20040720132914.GA17260@hub.freebsd.org> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: Nik Clayton cc: Ken Smith cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 Jul 2004 09:45:09 -0000 --PdAWLd+WEPmMbsbx Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Jul 20, 2004 at 01:29:14PM +0000, Murray Stokely wrote: > When we split up the book it makes the omissions stand out. We have > woefully little about setting up and maintaining webservers in our > Handbook, which is one of the most common uses of FreeBSD. That kind > of gets lost after 10 chapters of installating, the ports tree, unix > basics, and X Windows, but it really starts to stand out when you > split those basic prerequisites out. I'll just interject here and just say that I think that "installating" is the best neologism I've ever heard. Start using this people, I want it in the dictionary by year out. Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --PdAWLd+WEPmMbsbx Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA/jsiocfcwTS3JF8RAngDAKCWq9bJ92eSGr0PWvrqBjQgVhPzKQCgobWo VKhcBynN7h3IrRXb7wj4Ehw= =b7WX -----END PGP SIGNATURE----- --PdAWLd+WEPmMbsbx-- From owner-freebsd-doc@FreeBSD.ORG Wed Jul 21 10:09:56 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 739CF16A4CE; Wed, 21 Jul 2004 10:09:56 +0000 (GMT) Received: from ms-dienst.rz.rwth-aachen.de (ms-2.rz.RWTH-Aachen.DE [134.130.3.131]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3968343D31; Wed, 21 Jul 2004 10:09:56 +0000 (GMT) (envelope-from chris@unixpages.org) Received: from r220-1 (r220-1.rz.RWTH-Aachen.DE [134.130.3.31]) by ms-dienst.rz.rwth-aachen.de (iPlanet Messaging Server 5.2 HotFix 1.12 (built Feb 13 2003)) with ESMTP id <0I1700IX958NDA@ms-dienst.rz.rwth-aachen.de>; Wed, 21 Jul 2004 12:02:48 +0200 (MEST) Received: from relay.rwth-aachen.de ([134.130.3.1]) by r220-1 (MailMonitor for SMTP v1.2.2 ) ; Wed, 21 Jul 2004 12:02:46 +0200 (MEST) Received: from haakonia.hitnet.rwth-aachen.de (haakonia.hitnet.RWTH-Aachen.DE [137.226.181.92])i6LA2kmH026145; Wed, 21 Jul 2004 12:02:46 +0200 (MEST) Received: from gondor.middleearth (gondor.middleearth [192.168.1.42]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))(Postfix) with ESMTP id 0EC4228438; Wed, 21 Jul 2004 12:02:46 +0200 (CEST) Received: by gondor.middleearth (Postfix, from userid 1001) id C80186106; Wed, 21 Jul 2004 12:02:45 +0200 (CEST) Date: Wed, 21 Jul 2004 12:02:45 +0200 From: Christian Brueffer In-reply-to: <20040721094506.GW424@submonkey.net> To: Ceri Davies , Murray Stokely , Ken Smith , doc@freebsd.org, Nik Clayton Message-id: <20040721100245.GI590@unixpages.org> MIME-version: 1.0 Content-type: multipart/signed; boundary=c8JyeaiReRNoiMDS; protocol="application/pgp-signature"; micalg=pgp-sha1 Content-disposition: inline User-Agent: Mutt/1.5.5.1i X-Operating-System: FreeBSD 5.2-CURRENT X-PGP-Key: http://people.freebsd.org/~brueffer/brueffer.key.asc X-PGP-Fingerprint: A5C8 2099 19FF AACA F41B B29B 6C76 178C A0ED 982D References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> <20040720104501.GB5405@hub.freebsd.org> <20040720124337.GA8096@electra.cse.Buffalo.EDU> <20040720132914.GA17260@hub.freebsd.org> <20040721094506.GW424@submonkey.net> Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 Jul 2004 10:09:56 -0000 --c8JyeaiReRNoiMDS Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Jul 21, 2004 at 10:45:07AM +0100, Ceri Davies wrote: > On Tue, Jul 20, 2004 at 01:29:14PM +0000, Murray Stokely wrote: >=20 > > When we split up the book it makes the omissions stand out. We have > > woefully little about setting up and maintaining webservers in our > > Handbook, which is one of the most common uses of FreeBSD. That kind > > of gets lost after 10 chapters of installating, the ports tree, unix > > basics, and X Windows, but it really starts to stand out when you > > split those basic prerequisites out. >=20 > I'll just interject here and just say that I think that "installating" is > the best neologism I've ever heard. Start using this people, I want it > in the dictionary by year out. >=20 We could add it to share/dict/words for a start ;-) - Christian --=20 Christian Brueffer chris@unixpages.org brueffer@FreeBSD.org GPG Key: http://people.freebsd.org/~brueffer/brueffer.key.asc GPG Fingerprint: A5C8 2099 19FF AACA F41B B29B 6C76 178C A0ED 982D --c8JyeaiReRNoiMDS Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA/j9FbHYXjKDtmC0RAi1hAJ0WZJn5pYftvhUoLQBls8OeSMLqKwCdGYAk M0y2hEvrvIPNtuybcfq8TXQ= =SM8Z -----END PGP SIGNATURE----- --c8JyeaiReRNoiMDS-- From owner-freebsd-doc@FreeBSD.ORG Wed Jul 21 12:46:40 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6944216A4CE for ; Wed, 21 Jul 2004 12:46:40 +0000 (GMT) Received: from mbox.ibctech.ca (dev.eagle.ca [209.167.58.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id 611C643D31 for ; Wed, 21 Jul 2004 12:46:39 +0000 (GMT) (envelope-from iaccounts@ibctech.ca) Received: (qmail 65465 invoked by uid 1002); 21 Jul 2004 12:46:39 -0000 Received: from iaccounts@ibctech.ca by pearl.ibctech.ca by uid 89 with qmail-scanner-1.22 (clamscan: 0.73. spamassassin: 2.63. Clear:RC:1(127.0.0.1):. Processed in 1.021263 secs); 21 Jul 2004 12:46:39 -0000 Received: from unknown (HELO webmail.ibctech.ca) (127.0.0.1) by localhost.ibctech.ca with SMTP; 21 Jul 2004 12:46:37 -0000 Received: from 209.167.16.15 (SquirrelMail authenticated user steve@ibctech.ca); by webmail.ibctech.ca with HTTP; Wed, 21 Jul 2004 08:46:37 -0400 (EDT) Message-ID: <1270.209.167.16.15.1090413997.squirrel@209.167.16.15> Date: Wed, 21 Jul 2004 08:46:37 -0400 (EDT) From: "Steve Bertrand" To: "Mark Linimon" User-Agent: SquirrelMail/1.4.3a X-Mailer: SquirrelMail/1.4.3a MIME-Version: 1.0 Content-Type: text/plain;charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Priority: 3 (Normal) Importance: Normal References: <20040720154707.GB64597@clan.nothing-going-on.org> <4235.209.167.16.15.1090349232.squirrel@209.167.16.15> <200407201836.02208.linimon@lonesome.com> In-Reply-To: <200407201836.02208.linimon@lonesome.com> cc: freebsd-doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 Jul 2004 12:46:40 -0000 >> http://wiki.apache.org/spamassassin/ > Someone has obviously put a _lot_ of work into this one. > ...[snip]... > Do you know which software they are using? I did some snooping this morning, and found that they use one called Moinmoin (which is Python based): http://wiki.apache.org/spamassassin/MoinMoin ...and further to yesterday's discussion, wiki(s) are NOT only PHP-based. Tom, check this out: http://c2.com/cgi/wiki?WikiEngines :o) Steve > > mcl > From owner-freebsd-doc@FreeBSD.ORG Wed Jul 21 13:04:56 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 26C6916A4CE; Wed, 21 Jul 2004 13:04:56 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 09A8543D49; Wed, 21 Jul 2004 13:04:56 +0000 (GMT) (envelope-from josef@FreeBSD.org) Received: from freefall.freebsd.org (josef@localhost [127.0.0.1]) i6LD4thJ038976; Wed, 21 Jul 2004 13:04:55 GMT (envelope-from josef@freefall.freebsd.org) Received: (from josef@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6LD4toX038972; Wed, 21 Jul 2004 13:04:55 GMT (envelope-from josef) Date: Wed, 21 Jul 2004 13:04:55 GMT From: Josef El-Rayes Message-Id: <200407211304.i6LD4toX038972@freefall.freebsd.org> To: josef@FreeBSD.org, freebsd-doc@FreeBSD.org, josef@FreeBSD.org Subject: Re: docs/69252: [patch] Add entry about Konq to the list of browsers X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 Jul 2004 13:04:56 -0000 Synopsis: [patch] Add entry about Konq to the list of browsers Responsible-Changed-From-To: freebsd-doc->josef Responsible-Changed-By: josef Responsible-Changed-When: Wed Jul 21 13:04:46 GMT 2004 Responsible-Changed-Why: I'll handle this http://www.freebsd.org/cgi/query-pr.cgi?pr=69252 From owner-freebsd-doc@FreeBSD.ORG Wed Jul 21 15:20:17 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A307616A4CE for ; Wed, 21 Jul 2004 15:20:17 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8084A43D53 for ; Wed, 21 Jul 2004 15:20:17 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6LFKHwV062230 for ; Wed, 21 Jul 2004 15:20:17 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6LFKHjT062229; Wed, 21 Jul 2004 15:20:17 GMT (envelope-from gnats) Resent-Date: Wed, 21 Jul 2004 15:20:17 GMT Resent-Message-Id: <200407211520.i6LFKHjT062229@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, Giorgos Keramidas Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D4F3716A4CE for ; Wed, 21 Jul 2004 15:17:18 +0000 (GMT) Received: from bilbo.otenet.gr (bilbo.otenet.gr [195.170.0.13]) by mx1.FreeBSD.org (Postfix) with ESMTP id AC0DD43D48 for ; Wed, 21 Jul 2004 15:17:17 +0000 (GMT) (envelope-from keramida@bytemobile.com) Received: from orion.daedalusnetworks.priv (aris.bedc.ondsl.gr [62.103.39.226])i6LFH70M013073 for ; Wed, 21 Jul 2004 18:17:12 +0300 Received: from orion.daedalusnetworks.priv (orion [127.0.0.1]) i6LFHrKN034296 for ; Wed, 21 Jul 2004 18:17:53 +0300 (EEST) (envelope-from keramida@orion.daedalusnetworks.priv) Received: (from keramida@localhost)i6LFHpmB034265; Wed, 21 Jul 2004 18:17:51 +0300 (EEST) (envelope-from keramida) Message-Id: <200407211517.i6LFHpmB034265@orion.daedalusnetworks.priv> Date: Wed, 21 Jul 2004 18:17:51 +0300 (EEST) From: Giorgos Keramidas To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69383: disklabel = bsdlabel in 5.X or later X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Giorgos Keramidas List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 Jul 2004 15:20:17 -0000 >Number: 69383 >Category: docs >Synopsis: disklabel = bsdlabel in 5.X or later >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 Jul 21 15:20:17 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Giorgos Keramidas >Release: FreeBSD 5.2-CURRENT i386 >Organization: >Environment: System: FreeBSD orion.daedalusnetworks.priv 5.2-CURRENT FreeBSD 5.2-CURRENT #0: Tue Jul 20 13:09:21 EEST 2004 root@orion.local:/usr/obj/usr/src/sys/ORION i386 >Description: Various parts of our documentation refer to disklabel(8) which is being replaced by bsdlabel in 5.X and later versions of FreeBSD. Some time after 5.X becomes -STABLE we might want to consider changing this to bsdlabel(8) with a note to users of older versions. Hopefully, this PR will remind us that this ought to be done :-) >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Wed Jul 21 16:56:43 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 56B4616A4D0 for ; Wed, 21 Jul 2004 16:56:43 +0000 (GMT) Received: from electra.cse.Buffalo.EDU (electra.cse.Buffalo.EDU [128.205.32.2]) by mx1.FreeBSD.org (Postfix) with ESMTP id 02B7043D45 for ; Wed, 21 Jul 2004 16:56:43 +0000 (GMT) (envelope-from kensmith@cse.Buffalo.EDU) Received: from electra.cse.Buffalo.EDU (kensmith@localhost [127.0.0.1]) i6LGugTH020165 for ; Wed, 21 Jul 2004 12:56:42 -0400 (EDT) Received: (from kensmith@localhost) by electra.cse.Buffalo.EDU (8.12.10/8.12.9/Submit) id i6LGugri020164 for doc@freebsd.org; Wed, 21 Jul 2004 12:56:42 -0400 (EDT) Date: Wed, 21 Jul 2004 12:56:42 -0400 From: Ken Smith To: doc@freebsd.org Message-ID: <20040721165642.GA19955@electra.cse.Buffalo.EDU> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.4.1i Subject: Handbook update for 'make world' X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 Jul 2004 16:56:43 -0000 Thoughts? I *think* the flamewar over this change is finished but it might be premature. But most of this probably should be done regardless IHMO. Most of this de-emphasises "make world" in favor of the broken-down "make buildworld; make buildkernel; etc" procedure we've been recommending for a while now. There is one significant-ish procedural change, I moved the "mergemaster -p" step to be first because there are cases that the "make buildworld" step now checks to see if users/groups exist before it will even begin compiling stuff... Index: chapter.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml,v retrieving revision 1.203 diff -u -r1.203 chapter.sgml --- chapter.sgml 6 Jul 2004 15:09:54 -0000 1.203 +++ chapter.sgml 21 Jul 2004 16:49:13 -0000 @@ -61,7 +61,7 @@ CTM. How to rebuild and reinstall the entire base - system with make world. + system with make buildworld (etc). @@ -536,10 +536,10 @@ - Using <command>make world</command> + Using <command>make buildworld (etc)</command> - make world + make buildworld (etc) Once you have synchronized your local source tree against a particular version of &os; (&os.stable;, &os.current;, and so on) @@ -556,7 +556,8 @@ when you make mistakes, or when mistakes made by others in the source tree render your system unbootable. - Make sure you have taken a backup. And have a fixit floppy to + Make sure you have taken a backup. And have a fixit floppy or + bootable CD at hand. You will probably never have to use it, but it is better to be safe than sorry! @@ -593,7 +594,8 @@ To update your system, you should use the following procedure: - &prompt.root; make buildworld + &prompt.root; mergemaster -p +&prompt.root; make buildworld &prompt.root; make buildkernel &prompt.root; make installkernel &prompt.root; reboot @@ -602,8 +604,7 @@ boot -s from loader prompt for example). Then run: - &prompt.root; mergemaster -p -&prompt.root; make installworld + &prompt.root; make installworld &prompt.root; mergemaster &prompt.root; reboot @@ -678,9 +679,11 @@ /etc/group. There have been occasions when the installation part of - make world has expected certain usernames or groups + make installworld has expected certain usernames or groups to exist. When performing an upgrade it is likely that these - users or groups did not exist. This caused problems when upgrading. + users or groups did not exist. This caused problems when upgrading. + In some cases make buildworld will check to see if + these users or groups exist. A recent example of this is when the smmsp user was added. Users had the @@ -785,7 +788,7 @@ /usr/obj. The directories shadow those under /usr/src. - You can speed up the make world process, and + You can speed up the make buildworld process, and possibly save yourself some dependency headaches by removing this directory as well. @@ -895,7 +898,10 @@ &os.stable; midway between 2.2.2 and 2.2.5) the world target has been split in two: buildworld and - installworld. + installworld. Beginning with version + 5.3 of &os the world will be changed + so it will not work at all by default because it is actually + dangerous for most users. As the names imply, buildworld builds a complete new tree under /usr/obj, @@ -955,7 +961,7 @@ Timings - make world + make buildworld (etc) timings @@ -1069,7 +1075,7 @@ - Update Files Not Updated by <command>make world</command> + Update Files Not Updated by <command>make installworld</command> Remaking the world will not update certain directories (in particular, /etc, /var and @@ -1511,14 +1517,14 @@ /usr/obj contains all the object files that were produced during the compilation phase. Normally, one - of the first steps in the make world process is to + of the first steps in the make buildworld process is to remove this directory and start afresh. In this case, keeping /usr/obj around after you have finished makes little sense, and will free up a large chunk of disk space (currently about 340 MB). However, if you know what you are doing you can have - make world skip this step. This will make subsequent + make buildworld skip this step. This will make subsequent builds run much faster, since most of sources will not need to be recompiled. The flip side of this is that subtle dependency problems can creep in, causing your build to fail in odd ways. @@ -1539,7 +1545,7 @@ you found a problem. In general (and this is not a hard and - fast rule) the make world process builds new + fast rule) the make buildworld process builds new copies of essential tools (such as &man.gcc.1;, and &man.make.1;) and the system libraries. These tools and libraries are then installed. The new tools and libraries are @@ -1557,7 +1563,7 @@ &prompt.root; make -DNOCLEAN all This will not undo the work of the previous - make world. + make buildworld. If you see the message: @@ -1565,7 +1571,7 @@ Building everything.. -------------------------------------------------------------- - in the make world output then it is + in the make buildworld output then it is probably fairly safe to do so. If you do not see that message, or you are not sure, then it @@ -1740,7 +1746,7 @@ build machine. It is going to be the machine that the world and kernel are built on. Ideally, it should be a fast machine that has sufficient spare CPU to - run make world. You will also want to + run make buildworld (etc). You will also want to choose a machine to be the test machine, which will test software updates before they are put into production. This must be a -- Ken Smith - From there to here, from here to | kensmith@cse.buffalo.edu there, funny things are everywhere. | - Theodore Geisel | From owner-freebsd-doc@FreeBSD.ORG Wed Jul 21 21:14:59 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 68ECF16A4CE for ; Wed, 21 Jul 2004 21:14:59 +0000 (GMT) Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id 364C943D49 for ; Wed, 21 Jul 2004 21:14:59 +0000 (GMT) (envelope-from linimon@lonesome.com) Received: by mail.soaustin.net (Postfix, from userid 502) id 835F914316; Wed, 21 Jul 2004 16:14:58 -0500 (CDT) Date: Wed, 21 Jul 2004 16:14:58 -0500 (CDT) From: Mark Linimon X-X-Sender: linimon@pancho To: Ken Smith In-Reply-To: <20040721165642.GA19955@electra.cse.Buffalo.EDU> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: doc@freebsd.org Subject: Re: Handbook update for 'make world' X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 Jul 2004 21:14:59 -0000 I don't have any objection to any of this, but I think it might be nice to at least put in the text a) that a change in recommendation has been made, and b) why. Something like 'the sequence that includes "make buildworld/make installworld" is now preferred to the previously documented usage "make world". The latter skips some steps that may or may not be necessary in certain circumstances; the former includes all steps that are necessary in any circumstance, and is thus less likely to lead to unsatisfactory results.' mcl From owner-freebsd-doc@FreeBSD.ORG Thu Jul 22 06:54:35 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9A6A616A4CE for ; Thu, 22 Jul 2004 06:54:35 +0000 (GMT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 42A5143D49 for ; Thu, 22 Jul 2004 06:54:35 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost ([192.168.0.5]) (authenticated bits=0) by pittgoth.com (8.12.11/8.12.11) with ESMTP id i6M6sX66065630 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 22 Jul 2004 02:54:34 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Tue, 13 Jul 2004 10:22:14 -0400 From: Tom Rhodes To: Bill Moran Message-Id: <20040713102214.067b3461@localhost.pittgoth.com> In-Reply-To: <20040710183026.0baf1e83.wmoran@potentialtech.com> References: <20040710183026.0baf1e83.wmoran@potentialtech.com> X-Mailer: Sylpheed version 0.9.11claws (GTK+ 1.2.10; i386-portbld-freebsd5.2) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org Subject: Re: RFC: new doc on jail + quota X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Jul 2004 06:54:35 -0000 On Sat, 10 Jul 2004 18:30:26 -0400 Bill Moran wrote: > > I've recently been experimenting with running filesystem quotas within > jails. > > In case you haven't tried this, there are a number of gotchas, quirks and > tricks involved. So far I haven't found any documentation on doing this, > thus I've had to experiment to determine what works and what doesn't, and > how to get things working right. > > Now I want to get this documented, and I'm curious as to how folks think > I should do so. I see three possibilities, and the correct thing to do > may be more than one. > > 1) Update the various man pages for jail and quota commands to document > the interaction > 2) Add a chapter to the handbook on running disk quotas within a jail > 3) Write a new article for the articles section of the docs that details > what to do to get it working. > > What does the doc team think is the better approach? > > -- > Bill Moran > Potential Technologies > http://www.potentialtech.com > _______________________________________________ > 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" > -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Thu Jul 22 07:40:23 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 43F2A16A4CF for ; Thu, 22 Jul 2004 07:40:23 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 31AF643D54 for ; Thu, 22 Jul 2004 07:40:23 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6M7eM3a086092 for ; Thu, 22 Jul 2004 07:40:22 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6M7eM4L086091; Thu, 22 Jul 2004 07:40:22 GMT (envelope-from gnats) Resent-Date: Thu, 22 Jul 2004 07:40:22 GMT Resent-Message-Id: <200407220740.i6M7eM4L086091@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, Janos Mohacsi Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id AC1A316A4CE for ; Thu, 22 Jul 2004 07:38:32 +0000 (GMT) Received: from csoki.ki.iif.hu (csoki.ki.iif.hu [193.6.222.7]) by mx1.FreeBSD.org (Postfix) with ESMTP id F128E43D54 for ; Thu, 22 Jul 2004 07:38:31 +0000 (GMT) (envelope-from mohacsi@csoki.ki.iif.hu) Received: (from mohacsi@localhost) by csoki.ki.iif.hu (8.12.11/8.12.11) id i6M7cUia029831; Thu, 22 Jul 2004 09:38:30 +0200 (CEST) (envelope-from mohacsi) Message-Id: <200407220738.i6M7cUia029831@csoki.ki.iif.hu> Date: Thu, 22 Jul 2004 09:38:30 +0200 (CEST) From: Janos Mohacsi To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69417: securelevel(8) does not mention pf(4) in secure level 3 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Janos Mohacsi List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Jul 2004 07:40:23 -0000 >Number: 69417 >Category: docs >Synopsis: securelevel(8) does not mention pf(4) in secure level 3 >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 Jul 22 07:40:22 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Janos Mohacsi >Release: FreeBSD 5.2-CURRENT i386 >Organization: NIIF >Environment: System: FreeBSD csoki.ki.iif.hu 5.2-CURRENT FreeBSD 5.2-CURRENT #2: Fri Jul 9 09:57:34 CEST 2004 root@csoki.ki.iif.hu:/usr/obj/usr/src/sys/CSOKI i386 >Description: the securelevel(8) (init(8)) does not mention pf(4) in secure level 3 Only ipfw, ipfilter mentioned. >How-To-Repeat: Read manual page. >Fix: Add something like to secure level 3 section: pfctl(8) may no longer alter filter or nat rules >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Thu Jul 22 08:23:05 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C63A016A4CE for ; Thu, 22 Jul 2004 08:23:05 +0000 (GMT) Received: from eddie.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 924B643D1F for ; Thu, 22 Jul 2004 08:23:03 +0000 (GMT) (envelope-from simon@eddie.nitro.dk) Received: by eddie.nitro.dk (Postfix, from userid 1000) id 77A9F11817; Thu, 22 Jul 2004 10:23:01 +0200 (CEST) Date: Thu, 22 Jul 2004 10:23:01 +0200 From: "Simon L. Nielsen" To: Ken Smith Message-ID: <20040722082300.GA39030@eddie.nitro.dk> References: <20040721165642.GA19955@electra.cse.Buffalo.EDU> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="SUOF0GtieIMvvwua" Content-Disposition: inline In-Reply-To: <20040721165642.GA19955@electra.cse.Buffalo.EDU> User-Agent: Mutt/1.5.6i cc: doc@freebsd.org Subject: Re: Handbook update for 'make world' X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Jul 2004 08:23:05 -0000 --SUOF0GtieIMvvwua Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.07.21 12:56:42 -0400, Ken Smith wrote: >=20 > Thoughts? I *think* the flamewar over this change is finished but it mig= ht > be premature. But most of this probably should be done regardless IHMO. First, I think it's good to go over this, since the ambiguity of "make world" has been discussed before. > Most of this de-emphasises "make world" in favor of the broken-down > "make buildworld; make buildkernel; etc" procedure we've been recommending > for a while now. There is one significant-ish procedural change, I moved > the "mergemaster -p" step to be first because there are cases that the > "make buildworld" step now checks to see if users/groups exist before it > will even begin compiling stuff... Are you sure of that? I'm rather sure that you only need mergemaster -p before installworld, e.g. since you might be doing cross builds where you don't want to touch the host environment... UPDATING also has mergepaster -p before installworld, not before buildworld. > Index: chapter.sgml > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chap= ter.sgml,v > retrieving revision 1.203 > diff -u -r1.203 chapter.sgml > --- chapter.sgml 6 Jul 2004 15:09:54 -0000 1.203 > +++ chapter.sgml 21 Jul 2004 16:49:13 -0000 > @@ -61,7 +61,7 @@ > CTM. > > How to rebuild and reinstall the entire base > - system with make world. > + system with make buildworld (etc). I think it should be "make buildworld (etc).", since (etc) really isn't a command... The same appies to other entries in the patch. Perhaps it would be better just to write "rebuilding world" or something like that, where that can be used instead? > > =20 > > @@ -536,10 +536,10 @@ > > =20 > > - Using <command>make world</command> > + Using <command>make buildworld (etc)</command> > =20 > > - make world > + make buildworld (etc) > > Once you have synchronized your local source tree against a > particular version of &os; (&os.stable;, &os.current;, and so on) > @@ -556,7 +556,8 @@ > when you make mistakes, or when mistakes made by others in the > source tree render your system unbootable. > =20 > - Make sure you have taken a backup. And have a fixit floppy = to > + Make sure you have taken a backup. And have a fixit floppy = or > + bootable CD at > hand. You will probably never have to use it, but it is better to be > safe than sorry! > > @@ -593,7 +594,8 @@ > To update your system, you should use the following > procedure: > =20 > - &prompt.root; make buildworld > + &prompt.root; mergemaster -p > +&prompt.root; make buildworld > &prompt.root; make buildkernel > &prompt.root; make installkernel > &prompt.root; reboot > @@ -602,8 +604,7 @@ > boot -s from loader prompt for > example). Then run: > =20 > - &prompt.root; mergemaster -p > -&prompt.root; make installworld > + &prompt.root; make installworld > &prompt.root; mergemaster > &prompt.root; reboot > =20 > @@ -678,9 +679,11 @@ > /etc/group. > =20 > There have been occasions when the installation part of > - make world has expected certain usernames or grou= ps > + make installworld has expected certain usernames = or groups > to exist. When performing an upgrade it is likely that these > - users or groups did not exist. This caused problems when upgrading. > + users or groups did not exist. This caused problems when upgrading. > + In some cases make buildworld will check to see if > + these users or groups exist. > =20 > A recent example of this is when the > smmsp user was added. Users had the > @@ -785,7 +788,7 @@ > /usr/obj. The directories shadow those under > /usr/src. > =20 > - You can speed up the make world process, and > + You can speed up the make buildworld process,= and > possibly save yourself some dependency headaches by removing this > directory as well. > =20 > @@ -895,7 +898,10 @@ > &os.stable; midway between 2.2.2 and 2.2.5) the > world target has been split in > two: buildworld and > - installworld. > + installworld. Beginning with version ^ Should be double space. > + 5.3 of &os the world will be changed > + so it will not work at all by default because it is actually > + dangerous for most users. > =20 > As the names imply, buildworld > builds a complete new tree under /usr/obj, [...] > @@ -1740,7 +1746,7 @@ > build machine. It is going to be the > machine that the world and kernel are built on. Ideally, it > should be a fast machine that has sufficient spare CPU to > - run make world. You will also want to > + run make buildworld (etc). You will also want to How about using "make buildworld and make buildkernel" in this context - since that what matters for speeding up build. --=20 Simon L. Nielsen FreeBSD Documentation Team --SUOF0GtieIMvvwua Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA/3lkh9pcDSc1mlERAsOxAJ4owmbVyaQ2QW6Jh0FTjjhfxmDAYwCeIQ9D Tn5yqswTY9PzRNpnYOaSdRA= =JNaO -----END PGP SIGNATURE----- --SUOF0GtieIMvvwua-- From owner-freebsd-doc@FreeBSD.ORG Thu Jul 22 10:49:23 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BA9A316A4CE; Thu, 22 Jul 2004 10:49:23 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 99E4543D5A; Thu, 22 Jul 2004 10:49:23 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i6MAnNZF009566; Thu, 22 Jul 2004 10:49:23 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6MAnNnW009562; Thu, 22 Jul 2004 10:49:23 GMT (envelope-from keramida) Date: Thu, 22 Jul 2004 10:49:23 GMT From: Giorgos Keramidas Message-Id: <200407221049.i6MAnNnW009562@freefall.freebsd.org> To: janos.mohacsi@bsd.hu, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/69417: securelevel(8) does not mention pf(4) in secure level 3 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Jul 2004 10:49:23 -0000 Synopsis: securelevel(8) does not mention pf(4) in secure level 3 State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Thu Jul 22 10:48:35 GMT 2004 State-Changed-Why: Fixed, thanks :) Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Thu Jul 22 10:48:35 GMT 2004 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=69417 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 22 11:50:25 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id CE20016A4CE for ; Thu, 22 Jul 2004 11:50:25 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id B412443D41 for ; Thu, 22 Jul 2004 11:50:25 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6MBoPE5016127 for ; Thu, 22 Jul 2004 11:50:25 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6MBoPwb016126; Thu, 22 Jul 2004 11:50:25 GMT (envelope-from gnats) Resent-Date: Thu, 22 Jul 2004 11:50:25 GMT Resent-Message-Id: <200407221150.i6MBoPwb016126@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, Sascha Schneider Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1573E16A4CE for ; Thu, 22 Jul 2004 11:47:59 +0000 (GMT) Received: from ws111.noc.celox.de (ws111.noc.celox.de [217.146.128.167]) by mx1.FreeBSD.org (Postfix) with ESMTP id C39D543D3F for ; Thu, 22 Jul 2004 11:47:58 +0000 (GMT) (envelope-from sascha@ws111.noc.celox.de) Received: from sascha by ws111.noc.celox.de with local (Exim 4.40 (FreeBSD)) id 1Bnc3F-000OmW-MD for FreeBSD-gnats-submit@freebsd.org; Thu, 22 Jul 2004 13:47:53 +0200 Message-Id: Date: Thu, 22 Jul 2004 13:47:53 +0200 From: Sascha Schneider To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69428: [patch] Wrong symbolic constant in getrusage(2) on 4.10-STABLE X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Sascha Schneider List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Jul 2004 11:50:26 -0000 >Number: 69428 >Category: docs >Synopsis: [patch] Wrong symbolic constant in getrusage(2) on 4.10-STABLE >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: Thu Jul 22 11:50:25 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Sascha Schneider >Release: FreeBSD 4.10-STABLE i386 >Organization: >Environment: System: FreeBSD ws111.noc.celox.de 4.10-STABLE FreeBSD 4.10-STABLE #0: Mon Jul 5 15:45:06 CEST 2004 root@ws111.noc.celox.de:/usr/obj/usr/src/sys/WS111 i386 $FreeBSD: src/lib/libc/sys/getrusage.2,v 1.10.2.5 2001/12/14 18:34:00 ru Exp $ $FreeBSD: src/lib/libc/gen/sysconf.3,v 1.8.2.6 2001/12/14 18:33:51 ru Exp $ $FreeBSD: src/sys/sys/unistd.h,v 1.22.2.3 2003/11/11 07:26:33 das Exp $ >Description: getrusage(2) states that sysconf(_SC_CLOCK_TCK) would return the frequency of the statistic clock. According to sysconf(3) and /usr/include/sys/unistd.h this is wrong: sysconf(_SC_CLK_TCK) is the way to do it. >How-To-Repeat: [user@ws111] [~]$ zgrep TCK /usr/share/man/man2/getrusage.2.gz .Fn sysconf _SC_CLOCK_TCK [user@ws111] [~]$ zgrep TCK /usr/share/man/man3/sysconf.3.gz .It Li _SC_CLK_TCK [user@ws111] [~]$ zgrep TCK /usr/include/sys/unistd.h #define _SC_CLK_TCK [user@ws111] [~dc/stuff]$ cat getrusage-wrong.c #include #include int main(void) { printf("Frequency: %d\n", sysconf(_SC_CLOCK_TCK)); } [user@ws111] [~dc/stuff]$ make getrusage-wrong cc -O -pipe -march=pentium getrusage-wrong.c -o getrusage-wrong getrusage-wrong.c: In function `main': getrusage-wrong.c:6: `_SC_CLOCK_TCK' undeclared (first use in this function) getrusage-wrong.c:6: (Each undeclared identifier is reported only once getrusage-wrong.c:6: for each function it appears in.) *** Error code 1 Stop in /home/user/development/c/stuff. [user@ws111] [~dc/stuff]$ cat getrusage-right.c #include #include int main(void) { printf("Frequency: %d\n", sysconf(_SC_CLK_TCK)); } [user@ws111] [~dc/stuff]$ make getrusage-right cc -O -pipe -march=pentium getrusage-right.c -o getrusage-right [user@ws111] [~dc/stuff]$ ./getrusage-right Frequency: 128 >Fix: patch patch-getrusage.2 attached. >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Thu Jul 22 12:26:19 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7315516A4CE; Thu, 22 Jul 2004 12:26:19 +0000 (GMT) Received: from electra.cse.Buffalo.EDU (electra.cse.Buffalo.EDU [128.205.32.2]) by mx1.FreeBSD.org (Postfix) with ESMTP id 25CB843D49; Thu, 22 Jul 2004 12:26:19 +0000 (GMT) (envelope-from kensmith@cse.Buffalo.EDU) Received: from electra.cse.Buffalo.EDU (kensmith@localhost [127.0.0.1]) i6MCQITH017495; Thu, 22 Jul 2004 08:26:18 -0400 (EDT) Received: (from kensmith@localhost) by electra.cse.Buffalo.EDU (8.12.10/8.12.9/Submit) id i6MCQIba017494; Thu, 22 Jul 2004 08:26:18 -0400 (EDT) Date: Thu, 22 Jul 2004 08:26:18 -0400 From: Ken Smith To: "Simon L. Nielsen" Message-ID: <20040722122618.GA17005@electra.cse.Buffalo.EDU> References: <20040721165642.GA19955@electra.cse.Buffalo.EDU> <20040722082300.GA39030@eddie.nitro.dk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040722082300.GA39030@eddie.nitro.dk> User-Agent: Mutt/1.4.1i cc: Ken Smith cc: doc@FreeBSD.org Subject: Re: Handbook update for 'make world' X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Jul 2004 12:26:19 -0000 On Thu, Jul 22, 2004 at 10:23:01AM +0200, Simon L. Nielsen wrote: > On 2004.07.21 12:56:42 -0400, Ken Smith wrote: > > Most of this de-emphasises "make world" in favor of the broken-down > > "make buildworld; make buildkernel; etc" procedure we've been recommending > > for a while now. There is one significant-ish procedural change, I moved > > the "mergemaster -p" step to be first because there are cases that the > > "make buildworld" step now checks to see if users/groups exist before it > > will even begin compiling stuff... > > Are you sure of that? I'm rather sure that you only need mergemaster -p > before installworld, e.g. since you might be doing cross builds where > you don't want to touch the host environment... UPDATING also has > mergepaster -p before installworld, not before buildworld. Nope not sure - you're right. I mixed it up with something else that I got caught by recently. I'll restore the original order. > I think it should be "make buildworld (etc).", since > (etc) really isn't a command... The same appies to other entries in the > patch. > > Perhaps it would be better just to write "rebuilding > world" or something like that, where that can be used > instead? Where it was being used as a title of a section I changed it to "Rebuilding world" as you suggested, and moved (etc) outside the tags otherwise. Other suggested adjustments made as well. Thanks. -- Ken Smith - From there to here, from here to | kensmith@cse.buffalo.edu there, funny things are everywhere. | - Theodore Geisel | From owner-freebsd-doc@FreeBSD.ORG Thu Jul 22 12:39:35 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A9A8916A4CE for ; Thu, 22 Jul 2004 12:39:35 +0000 (GMT) Received: from electra.cse.Buffalo.EDU (electra.cse.Buffalo.EDU [128.205.32.2]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5D33E43D4C for ; Thu, 22 Jul 2004 12:39:35 +0000 (GMT) (envelope-from kensmith@cse.Buffalo.EDU) Received: from electra.cse.Buffalo.EDU (kensmith@localhost [127.0.0.1]) i6MCdYTH018011; Thu, 22 Jul 2004 08:39:34 -0400 (EDT) Received: (from kensmith@localhost) by electra.cse.Buffalo.EDU (8.12.10/8.12.9/Submit) id i6MCdY1c018010; Thu, 22 Jul 2004 08:39:34 -0400 (EDT) Date: Thu, 22 Jul 2004 08:39:34 -0400 From: Ken Smith To: Mark Linimon Message-ID: <20040722123934.GB17005@electra.cse.Buffalo.EDU> References: <20040721165642.GA19955@electra.cse.Buffalo.EDU> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.4.1i cc: Ken Smith cc: doc@freebsd.org Subject: Re: Handbook update for 'make world' X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Jul 2004 12:39:35 -0000 On Wed, Jul 21, 2004 at 04:14:58PM -0500, Mark Linimon wrote: > I don't have any objection to any of this, but I think it might be > nice to at least put in the text a) that a change in recommendation > has been made, and b) why. Something like 'the sequence that includes > "make buildworld/make installworld" is now preferred to the previously > documented usage "make world". The latter skips some steps that may or > may not be necessary in certain circumstances; the former includes all > steps that are necessary in any circumstance, and is thus less likely > to lead to unsatisfactory results.' How is this as a warning at the top (right after saying you should read the mailing lists): Do not use <command>make world</command> A lot of older documentation recommends using make world for this. Doing that skips some important steps and should only be used if you are sure of what you are doing. For almost all circumstances make world is the wrong thing to do, and the procedure described here should be used instead. [Cut-and-paste probably didn't preserve tabs...] -- Ken Smith - From there to here, from here to | kensmith@cse.buffalo.edu there, funny things are everywhere. | - Theodore Geisel | From owner-freebsd-doc@FreeBSD.ORG Thu Jul 22 14:41:19 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4EF8916A4CE; Thu, 22 Jul 2004 14:41:19 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2F39843D2F; Thu, 22 Jul 2004 14:41:19 +0000 (GMT) (envelope-from roam@FreeBSD.org) Received: from freefall.freebsd.org (roam@localhost [127.0.0.1]) i6MEfJNF037744; Thu, 22 Jul 2004 14:41:19 GMT (envelope-from roam@freefall.freebsd.org) Received: (from roam@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6MEfIF7037740; Thu, 22 Jul 2004 14:41:18 GMT (envelope-from roam) Date: Thu, 22 Jul 2004 14:41:18 GMT From: Peter Pentchev Message-Id: <200407221441.i6MEfIF7037740@freefall.freebsd.org> To: liamfoy@sepulcrum.org, roam@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/67806: Let 5.x users know how to boot into single user mode in cutting-edge. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Jul 2004 14:41:19 -0000 Synopsis: Let 5.x users know how to boot into single user mode in cutting-edge. State-Changed-From-To: open->feedback State-Changed-By: roam State-Changed-When: Thu Jul 22 14:39:18 GMT 2004 State-Changed-Why: What do y'all think about the following patch? In case GNATS mangles it, you can fetch it from http://people.FreeBSD.org/~roam/doc/boot-single.patch Index: doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml,v retrieving revision 1.203 diff -u -r1.203 chapter.sgml --- doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml 6 Jul 2004 15:09:54 -0000 1.203 +++ doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml 22 Jul 2004 14:34:13 -0000 @@ -748,9 +748,24 @@ from a running system, which will drop it to single user mode. - Alternatively, reboot the system, and at the boot prompt, - enter the flag. The system will then boot - single user. At the shell prompt you should then run: + Alternatively, reboot the system. When the boot loader starts and displays the + message Booting [/kernel] in 10 + seconds, press Space (or any key but + Enter) to interrupt the countdown and display the + loader prompt, then enter the boot -s command. + The system will then boot in single user mode. + + + If you are using &os.current;, the loader does not display a + countdown, but a full-screen menu instead. Press the appropriate + key to invoke the Boot &os; in single user mode + option; it is usually 4, but may differ if you + have customized your loader menu. + + + Once you have dropped the system into single user mode, run the + following commands at the shell prompt: &prompt.root; fsck -p &prompt.root; mount -u / http://www.freebsd.org/cgi/query-pr.cgi?pr=67806 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 22 15:20:28 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9D2BC16A4CE for ; Thu, 22 Jul 2004 15:20:28 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 94C6743D41 for ; Thu, 22 Jul 2004 15:20:28 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6MFKSAT044230 for ; Thu, 22 Jul 2004 15:20:28 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6MFKSJ6044226; Thu, 22 Jul 2004 15:20:28 GMT (envelope-from gnats) Date: Thu, 22 Jul 2004 15:20:28 GMT Message-Id: <200407221520.i6MFKSJ6044226@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Sascha Schneider Subject: Re: docs/69428: [patch] Wrong symbolic constant in getrusage(2) on 4.10-STABLE X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Sascha Schneider List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Jul 2004 15:20:28 -0000 The following reply was made to PR docs/69428; it has been noted by GNATS. From: Sascha Schneider To: bug-followup@FreeBSD.org Cc: Subject: Re: docs/69428: [patch] Wrong symbolic constant in getrusage(2) on 4.10-STABLE Date: Thu, 22 Jul 2004 17:19:29 +0200 --YiEDa0DAkWCtVeE4 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Hello, seems like attaching the patch to a prewritten PR, that is included by -f does not work. So, here it is. Kind regards, Sascha Schneider --YiEDa0DAkWCtVeE4 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: attachment; filename="patch-getrusage.2" --- getrusage.2.orig Thu Jul 22 12:44:13 2004 +++ getrusage.2 Thu Jul 22 12:43:48 2004 @@ -101,7 +101,7 @@ in units of kilobytes * ticks-of-execution. Ticks are statistics clock ticks. The statistics clock has a frequency of -.Fn sysconf _SC_CLOCK_TCK +.Fn sysconf _SC_CLK_TCK ticks per second. .It Fa ru_idrss an integral value of the amount of unshared memory residing in the --YiEDa0DAkWCtVeE4-- From owner-freebsd-doc@FreeBSD.ORG Thu Jul 22 18:27:12 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D681C16A4CE; Thu, 22 Jul 2004 18:27:12 +0000 (GMT) Received: from redqueen.elvandar.org (cust.94.120.adsl.cistron.nl [195.64.94.120]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4586043D3F; Thu, 22 Jul 2004 18:27:08 +0000 (GMT) (envelope-from remko@elvandar.org) Received: from [10.0.2.122] (nimrod.elvandar.intranet [10.0.2.122]) by redqueen.elvandar.org (Postfix) with ESMTP id CBF1E10685E; Thu, 22 Jul 2004 20:27:04 +0200 (CEST) Message-ID: <410006FB.4020504@elvandar.org> Date: Thu, 22 Jul 2004 20:27:07 +0200 From: Remko Lodder X-Accept-Language: en-us, en MIME-Version: 1.0 To: Tom Rhodes References: <20040710183026.0baf1e83.wmoran@potentialtech.com> <20040713102214.067b3461@localhost.pittgoth.com> In-Reply-To: <20040713102214.067b3461@localhost.pittgoth.com> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Scanned: by amavisd-new at elvandar.org cc: doc@FreeBSD.org Subject: Re: RFC: new doc on jail + quota X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Jul 2004 18:27:13 -0000 >>1) Update the various man pages for jail and quota commands to document >> the interaction >>2) Add a chapter to the handbook on running disk quotas within a jail >>3) Write a new article for the articles section of the docs that details >> what to do to get it working. >> >>What does the doc team think is the better approach? >> Heya, I think an article or the handbook are the best options, personally i go for the handbook, since that is read by many people. On the other hand, it is not commonly used nor frequently asked (yet) so when you stick with that way you should say it's a article. Still my vote would be for the handbook {since it adds technically advanced material to it, not only being interesting for beginners but also for advanced persons}. my $0.02 :-) -- Kind regards, Remko Lodder |remko@elvandar.org Reporter DSINet |remko@dsinet.org Projectleader Mostly-Harmless |remko@mostly-harmless.nl From owner-freebsd-doc@FreeBSD.ORG Thu Jul 22 18:36:13 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D705716A4CE for ; Thu, 22 Jul 2004 18:36:13 +0000 (GMT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6557243D39 for ; Thu, 22 Jul 2004 18:36:13 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost (acs-24-154-239-141.zoominternet.net [24.154.239.141]) (authenticated bits=0) by pittgoth.com (8.12.11/8.12.11) with ESMTP id i6MIa4eI069471 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 22 Jul 2004 14:36:05 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Thu, 22 Jul 2004 14:36:34 -0400 From: Tom Rhodes To: Remko Lodder Message-Id: <20040722143634.4a813860@localhost> In-Reply-To: <410006FB.4020504@elvandar.org> References: <20040710183026.0baf1e83.wmoran@potentialtech.com> <20040713102214.067b3461@localhost.pittgoth.com> <410006FB.4020504@elvandar.org> X-Mailer: Sylpheed-Claws 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd5.2) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org Subject: Re: RFC: new doc on jail + quota X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Jul 2004 18:36:14 -0000 On Thu, 22 Jul 2004 20:27:07 +0200 Remko Lodder wrote: > > >>1) Update the various man pages for jail and quota commands to document > >> the interaction > >>2) Add a chapter to the handbook on running disk quotas within a jail > >>3) Write a new article for the articles section of the docs that details > >> what to do to get it working. > >> > >>What does the doc team think is the better approach? > >> > > Heya, > > I think an article or the handbook are the best options, personally i go > for the handbook, since that is read by many people. On the other hand, > it is not commonly used nor frequently asked (yet) so when you stick > with that way you should say it's a article. Still my vote would be for > the handbook {since it adds technically advanced material to it, not > only being interesting for beginners but also for advanced persons}. > Hmmm, I'll probably think about this more later on; too busy at the present time. -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Thu Jul 22 18:40:29 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3150216A4CE for ; Thu, 22 Jul 2004 18:40:29 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1368B43D2D for ; Thu, 22 Jul 2004 18:40:29 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6MIeSOU066747 for ; Thu, 22 Jul 2004 18:40:28 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6MIeSGp066746; Thu, 22 Jul 2004 18:40:28 GMT (envelope-from gnats) Date: Thu, 22 Jul 2004 18:40:28 GMT Message-Id: <200407221840.i6MIeSGp066746@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: "Simon L. Nielsen" Subject: Re: docs/67806: Let 5.x users know how to boot into single user mode in cutting-edge. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: "Simon L. Nielsen" List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Jul 2004 18:40:29 -0000 The following reply was made to PR docs/67806; it has been noted by GNATS. From: "Simon L. Nielsen" To: Peter Pentchev Cc: freebsd-gnats-submit@FreeBSD.org, liamfoy@sepulcrum.org Subject: Re: docs/67806: Let 5.x users know how to boot into single user mode in cutting-edge. Date: Thu, 22 Jul 2004 20:40:16 +0200 --E13BgyNx05feLLmH Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.07.22 14:41:18 +0000, Peter Pentchev wrote: > What do y'all think about the following patch? Since we are getting closer and closer to 5.X as -STABLE I personally prefer to start making 4.X the exception, rather than the other way around, so 5.X is described and the 4.X behavior is in a "", but that might just be me... > Index: doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chap= ter.sgml,v > retrieving revision 1.203 > diff -u -r1.203 chapter.sgml > --- doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml 6 Jul 20= 04 15:09:54 -0000 1.203 > +++ doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml 22 Jul 2= 004 14:34:13 -0000 > @@ -748,9 +748,24 @@ > from a running system, which will drop it to single user > mode. > =20 > - Alternatively, reboot the system, and at the boot prompt, > - enter the flag. The system will then boot > - single user. At the shell prompt you should then run: > + Alternatively, reboot the system. When the + linkend=3D"boot-loader">boot loader starts and displays the > + message Booting [/kernel] in 10 > + seconds, press Space (or any key but > + Enter) to interrupt the countdown and display the > + loader prompt, then enter the boot -s command. > + The system will then boot in single user mode. > + > + > + If you are using &os.current;, the loader does not display a I think "&os; 5.X" is better since hopefully we should have 5.3-STABLE in a few months. --=20 Simon L. Nielsen FreeBSD Documentation Team --E13BgyNx05feLLmH Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFBAAoPh9pcDSc1mlERArpiAJ4wZ8SSbYsBz9dnIb1oNeeZFIKHiQCbBC/m Iu4nkAymR8eel0pcHgVPbwY= =Z6Pe -----END PGP SIGNATURE----- --E13BgyNx05feLLmH-- From owner-freebsd-doc@FreeBSD.ORG Fri Jul 23 01:00:54 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4776316A4EF; Fri, 23 Jul 2004 01:00:54 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 25AC743D2D; Fri, 23 Jul 2004 01:00:54 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i6N10scB010264; Fri, 23 Jul 2004 01:00:54 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6N10pnS010226; Fri, 23 Jul 2004 01:00:51 GMT (envelope-from keramida) Date: Fri, 23 Jul 2004 01:00:51 GMT From: Giorgos Keramidas Message-Id: <200407230100.i6N10pnS010226@freefall.freebsd.org> To: rado@studnet.edu.eu.org, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/59587: rewriting examples (part of documentation for FreeBSD 5.x) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Jul 2004 01:00:54 -0000 Synopsis: rewriting examples (part of documentation for FreeBSD 5.x) State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Fri Jul 23 00:58:46 GMT 2004 State-Changed-Why: Recent commits to the cdev example module have fixed what you describe despite the fact that the committers involved missed your PR in gnats. Still, thanks for the effort you put in writing this excellent PR and submitting it to us. Keep up the good work ;-) http://www.freebsd.org/cgi/query-pr.cgi?pr=59587 From owner-freebsd-doc@FreeBSD.ORG Fri Jul 23 01:02:20 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D8D1716A4CE; Fri, 23 Jul 2004 01:02:20 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id BA43843D54; Fri, 23 Jul 2004 01:02:20 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i6N12Kc6010361; Fri, 23 Jul 2004 01:02:20 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6N12KWi010357; Fri, 23 Jul 2004 01:02:20 GMT (envelope-from keramida) Date: Fri, 23 Jul 2004 01:02:20 GMT From: Giorgos Keramidas Message-Id: <200407230102.i6N12KWi010357@freefall.freebsd.org> To: keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/68201: [patch] pthread_atfork(3) man page X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Jul 2004 01:02:21 -0000 Synopsis: [patch] pthread_atfork(3) man page Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Fri Jul 23 01:01:54 GMT 2004 Responsible-Changed-Why: I'll take this one. http://www.freebsd.org/cgi/query-pr.cgi?pr=68201 From owner-freebsd-doc@FreeBSD.ORG Fri Jul 23 07:50:43 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E24EB16A4CE for ; Fri, 23 Jul 2004 07:50:42 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id C89D443D45 for ; Fri, 23 Jul 2004 07:50:42 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6N7oRPo063836 for ; Fri, 23 Jul 2004 07:50:27 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6N7oRDv063835; Fri, 23 Jul 2004 07:50:27 GMT (envelope-from gnats) Resent-Date: Fri, 23 Jul 2004 07:50:27 GMT Resent-Message-Id: <200407230750.i6N7oRDv063835@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, Brad Davis Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9F07D16A4CE for ; Fri, 23 Jul 2004 07:47:03 +0000 (GMT) Received: from valentine.liquidneon.com (valentine.liquidneon.com [216.38.206.180]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7244C43D2D for ; Fri, 23 Jul 2004 07:47:03 +0000 (GMT) (envelope-from bdavis@house.so14k.com) Received: from localhost (localhost [127.0.0.1]) by valentine.liquidneon.com (Postfix) with ESMTP id B0950CA for ; Fri, 23 Jul 2004 01:46:48 -0600 (MDT) Received: from valentine.liquidneon.com ([216.38.206.180]) by localhost (valentine.liquidneon.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 18480-06 for ; Fri, 23 Jul 2004 01:46:48 -0600 (MDT) Received: from mccaffrey.house.so14k.com (c-24-8-51-173.client.comcast.net [24.8.51.173]) by valentine.liquidneon.com (Postfix) with ESMTP id 5867E4E for ; Fri, 23 Jul 2004 01:46:48 -0600 (MDT) Received: by mccaffrey.house.so14k.com (Postfix, from userid 1001) id 8E7DAA8D; Fri, 23 Jul 2004 01:46:47 -0600 (MDT) Message-Id: <20040723074647.8E7DAA8D@mccaffrey.house.so14k.com> Date: Fri, 23 Jul 2004 01:46:47 -0600 (MDT) From: Brad Davis To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69471: Fix Caps & Correct the resources/install X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Brad Davis List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Jul 2004 07:50:43 -0000 >Number: 69471 >Category: docs >Synopsis: Fix Caps & Correct the resources/install >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 Jul 23 07:50:27 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Brad Davis >Release: FreeBSD 4.10-STABLE i386 >Organization: >Environment: System: FreeBSD mccaffrey.house.so14k.com 4.10-STABLE FreeBSD 4.10-STABLE #0: Fri May 28 08:02:41 MDT 2004 root@mccaffrey.house.so14k.com:/usr/obj/usr/src/sys/MCCAFFREY i386 >Description: Fix Caps & Correct the resources/install bits.. >How-To-Repeat: >Fix: --- doc-ori/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml Fri Jul 23 01:22:03 2004 +++ doc/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml Fri Jul 23 01:25:01 2004 @@ -166,8 +166,8 @@ Konqueror - light - light + medium + heavy KDE Libraries @@ -414,7 +414,7 @@ of KDE by installing x11/kdebase3. Konqueror is much more than a browser, - it is also a File Manager and a Multimedia Viewer. + it is also a file manager and a multimedia viewer. Konqueror also comes with a set of plugins, available in misc/konq-plugins. >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri Jul 23 08:10:16 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2A57D16A4CE for ; Fri, 23 Jul 2004 08:10:16 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 217EA43D48 for ; Fri, 23 Jul 2004 08:10:16 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6N8AGjb068563 for ; Fri, 23 Jul 2004 08:10:16 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6N8AFut068560; Fri, 23 Jul 2004 08:10:15 GMT (envelope-from gnats) Date: Fri, 23 Jul 2004 08:10:15 GMT Message-Id: <200407230810.i6N8AFut068560@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Marc Fonvieille Subject: Re: docs/69471: Fix Caps & Correct the resources/install X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Marc Fonvieille List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Jul 2004 08:10:16 -0000 The following reply was made to PR docs/69471; it has been noted by GNATS. From: Marc Fonvieille To: Brad Davis Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/69471: Fix Caps & Correct the resources/install Date: Fri, 23 Jul 2004 10:05:21 +0200 On Fri, Jul 23, 2004 at 01:46:47AM -0600, Brad Davis wrote: > > --- doc-ori/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml Fri Jul 23 01:22:03 2004 > +++ doc/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml Fri Jul 23 01:25:01 2004 > @@ -166,8 +166,8 @@ > > > Konqueror > - light > - light > + medium > + heavy > KDE Libraries > I'd say heavy in both case, compared to other browsers entries... firefox for example. Marc From owner-freebsd-doc@FreeBSD.ORG Fri Jul 23 08:50:28 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2771116A4CE for ; Fri, 23 Jul 2004 08:50:28 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 080B343D45 for ; Fri, 23 Jul 2004 08:50:28 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6N8oRue071556 for ; Fri, 23 Jul 2004 08:50:27 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6N8oR7b071555; Fri, 23 Jul 2004 08:50:27 GMT (envelope-from gnats) Date: Fri, 23 Jul 2004 08:50:27 GMT Message-Id: <200407230850.i6N8oR7b071555@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Michael Nottebrock Subject: Re: docs/69471: Fix Caps & Correct the resources/install X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Michael Nottebrock List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Jul 2004 08:50:28 -0000 The following reply was made to PR docs/69471; it has been noted by GNATS. From: Michael Nottebrock To: freebsd-gnats-submit@FreeBSD.org, so14k@so14k.com Cc: Subject: Re: docs/69471: Fix Caps & Correct the resources/install Date: Fri, 23 Jul 2004 10:44:39 +0200 Konqueror operates on the same basis as Opera (qt), which is ranked as "light", plus some additional overhead from the KDE extensions to qt. I agree however that "heavy" for firefox is a wrong assessment and should be dropped to "medium" as well. From owner-freebsd-doc@FreeBSD.ORG Fri Jul 23 09:44:08 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D103616A4CE for ; Fri, 23 Jul 2004 09:44:08 +0000 (GMT) Received: from vsmtp14.tin.it (vsmtp14.tin.it [212.216.176.118]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5FC7743D2D for ; Fri, 23 Jul 2004 09:44:08 +0000 (GMT) (envelope-from gerarra@tin.it) Received: from ims3a.cp.tin.it (192.168.70.103) by vsmtp14.tin.it (7.0.027) id 40967D8E00BF261E for doc@freebsd.org; Fri, 23 Jul 2004 11:44:07 +0200 Received: from [192.168.70.227] by ims3a.cp.tin.it with HTTP; Fri, 23 Jul 2004 11:44:06 +0200 Date: Fri, 23 Jul 2004 11:44:06 +0200 Message-ID: <40D1B0DA0003CFF4@ims3a.cp.tin.it> From: gerarra@tin.it To: doc@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset="ISO-8859-15" Content-Transfer-Encoding: quoted-printable Subject: handbook developers signal documentation X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Jul 2004 09:44:08 -0000 Hi, for a work of mine, I had to writedown some signal paper on FreeBSD. I've= noticed it's not up in developers handbook so I was wondering if, after a good hardening, it could be useful for freebsd documentation. Let me kn= ow. cheers rookie From owner-freebsd-doc@FreeBSD.ORG Fri Jul 23 09:46:02 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id AFBD016A4CF; Fri, 23 Jul 2004 09:46:02 +0000 (GMT) Date: Fri, 23 Jul 2004 09:46:02 +0000 From: Murray Stokely To: gerarra@tin.it Message-ID: <20040723094602.GA7154@hub.freebsd.org> References: <40D1B0DA0003CFF4@ims3a.cp.tin.it> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <40D1B0DA0003CFF4@ims3a.cp.tin.it> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: doc@freebsd.org Subject: Re: handbook developers signal documentation X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Jul 2004 09:46:02 -0000 On Fri, Jul 23, 2004 at 11:44:06AM +0200, gerarra@tin.it wrote: > for a work of mine, I had to writedown some signal paper on FreeBSD. I've > noticed it's not up in developers handbook so I was wondering if, after > a good hardening, it could be useful for freebsd documentation. Let me know. Yes definitely. Please submit it to this list or through our PR database. - Murray From owner-freebsd-doc@FreeBSD.ORG Fri Jul 23 09:52:46 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6C27716A4CE for ; Fri, 23 Jul 2004 09:52:46 +0000 (GMT) Received: from fam.ulusiada.pt (mail.fam.ulusiada.pt [193.136.184.3]) by mx1.FreeBSD.org (Postfix) with SMTP id 0E51643D39 for ; Fri, 23 Jul 2004 09:52:44 +0000 (GMT) (envelope-from "") Received: (qmail 5948 invoked by uid 502); 23 Jul 2004 09:52:41 -0000 Received: from by mail.fam.ulusiada.pt in 0.117336 secs); 23 Jul 2004 09:52:41 -0000 Date: 23 Jul 2004 09:52:40 -0000 From: "Mail System Anti-Virus Administrator" To: doc@freebsd.org Message-ID: X-Tnz-Problem-Type: 40 MIME-Version: 1.0 Content-type: text/plain cc: lixo@mail.fam.ulusiada.pt Subject: Virus found in sent message "hi" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Jul 2004 09:52:46 -0000 Attention: doc@freebsd.org. A Virus was found in an Email message you sent. This Email scanner intercepted it and stopped the entire message reaching it's destination. The Virus was reported to be: W32/Netsky.B@mm Please update your virus scanner or contact your I.T support personnel as soon as possible as you have a virus on your system. Your message was sent with the following envelope: MAIL FROM: doc@freebsd.org RCPT TO: 31722000@fam.ulusiada.pt ... and with the following headers: From: doc@freebsd.org To: 31722000@fam.ulusiada.pt Subject: hi Date: Fri, 23 Jul 2004 10:56:50 +0100 The original message is kept in: mail.fam.ulusiada.pt:/var/spool/qmailscan/quarantine where the Mail System Anti-Virus Administrator can further diagnose it. The Email scanner reported the following when it scanned that message: --- ---fprot results --- Virus scanning report - 23. July 2004 10:52 F-PROT 3.11b SIGN.DEF created 20. July 2004 SIGN2.DEF created 20. July 2004 MACRO.DEF created 19. July 2004 Search: /var/spool/qmailscan/mail.fam.ulusiada.pt10905763604045935 /var/spool/qmailscan/working/new/mail.fam.ulusiada.pt10905763604045935 Action: Report only Files: "Dumb" scan of all files Switches: /ARCHIVE /AI /var/spool/qmailscan/mail.fam.ulusiada.pt10905763604045935/topseller.com Infection: W32/Netsky.B@mm /var/spool/qmailscan/working/new/mail.fam.ulusiada.pt10905763604045935->topseller.com Infection: W32/Netsky.B@mm Results of virus scanning: Files: 3 MBRs: 0 Boot sectors: 0 Objects scanned: 4 Infected: 2 Suspicious: 0 Disinfected: 0 Deleted: 0 Renamed: 0 Time: 0:00 --- From owner-freebsd-doc@FreeBSD.ORG Fri Jul 23 09:54:22 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 9DA0216A4CF; Fri, 23 Jul 2004 09:54:22 +0000 (GMT) Date: Fri, 23 Jul 2004 09:54:22 +0000 From: Murray Stokely To: doc@freebsd.org Message-ID: <20040723095422.GC7154@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D Subject: Know something about Apache, FTPd, or Samba? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Jul 2004 09:54:22 -0000 As you may have noticed, I added sections about Apache, FTPd, and Samba to the Network Servers chapter of the Handbook this week. All three sections could use more review and flushing out with content. Thanks to those who have already committed improvements to those chapters or mailed me about them. In particular, there is a lot more to be said about Apache and Samba. Sections that I would like to see include : * Setting up virtual hosts with Apache. * Setting up webalizer to analyze web log files. * Requesting and installing a signed certificate with Apache/mod_ssl. * Installing PHP. * Formal in the Samba section to illustrate simple tasks. Screenshots of the network neighborhood in Windows and how to associate the shares on the FreeBSD server would be good. I'd like to see here so that we can link to them and so that they show up in the printed list of examples at the front of the book. etc.. I may work on some of these myself, but I likely won't get to everything. It would be great if others have time and inclination to help work on these new sections at the end of the Network Servers chapter. Thanks! - Murray From owner-freebsd-doc@FreeBSD.ORG Fri Jul 23 11:50:26 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BA3C316A4D3 for ; Fri, 23 Jul 2004 11:50:26 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id AB60143D48 for ; Fri, 23 Jul 2004 11:50:26 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6NBoQ9f093464 for ; Fri, 23 Jul 2004 11:50:26 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6NBoQ1x093463; Fri, 23 Jul 2004 11:50:26 GMT (envelope-from gnats) Resent-Date: Fri, 23 Jul 2004 11:50:26 GMT Resent-Message-Id: <200407231150.i6NBoQ1x093463@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, Brad Davis Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C971316A4CE for ; Fri, 23 Jul 2004 11:43:51 +0000 (GMT) Received: from valentine.liquidneon.com (valentine.liquidneon.com [216.38.206.180]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9BEC243D1D for ; Fri, 23 Jul 2004 11:43:51 +0000 (GMT) (envelope-from bdavis@house.so14k.com) Received: from localhost (localhost [127.0.0.1]) by valentine.liquidneon.com (Postfix) with ESMTP id 0EBA5FD for ; Fri, 23 Jul 2004 05:43:50 -0600 (MDT) Received: from valentine.liquidneon.com ([216.38.206.180]) by localhost (valentine.liquidneon.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 21540-09 for ; Fri, 23 Jul 2004 05:43:49 -0600 (MDT) Received: from mccaffrey.house.so14k.com (c-24-8-51-173.client.comcast.net [24.8.51.173]) by valentine.liquidneon.com (Postfix) with ESMTP id 992E14F for ; Fri, 23 Jul 2004 05:43:49 -0600 (MDT) Received: by mccaffrey.house.so14k.com (Postfix, from userid 1001) id 49389A89; Fri, 23 Jul 2004 05:43:49 -0600 (MDT) Message-Id: <20040723114349.49389A89@mccaffrey.house.so14k.com> Date: Fri, 23 Jul 2004 05:43:49 -0600 (MDT) From: Brad Davis To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69478: Add bit about Apache VirtualHosts X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Brad Davis List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Jul 2004 11:50:26 -0000 >Number: 69478 >Category: docs >Synopsis: Add bit about Apache VirtualHosts >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 Jul 23 11:50:26 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Brad Davis >Release: FreeBSD 4.10-STABLE i386 >Organization: >Environment: System: FreeBSD mccaffrey.house.so14k.com 4.10-STABLE FreeBSD 4.10-STABLE #0: Fri May 28 08:02:41 MDT 2004 root@mccaffrey.house.so14k.com:/usr/obj/usr/src/sys/MCCAFFREY i386 >Description: Add bit about VirtualHosts to the Apache section >How-To-Repeat: >Fix: --- doc-ori/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml Fri Jul 23 01:22:03 2004 +++ doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml Fri Jul 23 05:40:43 2004 @@ -4161,6 +4161,40 @@ + Virtual Hosting + + Apache supports two different types of Virtual Hosting. The first method is + Name-based Virtual Hosting. Name-based virtual hosting uses the clients HTTP/1.1 + headers to figure out the hostname. This allows many different domains to share + the same IP address. + + To setup Apache to use Name-based Virtual Hosting add an entry like the following + to your httpd.conf. + + NameVirtualHost * + + If you had the domains www.domain.tld and www.someotherdomain.tld you would add + entries that look like the following: + + <VirtualHost *> +ServerName www.domain.tld +DocumentRoot /www/domain.tld +<VirtualHost> + +<VirtualHost *> +ServerName www.someotherdomain.tld +DocumentRoot /www/someotherdomain.tld +</VirtualHost> + + Replace the addresses with the addresses you want to use and the path to the + documents with what you are using. + + For more info consult the official Apache documentation at: + + + + + Apache Modules Apache >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri Jul 23 11:52:59 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E433316A4CE; Fri, 23 Jul 2004 11:52:59 +0000 (GMT) Received: from valentine.liquidneon.com (valentine.liquidneon.com [216.38.206.180]) by mx1.FreeBSD.org (Postfix) with ESMTP id CA2B043D48; Fri, 23 Jul 2004 11:52:59 +0000 (GMT) (envelope-from so14k@so14k.com) Received: from localhost (localhost [127.0.0.1]) by valentine.liquidneon.com (Postfix) with ESMTP id 6BEA4103; Fri, 23 Jul 2004 05:52:59 -0600 (MDT) Received: from valentine.liquidneon.com ([216.38.206.180]) by localhost (valentine.liquidneon.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 22381-01; Fri, 23 Jul 2004 05:52:59 -0600 (MDT) Received: from webmail.liquidneon.com (valentine.liquidneon.com [216.38.206.180]) by valentine.liquidneon.com (Postfix) with ESMTP id DEB384F; Fri, 23 Jul 2004 05:52:58 -0600 (MDT) Received: from 199.201.236.2 (SquirrelMail authenticated user so14k@so14k.com); by webmail.liquidneon.com with HTTP; Fri, 23 Jul 2004 05:52:58 -0600 (MDT) Message-ID: <11802.199.201.236.2.1090583578.squirrel@199.201.236.2> In-Reply-To: <200407230850.i6N8oR7b071555@freefall.freebsd.org> References: <200407230850.i6N8oR7b071555@freefall.freebsd.org> Date: Fri, 23 Jul 2004 05:52:58 -0600 (MDT) From: "Brad Davis" To: "Michael Nottebrock" User-Agent: SquirrelMail/1.4.3a X-Mailer: SquirrelMail/1.4.3a MIME-Version: 1.0 Content-Type: text/plain;charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Priority: 3 (Normal) Importance: Normal X-Virus-Scanned: by amavisd-new at liquidneon.com cc: freebsd-doc@freebsd.org Subject: Re: docs/69471: Fix Caps & Correct the resources/install X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Jul 2004 11:53:00 -0000 I agree with lofi, so here is an updated patch to reflect the changes... --- doc-ori/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml Fri Jul 23 01:22:03 2004 +++ doc/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml Fri Jul 23 05:51:04 2004 @@ -159,15 +159,15 @@ Firefox - heavy + medium heavy Gtk+ Konqueror - light - light + medium + heavy KDE Libraries @@ -414,7 +414,7 @@ of KDE by installing x11/kdebase3. Konqueror is much more than a browser, - it is also a File Manager and a Multimedia Viewer. + it is also a file manager and a multimedia viewer. Konqueror also comes with a set of plugins, available in misc/konq-plugins. Regards, Brad Davis From owner-freebsd-doc@FreeBSD.ORG Fri Jul 23 12:08:50 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B852316A4CF; Fri, 23 Jul 2004 12:08:50 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 98D3643D48; Fri, 23 Jul 2004 12:08:50 +0000 (GMT) (envelope-from blackend@FreeBSD.org) Received: from freefall.freebsd.org (blackend@localhost [127.0.0.1]) i6NC8oC7097939; Fri, 23 Jul 2004 12:08:50 GMT (envelope-from blackend@freefall.freebsd.org) Received: (from blackend@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6NC8owC097935; Fri, 23 Jul 2004 12:08:50 GMT (envelope-from blackend) Date: Fri, 23 Jul 2004 12:08:50 GMT From: Marc Fonvieille Message-Id: <200407231208.i6NC8owC097935@freefall.freebsd.org> To: so14k@so14k.com, blackend@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/69471: Fix Caps & Correct the resources/install X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Jul 2004 12:08:50 -0000 Synopsis: Fix Caps & Correct the resources/install State-Changed-From-To: open->closed State-Changed-By: blackend State-Changed-When: Fri Jul 23 12:08:19 GMT 2004 State-Changed-Why: Fixed according to the discussion on -doc. Thanks. http://www.freebsd.org/cgi/query-pr.cgi?pr=69471 From owner-freebsd-doc@FreeBSD.ORG Fri Jul 23 17:11:48 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id AF1BF16A4CE; Fri, 23 Jul 2004 17:11:48 +0000 (GMT) Received: from smtp.eos.ocn.ne.jp (eos.ocn.ne.jp [211.6.83.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3688443D1F; Fri, 23 Jul 2004 17:11:48 +0000 (GMT) (envelope-from hrs@FreeBSD.org) Received: from delta.allbsd.org (p25007-adsao12honb4-acca.tokyo.ocn.ne.jp [219.161.86.7]) by smtp.eos.ocn.ne.jp (Postfix) with ESMTP id 04A4C157A; Sat, 24 Jul 2004 02:11:47 +0900 (JST) Received: from localhost (alph.allbsd.org [192.168.0.10]) by delta.allbsd.org (8.12.9p2/8.12.9) with ESMTP id i6NHBHA2064823; Sat, 24 Jul 2004 02:11:18 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Sat, 24 Jul 2004 02:10:23 +0900 (JST) Message-Id: <20040724.021023.78760665.hrs@eos.ocn.ne.jp> To: den@FreeBSD.org From: Hiroki Sato In-Reply-To: <40FC049D.4010902@FreeBSD.org> <20040720132947.GB17260@hub.freebsd.org> <40FCDD4B.5050904@FreeBSD.org> References: <20040719100354.GA90972@hub.freebsd.org> <40FC049D.4010902@FreeBSD.org> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 4.0.65 on Emacs 21.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Sat_Jul_24_02_10_23_2004_380)--" Content-Transfer-Encoding: 7bit cc: murray@FreeBSD.org cc: doc@FreeBSD.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Jul 2004 17:11:48 -0000 ----Security_Multipart(Sat_Jul_24_02_10_23_2004_380)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Hi, sorry for the delay. I was in trouble with my network connection for the past week... Denis Peplin wrote in <40FC049D.4010902@FreeBSD.org>: den> Currently we have one small problem with links between books - den> relative and absolute links. For example, in printed version of den> Handbook I see something like: ../faq/some_url.html Denis Peplin wrote in <40FCDD4B.5050904@FreeBSD.org>: den> + den> + den> + den> + den> + (snip) I looked your patch, but I think entities with langcode should not be divided as url..book and so on, since it increases the number of entities and make difficult to maintain it. I will work on the issue this weekend, so could you please wait? Thanks. -- | Hiroki SATO ----Security_Multipart(Sat_Jul_24_02_10_23_2004_380)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQBBAUZ/TyzT2CeTzy0RAj7NAKCUG0VycPdcm7cnzw6LLtZuxgnuWQCeKJoM Fbt4jJzZa5LUoRH5Yz0sQ5Q= =U7O5 -----END PGP SIGNATURE----- ----Security_Multipart(Sat_Jul_24_02_10_23_2004_380)---- From owner-freebsd-doc@FreeBSD.ORG Fri Jul 23 21:15:51 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5B8BE16A4CE for ; Fri, 23 Jul 2004 21:15:51 +0000 (GMT) Received: from web50809.mail.yahoo.com (web50809.mail.yahoo.com [206.190.38.252]) by mx1.FreeBSD.org (Postfix) with SMTP id E403343D45 for ; Fri, 23 Jul 2004 21:15:50 +0000 (GMT) (envelope-from suedes098@yahoo.com) Message-ID: <20040723211550.42263.qmail@web50809.mail.yahoo.com> Received: from [68.1.176.154] by web50809.mail.yahoo.com via HTTP; Fri, 23 Jul 2004 14:15:50 PDT Date: Fri, 23 Jul 2004 14:15:50 -0700 (PDT) From: Dan To: freebsd-doc@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Subject: correction needed for Freebsd 5.3 to do list page X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Jul 2004 21:15:51 -0000 Hey, I check the to do list page for Freebsd 5.3 regularly, and just wanted to let you guys know that it currently has a table error in the html coding http://www.freebsd.org/releases/5.3R/todo.html Hope that helps Have a good one Dan __________________________________ Do you Yahoo!? New and Improved Yahoo! Mail - 100MB free storage! http://promotions.yahoo.com/new_mail From owner-freebsd-doc@FreeBSD.ORG Fri Jul 23 21:26:16 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B821B16A4CE for ; Fri, 23 Jul 2004 21:26:16 +0000 (GMT) Received: from zaphod.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6FE8A43D3F for ; Fri, 23 Jul 2004 21:26:16 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id ACC71119B1; Fri, 23 Jul 2004 23:26:15 +0200 (CEST) Date: Fri, 23 Jul 2004 23:26:15 +0200 From: "Simon L. Nielsen" To: Dan Message-ID: <20040723212615.GD740@zaphod.nitro.dk> References: <20040723211550.42263.qmail@web50809.mail.yahoo.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="imjhCm/Pyz7Rq5F2" Content-Disposition: inline In-Reply-To: <20040723211550.42263.qmail@web50809.mail.yahoo.com> User-Agent: Mutt/1.5.6i cc: freebsd-doc@FreeBSD.org Subject: Re: correction needed for Freebsd 5.3 to do list page X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Jul 2004 21:26:16 -0000 --imjhCm/Pyz7Rq5F2 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.07.23 14:15:50 -0700, Dan wrote: > I check the to do list page for Freebsd 5.3 > regularly, and just wanted to let you guys know that > it currently has a table error in the html coding >=20 > http://www.freebsd.org/releases/5.3R/todo.html >=20 > Hope that helps I just contacted the Release Engineering team who "owns" the file, so it should hopefully be fixed shortly. Thanks for letting us know. --=20 Simon L. Nielsen FreeBSD Documentation Team --imjhCm/Pyz7Rq5F2 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFBAYJ3h9pcDSc1mlERAvnqAJ9q5YKA8HRvK9+H0Lgt1tZ0hGEEcACeKt8a F4ytHrnzCbfDG+MAJN7zAqU= =PJI8 -----END PGP SIGNATURE----- --imjhCm/Pyz7Rq5F2-- From owner-freebsd-doc@FreeBSD.ORG Sat Jul 24 01:52:52 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D29A216A4CE for ; Sat, 24 Jul 2004 01:52:52 +0000 (GMT) Received: from mproxy.gmail.com (rproxy.gmail.com [64.233.170.203]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6C90943D3F for ; Sat, 24 Jul 2004 01:52:52 +0000 (GMT) (envelope-from jon.drews@gmail.com) Received: by mproxy.gmail.com with SMTP id 78so31603rnl for ; Fri, 23 Jul 2004 18:52:51 -0700 (PDT) Received: by 10.38.82.2 with SMTP id f2mr3521rnb; Fri, 23 Jul 2004 18:52:51 -0700 (PDT) Message-ID: <8cb27cbf0407231852d41b5b4@mail.gmail.com> Date: Fri, 23 Jul 2004 20:52:51 -0500 From: Jon Drews To: freebsd-doc@freebsd.org Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Subject: Submission for USB scanning in FreeBSD X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 Jul 2004 01:52:53 -0000 Hi: I have seen quite a few questions on how to setup document scanning in FreeBSD and so I thought would submit this. Admittedly, it deals only with USB scanning; I have no experience with SCSI. I have used this in both 4.X and CURRENT. I also need to add the relevant man pages, as they are a good source of information also. Anyway here is a preliminary "howto"; feedback is welcome. USB Document Scanning in FreeBSD _____________________________________________________ Go to http://www.sane-project.org/sane-supported-devices.html and determine if your scanner is supported. 1) Install /usr/ports/graphics/sane-backends/, /usr/ports/graphics/sane-frontends/ and/or /usr/ports/graphics/xsane/ 2) run: # sane-find-scanner as root. In the case of my Epson, it found /dev/uscanner0 3) For an Epson scanner edit /usr/local/etc/sane.d/epson.conf and put in the device that sane-find-scanner discovered. In my case, the epson.conf file looks like so. Be sure to comment out the line "scsi EPSON". # epson.conf # # here are some examples for how to configure the EPSON backend # # SCSI scanner: #scsi EPSON # # Parallel port scanner: #pio 0x278 #pio 0x378 #pio 0x3BC # # USB scanner - only enable this if you have an EPSON scanner. It could # otherwise block your non-EPSON scanner from being # recognized. # Depending on your distribution, you may need either the # first or the second entry. #usb /dev/usbscanner0 #usb /dev/usb/scanner0 usb /dev/uscanner0 4) Add your account to group operator like so: operator:*:5:root,$ACCOUNT_THAT_HAS_SCANNER 5) Start Xsane or one of the other front ends and begin scanning. From owner-freebsd-doc@FreeBSD.ORG Sat Jul 24 07:28:18 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8FC4A16A4CE for ; Sat, 24 Jul 2004 07:28:18 +0000 (GMT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 891F843D2F for ; Sat, 24 Jul 2004 07:28:17 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) i6O7SFA3031381; Sat, 24 Jul 2004 09:28:15 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.11/8.12.11/Submit) id i6O7SFhN031380; Sat, 24 Jul 2004 09:28:15 +0200 (CEST) (envelope-from marc) Date: Sat, 24 Jul 2004 09:28:14 +0200 From: Marc Fonvieille To: Jon Drews Message-ID: <20040724072814.GA31347@abigail.blackend.org> References: <8cb27cbf0407231852d41b5b4@mail.gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <8cb27cbf0407231852d41b5b4@mail.gmail.com> User-Agent: Mutt/1.4.2.1i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.10-PRERELEASE cc: freebsd-doc@freebsd.org Subject: Re: Submission for USB scanning in FreeBSD X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 Jul 2004 07:28:18 -0000 On Fri, Jul 23, 2004 at 08:52:51PM -0500, Jon Drews wrote: > Hi: > > I have seen quite a few questions on how to setup document scanning > in FreeBSD and so I thought would submit this. Admittedly, it deals > only with USB scanning; I have no experience with SCSI. I have used > this in both 4.X and CURRENT. I also need to add the relevant man > pages, as they are a good source of information also. Anyway here is a > preliminary "howto"; feedback is welcome. > [...] I have the bits to write one section about image scanners (SCSI, USB etc.). I will see what I can do with your doc. I will grab, if possible, a scanner asking for a firmware load since it's a complex example. Marc From owner-freebsd-doc@FreeBSD.ORG Sat Jul 24 08:19:27 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 604B816A4CE for ; Sat, 24 Jul 2004 08:19:27 +0000 (GMT) Received: from castle.jp.FreeBSD.org (castle.jp.FreeBSD.org [210.226.20.15]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9B60843D1F for ; Sat, 24 Jul 2004 08:19:24 +0000 (GMT) (envelope-from QandA-request@jp.FreeBSD.org) Received: (from daemon@localhost) by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) id i6O8JNB32714; Sat, 24 Jul 2004 17:19:23 +0900 (JST) (envelope-from QandA-request@jp.FreeBSD.org) Date: Sat, 24 Jul 2004 17:19:23 +0900 (JST) From: QandA-request@jp.FreeBSD.org Message-Id: <200407240819.i6O8JNB32714@castle.jp.FreeBSD.org> To: doc@freebsd.org In-Reply-To: Your message of "Sat, 24 Jul 2004 17:19:12 +0900" <200407240819.i6O8JK832683@castle.jp.FreeBSD.org> References: <200407240819.i6O8JK832683@castle.jp.FreeBSD.org> Subject: Re: Approved document X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 Jul 2004 08:19:27 -0000 QandAへの投稿 ありがとうございます。皆様からお寄せ頂いたQandAは、 QandAプロジェクト内にて確認・整理され、FreeBSD QandA集に追加され ます。 この追加された QandAの文章は BSD StyleのCopyrightに設定さ れ、QandA文章の持ち主は The FreeBSD QandA Project (Japan) となり ますので、予めご承知ください。 以下に COPYRIGHT を添付します。 Copyright 1997, 1998 The FreeBSD QandA Project (Japan). http://www.jp.freebsd.org/QandA/ All rights reserved. Redistribution and use in unformatted and formatted forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of these documents in unformatted form must retain the above copyright notice, these conditions and the following disclaimer. 2. Redistributions of these documents in formatted form, if not accompanied by unformatted versions of the documents, must include a file containing the above copyright notice, these conditions and the following disclaimer. THESE DOCUMENTS ARE PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THESE DOCUMENTS, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. QandA へ質問のみを送られた方へ この QandA@jp.FreeBSD.org は質問を受け付ける場所ではありません。 をご覧になり、適切な メーリングリストへ加入してそちらへ質問してください。 From owner-freebsd-doc@FreeBSD.ORG Sat Jul 24 09:22:15 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8BC4C16A4CF for ; Sat, 24 Jul 2004 09:22:15 +0000 (GMT) Received: from comp.chem.msu.su (comp.chem.msu.su [158.250.32.97]) by mx1.FreeBSD.org (Postfix) with ESMTP id A132643D46 for ; Sat, 24 Jul 2004 09:22:14 +0000 (GMT) (envelope-from yar@comp.chem.msu.su) Received: from comp.chem.msu.su (localhost [127.0.0.1]) by comp.chem.msu.su (8.12.9p2/8.12.9) with ESMTP id i6O9MB6E010154 for ; Sat, 24 Jul 2004 13:22:11 +0400 (MSD) (envelope-from yar@comp.chem.msu.su) Received: (from yar@localhost) by comp.chem.msu.su (8.12.9p2/8.12.9/Submit) id i6O9MBmC010153 for doc@freebsd.org; Sat, 24 Jul 2004 13:22:11 +0400 (MSD) (envelope-from yar) Date: Sat, 24 Jul 2004 13:22:10 +0400 From: Yar Tikhiy To: doc@freebsd.org Message-ID: <20040724092210.GA7369@comp.chem.msu.su> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.5.6i Subject: Style for a long callout list X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 Jul 2004 09:22:15 -0000 Hi folks, eik@ and yours truly are writing a chapter for the Porters Handbook, in which we need to mark up a callout list as long as 20 items. We are concerned that so long callout list will be rendered by default using both graphic and textual representation of callout numbers, which looks somewhat ugly. What is the current FDP style as to this issue? Should we leave it alone or turn off callout graphics for the list completely? And if the latter, how could it be done? Thanks! -- Yar From owner-freebsd-doc@FreeBSD.ORG Sat Jul 24 09:39:33 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id AC49B16A4CE; Sat, 24 Jul 2004 09:39:33 +0000 (GMT) Received: from smtp.eos.ocn.ne.jp (eos.ocn.ne.jp [211.6.83.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2E21C43D53; Sat, 24 Jul 2004 09:39:33 +0000 (GMT) (envelope-from hrs@FreeBSD.org) Received: from delta.allbsd.org (p25007-adsao12honb4-acca.tokyo.ocn.ne.jp [219.161.86.7]) by smtp.eos.ocn.ne.jp (Postfix) with ESMTP id 909A31FC8; Sat, 24 Jul 2004 18:39:31 +0900 (JST) Received: from localhost (alph.allbsd.org [192.168.0.10]) by delta.allbsd.org (8.12.9p2/8.12.9) with ESMTP id i6O9dBA2071659; Sat, 24 Jul 2004 18:39:12 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Sat, 24 Jul 2004 18:37:04 +0900 (JST) Message-Id: <20040724.183704.07580226.hrs@eos.ocn.ne.jp> To: den@FreeBSD.org From: Hiroki Sato In-Reply-To: <20040724.021023.78760665.hrs@eos.ocn.ne.jp> References: <20040719100354.GA90972@hub.freebsd.org> <40FC049D.4010902@FreeBSD.org> <20040724.021023.78760665.hrs@eos.ocn.ne.jp> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 4.0.65 on Emacs 21.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart0(Sat_Jul_24_18_37_04_2004_249)--" Content-Transfer-Encoding: 7bit cc: murray@FreeBSD.org cc: doc@FreeBSD.org cc: hrs@FreeBSD.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 Jul 2004 09:39:33 -0000 ----Security_Multipart0(Sat_Jul_24_18_37_04_2004_249)-- Content-Type: Multipart/Mixed; boundary="--Next_Part(Sat_Jul_24_18_37_04_2004_124)--" Content-Transfer-Encoding: 7bit ----Next_Part(Sat_Jul_24_18_37_04_2004_124)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Hi, Hiroki Sato wrote in <20040724.021023.78760665.hrs@eos.ocn.ne.jp>: hrs> I will work on the issue this weekend, so could you please hrs> wait? Thanks. Patches are attached. In doc-relative-urls.diff, articles/checkpoint is used for an example. It defines &doc.langcode; in l10n.ent, and it is used for series of the entites &url.books.*; and &url.articles.*; defined in urls.ent. As a result, &url.books.handbook; always points the localized handbook. Since the translation teams often use a link to the original document, &url.books.*.en; are also defined. Comments? What we need to do are: 1) Define doc.langcode in /share/sgml/l10n.ent. When it is not defined, en_US.ISO8859-1 is used by default. (in the case of ja_JP.eucJP, for example, the changes are something like doc-relative-urls-ja.diff). 2) Add URL_RELPREFIX in the Makefile. When it is not defined, absolute URLs are always used. 3) Add l10n.ent and urls.ent in the document preamble. 4) Use &url.*; to point documents in doc/. -- | Hiroki SATO ----Next_Part(Sat_Jul_24_18_37_04_2004_124)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="doc-relative-urls.diff" Index: en_US.ISO8859-1/articles/checkpoint/Makefile =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/checkpoint/Makefile,v retrieving revision 1.6 diff -d -u -I\$FreeBSD:.*\$ -I\$NetBSD:.*\$ -I\$OpenBSD:.*\$ -I\$DragonFly:.*\$ -I\$Id:.*\$ -I\$hrs:.*\$ -r1.6 Makefile --- en_US.ISO8859-1/articles/checkpoint/Makefile 6 Apr 2004 16:10:02 -0000 1.6 +++ en_US.ISO8859-1/articles/checkpoint/Makefile 24 Jul 2004 08:58:14 -0000 @@ -13,5 +13,6 @@ SRCS= article.sgml IMAGES_EN= networks.pic +URL_RELPREFIX?= ../../.. DOC_PREFIX?= ${.CURDIR}/../../.. .include "${DOC_PREFIX}/share/mk/doc.project.mk" Index: en_US.ISO8859-1/articles/checkpoint/article.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/checkpoint/article.sgml,v retrieving revision 1.20 diff -d -u -I\$FreeBSD:.*\$ -I\$NetBSD:.*\$ -I\$OpenBSD:.*\$ -I\$DragonFly:.*\$ -I\$Id:.*\$ -I\$hrs:.*\$ -r1.20 article.sgml --- en_US.ISO8859-1/articles/checkpoint/article.sgml 23 Jul 2004 10:43:21 -0000 1.20 +++ en_US.ISO8859-1/articles/checkpoint/article.sgml 24 Jul 2004 09:08:17 -0000 @@ -35,6 +35,10 @@ %trademarks; + +%l10n.ent; + +%urls.ent; ]>
@@ -125,7 +129,7 @@ options IPSEC_DEBUG For instructions on building a custom kernel, refer to the - FreeBSD + FreeBSD handbook. Please note that IP protocol 50 (ESP) and UDP port 500 must be open between the Firewall-1 @@ -421,7 +425,7 @@ The FreeBSD Handbook: VPN over IPsec. - + Index: en_US.ISO8859-1/share/sgml/l10n.ent =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/share/sgml/l10n.ent,v retrieving revision 1.1 diff -d -u -I\$FreeBSD:.*\$ -I\$NetBSD:.*\$ -I\$OpenBSD:.*\$ -I\$DragonFly:.*\$ -I\$Id:.*\$ -I\$hrs:.*\$ -r1.1 l10n.ent --- en_US.ISO8859-1/share/sgml/l10n.ent 19 Apr 2003 11:39:28 -0000 1.1 +++ en_US.ISO8859-1/share/sgml/l10n.ent 24 Jul 2004 09:09:44 -0000 @@ -7,3 +7,6 @@ + + + Index: share/sgml/urls.ent =================================================================== RCS file: /home/ncvs/doc/share/sgml/urls.ent,v retrieving revision 1.4 diff -d -u -I\$FreeBSD:.*\$ -I\$NetBSD:.*\$ -I\$OpenBSD:.*\$ -I\$DragonFly:.*\$ -I\$Id:.*\$ -I\$hrs:.*\$ -r1.4 urls.ent --- share/sgml/urls.ent 7 Jul 2004 11:23:16 -0000 1.4 +++ share/sgml/urls.ent 24 Jul 2004 09:03:40 -0000 @@ -37,16 +37,119 @@ ]]> - - - - ]]> + - + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ----Next_Part(Sat_Jul_24_18_37_04_2004_124)-- Content-Type: Text/Plain; charset=iso-2022-jp Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="doc-relative-urls-ja.diff" Index: ja_JP.eucJP/share/sgml/l10n.ent =================================================================== RCS file: /home/ncvs/doc/ja_JP.eucJP/share/sgml/l10n.ent,v retrieving revision 1.1 diff -d -u -I\$FreeBSD:.*\$ -I\$NetBSD:.*\$ -I\$OpenBSD:.*\$ -I\$DragonFly:.*\$ -I\$Id:.*\$ -I\$hrs:.*\$ -r1.1 l10n.ent --- ja_JP.eucJP/share/sgml/l10n.ent 19 Apr 2003 11:39:30 -0000 1.1 +++ ja_JP.eucJP/share/sgml/l10n.ent 24 Jul 2004 08:52:57 -0000 @@ -7,3 +7,6 @@ + + + ----Next_Part(Sat_Jul_24_18_37_04_2004_124)---- ----Security_Multipart0(Sat_Jul_24_18_37_04_2004_249)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQBBAi3CTyzT2CeTzy0RArlNAJ9b7veQXtDI0M0+cvdgapY8yuYcDwCfclcz 00Ys3XdWzxcj6jIxcix1pUo= =Be3y -----END PGP SIGNATURE----- ----Security_Multipart0(Sat_Jul_24_18_37_04_2004_249)---- From owner-freebsd-doc@FreeBSD.ORG Sat Jul 24 11:51:32 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 887E116A4CF; Sat, 24 Jul 2004 11:51:32 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8078843D1D; Sat, 24 Jul 2004 11:51:32 +0000 (GMT) (envelope-from schweikh@FreeBSD.org) Received: from freefall.freebsd.org (schweikh@localhost [127.0.0.1]) i6OBpW73072327; Sat, 24 Jul 2004 11:51:32 GMT (envelope-from schweikh@freefall.freebsd.org) Received: (from schweikh@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6OBpW3Y072323; Sat, 24 Jul 2004 11:51:32 GMT (envelope-from schweikh) Date: Sat, 24 Jul 2004 11:51:32 GMT From: Jens Schweikhardt Message-Id: <200407241151.i6OBpW3Y072323@freefall.freebsd.org> To: cejkar@fit.vutbr.cz, schweikh@FreeBSD.org, freebsd-doc@FreeBSD.org, peter@FreeBSD.org Subject: Re: docs/56981: man terminfo(5) from libncurses does not display correctly X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 Jul 2004 11:51:32 -0000 Synopsis: man terminfo(5) from libncurses does not display correctly State-Changed-From-To: open->analyzed State-Changed-By: schweikh State-Changed-When: Sat Jul 24 11:46:52 GMT 2004 State-Changed-Why: This is because our contrib/ncurses is out-of-date. We still use ncurses 5.2 while 5.4 is the most recent version (and where the problem is fixed according to the ncurses maintainer, T.Dickey). So what is needed is an import of 5.4. Responsible-Changed-From-To: freebsd-doc->peter Responsible-Changed-By: schweikh Responsible-Changed-When: Sat Jul 24 11:46:52 GMT 2004 Responsible-Changed-Why: Over to Peter Wemm, who has imported ncurses in the past. Peter, could you please have a look at this? http://www.freebsd.org/cgi/query-pr.cgi?pr=56981 From owner-freebsd-doc@FreeBSD.ORG Sat Jul 24 11:59:03 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 54B0716A4CE; Sat, 24 Jul 2004 11:59:03 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3A4F043D3F; Sat, 24 Jul 2004 11:59:03 +0000 (GMT) (envelope-from schweikh@FreeBSD.org) Received: from freefall.freebsd.org (schweikh@localhost [127.0.0.1]) i6OBx3nj072447; Sat, 24 Jul 2004 11:59:03 GMT (envelope-from schweikh@freefall.freebsd.org) Received: (from schweikh@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6OBx3K1072443; Sat, 24 Jul 2004 11:59:03 GMT (envelope-from schweikh) Date: Sat, 24 Jul 2004 11:59:03 GMT From: Jens Schweikhardt Message-Id: <200407241159.i6OBx3K1072443@freefall.freebsd.org> To: horikawa@FreeBSD.org, schweikh@FreeBSD.org, freebsd-doc@FreeBSD.org, peter@FreeBSD.org Subject: Re: docs/46709: tables in terminfo.5 are broken X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 Jul 2004 11:59:03 -0000 Synopsis: tables in terminfo.5 are broken State-Changed-From-To: open->analyzed State-Changed-By: schweikh State-Changed-When: Sat Jul 24 11:57:19 GMT 2004 State-Changed-Why: This is a duplicate of 56981 and the fix is the same: Update contrib/ncurses to 5.4. Responsible-Changed-From-To: freebsd-doc->peter Responsible-Changed-By: schweikh Responsible-Changed-When: Sat Jul 24 11:57:19 GMT 2004 Responsible-Changed-Why: Peter, if you import ncurses 5.4, this PR can be closed as well. http://www.freebsd.org/cgi/query-pr.cgi?pr=46709 From owner-freebsd-doc@FreeBSD.ORG Sat Jul 24 13:52:04 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 20B7016A4CE for ; Sat, 24 Jul 2004 13:52:04 +0000 (GMT) Received: from shrike.submonkey.net (cpc2-cdif3-6-0-cust204.cdif.cable.ntl.com [81.103.67.204]) by mx1.FreeBSD.org (Postfix) with ESMTP id B0F4B43D1D for ; Sat, 24 Jul 2004 13:52:03 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.41 (FreeBSD)) id 1BoMwU-000G4V-4M; Sat, 24 Jul 2004 14:52:02 +0100 Date: Sat, 24 Jul 2004 14:52:02 +0100 From: Ceri Davies To: Yar Tikhiy Message-ID: <20040724135202.GA24947@submonkey.net> Mail-Followup-To: Ceri Davies , Yar Tikhiy , doc@freebsd.org References: <20040724092210.GA7369@comp.chem.msu.su> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="0OAP2g/MAC+5xKAE" Content-Disposition: inline In-Reply-To: <20040724092210.GA7369@comp.chem.msu.su> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: doc@freebsd.org Subject: Re: Style for a long callout list X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 Jul 2004 13:52:04 -0000 --0OAP2g/MAC+5xKAE Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, Jul 24, 2004 at 01:22:10PM +0400, Yar Tikhiy wrote: > Hi folks, >=20 > eik@ and yours truly are writing a chapter for the Porters Handbook, > in which we need to mark up a callout list as long as 20 items. We > are concerned that so long callout list will be rendered by default > using both graphic and textual representation of callout numbers, > which looks somewhat ugly. What is the current FDP style as to this > issue? Should we leave it alone or turn off callout graphics for > the list completely? And if the latter, how could it be done? Stick with it for now. We're hoping to add callout images up to 25 some time soon. Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --0OAP2g/MAC+5xKAE Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFBAmmBocfcwTS3JF8RAmzRAJ9ANxyCXq9KQlWUawGQIKV3pdrDjwCfT3vw wOTw6DM7q4ehOaXlHKCeR0E= =Z6Rq -----END PGP SIGNATURE----- --0OAP2g/MAC+5xKAE-- From owner-freebsd-doc@FreeBSD.ORG Sat Jul 24 14:06:16 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A375416A4CE for ; Sat, 24 Jul 2004 14:06:16 +0000 (GMT) Received: from comp.chem.msu.su (comp.chem.msu.su [158.250.32.97]) by mx1.FreeBSD.org (Postfix) with ESMTP id 368DB43D2F for ; Sat, 24 Jul 2004 14:06:15 +0000 (GMT) (envelope-from yar@comp.chem.msu.su) Received: from comp.chem.msu.su (localhost [127.0.0.1]) by comp.chem.msu.su (8.12.9p2/8.12.9) with ESMTP id i6OE6A6E021308; Sat, 24 Jul 2004 18:06:10 +0400 (MSD) (envelope-from yar@comp.chem.msu.su) Received: (from yar@localhost) by comp.chem.msu.su (8.12.9p2/8.12.9/Submit) id i6OE69mI021307; Sat, 24 Jul 2004 18:06:09 +0400 (MSD) (envelope-from yar) Date: Sat, 24 Jul 2004 18:06:09 +0400 From: Yar Tikhiy To: Ceri Davies , doc@freebsd.org Message-ID: <20040724140608.GE7369@comp.chem.msu.su> References: <20040724092210.GA7369@comp.chem.msu.su> <20040724135202.GA24947@submonkey.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040724135202.GA24947@submonkey.net> User-Agent: Mutt/1.5.6i Subject: Re: Style for a long callout list X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 Jul 2004 14:06:16 -0000 On Sat, Jul 24, 2004 at 02:52:02PM +0100, Ceri Davies wrote: > On Sat, Jul 24, 2004 at 01:22:10PM +0400, Yar Tikhiy wrote: > > > > eik@ and yours truly are writing a chapter for the Porters Handbook, > > in which we need to mark up a callout list as long as 20 items. We > > are concerned that so long callout list will be rendered by default > > using both graphic and textual representation of callout numbers, > > which looks somewhat ugly. What is the current FDP style as to this > > issue? Should we leave it alone or turn off callout graphics for > > the list completely? And if the latter, how could it be done? > > Stick with it for now. We're hoping to add callout images up to 25 some > time soon. I see, thanks! -- Yar From owner-freebsd-doc@FreeBSD.ORG Sat Jul 24 16:05:35 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6366C16A4CE for ; Sat, 24 Jul 2004 16:05:35 +0000 (GMT) Received: from qbop.com (mail.qbop.com [207.161.102.51]) by mx1.FreeBSD.org (Postfix) with ESMTP id D306D43D2F for ; Sat, 24 Jul 2004 16:05:34 +0000 (GMT) (envelope-from "") Received: from [207.161.102.51] by qbop.com [207.161.102.51] with SmartMax MailMax for doc@freebsd.org; Sat, 24 Jul 2004 11:05:58 -0500 X-SmartMax-AuthUser: To: doc@freebsd.org From: "Matthew Amihude" Message-ID: <1090685159.9253@qbop.com> Subject: Out of Office X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Date: Sat, 24 Jul 2004 16:05:35 -0000 X-Original-Date: Date: Sat, 24 Jul 2004 11:05:57 -0500 X-List-Received-Date: Sat, 24 Jul 2004 16:05:35 -0000 I will be out of the office until Tuesday July 27th, 2004. If you require immediate assistance please contact Shannon Galli at 204.989.5664 or via email at shannon@webwizmedia.com. Regards, Matt From owner-freebsd-doc@FreeBSD.ORG Sat Jul 24 16:13:11 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0B7B016A4CE for ; Sat, 24 Jul 2004 16:13:11 +0000 (GMT) Received: from redqueen.elvandar.org (cust.94.120.adsl.cistron.nl [195.64.94.120]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2830843D1D for ; Sat, 24 Jul 2004 16:13:08 +0000 (GMT) (envelope-from remko@elvandar.org) Received: from [10.0.2.122] (nimrod.elvandar.intranet [10.0.2.122]) by redqueen.elvandar.org (Postfix) with ESMTP id D916510685E; Sat, 24 Jul 2004 18:13:04 +0200 (CEST) Message-ID: <41028A91.1080502@elvandar.org> Date: Sat, 24 Jul 2004 18:13:05 +0200 From: Remko Lodder X-Accept-Language: en-us, en MIME-Version: 1.0 To: Matthew Amihude References: <1090685159.9253@qbop.com> In-Reply-To: <1090685159.9253@qbop.com> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Scanned: by amavisd-new at elvandar.org cc: doc@freebsd.org Subject: Re: Out of Office X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 Jul 2004 16:13:11 -0000 Matthew Amihude wrote: > I will be out of the office until Tuesday July 27th, 2004. If you require immediate assistance please contact Shannon Galli at 204.989.5664 or via email at shannon@webwizmedia.com. > Great, your useraccount is probably named "matt" or "matthew" and we can try to call shannon now for some information about your work etc. Good time to start hacking your account ! This might be the same reaction as a scriptkiddie or someone evil who wants to abuse you being away status on your work. On the otherhand, you can easily defend yourself against it. Don't send out, out of the office announcements. If you do, just don't include any information like phonenumbers or names, just give a general "you can also mail info@company.tld for more information" message, and make sure that your account is not named the same as matt or matthew... One more thing... please stop mail delivery, if you do need to send out of office announcements, for mailinglists. Thanks in advance, > Regards, > > Matt > -- Kind regards, Remko Lodder |remko@elvandar.org Reporter DSINet |remko@dsinet.org Projectleader Mostly-Harmless |remko@mostly-harmless.nl