From owner-freebsd-doc@FreeBSD.ORG Sun Jul 4 03:24:32 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 7F34D16A4CE; Sun, 4 Jul 2004 03:24:32 +0000 (GMT) Received: from mail.ciam.ru (mail.ciam.ru [213.147.57.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2A47243D4C; Sun, 4 Jul 2004 03:24:32 +0000 (GMT) (envelope-from sem@ciam.ru) Received: from ppp174-151.pppoe.mtu-net.ru ([81.195.174.151] helo=ciam.ru) by mail.ciam.ru with asmtp (Exim 4.x) id 1BgxcE-000Gkg-Kn; Sun, 04 Jul 2004 07:24:30 +0400 Message-ID: <40E7787A.70005@ciam.ru> Date: Sun, 04 Jul 2004 07:24:42 +0400 From: Sergey Matveychuk User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7b) Gecko/20040421 X-Accept-Language: en-us, en MIME-Version: 1.0 To: Giorgos Keramidas References: <40E76A91.70009@ciam.ru> <20040704030813.GA672@gothmog.gr> In-Reply-To: <20040704030813.GA672@gothmog.gr> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit cc: questions@freebsd.org cc: doc@freebsd.org cc: www@freebsd.org Subject: Re: the Donations Liaison Officer 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, 04 Jul 2004 03:24:32 -0000 Giorgos Keramidas wrote: > On 2004-07-04 06:25, Sergey Matveychuk wrote: > >>Who is the Donations Liaison Officer? It's not clear from >>http://www.freebsd.org/donations/index.html > > > Originally, it was Michael Lucas who was the DLO, if my memory doesn't > fail me. Unless this changed during the one year I've been away, he's > still the guy behind the donations@ mail alias. > > Is it very important to know the exact person though? The mail alias > points to the right person at any time. Not really. I've just miss "Just contact us at donations@FreeBSD.org with your offer" phrase. It should be made as mailto: link there. I've Cc: this to www@ and doc@ as offer. -- Sem. From owner-freebsd-doc@FreeBSD.ORG Sun Jul 4 07:31: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 255F116A4CE; Sun, 4 Jul 2004 07:31:48 +0000 (GMT) Received: from grog.secure-computing.net (front-door.secure-computing.net [63.228.14.246]) by mx1.FreeBSD.org (Postfix) with ESMTP id A853A43D1D; Sun, 4 Jul 2004 07:31:47 +0000 (GMT) (envelope-from ecrist@secure-computing.net) Received: from Nomad (nat-server.secure-computing.net [63.228.14.245]) (authenticated bits=0)i647VAUD079056; Sun, 4 Jul 2004 02:31:10 -0500 (CDT) (envelope-from ecrist@secure-computing.net) From: "Eric Crist" To: "'Sergey Matveychuk'" , "'Giorgos Keramidas'" Date: Sun, 4 Jul 2004 02:41:10 -0500 Message-ID: <01a301c4619a$49d88140$6501a8c0@Nomad> X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook, Build 10.0.2616 In-Reply-To: <40E7787A.70005@ciam.ru> X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1409 Importance: Normal X-Virus-Scanned: clamd / ClamAV version 0.72, clamav-milter version 0.72 on grog.secure-computing.net X-Virus-Status: Clean cc: questions@freebsd.org cc: doc@freebsd.org cc: www@freebsd.org Subject: RE: the Donations Liaison Officer 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, 04 Jul 2004 07:31:48 -0000 If there isn't one, I offer my expertise. I've been running a Corp for three ears and have a little free time now. Eric F Crist Found on Conan O'Brian: Children's books written by celebrities; By Mel Gibson: Jesus Christ and the Terrible, Horrible, No Good, Very Bad Day. ----- Keep your powder dry and your pecker hard and the world WILL turn. ----- Eric F Crist > -----Original Message----- > From: owner-freebsd-questions@freebsd.org > [mailto:owner-freebsd-questions@freebsd.org] On Behalf Of > Sergey Matveychuk > Sent: Saturday, July 03, 2004 10:25 PM > To: Giorgos Keramidas > Cc: questions@freebsd.org; doc@freebsd.org; www@freebsd.org > Subject: Re: the Donations Liaison Officer > > > Giorgos Keramidas wrote: > > > On 2004-07-04 06:25, Sergey Matveychuk wrote: > > > >>Who is the Donations Liaison Officer? It's not clear from > >>http://www.freebsd.org/donations/index.html > > > > > > Originally, it was Michael Lucas who was the DLO, if my > memory doesn't > > fail me. Unless this changed during the one year I've been > away, he's > > still the guy behind the donations@ mail alias. > > > > Is it very important to know the exact person though? The > mail alias > > points to the right person at any time. > > Not really. I've just miss "Just contact us at donations@FreeBSD.org > with your offer" phrase. It should be made as mailto: link there. > > I've Cc: this to www@ and doc@ as offer. > > -- > Sem. > _______________________________________________ > freebsd-questions@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/free> bsd-questions > > To unsubscribe, send any mail to > "freebsd-questions-unsubscribe@freebsd.org" > From owner-freebsd-doc@FreeBSD.ORG Sun Jul 4 12:13:32 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 4611E16A4CE; Sun, 4 Jul 2004 12:13:32 +0000 (GMT) Received: from gw.pelleg.org (gw.pelleg.org [205.201.13.235]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1C73243D3F; Sun, 4 Jul 2004 12:13:32 +0000 (GMT) (envelope-from daniel@pelleg.org) Received: from lank.here (lank.wburn [192.168.3.41]) by gw.pelleg.org (Postfix) with ESMTP id 7BEEB5A53; Sun, 4 Jul 2004 08:13:30 -0400 (EDT) Received: by lank.here (Postfix, from userid 7675) id B2EE2509; Sun, 4 Jul 2004 08:13:28 -0400 (EDT) To: freebsd-doc@freebsd.org, blackend@FreeBSD.org From: Dan Pelleg Date: Sun, 04 Jul 2004 08:13:28 -0400 Message-ID: User-Agent: Gnus/5.1002 (Gnus v5.10.2) XEmacs/21.1 (Cuyahoga Valley, berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Subject: RE: docs/57298: Using compact flash cards 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, 04 Jul 2004 12:13:32 -0000 Is anyone working on this PR? -- Dan Pelleg From owner-freebsd-doc@FreeBSD.ORG Sun Jul 4 20:45:26 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 A3DA516A4CE for ; Sun, 4 Jul 2004 20:45:26 +0000 (GMT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 96EAD43D45 for ; Sun, 4 Jul 2004 20:45:25 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) i64KjNO8050449; Sun, 4 Jul 2004 22:45:23 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.11/8.12.11/Submit) id i64KjNd8050448; Sun, 4 Jul 2004 22:45:23 +0200 (CEST) (envelope-from marc) Date: Sun, 4 Jul 2004 22:45:23 +0200 From: Marc Fonvieille To: Dan Pelleg Message-ID: <20040704204523.GB40868@abigail.blackend.org> References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: 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/57298: Using compact flash cards 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, 04 Jul 2004 20:45:26 -0000 On Sun, Jul 04, 2004 at 08:13:28AM -0400, Dan Pelleg wrote: > > Is anyone working on this PR? > I think I'm responsible of it, and it's why you CCed me :)) I have an "USB Storage Devices" section waiting for being added, I have to think how to merge the CF Card part. This addition will be done when life/work/etc. will give me enough time to do it. Marc From owner-freebsd-doc@FreeBSD.ORG Mon Jul 5 09:30: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 9CD7616A4CE for ; Mon, 5 Jul 2004 09:30:11 +0000 (GMT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 99FC143D45 for ; Mon, 5 Jul 2004 09:30:10 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) i659U8Rt081413; Mon, 5 Jul 2004 11:30:08 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.11/8.12.11/Submit) id i659U8xL081412; Mon, 5 Jul 2004 11:30:08 +0200 (CEST) (envelope-from marc) Date: Mon, 5 Jul 2004 11:30:08 +0200 From: Marc Fonvieille To: freebsd-doc@freebsd.org Message-ID: <20040705093007.GA79807@abigail.blackend.org> References: <20040704204523.GB40868@abigail.blackend.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040704204523.GB40868@abigail.blackend.org> User-Agent: Mutt/1.4.2.1i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.10-PRERELEASE Subject: Re: docs/57298: Using compact flash cards 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, 05 Jul 2004 09:30:11 -0000 On Sun, Jul 04, 2004 at 10:45:23PM +0200, Marc Fonvieille wrote: [...] > > I have an "USB Storage Devices" section waiting for being added, I have > to think how to merge the CF Card part. > In fact I think I will add a separate Flash Cards section since flash cards (CF, SD, etc.) are not related to the USB system. External card readers are using USB, so we'll just need to point people on the USB section. The remaining cases: PCMCIA adapters and cameras should be the main part of that section. Marc From owner-freebsd-doc@FreeBSD.ORG Mon Jul 5 11:00: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 A9C3416A4CE for ; Mon, 5 Jul 2004 11:00:50 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9EE8A43D39 for ; Mon, 5 Jul 2004 11:00:50 +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 i65B0ort054451 for ; Mon, 5 Jul 2004 11:00:50 GMT (envelope-from owner-bugmaster@freebsd.org) Received: (from peter@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i65B0nwC054446 for freebsd-doc@freebsd.org; Mon, 5 Jul 2004 11:00:49 GMT (envelope-from owner-bugmaster@freebsd.org) Date: Mon, 5 Jul 2004 11:00:49 GMT Message-Id: <200407051100.i65B0nwC054446@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, 05 Jul 2004 11:00:50 -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/10/14] docs/58033 doc [PATCH] getenv(3) manpage doesn't state t 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 14 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/04/29] docs/26943 doc [patch] description of :C modifier is mis 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/22] docs/54752 doc bus_dma explained in ISA section: should 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/25] docs/65952 doc handbook kernel conf has old cruft 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/04/30] docs/66117 doc Handbook Serial Console Page doesn't list 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/11] docs/66539 doc [patch] share/man/man4/netgraph.4 inconsi o [2004/05/11] docs/66540 doc [patch] share/man/man4/ppbus.4 wording ni o [2004/05/12] docs/66574 doc [patch] MFC share/man/man4/ng_iface.4 1.1 o [2004/05/12] docs/66575 doc [patch] MFC share/man/man4/ng_ksocket.4 v o [2004/05/13] docs/66610 doc Update handbook re: CVSup tags o [2004/05/13] docs/66621 doc Document fix for "kmem_map too small pani o [2004/05/17] docs/66764 doc [patch] 4_RELENG share/man/man4/ng_one2ma 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/66771 doc [patch] usr.sbin/pccard/pccardc/pccardc.8 o [2004/05/17] docs/66775 doc Clarification that port names should not o [2004/05/18] docs/66824 doc [patch] share/man/man4/man4.i386/fe.4 gra o [2004/05/18] docs/66826 doc [patch] RELENG_4 share/man/man4/man4.i386 o [2004/05/18] docs/66827 doc [patch] usr.sbin/usbd/usbd.conf.5 bad com o [2004/05/18] docs/66828 doc [patch] /usr/src/sys/conf/NOTES spelling o [2004/05/23] docs/67078 doc [patch] MFC of a rtld(1) man page is inco o [2004/06/01] docs/67458 doc [patch] usr.bin/lex/lex.1 language nit 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/19] docs/68115 doc ISO-IMAGES-i386/README.TXT - cdrecord is 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/68605 doc Porter's Handbook: document how to handle o [2004/07/02] docs/68606 doc Porter's Handbook: document how to write 164 problems total. From owner-freebsd-doc@FreeBSD.ORG Mon Jul 5 14:37:30 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 002E116A4CE; Mon, 5 Jul 2004 14:37:29 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id C459543D48; Mon, 5 Jul 2004 14:37:29 +0000 (GMT) (envelope-from yar@FreeBSD.org) Received: from freefall.freebsd.org (yar@localhost [127.0.0.1]) i65EbTpx091317; Mon, 5 Jul 2004 14:37:29 GMT (envelope-from yar@freefall.freebsd.org) Received: (from yar@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i65EbTNv091313; Mon, 5 Jul 2004 14:37:29 GMT (envelope-from yar) Date: Mon, 5 Jul 2004 14:37:29 GMT From: Yar Tikhiy Message-Id: <200407051437.i65EbTNv091313@freefall.freebsd.org> To: yar@FreeBSD.org, freebsd-doc@FreeBSD.org, yar@FreeBSD.org Subject: Re: docs/68605: Porter's Handbook: document how to handle security upgrades 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, 05 Jul 2004 14:37:30 -0000 Synopsis: Porter's Handbook: document how to handle security upgrades Responsible-Changed-From-To: freebsd-doc->yar Responsible-Changed-By: yar Responsible-Changed-When: Mon Jul 5 14:34:52 GMT 2004 Responsible-Changed-Why: Oliver and I are collaborating over this issue. http://www.freebsd.org/cgi/query-pr.cgi?pr=68605 From owner-freebsd-doc@FreeBSD.ORG Mon Jul 5 21:06:57 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 7909D16A4CE; Mon, 5 Jul 2004 21:06:57 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 61BAB43D45; Mon, 5 Jul 2004 21:06:57 +0000 (GMT) (envelope-from bms@FreeBSD.org) Received: from freefall.freebsd.org (bms@localhost [127.0.0.1]) i65L6vLN070452; Mon, 5 Jul 2004 21:06:57 GMT (envelope-from bms@freefall.freebsd.org) Received: (from bms@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i65L6vtH070448; Mon, 5 Jul 2004 21:06:57 GMT (envelope-from bms) Date: Mon, 5 Jul 2004 21:06:57 GMT From: Bruce M Simpson Message-Id: <200407052106.i65L6vtH070448@freefall.freebsd.org> To: bms@FreeBSD.org, freebsd-doc@FreeBSD.org, hmp@FreeBSD.org Subject: Re: docs/54752: bus_dma explained in ISA section: should be in own topic 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, 05 Jul 2004 21:06:57 -0000 Synopsis: bus_dma explained in ISA section: should be in own topic Responsible-Changed-From-To: freebsd-doc->hmp Responsible-Changed-By: bms Responsible-Changed-When: Mon Jul 5 21:06:40 GMT 2004 Responsible-Changed-Why: hmp@ has an interest in busdma docs http://www.freebsd.org/cgi/query-pr.cgi?pr=54752 From owner-freebsd-doc@FreeBSD.ORG Tue Jul 6 06:40:01 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 B373D16A4CF for ; Tue, 6 Jul 2004 06:40:01 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8860B43D3F for ; Tue, 6 Jul 2004 06:40:01 +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 i666e1BS056705 for ; Tue, 6 Jul 2004 06:40:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i666e13x056704; Tue, 6 Jul 2004 06:40:01 GMT (envelope-from gnats) Resent-Date: Tue, 6 Jul 2004 06:40:01 GMT Resent-Message-Id: <200407060640.i666e13x056704@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 1180516A4CE for ; Tue, 6 Jul 2004 06:37:05 +0000 (GMT) Received: from valentine.liquidneon.com (valentine.liquidneon.com [216.38.206.180]) by mx1.FreeBSD.org (Postfix) with ESMTP id A3B8D43D41 for ; Tue, 6 Jul 2004 06:37:04 +0000 (GMT) (envelope-from bdavis@house.so14k.com) Received: from localhost (localhost [127.0.0.1]) by valentine.liquidneon.com (Postfix) with ESMTP id 058CD792 for ; Tue, 6 Jul 2004 00:37:04 -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 96037-09 for ; Tue, 6 Jul 2004 00:37:03 -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 AC70C702 for ; Tue, 6 Jul 2004 00:37:03 -0600 (MDT) Received: by mccaffrey.house.so14k.com (Postfix, from userid 1001) id 2860D72F; Tue, 6 Jul 2004 00:37:03 -0600 (MDT) Message-Id: <20040706063703.2860D72F@mccaffrey.house.so14k.com> Date: Tue, 6 Jul 2004 00:37:03 -0600 (MDT) From: Brad Davis To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/68717: reference ssh instead of telnet 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: Tue, 06 Jul 2004 06:40:01 -0000 >Number: 68717 >Category: docs >Synopsis: reference ssh instead of telnet >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: Tue Jul 06 06:40:01 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: Reference sshing to a machine instead of teletting. >How-To-Repeat: >Fix: Apply the diff at http://freebsd.so14k.com/ssh.patch MD5 (ssh.patch) = 5291851ba142bdcb99f84c83fa280a98 >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Tue Jul 6 07:00:45 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 F3C5316A4CE for ; Tue, 6 Jul 2004 07:00:44 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id CB3EE43D2D for ; Tue, 6 Jul 2004 07:00:44 +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 i6670im1057609 for ; Tue, 6 Jul 2004 07:00:44 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6670ipJ057607; Tue, 6 Jul 2004 07:00:44 GMT (envelope-from gnats) Resent-Date: Tue, 6 Jul 2004 07:00:44 GMT Resent-Message-Id: <200407060700.i6670ipJ057607@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 0BAAE16A4CE for ; Tue, 6 Jul 2004 06:56:39 +0000 (GMT) Received: from valentine.liquidneon.com (valentine.liquidneon.com [216.38.206.180]) by mx1.FreeBSD.org (Postfix) with ESMTP id E0B2643D1D for ; Tue, 6 Jul 2004 06:56:38 +0000 (GMT) (envelope-from bdavis@house.so14k.com) Received: from localhost (localhost [127.0.0.1]) by valentine.liquidneon.com (Postfix) with ESMTP id 7B9DC834 for ; Tue, 6 Jul 2004 00:56:38 -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 96602-03 for ; Tue, 6 Jul 2004 00:56:38 -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 2E48D702 for ; Tue, 6 Jul 2004 00:56:38 -0600 (MDT) Received: by mccaffrey.house.so14k.com (Postfix, from userid 1001) id DD9F072F; Tue, 6 Jul 2004 00:56:37 -0600 (MDT) Message-Id: <20040706065637.DD9F072F@mccaffrey.house.so14k.com> Date: Tue, 6 Jul 2004 00:56:37 -0600 (MDT) From: Brad Davis To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/68718: s/// 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: Tue, 06 Jul 2004 07:00:45 -0000 >Number: 68718 >Category: docs >Synopsis: s/// >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: Tue Jul 06 07:00:44 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: s/// >How-To-Repeat: >Fix: Apply the diff at http://freebsd.so14k.com/editors.patch MD5 (editors.patch) = f1055ec47ae1011c1fa1fe0c359f2da6 >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Tue Jul 6 07:04:42 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 DCC7716A4CE; Tue, 6 Jul 2004 07:04:42 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id BA78043D4C; Tue, 6 Jul 2004 07:04:42 +0000 (GMT) (envelope-from simon@FreeBSD.org) Received: from freefall.freebsd.org (simon@localhost [127.0.0.1]) i6674gRb057888; Tue, 6 Jul 2004 07:04:42 GMT (envelope-from simon@freefall.freebsd.org) Received: (from simon@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6674gQh057884; Tue, 6 Jul 2004 07:04:42 GMT (envelope-from simon) Date: Tue, 6 Jul 2004 07:04:42 GMT From: "Simon L. Nielsen" Message-Id: <200407060704.i6674gQh057884@freefall.freebsd.org> To: so14k@so14k.com, simon@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/68717: reference ssh instead of telnet 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, 06 Jul 2004 07:04:43 -0000 Synopsis: reference ssh instead of telnet State-Changed-From-To: open->closed State-Changed-By: simon State-Changed-When: Tue Jul 6 07:03:05 GMT 2004 State-Changed-Why: Committed, thanks for the submission! BTW. it's preferred if you attach patches directly to the PR since it makes it faster to review the PR, and it makes the record in the PR more complete. http://www.freebsd.org/cgi/query-pr.cgi?pr=68717 From owner-freebsd-doc@FreeBSD.ORG Tue Jul 6 07:30:24 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 C968B16A4D1 for ; Tue, 6 Jul 2004 07:30:24 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6808943D55 for ; Tue, 6 Jul 2004 07: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 i667ULcj063060 for ; Tue, 6 Jul 2004 07: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 i667UL71063059; Tue, 6 Jul 2004 07:30:21 GMT (envelope-from gnats) Date: Tue, 6 Jul 2004 07:30:21 GMT Message-Id: <200407060730.i667UL71063059@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Marc Fonvieille Subject: Re: docs/68718: s/// 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: Tue, 06 Jul 2004 07:30:25 -0000 The following reply was made to PR docs/68718; it has been noted by GNATS. From: Marc Fonvieille To: Brad Davis Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/68718: s/// Date: Tue, 6 Jul 2004 09:24:37 +0200 On Tue, Jul 06, 2004 at 12:56:37AM -0600, Brad Davis wrote: > >Description: > s/// > >How-To-Repeat: > >Fix: > Apply the diff at http://freebsd.so14k.com/editors.patch > MD5 (editors.patch) = f1055ec47ae1011c1fa1fe0c359f2da6 Please add patch to the PR. I'm not sure your patch is the best solution, I'd do instead for more consistency with previous "paras": FreeBSD also comes with more powerful text editors such as vi as part of the base system, while other editors, like Emacs and vim, are part of the FreeBSD Ports Collection (editors/emacs and editors/vim). These editors offer much more functionality and power at the expense of being a little more complicated to learn. However if you plan on doing a lot of text editing, learning a more powerful editor such as vim or Emacs will save you much more time in the long run. I used vim and not Vim since www.vim.org uses both, the easiest to type is vim :) Marc From owner-freebsd-doc@FreeBSD.ORG Tue Jul 6 14:41: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 EDE7D16A4CF for ; Tue, 6 Jul 2004 14:41:12 +0000 (GMT) Received: from mail.FreeBSD.org.cn (dns3.freebsd.org.cn [61.129.66.75]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4E88243D3F for ; Tue, 6 Jul 2004 14:41:11 +0000 (GMT) (envelope-from delphij@frontfree.net) Received: (qmail 8165 invoked by uid 0); 6 Jul 2004 14:39:46 -0000 Received: from unknown (HELO beastie.frontfree.net) (218.107.145.7) by mail.FreeBSD.org.cn with AES256-SHA encrypted SMTP; 6 Jul 2004 14:39:46 -0000 Received: from localhost (localhost.frontfree.net [127.0.0.1]) by beastie.frontfree.net (Postfix) with ESMTP id F2C2311F35; Tue, 6 Jul 2004 22:41:03 +0800 (CST) Received: from beastie.frontfree.net ([127.0.0.1]) by localhost (beastie.frontfree.net [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 02119-03; Tue, 6 Jul 2004 22:41:03 +0800 (CST) Received: by beastie.frontfree.net (Postfix, from userid 1001) id 389D711EFA; Tue, 6 Jul 2004 22:41:02 +0800 (CST) Date: Tue, 6 Jul 2004 22:41:02 +0800 From: Xin LI To: Dag-Erling Sm?rgrav Message-ID: <20040706144102.GA4034@frontfree.net> References: <20040625033718.GA1691@frontfree.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="wRRV7LY7NUeQGEoC" Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.4.2.1i X-GPG-key-ID/Fingerprint: 0xCAEEB8C0 / 43B8 B703 B8DD 0231 B333 DC28 39FB 93A0 CAEE B8C0 X-GPG-Public-Key: http://www.delphij.net/delphij.asc X-Operating-System: FreeBSD beastie.frontfree.net 5.2-delphij FreeBSD 5.2-delphij #80: Thu Jun 24 17:30:33 CST 2004 delphij@beastie.frontfree.net:/usr/obj/usr/src/sys/BEASTIE i386 X-URL: http://www.delphij.net X-By: delphij@beastie.frontfree.net X-Location: Beijing, China X-Virus-Scanned: by amavisd-new at frontfree.net cc: hackers@FreeBSD.org cc: doc@FreeBSD.org Subject: About rules on style changes [Was: Re: Preliminary sys/netinet style 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: Tue, 06 Jul 2004 14:41:13 -0000 --wRRV7LY7NUeQGEoC Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hi, Dag-Erling, (I have removed freebsd-net@ from cc list and added doc@ as the topic seemed to be more related to doc@) On Tue, Jul 06, 2004 at 01:50:34PM +0200, Dag-Erling Sm?rgrav wrote: > Xin LI writes: > > I have a patchset to remove tailing spaces, convert leading spaces > > to tabs, and removes spaces before tabs. >=20 > As a rule, we never do this except in conjunction with other changes. Hmm... Seems that I have misunderstood the committers' guide, section 10.3, which said: "Do not mix style fixes with new functionality. A style fix is any change which does not modify the functionality of the code. Mixing the changes obfuscates the functionality change when using cvs diff, which can hide any new bugs." I thought that this is not a strict discourage of style fixes. Shall we add something to clarify the rule, like this: "In order to prevent difficulties other committers will encounter when making changes or merging changes from third party, it is discouraged to do style changes when there is no functional changes over a subsystem, and please follow style(9) when committing new code, as a consistent style will ease others' work when merging your changes." Thanks. Cheers, --=20 Xin LI http://www.delphij.net/ See complete headers for GPG key and other information. --wRRV7LY7NUeQGEoC Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA6rn+OfuToMruuMARAl+tAJwMRH92KFtSIOxXvYcvV8303naXbwCePMeo PTpr1778jc1P7/93X/2ht/k= =x0kj -----END PGP SIGNATURE----- --wRRV7LY7NUeQGEoC-- From owner-freebsd-doc@FreeBSD.ORG Tue Jul 6 14:47:02 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 58C6E16A4CE; Tue, 6 Jul 2004 14:47:02 +0000 (GMT) Received: from smtp.des.no (flood.des.no [217.116.83.31]) by mx1.FreeBSD.org (Postfix) with ESMTP id B3BF943D55; Tue, 6 Jul 2004 14:47:01 +0000 (GMT) (envelope-from des@des.no) Received: by smtp.des.no (Pony Express, from userid 666) id 8F015531C; Tue, 6 Jul 2004 16:47:00 +0200 (CEST) Received: from dwp.des.no (des.no [80.203.228.37]) by smtp.des.no (Pony Express) with ESMTP id 0B212531B; Tue, 6 Jul 2004 16:46:53 +0200 (CEST) Received: by dwp.des.no (Postfix, from userid 2602) id DCB9DB860; Tue, 6 Jul 2004 16:46:52 +0200 (CEST) To: Xin LI References: <20040625033718.GA1691@frontfree.net> <20040706144102.GA4034@frontfree.net> From: des@des.no (=?iso-8859-1?q?Dag-Erling_Sm=F8rgrav?=) Date: Tue, 06 Jul 2004 16:46:52 +0200 In-Reply-To: <20040706144102.GA4034@frontfree.net> (Xin LI's message of "Tue, 6 Jul 2004 22:41:02 +0800") Message-ID: User-Agent: Gnus/5.1006 (Gnus v5.10.6) Emacs/21.3 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable X-Spam-Checker-Version: SpamAssassin 2.63 (2004-01-11) on flood.des.no X-Spam-Level: X-Spam-Status: No, hits=0.0 required=5.0 tests=AWL autolearn=no version=2.63 cc: hackers@FreeBSD.org cc: doc@FreeBSD.org Subject: Re: About rules on style changes 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, 06 Jul 2004 14:47:02 -0000 Xin LI writes: > Hmm... Seems that I have misunderstood the committers' guide, section > 10.3, which said: > > "Do not mix style fixes with new functionality. A style fix is any > change which does not modify the functionality of the code. Mixing the > changes obfuscates the functionality change when using cvs diff, which > can hide any new bugs." That just means you have to do it in a separate commit. We do not generally make style changes for their own sake; instead, we commit style fixes shortly before or after a functional change. DES --=20 Dag-Erling Sm=F8rgrav - des@des.no From owner-freebsd-doc@FreeBSD.ORG Tue Jul 6 15:03:31 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 937C916A4CE for ; Tue, 6 Jul 2004 15:03:31 +0000 (GMT) Received: from mail.FreeBSD.org.cn (dns3.freebsd.org.cn [61.129.66.75]) by mx1.FreeBSD.org (Postfix) with ESMTP id BCA5D43D2F for ; Tue, 6 Jul 2004 15:03:30 +0000 (GMT) (envelope-from delphij@frontfree.net) Received: (qmail 8640 invoked by uid 0); 6 Jul 2004 15:02:06 -0000 Received: from unknown (HELO beastie.frontfree.net) (218.107.145.7) by mail.FreeBSD.org.cn with AES256-SHA encrypted SMTP; 6 Jul 2004 15:02:06 -0000 Received: from localhost (localhost.frontfree.net [127.0.0.1]) by beastie.frontfree.net (Postfix) with ESMTP id 4B7A711F5A; Tue, 6 Jul 2004 23:03:28 +0800 (CST) Received: from beastie.frontfree.net ([127.0.0.1]) by localhost (beastie.frontfree.net [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 02426-02; Tue, 6 Jul 2004 23:03:27 +0800 (CST) Received: by beastie.frontfree.net (Postfix, from userid 1001) id 40C9211EFA; Tue, 6 Jul 2004 23:03:27 +0800 (CST) Date: Tue, 6 Jul 2004 23:03:27 +0800 From: Xin LI To: Dag-Erling Sm?rgrav Message-ID: <20040706150327.GA3817@frontfree.net> References: <20040625033718.GA1691@frontfree.net> <20040706144102.GA4034@frontfree.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="PEIAKu/WMn1b1Hv9" Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.4.2.1i X-GPG-key-ID/Fingerprint: 0xCAEEB8C0 / 43B8 B703 B8DD 0231 B333 DC28 39FB 93A0 CAEE B8C0 X-GPG-Public-Key: http://www.delphij.net/delphij.asc X-Operating-System: FreeBSD beastie.frontfree.net 5.2-delphij FreeBSD 5.2-delphij #80: Thu Jun 24 17:30:33 CST 2004 delphij@beastie.frontfree.net:/usr/obj/usr/src/sys/BEASTIE i386 X-URL: http://www.delphij.net X-By: delphij@beastie.frontfree.net X-Location: Beijing, China X-Virus-Scanned: by amavisd-new at frontfree.net cc: hackers@FreeBSD.org cc: doc@FreeBSD.org Subject: Re: About rules on style changes 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, 06 Jul 2004 15:03:31 -0000 --PEIAKu/WMn1b1Hv9 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Thanks for the clarification :-) On Tue, Jul 06, 2004 at 04:46:52PM +0200, Dag-Erling Sm?rgrav wrote: [snip] > That just means you have to do it in a separate commit. We do not > generally make style changes for their own sake; instead, we commit > style fixes shortly before or after a functional change. Cheers, --=20 Xin LI http://www.delphij.net/ See complete headers for GPG key and other information. --PEIAKu/WMn1b1Hv9 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA6r8/OfuToMruuMARAkjHAJ9xHxhmbfKYPmIGmN3BdT4phh8mkwCdGxUp 2/0owFtcgvqVCYP4XnHunoI= =BcOC -----END PGP SIGNATURE----- --PEIAKu/WMn1b1Hv9-- From owner-freebsd-doc@FreeBSD.ORG Tue Jul 6 15:06: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 4F74D16A4CE for ; Tue, 6 Jul 2004 15:06:36 +0000 (GMT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id D397343D2F for ; Tue, 6 Jul 2004 15:06:35 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost.pittgoth.com (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 i66F6YJu093431 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT) for ; Tue, 6 Jul 2004 11:06:34 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Tue, 6 Jul 2004 11:07:08 -0400 From: Tom Rhodes To: FreeBSD-doc@FreeBSD.org Message-Id: <20040706110708.78ee82b6@localhost.pittgoth.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 Subject: Kick up some discussion on an issue 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, 06 Jul 2004 15:06:36 -0000 Hey gang- Ever notice how we have a 'who's who' section in the committers guide? Notice how at one point I had all the hats and teams listed on the internal pages but moved them to the contributing article in hopes to cut confusion? We have the 'doc proj staff listing' and the 'who's who' listing which I'm thinking of moving over to the contributors. The doc project staff listing is out of date and could probably be moved to 'misc hats' under the contributors' 'other FreeBSD teams' section. My worry is that moving the who's who section and replacing it with a link may just open a can of worms which should remain closed, any thoughts? -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Tue Jul 6 16:37: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 ADB9916A4CE for ; Tue, 6 Jul 2004 16:37:08 +0000 (GMT) Received: from mproxy.gmail.com (rproxy.gmail.com [64.233.170.203]) by mx1.FreeBSD.org (Postfix) with SMTP id 5B40643D2F for ; Tue, 6 Jul 2004 16:37:08 +0000 (GMT) (envelope-from creidieki@gmail.com) Received: by mproxy.gmail.com with SMTP id 72so21190rnf for ; Tue, 06 Jul 2004 09:37:07 -0700 (PDT) Received: by 10.38.164.46 with SMTP id m46mr33948rne; Tue, 06 Jul 2004 09:37:07 -0700 (PDT) Message-ID: <4355f89c040706093715c2fa95@mail.gmail.com> Date: Tue, 6 Jul 2004 12:37:07 -0400 From: "M. Creidieki Crouch" To: doc@freebsd.org Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Subject: FreeBSD FAQ 9.7 Update 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, 06 Jul 2004 16:37:08 -0000 Hi, In section 9.7, the FreeBSD FAQ mentions that, of Linux filesystems, FreeBSD supports ext2fs, and mentions that other information would be appreciated. I think it would be helpful to mention that reiserFS is currently not supported. I can't find any official references to that fact, but an example email from a developer mentioning this would be http://www.freebsd.org/cgi/getmsg.cgi?fetch=799619+0+/usr/local/www/db/text/2004/freebsd-current/20040620.freebsd-current This was actually one of the reasons I had trouble getting FreeBSD working on my machine. Thanks! M. Creidieki Crouch creidieki@gmail.com From owner-freebsd-doc@FreeBSD.ORG Tue Jul 6 17:50:20 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 445CA16A4CE for ; Tue, 6 Jul 2004 17:50:20 +0000 (GMT) Received: from www.freebsd.org (www.freebsd.org [216.136.204.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4009F43D31 for ; Tue, 6 Jul 2004 17:50:20 +0000 (GMT) (envelope-from www@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 i66HoKp9008295 for ; Tue, 6 Jul 2004 17:50:20 GMT (envelope-from www@www.freebsd.org) Received: (from www@localhost) by www.freebsd.org (8.12.11/8.12.11/Submit) id i66HoKCF008294 for freebsd-doc@FreeBSD.org; Tue, 6 Jul 2004 17:50:20 GMT (envelope-from www) Date: Tue, 6 Jul 2004 17:50:20 GMT From: World Wide Web Owner Message-Id: <200407061750.i66HoKCF008294@www.freebsd.org> To: freebsd-doc@FreeBSD.org Subject: FreeBSD web build failed on www.freebsd.org 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, 06 Jul 2004 17:50:20 -0000 install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/mail/pine1.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/mail/pine2.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/mail/pine3.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/mail/pine4.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/mail/pine5.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/advanced-networking install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/advanced-networking/net-routing.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/advanced-networking /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/security/ipsec-network.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/security/ipsec-crypt-pkt.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/security/ipsec-encap-pkt.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/security/ipsec-out-pkt.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-concat.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-mirrored-vol.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-raid10-vol.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-raid5-org.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-simple-vol.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-striped-vol.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-striped.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/handbook.html -> /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/index.html ===> doc/books/porters-handbook install -c -o www -g www -m 444 $(/usr/bin/xargs < HTML.manifest) /w/www/build/www/en/doc/en_US.ISO8859-1/books/porters-handbook install -c -o www -g www -m 444 docbook.css /w/www/build/www/en/doc/en_US.ISO8859-1/books/porters-handbook install -c -o www -g www -m 444 book.html /w/www/build/www/en/doc/en_US.ISO8859-1/books/porters-handbook install -c -o www -g www -m 444 docbook.css /w/www/build/www/en/doc/en_US.ISO8859-1/books/porters-handbook /w/www/build/www/en/doc/faq -> /w/www/build/www/en/doc/en_US.ISO8859-1/books/faq /w/www/build/www/en/doc/handbook -> /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook /w/www/build/www/en/doc/en -> /w/www/build/www/en/doc/en_US.ISO8859-1 /usr/local/bin/jade:/w/www/build/doc/en_US.ISO8859-1/books/handbook/book.sgml:150:18:E: general entity "url.relprefix" not defined and no default entity *** Error code 1 Stop in /w/www/build/www/en/doc. *** Error code 1 Stop in /w/www/build/www/en. 1623.31 real 1395.47 user 68.20 sys From owner-freebsd-doc@FreeBSD.ORG Tue Jul 6 18:50:24 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 B0DB216A4CE for ; Tue, 6 Jul 2004 18:50:24 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 79DFF43D55 for ; Tue, 6 Jul 2004 18: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 i66IoOc4050030 for ; Tue, 6 Jul 2004 18: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 i66IoO8P050028; Tue, 6 Jul 2004 18:50:24 GMT (envelope-from gnats) Date: Tue, 6 Jul 2004 18:50:24 GMT Message-Id: <200407061850.i66IoO8P050028@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Brad Davis Subject: Re: docs/68718: s/// 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: Tue, 06 Jul 2004 18:50:24 -0000 The following reply was made to PR docs/68718; it has been noted by GNATS. From: Brad Davis To: Marc Fonvieille Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/68718: s/// Date: Tue, 6 Jul 2004 12:43:01 -0600 On Tuesday 06 July 2004 01:24, Marc Fonvieille wrote: > On Tue, Jul 06, 2004 at 12:56:37AM -0600, Brad Davis wrote: > > >Description: > > > > s/// > > > > >How-To-Repeat: > > >Fix: > > > > Apply the diff at http://freebsd.so14k.com/editors.patch > > MD5 (editors.patch) = f1055ec47ae1011c1fa1fe0c359f2da6 > > Please add patch to the PR. > > I'm not sure your patch is the best solution, I'd do instead for more > consistency with previous "paras": > > FreeBSD also comes with more powerful text editors such as > vi as part of the base system, while other > editors, like Emacs and > vim, are part of the FreeBSD Ports Collection > ( role="package">editors/emacs and role="package">editors/vim). These editors offer much more > functionality and power at the expense of being a little more complicated > to learn. However if you plan on doing a lot of text editing, learning a > more powerful editor such as > vim or Emacs > will save you much more time in the long run. > > I used vim and not Vim since www.vim.org uses both, the easiest to > type is vim :) I will add my patches into the PRs directly from now on! (I thought it would be easier for you guys to fetch them and look that way :) I'm not sure what your looking for. Do you want my approval? If so you have it! Regards, Brad Davis -- Oh, well, I guess this is just going to be one of those lifetimes. From owner-freebsd-doc@FreeBSD.ORG Tue Jul 6 23:22: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 262CE16A4CE; Tue, 6 Jul 2004 23:22:38 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 04C3743D1F; Tue, 6 Jul 2004 23:22:38 +0000 (GMT) (envelope-from hmp@FreeBSD.org) Received: from freefall.freebsd.org (hmp@localhost [127.0.0.1]) i66NMbpb081066; Tue, 6 Jul 2004 23:22:37 GMT (envelope-from hmp@freefall.freebsd.org) Received: (from hmp@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i66NMbQq081062; Tue, 6 Jul 2004 23:22:37 GMT (envelope-from hmp) Date: Tue, 6 Jul 2004 23:22:37 GMT From: Hiten Pandya Message-Id: <200407062322.i66NMbQq081062@freefall.freebsd.org> To: rf358197@ohio.edu, hmp@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/58033: [PATCH] getenv(3) manpage doesn't state the return value of getenv. 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, 06 Jul 2004 23:22:38 -0000 Synopsis: [PATCH] getenv(3) manpage doesn't state the return value of getenv. State-Changed-From-To: open->closed State-Changed-By: hmp State-Changed-When: Tue Jul 6 23:21:50 GMT 2004 State-Changed-Why: A similar version has been committed to -CURRENT, and will be MFC'ed in about three days. Thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=58033 From owner-freebsd-doc@FreeBSD.ORG Tue Jul 6 23:50:24 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 6621616A4CE for ; Tue, 6 Jul 2004 23:50:24 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 439DD43D39 for ; Tue, 6 Jul 2004 23: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 i66NoOJl083601 for ; Tue, 6 Jul 2004 23: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 i66NoO1p083600; Tue, 6 Jul 2004 23:50:24 GMT (envelope-from gnats) Date: Tue, 6 Jul 2004 23:50:24 GMT Message-Id: <200407062350.i66NoO1p083600@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Hiten Pandya Subject: Re: docs/68595: [PATCH] add FAQ entry for lock order reversals X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Hiten Pandya List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 06 Jul 2004 23:50:24 -0000 The following reply was made to PR docs/68595; it has been noted by GNATS. From: Hiten Pandya To: freebsd-gnats-submit@freebsd.org Cc: noackj@concordiacrusaders.org Subject: Re: docs/68595: [PATCH] add FAQ entry for lock order reversals Date: Tue, 6 Jul 2004 19:40:55 -0400 (EDT) Dear Jonathan, This text actually belongs in the glossary part of the Handbook. People generally tend to print out the Handbook so by putting it there, it results into better documentation. Cheers. Hiten Pandya hmp at freebsd.org From owner-freebsd-doc@FreeBSD.ORG Wed Jul 7 01:30: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 A198016A4CE for ; Wed, 7 Jul 2004 01:30:20 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7632943D5C for ; Wed, 7 Jul 2004 01:30: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 i671UJA7096212 for ; Wed, 7 Jul 2004 01: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 i671UJ05096211; Wed, 7 Jul 2004 01:30:19 GMT (envelope-from gnats) Resent-Date: Wed, 7 Jul 2004 01:30:19 GMT Resent-Message-Id: <200407070130.i671UJ05096211@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, Dave Duchscher Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 58F0416A4CE for ; Wed, 7 Jul 2004 01:27:16 +0000 (GMT) Received: from www.freebsd.org (www.freebsd.org [216.136.204.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4E16E43D1D for ; Wed, 7 Jul 2004 01:27:16 +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 i671RGup090348 for ; Wed, 7 Jul 2004 01:27:16 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.12.11/8.12.11/Submit) id i671RGas090347; Wed, 7 Jul 2004 01:27:16 GMT (envelope-from nobody) Message-Id: <200407070127.i671RGas090347@www.freebsd.org> Date: Wed, 7 Jul 2004 01:27:16 GMT From: Dave Duchscher To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-2.3 Subject: docs/68746: Virtual hosts documentaion doesn't make clear issues with netmask on adding aliases. 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, 07 Jul 2004 01:30:20 -0000 >Number: 68746 >Category: docs >Synopsis: Virtual hosts documentaion doesn't make clear issues with netmask on adding aliases. >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: Wed Jul 07 01:30:19 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Dave Duchscher >Release: FreeBSD 5.2.1p8 >Organization: Texas A&M University >Environment: >Description: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/configtuning-virtual-hosts.html IMHO, this document does make clear the subtle issues with netmasks when setting up aliases. As you know, aliases on the same network as the primary interface need a netmask of 255.255.255.255. The first alias on a different network needs the correct netmask. Additional aliases need to have 255.255.255.255. IMHO, I think this document should cover these subtle issues with netmasks in more detail. This PR was prompted by helping other system administrators on IRC. >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Wed Jul 7 02:00:37 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 F1FAF16A4D4 for ; Wed, 7 Jul 2004 02:00:36 +0000 (GMT) Received: from www.freebsd.org (www.freebsd.org [216.136.204.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id ECAE743D1D for ; Wed, 7 Jul 2004 02:00:25 +0000 (GMT) (envelope-from www@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 i6720PMj007390 for ; Wed, 7 Jul 2004 02:00:25 GMT (envelope-from www@www.freebsd.org) Received: (from www@localhost) by www.freebsd.org (8.12.11/8.12.11/Submit) id i6720P3q007389 for freebsd-doc@FreeBSD.org; Wed, 7 Jul 2004 02:00:25 GMT (envelope-from www) Date: Wed, 7 Jul 2004 02:00:25 GMT From: World Wide Web Owner Message-Id: <200407070200.i6720P3q007389@www.freebsd.org> To: freebsd-doc@FreeBSD.org Subject: FreeBSD web build failed on www.freebsd.org 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, 07 Jul 2004 02:00:37 -0000 install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/mail/pine1.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/mail/pine2.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/mail/pine3.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/mail/pine4.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/mail/pine5.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/advanced-networking install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/advanced-networking/net-routing.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/advanced-networking /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/security/ipsec-network.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/security/ipsec-crypt-pkt.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/security/ipsec-encap-pkt.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/security/ipsec-out-pkt.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-concat.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-mirrored-vol.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-raid10-vol.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-raid5-org.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-simple-vol.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-striped-vol.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /w/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-striped.png /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/handbook.html -> /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/index.html ===> doc/books/porters-handbook install -c -o www -g www -m 444 $(/usr/bin/xargs < HTML.manifest) /w/www/build/www/en/doc/en_US.ISO8859-1/books/porters-handbook install -c -o www -g www -m 444 docbook.css /w/www/build/www/en/doc/en_US.ISO8859-1/books/porters-handbook install -c -o www -g www -m 444 book.html /w/www/build/www/en/doc/en_US.ISO8859-1/books/porters-handbook install -c -o www -g www -m 444 docbook.css /w/www/build/www/en/doc/en_US.ISO8859-1/books/porters-handbook /w/www/build/www/en/doc/faq -> /w/www/build/www/en/doc/en_US.ISO8859-1/books/faq /w/www/build/www/en/doc/handbook -> /w/www/build/www/en/doc/en_US.ISO8859-1/books/handbook /w/www/build/www/en/doc/en -> /w/www/build/www/en/doc/en_US.ISO8859-1 /usr/local/bin/jade:/w/www/build/doc/en_US.ISO8859-1/books/handbook/book.sgml:150:18:E: general entity "url.relprefix" not defined and no default entity *** Error code 1 Stop in /w/www/build/www/en/doc. *** Error code 1 Stop in /w/www/build/www/en. 2225.33 real 1644.46 user 96.17 sys From owner-freebsd-doc@FreeBSD.ORG Wed Jul 7 05:55:13 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 9ED7316A4CE for ; Wed, 7 Jul 2004 05:55:13 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 94EB843D53 for ; Wed, 7 Jul 2004 05:55:13 +0000 (GMT) (envelope-from www@FreeBSD.org) Received: from freefall.freebsd.org (www@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i675tDHZ040859 for ; Wed, 7 Jul 2004 05:55:13 GMT (envelope-from www@freefall.freebsd.org) Received: (from www@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i675tDjM040858 for freebsd-doc; Wed, 7 Jul 2004 05:55:13 GMT (envelope-from www) Date: Wed, 7 Jul 2004 05:55:13 GMT From: WWW pseudo-user Message-Id: <200407070555.i675tDjM040858@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org Subject: FreeBSD web build failed on freefall.freebsd.org 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, 07 Jul 2004 05:55:13 -0000 install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/mail/pine1.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/mail/pine2.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/mail/pine3.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/mail/pine4.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/mail/pine5.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/mail /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/advanced-networking install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/advanced-networking/net-routing.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/advanced-networking /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/security/ipsec-network.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/security/ipsec-crypt-pkt.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/security/ipsec-encap-pkt.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/security/ipsec-out-pkt.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/security /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-concat.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-mirrored-vol.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-raid10-vol.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-raid5-org.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-simple-vol.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-striped-vol.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /bin/mkdir -p /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum install -c -o www -g www -m 444 /c/www/build/doc/en_US.ISO8859-1/books/handbook/../../../share/images/books/handbook/vinum/vinum-striped.png /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/vinum /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/handbook.html -> /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook/index.html ===> doc/books/porters-handbook install -c -o www -g www -m 444 $(/usr/bin/xargs < HTML.manifest) /c/www/build/www/en/doc/en_US.ISO8859-1/books/porters-handbook install -c -o www -g www -m 444 docbook.css /c/www/build/www/en/doc/en_US.ISO8859-1/books/porters-handbook install -c -o www -g www -m 444 book.html /c/www/build/www/en/doc/en_US.ISO8859-1/books/porters-handbook install -c -o www -g www -m 444 docbook.css /c/www/build/www/en/doc/en_US.ISO8859-1/books/porters-handbook /c/www/build/www/en/doc/faq -> /c/www/build/www/en/doc/en_US.ISO8859-1/books/faq /c/www/build/www/en/doc/handbook -> /c/www/build/www/en/doc/en_US.ISO8859-1/books/handbook /c/www/build/www/en/doc/en -> /c/www/build/www/en/doc/en_US.ISO8859-1 /usr/local/bin/jade:/c/www/build/doc/en_US.ISO8859-1/books/handbook/book.sgml:150:18:E: general entity "url.relprefix" not defined and no default entity *** Error code 1 Stop in /c/www/build/www/en/doc. *** Error code 1 Stop in /c/www/build/www/en. 1954.56 real 1437.62 user 53.01 sys From owner-freebsd-doc@FreeBSD.ORG Wed Jul 7 16:16: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 4C5A816A4CE; Wed, 7 Jul 2004 16:16:24 +0000 (GMT) Received: from avexch01.qlogic.com (pat.qlogic.com [198.70.193.2]) by mx1.FreeBSD.org (Postfix) with ESMTP id 12DC043D2F; Wed, 7 Jul 2004 16:16:24 +0000 (GMT) (envelope-from robert.wagner@enigma.qlogic.com) Received: from avexch02.qlogic.com ([10.1.4.82]) by avexch01.qlogic.com with Microsoft SMTPSVC(5.0.2195.6713); Wed, 7 Jul 2004 09:11:51 -0700 X-MimeOLE: Produced By Microsoft Exchange V6.0.6487.1 Content-class: urn:content-classes:message MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Date: Wed, 7 Jul 2004 09:13:49 -0700 Message-ID: X-MS-Has-Attach: X-MS-TNEF-Correlator: Thread-Topic: man page for mbuf is not consistent with header defines (for sure in stable 4.10-PRERELEASE) thread-index: AcRkPb6+cznw2BheTAuDIBt0u91Pew== From: "Robert Wagner" To: X-OriginalArrivalTime: 07 Jul 2004 16:11:51.0937 (UTC) FILETIME=[1D3A7710:01C4643D] cc: "freebsd-stable@freebsd.org" Subject: man page for mbuf is not consistent with header defines (for sure in stable 4.10-PRERELEASE) 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, 07 Jul 2004 16:16:24 -0000 The man page for mbuf has mbuf pkthdr flags definitions that do not = match header file. man page shows=20 /* mbuf pkthdr flags, also in m_flags */ #define M_BCAST 0x0200 /* send/received as link-level = broadcast */ #define M_MCAST 0x0400 /* send/received as link-level = multicast */ #define M_FRAG 0x0800 /* packet is fragment of larger = packet */ #define M_FIRSTFRAG 0x1000 /* packet is first fragment */ #define M_LASTFRAG 0x2000 /* packet is last fragment */ header (mbuf.h) file shows /* * mbuf pkthdr flags (also stored in m_flags). */ #define M_BCAST 0x0100 /* send/received as link-level broadcast */ #define M_MCAST 0x0200 /* send/received as link-level multicast */ #define M_FRAG 0x0400 /* packet is a fragment of a larger packet */ #define M_FIRSTFRAG 0x0800 /* packet is first fragment */ #define M_LASTFRAG 0x1000 /* packet is last fragment */ I am currently seeing this in 4.10-PRERELEASE=20 Comments??? From owner-freebsd-doc@FreeBSD.ORG Wed Jul 7 16:35: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 E7B6516A4CE for ; Wed, 7 Jul 2004 16:35:36 +0000 (GMT) Received: from relay.macomnet.ru (relay.macomnet.ru [195.128.64.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id 43E7B43D41 for ; Wed, 7 Jul 2004 16:35:36 +0000 (GMT) (envelope-from maxim@macomnet.ru) Received: from mp2.macomnet.net (vi70540f@mp2.macomnet.net [195.128.64.6]) by relay.macomnet.ru (8.12.10/8.12.10) with ESMTP id i67GZXu517831334; Wed, 7 Jul 2004 20:35:34 +0400 (MSD) Date: Wed, 7 Jul 2004 20:35:33 +0400 (MSD) From: Maxim Konovalov To: Robert Wagner In-Reply-To: Message-ID: <20040707203455.M81540@mp2.macomnet.net> References: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: freebsd-doc@freebsd.org Subject: Re: man page for mbuf is not consistent with header defines (for sure in stable 4.10-PRERELEASE) 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, 07 Jul 2004 16:35:37 -0000 [ Trim CC: ] On Wed, 7 Jul 2004, 09:13-0700, Robert Wagner wrote: > The man page for mbuf has mbuf pkthdr flags definitions that do not match header file. > > man page shows > > /* mbuf pkthdr flags, also in m_flags */ > #define M_BCAST 0x0200 /* send/received as link-level broadcast */ > #define M_MCAST 0x0400 /* send/received as link-level multicast */ > #define M_FRAG 0x0800 /* packet is fragment of larger packet */ > #define M_FIRSTFRAG 0x1000 /* packet is first fragment */ > #define M_LASTFRAG 0x2000 /* packet is last fragment */ > > header (mbuf.h) file shows > > /* > * mbuf pkthdr flags (also stored in m_flags). > */ > #define M_BCAST 0x0100 /* send/received as link-level broadcast */ > #define M_MCAST 0x0200 /* send/received as link-level multicast */ > #define M_FRAG 0x0400 /* packet is a fragment of a larger packet */ > #define M_FIRSTFRAG 0x0800 /* packet is first fragment */ > #define M_LASTFRAG 0x1000 /* packet is last fragment */ > > I am currently seeing this in 4.10-PRERELEASE > > Comments??? Fixed in -STABLE, thanks for the report. -- Maxim Konovalov From owner-freebsd-doc@FreeBSD.ORG Wed Jul 7 19: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 C12DE16A4CE for ; Wed, 7 Jul 2004 19:50:29 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id BC00A43D2D for ; Wed, 7 Jul 2004 19: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 i67JoTJ3081954 for ; Wed, 7 Jul 2004 19:50:29 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i67JoT4h081953; Wed, 7 Jul 2004 19:50:29 GMT (envelope-from gnats) Date: Wed, 7 Jul 2004 19:50:29 GMT Message-Id: <200407071950.i67JoT4h081953@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Giorgos Keramidas 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: Giorgos Keramidas List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 07 Jul 2004 19:50:29 -0000 The following reply was made to PR docs/67806; it has been noted by GNATS. From: Giorgos Keramidas To: "Liam J. Foy" Cc: bug-followup@FreeBSD.org Subject: Re: docs/67806: Let 5.x users know how to boot into single user mode in cutting-edge. Date: Wed, 7 Jul 2004 22:44:44 +0300 > Patch can be viewed at: http://liamfoy.kerneled.org/fix.diff When the patch is a minor edit like this one, it usually isn't a very serious problem to see the entire diff as part of the PR text IMHO :) : --- /hd3/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml Thu Jun 10 19:51:47 2004 : +++ /hd3/chapter.sgml Thu Jun 10 19:59:56 2004 : @@ -749,8 +749,9 @@ : 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: : + enter the flag (5.x users press 4 at boot : + up menu). The system will then boot single user. At the shell : + prompt you should then run: : : &prompt.root; fsck -p : &prompt.root; mount -u / Two comments: a. Your editor seems to be inserting trailing whitespace when lines are wrapped. This means that the lines starting with + in the diff above insert whitespace that someone will have to delete later. b. Is "just press 4" some magic key combo for the boot loader of 5.X? I've been using a lot of different keys: SPACE, RETURN, ESC are a few of those. There is nothing different to the boot process of 5.X regarding single-user mode AFAIK. Did I miss/overlook something? From owner-freebsd-doc@FreeBSD.ORG Wed Jul 7 21:29:39 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 9D3FA16A4CF; Wed, 7 Jul 2004 21:29:39 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7ADD243D45; Wed, 7 Jul 2004 21:29:39 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i67LTdqN093445; Wed, 7 Jul 2004 21:29:39 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i67LTdIR093441; Wed, 7 Jul 2004 21:29:39 GMT (envelope-from keramida) Date: Wed, 7 Jul 2004 21:29:39 GMT From: Giorgos Keramidas Message-Id: <200407072129.i67LTdIR093441@freefall.freebsd.org> To: fox@vader.aacc.cc.md.us, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/67458: [patch] usr.bin/lex/lex.1 language nit 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, 07 Jul 2004 21:29:39 -0000 Synopsis: [patch] usr.bin/lex/lex.1 language nit State-Changed-From-To: open->patched State-Changed-By: keramida State-Changed-When: Wed Jul 7 21:28:12 GMT 2004 State-Changed-Why: Committed to -CURRENT. I'll take care of the MFC. Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Wed Jul 7 21:28:12 GMT 2004 Responsible-Changed-Why: Committed to -CURRENT. I'll take care of the MFC. http://www.freebsd.org/cgi/query-pr.cgi?pr=67458 From owner-freebsd-doc@FreeBSD.ORG Wed Jul 7 21:39:14 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 3C0E716A4CE; Wed, 7 Jul 2004 21:39:14 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1D41743D31; Wed, 7 Jul 2004 21:39:14 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i67LdE0g095082; Wed, 7 Jul 2004 21:39:14 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i67LdDRH095078; Wed, 7 Jul 2004 21:39:13 GMT (envelope-from keramida) Date: Wed, 7 Jul 2004 21:39:13 GMT From: Giorgos Keramidas Message-Id: <200407072139.i67LdDRH095078@freefall.freebsd.org> To: fox@vader.aacc.cc.md.us, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/66824: [patch] share/man/man4/man4.i386/fe.4 grammar, and 2 questions 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, 07 Jul 2004 21:39:14 -0000 Synopsis: [patch] share/man/man4/man4.i386/fe.4 grammar, and 2 questions State-Changed-From-To: open->patched State-Changed-By: keramida State-Changed-When: Wed Jul 7 21:37:58 GMT 2004 State-Changed-Why: A slightly modified version of the patch has been committed to -CURRENT. Thanks for your help with the manpages :) Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Wed Jul 7 21:37:58 GMT 2004 Responsible-Changed-Why: I'll handle the MFC. http://www.freebsd.org/cgi/query-pr.cgi?pr=66824 From owner-freebsd-doc@FreeBSD.ORG Wed Jul 7 22:12:11 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 7E60B16A4DA; Wed, 7 Jul 2004 22:12:11 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4960643D69; Wed, 7 Jul 2004 22:12:11 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i67MCBhs000113; Wed, 7 Jul 2004 22:12:11 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i67MCARL000107; Wed, 7 Jul 2004 22:12:10 GMT (envelope-from keramida) Date: Wed, 7 Jul 2004 22:12:10 GMT From: Giorgos Keramidas Message-Id: <200407072212.i67MCARL000107@freefall.freebsd.org> To: chuck@pkix.net, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/66610: Update handbook re: CVSup tags 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, 07 Jul 2004 22:12:11 -0000 Synopsis: Update handbook re: CVSup tags State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Wed Jul 7 22:10:28 GMT 2004 State-Changed-Why: Committed a slightly modified version after fixing a few tags that needed closing and rewording a bit. Thanks! Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Wed Jul 7 22:10:28 GMT 2004 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=66610 From owner-freebsd-doc@FreeBSD.ORG Wed Jul 7 22:30:31 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 7651A16A4FA for ; Wed, 7 Jul 2004 22:30:31 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6D83B43D41 for ; Wed, 7 Jul 2004 22:30:31 +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 i67MUVxW000678 for ; Wed, 7 Jul 2004 22:30:31 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i67MUVfi000676; Wed, 7 Jul 2004 22:30:31 GMT (envelope-from gnats) Date: Wed, 7 Jul 2004 22:30:31 GMT Message-Id: <200407072230.i67MUVfi000676@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Giorgos Keramidas Subject: Re: docs/66117: Handbook Serial Console Page doesn't list how to recompile boot blocks. 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, 07 Jul 2004 22:30:31 -0000 The following reply was made to PR docs/66117; it has been noted by GNATS. From: Giorgos Keramidas To: Jamin Brown Cc: bug-followup@FreeBSD.org Subject: Re: docs/66117: Handbook Serial Console Page doesn't list how to recompile boot blocks. Date: Thu, 8 Jul 2004 01:27:33 +0300 > Add documentation that explains that: > > cd /usr/src/sys/boot/i386/boot2 > make clean > make all install There is documentation about doing exactly this thing a few lines below. Is a cross-reference ok (to avoid repeating things)? %% Index: chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml,v retrieving revision 1.88 diff -u -r1.88 chapter.sgml --- chapter.sgml 6 Jun 2004 18:17:07 -0000 1.88 +++ chapter.sgml 7 Jul 2004 22:21:55 -0000 @@ -2442,7 +2442,12 @@ blocks: BOOT_COMCONSOLE_SPEED=19200 - + + Changing BOOT_COMCONSOLE_SPEED in + make.conf might require building and + installing new boot blocks. + See for details. + If the serial console is configured in some other way than by booting with , or if the serial console used by the kernel is different from the one used by the boot blocks, then %% From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 01:28: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 E3A0316A4CE for ; Thu, 8 Jul 2004 01:28:19 +0000 (GMT) Received: from new.knowspam.net (new.knowspam.net [64.49.216.134]) by mx1.FreeBSD.org (Postfix) with ESMTP id B4C7643D55 for ; Thu, 8 Jul 2004 01:28:19 +0000 (GMT) (envelope-from pete@petesmoviepage.com) Received: from new.knowspam.net (localhost [127.0.0.1]) by new.knowspam.net (Postfix) with SMTP id 03C78290B8C for ; Wed, 7 Jul 2004 18:18:57 -0700 (PDT) From: pete@petesmoviepage.com X-Mailer: net.non.io.SMTPClient-0.74@new.knowspam.net/64.49.216.134 Message-Id: To: doc@freebsd.org Date: Wed, 7 Jul 2004 18:18:57 -0700 Subject: RE: re: your text 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, 08 Jul 2004 01:28:20 -0000 Hi, pete@petesmoviepage.com is protected from spam by knowspam.net. For pete@petesmoviepage.com to receive your email, you need to demonstrate you are human by answering the simple question at this link: http://knowspam.net/v/v?a=ZG9jQGZyZWVic2Qub3Jn&b=cGV0ZUBwZXRlc21vdmllcGFnZS5jb20g Thanks! From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 04:00:46 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 CD35A16A4CF for ; Thu, 8 Jul 2004 04:00:46 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id AA19943D4C for ; Thu, 8 Jul 2004 04:00:46 +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 i6840kDx056912 for ; Thu, 8 Jul 2004 04:00:46 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6840kox056904; Thu, 8 Jul 2004 04:00:46 GMT (envelope-from gnats) Resent-Date: Thu, 8 Jul 2004 04:00:46 GMT Resent-Message-Id: <200407080400.i6840kox056904@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, Chris Pepper Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5D42316A4CE; Thu, 8 Jul 2004 03:59:29 +0000 (GMT) Received: from guest.reppep.com (guest.reppep.com [66.92.104.203]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1F03B43D3F; Thu, 8 Jul 2004 03:59:29 +0000 (GMT) (envelope-from pepper@reppep.com) Received: by guest.reppep.com (Postfix, from userid 501) id 5E9665C2A; Wed, 7 Jul 2004 23:59:28 -0400 (EDT) Message-Id: <20040708035928.5E9665C2A@guest.reppep.com> Date: Wed, 7 Jul 2004 23:59:28 -0400 (EDT) From: Chris Pepper To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 cc: hmp@FreeBSD.org Subject: docs/68799: Fix a couple language nits in tuning.7 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Chris Pepper List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 08 Jul 2004 04:00:46 -0000 >Number: 68799 >Category: docs >Synopsis: Fix a couple language nits in tuning.7 >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 08 04:00:46 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Chris Pepper >Release: FreeBSD 5.2.1-RELEASE i386 >Organization: >Environment: System: FreeBSD guest.reppep.com 5.2.1-RELEASE FreeBSD 5.2.1-RELEASE #1: Thu Jun 17 23:50:42 EDT 2004 root@guest.reppep.com:/usr/obj/usr/src/sys/REPPEP5 i386 >Description: tuning.7 has some minor problems (effects used where affects should be, and similar). >How-To-Repeat: man tuning >Fix: Patch like so: --- tuning.7.patch begins here --- --- /usr/src/share/man/man7/tuning.7 Sun Sep 14 19:44:55 2003 +++ tuning.7 Wed Jul 7 23:53:53 2004 @@ -582,9 +582,9 @@ interactive connections, especially over slow modems, will also be able to operate with lower round trip times. However, note that this feature -only effects data transmission (uploading / server-side). +only affects data transmission (uploading / server-side). It does not -effect data reception (downloading). +affect data reception (downloading). .Pp Adjusting .Va net.inet.tcp.inflight_stab @@ -625,8 +625,8 @@ This most commonly occurs when you are running a heavily loaded web proxy. The port range is not an issue -when running serves which handle mainly incoming connections, such as a -normal web server, or has a limited number of outgoing connections, such +when running servers which handle mainly incoming connections, such as a +normal web server, or have a limited number of outgoing connections, such as a mail relay. For situations where you may run yourself out of ports, we recommend increasing --- tuning.7.patch ends here --- >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 05:28:51 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 2945C16A4CF; Thu, 8 Jul 2004 05:28:51 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 09B9B43D5D; Thu, 8 Jul 2004 05:28:51 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i685SonG071959; Thu, 8 Jul 2004 05:28:50 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i685Sodb071955; Thu, 8 Jul 2004 05:28:50 GMT (envelope-from keramida) Date: Thu, 8 Jul 2004 05:28:50 GMT From: Giorgos Keramidas Message-Id: <200407080528.i685Sodb071955@freefall.freebsd.org> To: alec@gwi.net, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/66117: Handbook Serial Console Page doesn't list how to recompile boot blocks. 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, 08 Jul 2004 05:28:51 -0000 Synopsis: Handbook Serial Console Page doesn't list how to recompile boot blocks. State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Thu Jul 8 05:28:05 GMT 2004 State-Changed-Why: Committed the patch. Thanks! Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Thu Jul 8 05:28:05 GMT 2004 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=66117 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 06:50:24 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 EABF716A4CE for ; Thu, 8 Jul 2004 06:50:24 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id E31B843D62 for ; Thu, 8 Jul 2004 06: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 i686oO0j080779 for ; Thu, 8 Jul 2004 06: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 i686oOQ7080778; Thu, 8 Jul 2004 06:50:24 GMT (envelope-from gnats) Date: Thu, 8 Jul 2004 06:50:24 GMT Message-Id: <200407080650.i686oOQ7080778@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Jonathan Noack Subject: Re: docs/68595: [PATCH] add FAQ entry for lock order reversals X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Jonathan Noack List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 08 Jul 2004 06:50:25 -0000 The following reply was made to PR docs/68595; it has been noted by GNATS. From: Jonathan Noack To: Hiten Pandya , Cc: Subject: Re: docs/68595: [PATCH] add FAQ entry for lock order reversals Date: Thu, 08 Jul 2004 01:45:26 -0500 I can't seem to find the glossary part of the handbook (there doesn't app= ear to be a glossary at http://www.freebsd.org/handbook/ and grepping for glossary in the doc source didn't turn up much). Can you point me to whe= re it is defined? Jon Jonathan Noack Technology Coordinator Concordia Lutheran High School (http://www.concordiacrusaders.org) 700 East Main Street Tomball, TX 77375-6721 281.351.2547 x229 (work) 713.480.7163 (cell) "Do not worry about your problems with computers, I assure you mine are f= ar greater." -- Jonathan Noack From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 08:20: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 BB3B816A4CE for ; Thu, 8 Jul 2004 08:20:19 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id B2C7243D46 for ; Thu, 8 Jul 2004 08:20: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 i688KJHE092754 for ; Thu, 8 Jul 2004 08:20:19 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i688KJBs092753; Thu, 8 Jul 2004 08:20:19 GMT (envelope-from gnats) Date: Thu, 8 Jul 2004 08:20:19 GMT Message-Id: <200407080820.i688KJBs092753@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: "Simon L. Nielsen" Subject: Re: docs/68595: [PATCH] add FAQ entry for lock order reversals 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, 08 Jul 2004 08:20:19 -0000 The following reply was made to PR docs/68595; it has been noted by GNATS. From: "Simon L. Nielsen" To: Jonathan Noack Cc: freebsd-gnats-submit@FreeBSD.org Subject: Re: docs/68595: [PATCH] add FAQ entry for lock order reversals Date: Thu, 8 Jul 2004 10:18:12 +0200 --YiEDa0DAkWCtVeE4 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.07.08 06:50:24 +0000, Jonathan Noack wrote: > I can't seem to find the glossary part of the handbook (there doesn't > appear to be a glossary at http://www.freebsd.org/handbook/ and > grepping for glossary in the doc source didn't turn up much). Can you > point me to where it is defined? It is not build by default (yet) since there hasn't been that much content in it (though that should probably be reconsidered soon). Anyway, it's located in: doc/en_US.ISO8859-1/share/sgml/glossary/freebsd-glossary.sgml --=20 Simon L. Nielsen FreeBSD Documentation Team --YiEDa0DAkWCtVeE4 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA7QNDh9pcDSc1mlERAmewAKCdITaRCk9xC2Y++8XBu1FsMMuLfACgopmt zbiZ5oNMJnFc/nwNGBaqvCs= =49+r -----END PGP SIGNATURE----- --YiEDa0DAkWCtVeE4-- From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 11:03: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 0AF6916A4CE; Thu, 8 Jul 2004 11:03:28 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id E542D43D5A; Thu, 8 Jul 2004 11:03:27 +0000 (GMT) (envelope-from hmp@FreeBSD.org) Received: from freefall.freebsd.org (hmp@localhost [127.0.0.1]) i68B3Rjq009108; Thu, 8 Jul 2004 11:03:27 GMT (envelope-from hmp@freefall.freebsd.org) Received: (from hmp@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i68B3RB6009104; Thu, 8 Jul 2004 11:03:27 GMT (envelope-from hmp) Date: Thu, 8 Jul 2004 11:03:27 GMT From: Hiten Pandya Message-Id: <200407081103.i68B3RB6009104@freefall.freebsd.org> To: hmp@FreeBSD.org, freebsd-doc@FreeBSD.org, hmp@FreeBSD.org Subject: Re: docs/68799: Fix a couple language nits in tuning.7 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, 08 Jul 2004 11:03:28 -0000 Synopsis: Fix a couple language nits in tuning.7 Responsible-Changed-From-To: freebsd-doc->hmp Responsible-Changed-By: hmp Responsible-Changed-When: Thu Jul 8 11:02:59 GMT 2004 Responsible-Changed-Why: I will handle this in a moment. http://www.freebsd.org/cgi/query-pr.cgi?pr=68799 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 11:20:14 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 98E7116A4CF for ; Thu, 8 Jul 2004 11:20:14 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9500743D53 for ; Thu, 8 Jul 2004 11:20:14 +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 i68BKBgu013202 for ; Thu, 8 Jul 2004 11:20:11 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i68BKBcK013201; Thu, 8 Jul 2004 11:20:11 GMT (envelope-from gnats) Date: Thu, 8 Jul 2004 11:20:11 GMT Message-Id: <200407081120.i68BKBcK013201@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Hiten Pandya Subject: Re: docs/68595: [PATCH] add FAQ entry for lock order reversals X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Hiten Pandya List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 08 Jul 2004 11:20:14 -0000 The following reply was made to PR docs/68595; it has been noted by GNATS. From: Hiten Pandya To: Jonathan Noack Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/68595: [PATCH] add FAQ entry for lock order reversals Date: Thu, 8 Jul 2004 07:15:49 -0400 (EDT) I do apologise. The glossary is actually part of the Architecture Handbook. In that case, it might be just OK to add it to the FAQ right now, and once a Glossary chapter is written for the Handbook it can be included in there. Hiten Pandya hmp at freebsd.org On Thu, 8 Jul 2004, Jonathan Noack wrote: :I can't seem to find the glossary part of the handbook (there doesn't appear :to be a glossary at http://www.freebsd.org/handbook/ and grepping for :glossary in the doc source didn't turn up much). Can you point me to where :it is defined? : :Jon : : :Jonathan Noack :Technology Coordinator :Concordia Lutheran High School (http://www.concordiacrusaders.org) :700 East Main Street :Tomball, TX 77375-6721 :281.351.2547 x229 (work) :713.480.7163 (cell) : :"Do not worry about your problems with computers, I assure you mine are far :greater." -- Jonathan Noack : : : From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 11:42: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 77FF916A4CE for ; Thu, 8 Jul 2004 11:42:28 +0000 (GMT) Received: from zeverly.mail.atl.earthlink.net (zeverly.mail.atl.earthlink.net [207.69.200.46]) by mx1.FreeBSD.org (Postfix) with ESMTP id 23B9743D5C for ; Thu, 8 Jul 2004 11:42:28 +0000 (GMT) (envelope-from wfp58794@mspring.net) Received: from cassius-z.mspring.net ([207.69.231.72] helo=mspring.net) by zeverly.mail.atl.earthlink.net with esmtp (Exim 3.36 #1) id 1BiXIJ-0001b4-00 for freebsd-doc@freebsd.org; Thu, 08 Jul 2004 07:42:27 -0400 Received: by mspring.net id HAA0000014418; Thu, 8 Jul 2004 07:42:27 -0400 (EDT) Date: Thu, 8 Jul 2004 07:42:27 -0400 (EDT) Message-Id: <200407081142.HAA0000014418@mspring.net> To: freebsd-doc@freebsd.org From: Unsubscriber Subject: freebsd-doc@freebsd.org Removed 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, 08 Jul 2004 11:42:28 -0000 You (freebsd-doc@freebsd.org) have been removed from the IGDNYC mailing list. We apologize for any inconveniences. From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 14:03:30 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 AA33C16A4CE; Thu, 8 Jul 2004 14:03:30 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8B98743D5A; Thu, 8 Jul 2004 14:03:30 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i68E3UJ5031381; Thu, 8 Jul 2004 14:03:30 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i68E3UVF031377; Thu, 8 Jul 2004 14:03:30 GMT (envelope-from keramida) Date: Thu, 8 Jul 2004 14:03:30 GMT From: Giorgos Keramidas Message-Id: <200407081403.i68E3UVF031377@freefall.freebsd.org> To: randy@psg.com, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, blackend@FreeBSD.org Subject: Re: docs/65952: handbook kernel conf has old cruft 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, 08 Jul 2004 14:03:30 -0000 Synopsis: handbook kernel conf has old cruft State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Thu Jul 8 14:02:55 GMT 2004 State-Changed-Why: This has already been fixed in the Handbook since Aug 2003. Responsible-Changed-From-To: freebsd-doc->blackend Responsible-Changed-By: keramida Responsible-Changed-When: Thu Jul 8 14:02:55 GMT 2004 Responsible-Changed-Why: Marc was the one who fixed this. http://www.freebsd.org/cgi/query-pr.cgi?pr=65952 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 16:07: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 D6A4916A4CE; Thu, 8 Jul 2004 16:07:21 +0000 (GMT) Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id BB9D143D49; Thu, 8 Jul 2004 16:07:21 +0000 (GMT) (envelope-from linimon@lonesome.com) Received: by mail.soaustin.net (Postfix, from userid 502) id 39B48148BF; Thu, 8 Jul 2004 11:07:21 -0500 (CDT) Date: Thu, 8 Jul 2004 11:07:21 -0500 (CDT) From: Mark Linimon X-X-Sender: linimon@pancho To: Hiten Pandya In-Reply-To: <200407081120.i68BKBcK013201@freefall.freebsd.org> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: freebsd-www@FreeBSD.org cc: freebsd-doc@FreeBSD.org Subject: Re: docs/68595: [PATCH] add FAQ entry for lock order reversals 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, 08 Jul 2004 16:07:22 -0000 I added LOR to the glossary a few days ago. It includes a URL to the list page. I noted that the glossary does not seem to be built in the version of the handbook that is displayed on the website as well at that time. There seems to be a Makefile flag to turn it on. Does anyone know why that flag is not on for the www page? mcl From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 16:08:42 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 D9AA416A4CE; Thu, 8 Jul 2004 16:08:42 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id BAA7D43D58; Thu, 8 Jul 2004 16:08:42 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i68G8gFa048846; Thu, 8 Jul 2004 16:08:42 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i68G8fKO048842; Thu, 8 Jul 2004 16:08:41 GMT (envelope-from keramida) Date: Thu, 8 Jul 2004 16:08:41 GMT From: Giorgos Keramidas Message-Id: <200407081608.i68G8fKO048842@freefall.freebsd.org> To: so14k@so14k.com, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/68718: s/// 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, 08 Jul 2004 16:08:43 -0000 Synopsis: s/// State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Thu Jul 8 16:07:34 GMT 2004 State-Changed-Why: Committed a version similar to the one Marc proposed. Thanks for noticing this! Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Thu Jul 8 16:07:34 GMT 2004 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=68718 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 16:10: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 C5FD716A4CE; Thu, 8 Jul 2004 16:10:50 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id A8BB743D1D; Thu, 8 Jul 2004 16:10:50 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i68GAoqd049088; Thu, 8 Jul 2004 16:10:50 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i68GAo0S049084; Thu, 8 Jul 2004 16:10:50 GMT (envelope-from keramida) Date: Thu, 8 Jul 2004 16:10:50 GMT From: Giorgos Keramidas Message-Id: <200407081610.i68GAo0S049084@freefall.freebsd.org> To: liamfoy@sepulcrum.org, keramida@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, 08 Jul 2004 16:10:50 -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: keramida State-Changed-When: Thu Jul 8 16:09:31 GMT 2004 State-Changed-Why: I don't think there is any significant difference when booting 5.X into single-user mode. Have I misunderstood your suggestion or the text of your proposed change? http://www.freebsd.org/cgi/query-pr.cgi?pr=67806 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 16:15: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 1C75816A4CF; Thu, 8 Jul 2004 16:15:19 +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 CF9C143D58; Thu, 8 Jul 2004 16:15:18 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.34; FreeBSD) id 1BibYM-000H8G-0t; Thu, 08 Jul 2004 17:15:18 +0100 Date: Thu, 8 Jul 2004 17:15:17 +0100 From: Ceri Davies To: Mark Linimon Message-ID: <20040708161517.GS29928@submonkey.net> Mail-Followup-To: Ceri Davies , Mark Linimon , Hiten Pandya , freebsd-www@FreeBSD.org, freebsd-doc@FreeBSD.org References: <200407081120.i68BKBcK013201@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="JLiXfqD9/Kt1b+Pq" Content-Disposition: inline In-Reply-To: X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: Hiten Pandya cc: freebsd-doc@FreeBSD.org cc: freebsd-www@FreeBSD.org Subject: Re: docs/68595: [PATCH] add FAQ entry for lock order reversals 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, 08 Jul 2004 16:15:19 -0000 --JLiXfqD9/Kt1b+Pq Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, Jul 08, 2004 at 11:07:21AM -0500, Mark Linimon wrote: > I added LOR to the glossary a few days ago. It includes a URL to the > list page. >=20 > I noted that the glossary does not seem to be built in the version of > the handbook that is displayed on the website as well at that time. > There seems to be a Makefile flag to turn it on. Does anyone know > why that flag is not on for the www page? There simply wasn't enough content in it when I committed it. Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --JLiXfqD9/Kt1b+Pq Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA7XMVocfcwTS3JF8RAmj0AJ4xpUWOM1k9eWWPcUGZESr59MevUQCfdOvA V6j/cIJNhzE1Ycnn5jH8Gi8= =LhmI -----END PGP SIGNATURE----- --JLiXfqD9/Kt1b+Pq-- From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 16:28:31 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 1F38816A4CE; Thu, 8 Jul 2004 16:28:31 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 00AA843D49; Thu, 8 Jul 2004 16:28:31 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i68GSUwD049780; Thu, 8 Jul 2004 16:28:30 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i68GSQsl049776; Thu, 8 Jul 2004 16:28:26 GMT (envelope-from keramida) Date: Thu, 8 Jul 2004 16:28:26 GMT From: Giorgos Keramidas Message-Id: <200407081628.i68GSQsl049776@freefall.freebsd.org> To: fox@vader.aacc.cc.md.us, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/66540: [patch] share/man/man4/ppbus.4 wording nits 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, 08 Jul 2004 16:28:31 -0000 Synopsis: [patch] share/man/man4/ppbus.4 wording nits State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Thu Jul 8 16:27:37 GMT 2004 State-Changed-Why: Committed, thanks! Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Thu Jul 8 16:27:37 GMT 2004 Responsible-Changed-Why: I'll MFC this in a few days. http://www.freebsd.org/cgi/query-pr.cgi?pr=66540 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 21: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 6E23916A4CE for ; Thu, 8 Jul 2004 21:50:26 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 668C943D2F for ; Thu, 8 Jul 2004 21: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 i68LoQsX089224 for ; Thu, 8 Jul 2004 21: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 i68LoQrI089223; Thu, 8 Jul 2004 21:50:26 GMT (envelope-from gnats) Date: Thu, 8 Jul 2004 21:50:26 GMT Message-Id: <200407082150.i68LoQrI089223@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: des@des.no (=?iso-8859-1?q?Dag-Erling_Sm=F8rgrav?=) 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: =?iso-8859-1?q?Dag-Erling_Sm=F8rgrav?= List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 08 Jul 2004 21:50:26 -0000 The following reply was made to PR docs/67806; it has been noted by GNATS. From: des@des.no (=?iso-8859-1?q?Dag-Erling_Sm=F8rgrav?=) To: Giorgos Keramidas Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/67806: Let 5.x users know how to boot into single user mode in cutting-edge. Date: Thu, 08 Jul 2004 23:48:54 +0200 Giorgos Keramidas writes: > I don't think there is any significant difference when booting 5.X into > single-user mode. Have I misunderstood your suggestion or the text of > your proposed change? There *is* a difference. First of all, the original text is incorrect even for 4.x (it should say "wait until the countdown, press enter, type 'boot -s' and press enter again" since 4.x has /boot/loader). Second, a default 5.x installation has the horrid daemon menu, where you press 4 to get single-user mode (or 6 to get the loader prompt, at which point you type 'boot -s' as in 4.x) DES --=20 Dag-Erling Sm=F8rgrav - des@des.no From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 22:11:35 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 E795116A4CE; Thu, 8 Jul 2004 22:11:35 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id C713B43D2D; Thu, 8 Jul 2004 22:11:35 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i68MBZte095572; Thu, 8 Jul 2004 22:11:35 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i68MBZ46095568; Thu, 8 Jul 2004 22:11:35 GMT (envelope-from keramida) Date: Thu, 8 Jul 2004 22:11:35 GMT From: Giorgos Keramidas Message-Id: <200407082211.i68MBZ46095568@freefall.freebsd.org> To: liamfoy@sepulcrum.org, keramida@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, 08 Jul 2004 22:11:36 -0000 Synopsis: Let 5.x users know how to boot into single user mode in cutting-edge. State-Changed-From-To: feedback->open State-Changed-By: keramida State-Changed-When: Thu Jul 8 22:10:33 GMT 2004 State-Changed-Why: Doug-Erling explained to me what I was missing. Put this back into the pool of open PRs. http://www.freebsd.org/cgi/query-pr.cgi?pr=67806 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 8 23:26: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 5B71A16A4CE; Thu, 8 Jul 2004 23:26:39 +0000 (GMT) Received: from bilbo.otenet.gr (bilbo.otenet.gr [195.170.0.13]) by mx1.FreeBSD.org (Postfix) with ESMTP id 951FD43D2F; Thu, 8 Jul 2004 23:26:38 +0000 (GMT) (envelope-from keramida@freebsd.org) Received: from gothmog.gr (patr530-b124.otenet.gr [212.205.244.132]) i68NQY5B028713; Fri, 9 Jul 2004 02:26:35 +0300 Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.12.11/8.12.11) with ESMTP id i68NQXfK099254; Fri, 9 Jul 2004 02:26:33 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from giorgos@localhost) by gothmog.gr (8.12.11/8.12.11/Submit) id i68NPZIV096998; Fri, 9 Jul 2004 02:25:35 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Fri, 9 Jul 2004 02:25:34 +0300 From: Giorgos Keramidas To: doc@freebsd.org, Ruslan Ermilov Message-ID: <20040708232534.GA85731@gothmog.gr> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Subject: RFC: pciconf.8 options diff 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, 08 Jul 2004 23:26:39 -0000 I've tried to convert the description of options in pciconf.8 to the usual .Bl ... .El style. The changes I made locally are: %% Index: pciconf.8 =================================================================== RCS file: /home/ncvs/src/usr.sbin/pciconf/pciconf.8,v retrieving revision 1.26 diff -u -r1.26 pciconf.8 --- pciconf.8 6 Jan 2004 20:23:20 -0000 1.26 +++ pciconf.8 8 Jul 2004 23:19:51 -0000 @@ -52,22 +52,16 @@ .Pa /dev/pci , normally only the super-user. .Pp -With the -.Fl l -option, it lists all devices found by the boot probe in the following format: +The following options are available: +.Bl -tag -width indent +.It Fl l +Lists all devices found by the boot probe in the following format: .Bd -literal foo0@pci0:4:0: class=0x010000 card=0x00000000 chip=0x000f1000 rev=0x01 hdr=0x00 bar0@pci0:5:0: class=0x000100 card=0x00000000 chip=0x88c15333 rev=0x00 hdr=0x00 none0@pci0:6:0: class=0x020000 card=0x00000000 chip=0x802910ec rev=0x00 hdr=0x00 .Ed .Pp -If the -.Fl v -option is supplied, -.Nm -will attempt to load the vendor/device information database, and print -vendor, device, class and subclass identification strings for each device. -.Pp The first column gives the device name, unit number, and .Ar selector . @@ -80,8 +74,10 @@ The .Ar selector is in a form which may directly be used for the other forms of the command. +.Pp The second column is the class code, with the class byte printed as two hex digits, followed by the sub-class and the interface bytes. +.Pp The third column gives the contents of the subvendorid register, introduced in revision 2.1 of the .Tn PCI @@ -99,8 +95,11 @@ this card is based on. It consists of two fields, identifying the chip and its vendor, as above. +.Pp The fifth column prints the chip's revision. +.Pp The sixth column describes the header type. +.Pp Currently assigned header types are 0 for all devices except .Tn PCI to @@ -115,36 +114,20 @@ device, which contains several (similar or independent) functions on one chip. .Pp -All invocations of -.Nm -except for -.Fl l -require a -.Ar selector -of the form -.Li pci Ns Va bus Ns \&: Ns Va device -(optionally followed by -.Li \&: Ns Va function ) . -A final colon may be appended and -will be ignored; this is so that the first column in the output of -.Nm -.Fl l -can be used without modification. -All numbers are base 10. -.Pp -With the -.Fl a -flag, +.It Fl v +When used in combination with +.Fl l , .Nm -determines whether any driver has been assigned to the device +will attempt to load the vendor/device information database, and print +vendor, device, class and subclass identification strings for each device. +.It Fl a +Determine whether any driver has been assigned to the device identified by .Ar selector . An exit status of zero indicates that the device has a driver; non-zero indicates that it does not. -.Pp -The -.Fl r -option reads a configuration space register at byte offset +.It Fl r +Reads a configuration space register at byte offset .Ar addr of device .Ar selector @@ -152,25 +135,47 @@ The optional second address .Ar addr2 specifies a range to read. -The -.Fl w -option writes the +.It Fl w +Write the .Ar value into a configuration space register at byte offset .Ar addr of device .Ar selector . -For both operations, the flags -.Fl b -and -.Fl h -select the width of the operation; -.Fl b -indicates a byte operation, and -.Fl h -indicates a halfword (two-byte) operation. -The default is to read or -write a longword (four bytes). +.It Fl b +When used in combination with +.Fl r +or +.Fl w +indicate that the width of the operation is 1 byte. +The default is to read or write a longword (four bytes). +.It Fl h +When used in combination with +.Fl r +or +.Fl w +indicate that the width of the operation is 1 half-word (two bytes). +The default is to read or write a longword (four bytes). +.El +.Pp +All invocations of +.Nm +except for +.Fl l +require a +.Ar selector +of the form +.Li pci Ns Va bus Ns \&: Ns Va device +(optionally followed by +.Li \&: Ns Va function ) . +A final colon may be appended and +will be ignored; this is so that the first column in the output of +.Nm +.Fl l +can be used without modification. +All numbers in the +.Ar selector +are base 10. .Sh ENVIRONMENT The PCI vendor/device information database is normally read from .Pa /usr/share/misc/pci_vendors . %% Any objections to committing this? Comments? Suggestions for improvement? I know that the options are unsorted in the resulting manpage. If it's ok to sort the options with a different commit, then I'll do it separately. Otherwise I'll do it in only one commit. - Giorgos From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 00:58:41 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 97D6E16A4CE; Fri, 9 Jul 2004 00:58:41 +0000 (GMT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id E473A43D41; Fri, 9 Jul 2004 00:58:40 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost.pittgoth.com ([192.168.0.5]) (authenticated bits=0) by pittgoth.com (8.12.11/8.12.11) with ESMTP id i690weCh004110 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 8 Jul 2004 20:58:40 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Thu, 8 Jul 2004 20:59:13 -0400 From: Tom Rhodes To: Giorgos Keramidas Message-Id: <20040708205913.502f6911@localhost.pittgoth.com> In-Reply-To: <20040708232534.GA85731@gothmog.gr> References: <20040708232534.GA85731@gothmog.gr> 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: Ruslan Ermilov cc: doc@FreeBSD.org Subject: Re: RFC: pciconf.8 options diff 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, 09 Jul 2004 00:58:41 -0000 On Fri, 9 Jul 2004 02:25:34 +0300 Giorgos Keramidas wrote: > I've tried to convert the description of options in pciconf.8 to the > usual .Bl ... .El style. The changes I made locally are: > > %% > Index: pciconf.8 > =================================================================== > RCS file: /home/ncvs/src/usr.sbin/pciconf/pciconf.8,v > retrieving revision 1.26 > diff -u -r1.26 pciconf.8 > --- pciconf.8 6 Jan 2004 20:23:20 -0000 1.26 > +++ pciconf.8 8 Jul 2004 23:19:51 -0000 > @@ -52,22 +52,16 @@ > .Pa /dev/pci , > normally only the super-user. > .Pp > -With the > -.Fl l > -option, it lists all devices found by the boot probe in the following format: > +The following options are available: > +.Bl -tag -width indent > +.It Fl l > +Lists all devices found by the boot probe in the following format: > .Bd -literal > foo0@pci0:4:0: class=0x010000 card=0x00000000 chip=0x000f1000 rev=0x01 hdr=0x00 > bar0@pci0:5:0: class=0x000100 card=0x00000000 chip=0x88c15333 rev=0x00 hdr=0x00 > none0@pci0:6:0: class=0x020000 card=0x00000000 chip=0x802910ec rev=0x00 hdr=0x00 > .Ed > .Pp > -If the > -.Fl v > -option is supplied, > -.Nm > -will attempt to load the vendor/device information database, and print > -vendor, device, class and subclass identification strings for each device. > -.Pp > The first column gives the > device name, unit number, and > .Ar selector . > @@ -80,8 +74,10 @@ > The > .Ar selector > is in a form which may directly be used for the other forms of the command. > +.Pp > The second column is the class code, with the class byte printed as two > hex digits, followed by the sub-class and the interface bytes. > +.Pp > The third column gives the contents of the subvendorid register, introduced > in revision 2.1 of the > .Tn PCI > @@ -99,8 +95,11 @@ > this card is based on. > It consists of two fields, identifying the chip and > its vendor, as above. > +.Pp > The fifth column prints the chip's revision. > +.Pp > The sixth column describes the header type. > +.Pp > Currently assigned header types are 0 for all devices except > .Tn PCI > to In place of all these .Pp macros, how about making them a list? Perhaps: .Bl -bullet .It I describe column one. .It I describe column two. ... > @@ -115,36 +114,20 @@ > device, which contains several (similar or independent) functions on > one chip. > .Pp > -All invocations of > -.Nm > -except for > -.Fl l > -require a > -.Ar selector > -of the form > -.Li pci Ns Va bus Ns \&: Ns Va device > -(optionally followed by > -.Li \&: Ns Va function ) . > -A final colon may be appended and > -will be ignored; this is so that the first column in the output of > -.Nm > -.Fl l > -can be used without modification. > -All numbers are base 10. > -.Pp > -With the > -.Fl a > -flag, > +.It Fl v > +When used in combination with > +.Fl l , > .Nm > -determines whether any driver has been assigned to the device > +will attempt to load the vendor/device information database, and print > +vendor, device, class and subclass identification strings for each device. > +.It Fl a > +Determine whether any driver has been assigned to the device > identified by s/any/a here > .Ar selector . > An exit status of zero indicates that the device has a driver; > non-zero indicates that it does not. > -.Pp > -The > -.Fl r > -option reads a configuration space register at byte offset > +.It Fl r > +Reads a configuration space register at byte offset > .Ar addr > of device > .Ar selector > @@ -152,25 +135,47 @@ > The optional second address > .Ar addr2 > specifies a range to read. > -The > -.Fl w > -option writes the > +.It Fl w > +Write the > .Ar value > into a configuration space register at byte offset > .Ar addr > of device > .Ar selector . > -For both operations, the flags > -.Fl b > -and > -.Fl h > -select the width of the operation; > -.Fl b > -indicates a byte operation, and > -.Fl h > -indicates a halfword (two-byte) operation. > -The default is to read or > -write a longword (four bytes). > +.It Fl b > +When used in combination with > +.Fl r > +or > +.Fl w Perhaps a comma after w? > +indicate that the width of the operation is 1 byte. > +The default is to read or write a longword (four bytes). > +.It Fl h > +When used in combination with > +.Fl r > +or > +.Fl w Again here? > +indicate that the width of the operation is 1 half-word (two bytes). > +The default is to read or write a longword (four bytes). > +.El > +.Pp > +All invocations of > +.Nm > +except for > +.Fl l > +require a > +.Ar selector > +of the form > +.Li pci Ns Va bus Ns \&: Ns Va device > +(optionally followed by > +.Li \&: Ns Va function ) . I don't think we need '()' around this text. > +A final colon may be appended and > +will be ignored; this is so that the first column in the output of s/that // > +.Nm > +.Fl l > +can be used without modification. > +All numbers in the > +.Ar selector > +are base 10. > .Sh ENVIRONMENT > The PCI vendor/device information database is normally read from > .Pa /usr/share/misc/pci_vendors . > %% > > Any objections to committing this? Comments? Suggestions for > improvement? > > I know that the options are unsorted in the resulting manpage. > If it's ok to sort the options with a different commit, then > I'll do it separately. Otherwise I'll do it in only one commit. Remember, you are not required to take my advice. It's only when I demand you take my advice that you actually take my advice. :) -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 03:20: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 BD85F16A4CE for ; Fri, 9 Jul 2004 03:20:17 +0000 (GMT) Received: from basm.cerias.purdue.edu (basm.cerias.purdue.edu [128.10.243.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id B07F143D49 for ; Fri, 9 Jul 2004 03:20:16 +0000 (GMT) (envelope-from flack@cerias.purdue.edu) Received: from basm.cerias.purdue.edu (flack@localhost [127.0.0.1]) ESMTP id i693KCwr003043 for ; Thu, 8 Jul 2004 22:20:12 -0500 (EST) Message-Id: <200407090320.i693KCwr003043@basm.cerias.purdue.edu> X-Mailer: exmh version 2.3.1 03/08/2001 with nmh-1.0.4 To: doc@freebsd.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 X-OtherArticle: http://www.linuxjournal.com/article.php?sid=2643 Content-Transfer-Encoding: quoted-printable Date: Thu, 08 Jul 2004 22:20:12 -0500 From: Chapman Flack X-Scanned-By: MIMEDefang 2.43 Subject: Two comments on 'Commercial Applications' FAQ 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, 09 Jul 2004 03:20:17 -0000 Hi, I just noticed two things about the commercial applications section of the FAQ. 6.2. Where can I get Motif=AE for FreeBSD? The Open Group has released the source code to Motif 2.1.30. You can install the open-motif package, or compile it from ports. Refer to the ports section of the Handbook for more information on how to do this. Note: The Open Motif distribution only allows redistribution if it is running on an open source operating system. In addition, there are commercial distributions of the Motif software available. These, however, are not for free, but their license allows them to be used in closed-source software. This section seems to make the Open Motif licensing sound worse than it is. The Open Motif license condition is that it must be run on an open source OS. Of course for anyone thinking of installing Open Motif on FreeBSD, the condition is trivially satisfied. It's even satisfied if the user wants to redistribute FreeBSD with Open Motif on it--the only exception is if the user wants to redistribute as a closed-source FreeBSD-derived OS. It could be misleading to say of the commercial distributions "but their license allows them to be used in closed-source software". The reader might think that refers to *linking Motif apps on his FreeBSD box and selling the apps as closed source*. But that's perfectly fine under the Open Motif license; it's clearly spelled out in the OpenGroup FAQ. http://www.opengroup.org/openmotif/faq.html So the *only* infringement risk with Open Motif is if the user wants to bundle it with a modified FreeBSD and distribute that as a closed-source OS. But buying Motif in a box from Apps2go or MetroLink or XiG doesn't help in that case either; I'm sure they would frown on having their commercial product redistributed that way. A person who wanted to distribute a closed OS with Motif would really have to negotiate a license for that, any way you slice it. But for any other use of FreeBSD, there is no reason to be concerned about the Open Motif license. 6.3. Where can I get CDE for FreeBSD? Xi Graphics used to sell CDE for FreeBSD, but no longer do. KDE is an open source X11 desktop which is similar to CDE in many respects. You might also like the look and feel of xfce. KDE and xfce are both in the ports system. This answer I think could be taken as misleading by somebody who has an actual need or interest in CDE. KDE is only "similar to" CDE in some outward, superficial respects ... if you pick the right theme it might /look/ similar. dtksh isn't there, ToolTalk isn't there, the appbuilder isn't there, the APIs are all different--as the guy said in Linux Journal, "there is much more to CDE than meets the eye" (http://www.linuxjournal.com/article.php?sid=3D2324) and the only part you can get with KDE or xfce is the part that meets the eye. I think it would be better to give a slightly longer answer, mentioning that unfortunately nobody's offering CDE for FreeBSD at the moment, and KDE and xfce are available and may suffice if nothing matters but outward appearance, but be clear about all of the cool CDE infrastructure that won't be there, and any available information about what pieces might be becoming available (e.g. Open Motif is now available, real ksh93 has finally been opensourced and the dtksh extensions would probably not be that hard to reimplement in a pinch, and maybe with that trend some arrangement could be reached for the rest of the infrastructure, given interest). Chapman Flack flack@cs.purdue.edu From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 03:50: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 E1C2D16A4CF for ; Fri, 9 Jul 2004 03:50:21 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id C612B43D41 for ; Fri, 9 Jul 2004 03:50: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 i693oLEG033462 for ; Fri, 9 Jul 2004 03:50:21 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i693oLNx033461; Fri, 9 Jul 2004 03:50:21 GMT (envelope-from gnats) Resent-Date: Fri, 9 Jul 2004 03:50:21 GMT Resent-Message-Id: <200407090350.i693oLNx033461@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, Chris Pepper Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D1EE616A4CE; Fri, 9 Jul 2004 03:46:31 +0000 (GMT) Received: from guest.reppep.com (guest.reppep.com [66.92.104.203]) by mx1.FreeBSD.org (Postfix) with ESMTP id A6A2F43D41; Fri, 9 Jul 2004 03:46:31 +0000 (GMT) (envelope-from pepper@reppep.com) Received: by guest.reppep.com (Postfix, from userid 501) id 817FC5C2A; Thu, 8 Jul 2004 23:46:30 -0400 (EDT) Message-Id: <20040709034630.817FC5C2A@guest.reppep.com> Date: Thu, 8 Jul 2004 23:46:30 -0400 (EDT) From: Chris Pepper To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 cc: dougb@FreeBSD.org Subject: docs/68843: Dates on rc.subr(8) & rc(8) are whack. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Chris Pepper List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 09 Jul 2004 03:50:22 -0000 >Number: 68843 >Category: docs >Synopsis: Dates on rc.subr(8) & rc(8) are whack. >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 09 03:50:21 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Chris Pepper >Release: FreeBSD 5.2.1-RELEASE i386 >Organization: >Environment: System: FreeBSD guest.reppep.com 5.2.1-RELEASE FreeBSD 5.2.1-RELEASE #1: Thu Jun 17 23:50:42 EDT 2004 root@guest.reppep.com:/usr/obj/usr/src/sys/REPPEP5 i386 >Description: The manual pages for rc & rc.subr have very strange dates. >How-To-Repeat: Look at the last line of the rc & rc.subr manual pages on a variety of recent systems, including the web site: pepper@www:~$ uname -a FreeBSD www.reppep.com 4.10-STABLE FreeBSD 4.10-STABLE #15: Sun May 30 22:18:46 EDT 2004 root@www.reppep.com:/usr/obj/usr/src/sys/REPPEP i386 pepper@www:~$ man rc.subr|tail -1 FreeBSD 4.10 January 6, 2004 FreeBSD 4.10 pepper@www:~$ man rc|tail -1 FreeBSD 4.10 December 11, 1993 FreeBSD 4.10 pepper@guest:~$ uname -a FreeBSD guest.reppep.com 5.2.1-RELEASE FreeBSD 5.2.1-RELEASE #1: Thu Jun 17 23:50:42 EDT 2004 root@guest.reppep.com:/usr/obj/usr/src/sys/REPPEP5 i386 pepper@guest:~$ man rc.subr|tail -1 FreeBSD 5.2.1 April 18, 2002 FreeBSD 5.2.1 pepper@guest:~$ man rc|tail -1 FreeBSD 5.2.1 November 4, 2002 FreeBSD 5.2.1 http://www.freebsd.org/cgi/man.cgi?query=rc.subr&sektion=8 says: FreeBSD 4.10 April 18, 2002 FreeBSD 4.10 http://www.freebsd.org/cgi/man.cgi?query=rc&sektion=8 says: FreeBSD 4.10 November 4, 2002 FreeBSD 4.10 And the hypertext man pages can't find rc.subr(8) in FreeBSD 4.10-RELEASE or FreeBSD 4.10-stable, which is illogical since the manual page with no version specification claims to be from 4.10: http://www.freebsd.org/cgi/man.cgi?query=rc.subr&apropos=0&sektion=8&manpath=FreeBSD+4.10-RELEASE&format=html http://www.freebsd.org/cgi/man.cgi?query=rc.subr&apropos=0&sektion=8&manpath=FreeBSD+4.10-stable&format=html >Fix: Reconcile the date lines (or entities?) used for manual page versions. >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 03:53: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 F039016A4CE; Fri, 9 Jul 2004 03:53:36 +0000 (GMT) Received: from www.reppep.com (www.reppep.com [66.92.104.200]) by mx1.FreeBSD.org (Postfix) with ESMTP id CB94B43D1F; Fri, 9 Jul 2004 03:53:36 +0000 (GMT) (envelope-from pepper@reppep.com) Received: from [10.0.1.250] (airport.reppep.com [66.92.104.202]) by www.reppep.com (Postfix) with ESMTP id DB6C5FF6E; Thu, 8 Jul 2004 23:53:34 -0400 (EDT) Mime-Version: 1.0 X-Sender: pepper@mail.reppep.com Message-Id: Date: Thu, 8 Jul 2004 23:50:20 -0400 To: freebsd-questions@freebsd.org From: Chris Pepper Content-Type: text/plain; charset="us-ascii" ; format="flowed" cc: freebsd-doc@freebsd.org Subject: Finding rc variables 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, 09 Jul 2004 03:53:37 -0000 For naive users (as I am under FreeBSD 5), /etc/rc.d and beg the question: "What variables do I need to enable in rc.conf?" Is the intention that users will add an _enable variable for each of the 113 scripts in /etc/rc.d they use, or only a subset? The Handbook doesn't list the scripts that are toggled via rc.conf (which is good from a maintenance perspective), but is a there an efficient way to get such a list, or is it really just 'ls /etc/rc.d'? I see mentions of RCng and rc.conf in /usr/ports/UPDATING, but they're not suitable for extracting a complete list. Reading UPDATING, I get the impression all ports will eventually use RCng, but most of the scripts I have installed don't yet -- is the following a suitable test for port scripts? grep '^# KEYWORD:' /usr/local/etc/rc.d/* Thx, Chris Pepper -- Chris Pepper: Rockefeller University: From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 04:20:24 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 476E516A4D5 for ; Fri, 9 Jul 2004 04:20:24 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7CE3343D5C for ; Fri, 9 Jul 2004 04:20: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 i694KMd3044003 for ; Fri, 9 Jul 2004 04:20:22 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i694KMff044002; Fri, 9 Jul 2004 04:20:22 GMT (envelope-from gnats) Resent-Date: Fri, 9 Jul 2004 04:20:22 GMT Resent-Message-Id: <200407090420.i694KMff044002@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, David Schultz Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A9EA216A4CE for ; Fri, 9 Jul 2004 04:13:59 +0000 (GMT) Received: from VARK.homeunix.com (adsl-69-107-108-110.dsl.pltn13.pacbell.net [69.107.108.110]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7456543D31 for ; Fri, 9 Jul 2004 04:13:59 +0000 (GMT) (envelope-from das@VARK.homeunix.com) Received: from VARK.homeunix.com (localhost [127.0.0.1]) by VARK.homeunix.com (8.12.11/8.12.10) with ESMTP id i694Dr5H015409 for ; Thu, 8 Jul 2004 21:13:53 -0700 (PDT) (envelope-from das@VARK.homeunix.com) Received: (from das@localhost) by VARK.homeunix.com (8.12.11/8.12.10/Submit) id i694DrwD015408; Thu, 8 Jul 2004 21:13:53 -0700 (PDT) (envelope-from das) Message-Id: <200407090413.i694DrwD015408@VARK.homeunix.com> Date: Thu, 8 Jul 2004 21:13:53 -0700 (PDT) From: David Schultz To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/68845: The .At macro produces unexpected results 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, 09 Jul 2004 04:20:24 -0000 >Number: 68845 >Category: docs >Synopsis: The .At macro produces unexpected results >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Fri Jul 09 04:20:21 GMT 2004 >Closed-Date: >Last-Modified: >Originator: David Schultz >Release: FreeBSD 5.2-CURRENT i386 >Organization: The FreeBSD Project >Environment: >Description: >How-To-Repeat: The following mdoc markup produces the text ``AT&T System V.3 UNIX''. .At V.3 A more commonly recognizable string would have ``SVR3'' or ``System V Release 3'' in place of ``System V.3''. (Also, does it need to be ``UNIX(TM)'' for legal reasons?) >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 05:23:08 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 DA08316A4CF for ; Fri, 9 Jul 2004 05:23:08 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id D2AD643D5A for ; Fri, 9 Jul 2004 05:23:08 +0000 (GMT) (envelope-from www@FreeBSD.org) Received: from freefall.freebsd.org (www@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i695N8Lg064802 for ; Fri, 9 Jul 2004 05:23:08 GMT (envelope-from www@freefall.freebsd.org) Received: (from www@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i695N8rc064801 for freebsd-doc; Fri, 9 Jul 2004 05:23:08 GMT (envelope-from www) Date: Fri, 9 Jul 2004 05:23:08 GMT From: WWW pseudo-user Message-Id: <200407090523.i695N8rc064801@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org Subject: FreeBSD web build failed on freefall.freebsd.org 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, 09 Jul 2004 05:23:09 -0000 ? relnotes4/doc/fr_FR.ISO8859-1/relnotes/i386/x18.html ===> security ===> commercial ===> docproj ===> news ===> news/1993 ===> news/1996 ===> news/1997 ===> news/1998 ===> news/1999 ===> news/2000 ===> news/2001 ===> news/2002 ===> news/status ===> advocacy ===> events Generating curdate.xml /usr/local/bin/xsltproc -o events.html /c/www/build/www/en/events/events.xsl /c/www/build/www/en/events/events.xml /usr/local/bin/tidy -i -m -raw -preserve -f /dev/null -asxml events.html ===> events/2002 ===> events/2003 ===> FAQ ===> handbook ===> tutorials ===> internal /usr/bin/perl5 /c/www/build/www/en/internal/homepage.pl > homepage.inc /usr/bin/sed -e 's///' homepage.sgml | /usr/bin/env SGML_CATALOG_FILES= /usr/local/bin/sgmlnorm -d -ifreebsd.urls.absolute -c /usr/local/share/sgml/html/catalog -D /c/www/build/www/en/internal > homepage.html || (/bin/rm -f homepage.html && false) /usr/local/bin/tidy -i -m -raw -preserve -f /dev/null -asxml homepage.html *** Error code 1 (ignored) ===> java ===> java/dists ===> java/docs ===> java/links ===> copyright ===> search ===> projects ===> projects/busdma ===> projects/c99 /usr/bin/sed -e 's///' index.sgml | /usr/bin/env SGML_CATALOG_FILES= /usr/local/bin/sgmlnorm -d -ifreebsd.urls.absolute -c /usr/local/share/sgml/html/catalog -D /c/www/build/www/en/projects/c99 > index.html || (/bin/rm -f index.html && false) /usr/local/bin/sgmlnorm:0:1045:14:E: general entity "a.stefanf" not defined and no default entity *** Error code 1 Stop in /c/www/build/www/en/projects/c99. *** Error code 1 Stop in /c/www/build/www/en/projects. *** Error code 1 Stop in /c/www/build/www/en. 19.40 real 0.97 user 0.73 sys From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 05:23: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 A45FB16A4CE for ; Fri, 9 Jul 2004 05:23:10 +0000 (GMT) Received: from www.freebsd.org (www.freebsd.org [216.136.204.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9D92C43D5A for ; Fri, 9 Jul 2004 05:23:10 +0000 (GMT) (envelope-from www@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 i695NAGr030863 for ; Fri, 9 Jul 2004 05:23:10 GMT (envelope-from www@www.freebsd.org) Received: (from www@localhost) by www.freebsd.org (8.12.11/8.12.11/Submit) id i695NAia030862 for freebsd-doc@FreeBSD.org; Fri, 9 Jul 2004 05:23:10 GMT (envelope-from www) Date: Fri, 9 Jul 2004 05:23:10 GMT From: World Wide Web Owner Message-Id: <200407090523.i695NAia030862@www.freebsd.org> To: freebsd-doc@FreeBSD.org Subject: FreeBSD web build failed on www.freebsd.org 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, 09 Jul 2004 05:23:10 -0000 ? relnotes4/doc/fr_FR.ISO8859-1/relnotes/i386/x18.html ===> security ===> commercial ===> docproj ===> news ===> news/1993 ===> news/1996 ===> news/1997 ===> news/1998 ===> news/1999 ===> news/2000 ===> news/2001 ===> news/2002 ===> news/status ===> advocacy ===> events Generating curdate.xml /usr/local/bin/xsltproc -o events.html /w/www/build/www/en/events/events.xsl /w/www/build/www/en/events/events.xml /usr/local/bin/tidy -i -m -raw -preserve -f /dev/null -asxml events.html ===> events/2002 ===> events/2003 ===> FAQ ===> handbook ===> tutorials ===> internal /usr/bin/perl5 /w/www/build/www/en/internal/homepage.pl > homepage.inc /usr/bin/sed -e 's///' homepage.sgml | /usr/bin/env SGML_CATALOG_FILES= /usr/local/bin/sgmlnorm -d -ifreebsd.urls.absolute -c /usr/local/share/sgml/html/catalog -D /w/www/build/www/en/internal > homepage.html || (/bin/rm -f homepage.html && false) /usr/local/bin/tidy -i -m -raw -preserve -f /dev/null -asxml homepage.html *** Error code 1 (ignored) ===> java ===> java/dists ===> java/docs ===> java/links ===> copyright ===> search ===> projects ===> projects/busdma ===> projects/c99 /usr/bin/sed -e 's///' index.sgml | /usr/bin/env SGML_CATALOG_FILES= /usr/local/bin/sgmlnorm -d -ifreebsd.urls.absolute -c /usr/local/share/sgml/html/catalog -D /w/www/build/www/en/projects/c99 > index.html || (/bin/rm -f index.html && false) /usr/local/bin/sgmlnorm:0:1045:14:E: general entity "a.stefanf" not defined and no default entity *** Error code 1 Stop in /w/www/build/www/en/projects/c99. *** Error code 1 Stop in /w/www/build/www/en/projects. *** Error code 1 Stop in /w/www/build/www/en. 4.58 real 1.38 user 1.28 sys From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 07:12: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 B2C0916A4CE; Fri, 9 Jul 2004 07:12:12 +0000 (GMT) Received: from frodo.otenet.gr (frodo.otenet.gr [195.170.0.12]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6EAE643D2F; Fri, 9 Jul 2004 07:12:11 +0000 (GMT) (envelope-from keramida@ceid.upatras.gr) Received: from orion.daedalusnetworks.priv (aris.bedc.ondsl.gr [62.103.39.226]) by frodo.otenet.gr (8.12.10/8.12.10) with SMTP id i697C5ds021736; Fri, 9 Jul 2004 10:12:06 +0300 Received: from orion.daedalusnetworks.priv (orion [127.0.0.1]) i697EV63011054; Fri, 9 Jul 2004 10:14:31 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Received: (from keramida@localhost)i697ETx7011053; Fri, 9 Jul 2004 10:14:29 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Date: Fri, 9 Jul 2004 10:14:29 +0300 From: Giorgos Keramidas To: Tom Rhodes Message-ID: <20040709071429.GA10729@orion.daedalusnetworks.priv> References: <20040708232534.GA85731@gothmog.gr> <20040708205913.502f6911@localhost.pittgoth.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040708205913.502f6911@localhost.pittgoth.com> cc: Ruslan Ermilov cc: doc@freebsd.org Subject: Re: RFC: pciconf.8 options diff 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, 09 Jul 2004 07:12:12 -0000 On 2004-07-08 20:59, Tom Rhodes wrote: > On Fri, 9 Jul 2004 02:25:34 +0300 > Giorgos Keramidas wrote: > > > I've tried to convert the description of options in pciconf.8 to the > > usual .Bl ... .El style. The changes I made locally are: I forgot to add that there are places where things can be rewritten, but I didn't touch those. I planned to reorder/rearrange the text first and then do grammar, syntax or other content changes. > > @@ -80,8 +74,10 @@ > > [...] > > +.Pp > > The second column [...] > > +.Pp > > The third column [...] > > In place of all these .Pp macros, how about making them a list? > Perhaps: > > .Bl -bullet > .It > I describe column one. > .It > I describe column two. > ... That seems ok too. Even without making the change to a second-level list, the manpage is IMHO a lot more readable when each one of `first', `second', ... `sixth' are in separate paragraphs. The only argument I have against a second-level list is that I tend to prefer avoiding deeply nested lists. If that's what everyone else prefers though, it's fine too. > > -determines whether any driver has been assigned to the device > > +will attempt to load the vendor/device information database, and print > > +vendor, device, class and subclass identification strings for each device. > > +.It Fl a > > +Determine whether any driver has been assigned to the device > > identified by > > s/any/a here That's part of the original text, but thanks for catching it. > > +.It Fl b > > +When used in combination with > > +.Fl r > > +or > > +.Fl w > > Perhaps a comma after w? Heh. I spent a few moments wondering about this one. It's probably ok to add a comma. Does anyone have some sort of English syntax & style pointer that could clarify which of the two is actually correct? My gut feeling is that a comma *is* required. > > +indicate that the width of the operation is 1 half-word (two bytes). > > +The default is to read or write a longword (four bytes). > > +.El > > +.Pp > > +All invocations of > > +.Nm > > +except for > > +.Fl l > > +require a > > +.Ar selector > > +of the form > > +.Li pci Ns Va bus Ns \&: Ns Va device > > +(optionally followed by > > +.Li \&: Ns Va function ) . > > I don't think we need '()' around this text. I think we do. Read the text in the formatted manpage. All invocations of pciconf except for -l require a selector of the form pcibus:device (optionally followed by :function). Some sort of separation needs to be done. There are other ways to write this too, such as: All invocations of pciconf except for -l require a selector of the form pcibus:device[:function]. It's more compact and follows the well-known(?) convention of enclosing optional parts in square brackets. > > +A final colon may be appended and > > +will be ignored; this is so that the first column in the output of > > s/that // > > > +.Nm > > +.Fl l > > +can be used without modification. I have better plans for this one after the options are made into a list, are sorted and content changes are ok to make: A final colon may be appended and it will be ignored. This allows using the first column of `pciconf -l' without modification. > Remember, you are not required to take my advice. It's only when > I demand you take my advice that you actually take my advice. :) Thanks. I appreciate it, but I see no comments about making the options a list with `.Bl'. Does that mean it's ok? Note that there *is* a problem with the options list in the change I posted, which I noticed this morning while reading the `nroff' output for the changed manpage. The sample `pciconf -l' output gets indented too much and crosses the 80-column boundary. I'm not sure how to solve this without editing the pciconf output to make it look like: hostb0@pci0:0:0: class=NUM card=NUM chip=NUM rev=NUM hdr=NUM hostb0@pci0:0:0: class=NUM card=NUM chip=NUM rev=NUM hdr=NUM hostb0@pci0:0:0: class=NUM card=NUM chip=NUM rev=NUM hdr=NUM which solves the width problems, but loses us some information (namely, the fact that the numbers printed by pciconf are in hexadecimal). Giorgos From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 07:27:01 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 96D8016A4CF; Fri, 9 Jul 2004 07:27:01 +0000 (GMT) Received: from pinky.otenet.gr (pinky.otenet.gr [195.170.0.24]) by mx1.FreeBSD.org (Postfix) with ESMTP id CB39043D1F; Fri, 9 Jul 2004 07:27:00 +0000 (GMT) (envelope-from keramida@freebsd.org) Received: from orion.daedalusnetworks.priv (aris.bedc.ondsl.gr [62.103.39.226])i697QnfY019815; Fri, 9 Jul 2004 10:26:53 +0300 Received: from orion.daedalusnetworks.priv (orion [127.0.0.1]) i697TGuB011206; Fri, 9 Jul 2004 10:29:16 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost)i697TGGr011205; Fri, 9 Jul 2004 10:29:16 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Fri, 9 Jul 2004 10:29:16 +0300 From: Giorgos Keramidas To: Chris Pepper Message-ID: <20040709072916.GB10729@orion.daedalusnetworks.priv> References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: cc: freebsd-doc@freebsd.org cc: freebsd-questions@freebsd.org Subject: Re: Finding rc variables 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, 09 Jul 2004 07:27:02 -0000 On 2004-07-08 23:50, Chris Pepper wrote: > For naive users (as I am under FreeBSD 5), /etc/rc.d and > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/configtuning-rcng.html > > beg the question: "What variables do I need to enable in rc.conf?" Is the > intention that users will add an _enable variable for each of the 113 > scripts in /etc/rc.d they use, or only a subset? > > The Handbook doesn't list the scripts that are toggled via rc.conf > (which is good from a maintenance perspective), but is a there an > efficient way to get such a list, or is it really just 'ls /etc/rc.d'? IMHO such a list would be a pain to maintain. Additionally, much of its functionality or usefulness would overlap with the comments of the file `/etc/defaults/rc.conf' and the rc.conf(5) manpage. I wouldn't disagree with adding a pointer to the Handbook that redirects the reader to the comments of /etc/defaults/rc.conf and the manpage rc.conf(5) though. Giorgos From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 14:37: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 F0E7A16A4CE for ; Fri, 9 Jul 2004 14:37:26 +0000 (GMT) Received: from sccrmhc11.comcast.net (sccrmhc11.comcast.net [204.127.202.55]) by mx1.FreeBSD.org (Postfix) with ESMTP id ACC9043D48 for ; Fri, 9 Jul 2004 14:37:26 +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 <20040709143721011009g0fre>; Fri, 9 Jul 2004 14:37:26 +0000 From: Leonard Zettel To: freebsd-doc@freebsd.org Date: Fri, 9 Jul 2004 10:38:52 -0400 User-Agent: KMail/1.6.2 MIME-Version: 1.0 Content-Disposition: inline Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Message-Id: <200407091038.52304.zettel@acm.org> Subject: Acronyms believed harmful 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, 09 Jul 2004 14:37:27 -0000 With apologies to Edsger Dijkstra, RIP. I am probably pissing into the wind with this one, but I feel honor-bound to try.... In my (undoubtedly unhumble) opinion the worst style-rot to attack the English language in the last fifty years is the unrestricted proliferation of unnecessary acronyms in the technical literature. Things like DTD are not English, they are jargon! They place an unnecessary burden on the reader. This burden falls most heavily on newbies and (I would imagine) people to whom English is a second (or third or fourth) language - exactly the people who most need the help of clear documentation. At a minimum I plead for the following rule: all uses of acronyms in any document should include the term fully spelled out at the first appearance of said acronym. Given the text completion and search-and- replace capabilities of most text processing systems an even better rule would be to ban them altogether. =A0 =A0-LenZ- From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 14:49:57 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 0599B16A4CE for ; Fri, 9 Jul 2004 14:49:57 +0000 (GMT) Received: from fledge.watson.org (fledge.watson.org [204.156.12.50]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9ECD343D39 for ; Fri, 9 Jul 2004 14:49:56 +0000 (GMT) (envelope-from hmp@freebsd.org) Received: from fledge.watson.org (localhost [127.0.0.1]) by fledge.watson.org (8.12.11/8.12.11) with ESMTP id i69Enp25035344; Fri, 9 Jul 2004 10:49:51 -0400 (EDT) (envelope-from hmp@freebsd.org) Received: from localhost (hmp@localhost)i69Enp7O035341; Fri, 9 Jul 2004 10:49:51 -0400 (EDT) (envelope-from hmp@freebsd.org) X-Authentication-Warning: fledge.watson.org: hmp owned process doing -bs Date: Fri, 9 Jul 2004 10:49:51 -0400 (EDT) From: Hiten Pandya X-X-Sender: hmp@fledge.watson.org To: zettel@acm.org Message-ID: <20040709104801.V34977@fledge.watson.org> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: freebsd-doc@freebsd.org Subject: Re: Acronyms believed harmful 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, 09 Jul 2004 14:49:57 -0000 Yes, I fully agree on this point. Lately, I have not seen much use of acronyms/abbreviations in section or chapter titles, but that should be reduced too, whenever possible. Especially, IRC style abbreviations. Regards, Hiten Pandya hmp at freebsd.org From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 14:52: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 0602E16A4CE; Fri, 9 Jul 2004 14:52:35 +0000 (GMT) Received: from rwcrmhc11.comcast.net (rwcrmhc11.comcast.net [204.127.198.35]) by mx1.FreeBSD.org (Postfix) with ESMTP id C1F8B43D46; Fri, 9 Jul 2004 14:52:34 +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 (rwcrmhc11) with ESMTP id <2004070914523401300j7dnbe>; Fri, 9 Jul 2004 14:52:34 +0000 From: Leonard Zettel To: Hiten Pandya Date: Fri, 9 Jul 2004 10:54:05 -0400 User-Agent: KMail/1.6.2 References: <20040709104801.V34977@fledge.watson.org> In-Reply-To: <20040709104801.V34977@fledge.watson.org> MIME-Version: 1.0 Content-Disposition: inline Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Message-Id: <200407091054.05228.zettel@acm.org> cc: freebsd-doc@freebsd.org Subject: Re: Acronyms believed harmful 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, 09 Jul 2004 14:52:35 -0000 On Friday 09 July 2004 10:49 am, Hiten Pandya wrote: > Yes, I fully agree on this point. > > Lately, I have not seen much use of acronyms/abbreviations in > section or chapter titles, but that should be reduced too, whenever > possible. Especially, IRC style abbreviations. > Take a look at the documentation primer. -LenZ- > Regards, > > Hiten Pandya > hmp at freebsd.org From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 16:06: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 C2D2E16A4CF for ; Fri, 9 Jul 2004 16:06: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 820BD43D1F for ; Fri, 9 Jul 2004 16:06:43 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.34; FreeBSD) id 1Bixta-000M8Q-4G; Fri, 09 Jul 2004 17:06:42 +0100 Date: Fri, 9 Jul 2004 17:06:42 +0100 From: Ceri Davies To: Leonard Zettel Message-ID: <20040709160642.GB29928@submonkey.net> Mail-Followup-To: Ceri Davies , Leonard Zettel , freebsd-doc@freebsd.org References: <200407091038.52304.zettel@acm.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="K0M4iRgkWWXhiQ9N" Content-Disposition: inline In-Reply-To: <200407091038.52304.zettel@acm.org> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: freebsd-doc@freebsd.org Subject: Re: Acronyms believed harmful 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, 09 Jul 2004 16:06:44 -0000 --K0M4iRgkWWXhiQ9N Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Jul 09, 2004 at 10:38:52AM -0400, Leonard Zettel wrote: > Things like DTD are not English, they > are jargon! They place an unnecessary > burden on the reader. This burden > falls most heavily on newbies and > (I would imagine) people to whom > English is a second (or third or fourth) > language - exactly the people who > most need the help of clear documentation. >=20 > At a minimum I plead for the following rule: > all uses of acronyms in any document > should include the term fully spelled out > at the first appearance of said acronym. Well, there's a work in progress(ish) to have the first use of an acronym expand to a link to it's entry in the glossary. This can't happen until the glossary is full. Help to fill it. Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --K0M4iRgkWWXhiQ9N Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA7sKRocfcwTS3JF8RAndZAJ93hOzoY2Tl0J21llL2WwiVg17dKgCfQGXL VhQgq69dKDzHvIdcNa9ylw0= =n6mk -----END PGP SIGNATURE----- --K0M4iRgkWWXhiQ9N-- From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 16:35: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 E68FD16A4CE; Fri, 9 Jul 2004 16:35:34 +0000 (GMT) Received: from rwcrmhc11.comcast.net (rwcrmhc11.comcast.net [204.127.198.35]) by mx1.FreeBSD.org (Postfix) with ESMTP id B14B143D4C; Fri, 9 Jul 2004 16:35:34 +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 (rwcrmhc11) with ESMTP id <2004070916353301300ivu8le>; Fri, 9 Jul 2004 16:35:34 +0000 From: Leonard Zettel To: Ceri Davies Date: Fri, 9 Jul 2004 12:37:04 -0400 User-Agent: KMail/1.6.2 References: <200407091038.52304.zettel@acm.org> <20040709160642.GB29928@submonkey.net> In-Reply-To: <20040709160642.GB29928@submonkey.net> MIME-Version: 1.0 Content-Disposition: inline Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Message-Id: <200407091237.04562.zettel@acm.org> cc: freebsd-doc@FreeBSD.org Subject: Re: Acronyms believed harmful 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, 09 Jul 2004 16:35:35 -0000 On Friday 09 July 2004 12:06 pm, Ceri Davies wrote: > On Fri, Jul 09, 2004 at 10:38:52AM -0400, Leonard Zettel wrote: > > Things like DTD are not English, they > > are jargon! They place an unnecessary > > burden on the reader. This burden > > falls most heavily on newbies and > > (I would imagine) people to whom > > English is a second (or third or fourth) > > language - exactly the people who > > most need the help of clear documentation. > > > > At a minimum I plead for the following rule: > > all uses of acronyms in any document > > should include the term fully spelled out > > at the first appearance of said acronym. > > Well, there's a work in progress(ish) to have the first use of an > acronym expand to a link to it's entry in the glossary. This can't > happen until the glossary is full. Help to fill it. > Love to! How? -LenZ- > Ceri From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 16:52: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 6235E16A4CE; Fri, 9 Jul 2004 16:52:09 +0000 (GMT) Received: from internet.potentialtech.com (h-66-167-251-6.phlapafg.covad.net [66.167.251.6]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2AD6543D2D; Fri, 9 Jul 2004 16:52:09 +0000 (GMT) (envelope-from wmoran@potentialtech.com) Received: from working.potentialtech.com (pa-plum-cmts1e-68-68-113-64.pittpa.adelphia.net [68.68.113.64]) by internet.potentialtech.com (Postfix) with ESMTP id 591FF69A39; Fri, 9 Jul 2004 12:52:08 -0400 (EDT) Date: Fri, 9 Jul 2004 12:52:07 -0400 From: Bill Moran To: Ceri Davies Message-Id: <20040709125207.66591fc2.wmoran@potentialtech.com> In-Reply-To: <20040709160642.GB29928@submonkey.net> References: <200407091038.52304.zettel@acm.org> <20040709160642.GB29928@submonkey.net> Organization: Potential Technologies X-Mailer: Sylpheed version 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd4.9) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: freebsd-doc@freebsd.org Subject: Re: Acronyms believed harmful 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, 09 Jul 2004 16:52:09 -0000 Ceri Davies wrote: > On Fri, Jul 09, 2004 at 10:38:52AM -0400, Leonard Zettel wrote: > > > Things like DTD are not English, they > > are jargon! They place an unnecessary > > burden on the reader. This burden > > falls most heavily on newbies and > > (I would imagine) people to whom > > English is a second (or third or fourth) > > language - exactly the people who > > most need the help of clear documentation. > > > > At a minimum I plead for the following rule: > > all uses of acronyms in any document > > should include the term fully spelled out > > at the first appearance of said acronym. > > Well, there's a work in progress(ish) to have the first use of an > acronym expand to a link to it's entry in the glossary. This can't > happen until the glossary is full. Help to fill it. I was going to _try_ to spend some time contributing to this over the weekend. Before I start, I have a policy question: If we look at tech terms that are NOT FreeBSD-specific (such as DTD) should the FreeBSD glossary contain a full definition, or possibly a link to another source? -- Bill Moran Potential Technologies http://www.potentialtech.com From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 17:10: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 4F9F716A4CE for ; Fri, 9 Jul 2004 17:10:00 +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 B818E43D39 for ; Fri, 9 Jul 2004 17:09:59 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.34; FreeBSD) id 1Biysm-000MSI-HA; Fri, 09 Jul 2004 18:09:56 +0100 Date: Fri, 9 Jul 2004 18:09:56 +0100 From: Ceri Davies To: Bill Moran Message-ID: <20040709170956.GC29928@submonkey.net> Mail-Followup-To: Ceri Davies , Bill Moran , zettel@acm.org, freebsd-doc@freebsd.org References: <200407091038.52304.zettel@acm.org> <20040709160642.GB29928@submonkey.net> <20040709125207.66591fc2.wmoran@potentialtech.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="ZjLa2K+dB9SFbrgo" Content-Disposition: inline In-Reply-To: <20040709125207.66591fc2.wmoran@potentialtech.com> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: freebsd-doc@freebsd.org Subject: Re: Acronyms believed harmful 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, 09 Jul 2004 17:10:00 -0000 --ZjLa2K+dB9SFbrgo Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Jul 09, 2004 at 12:52:07PM -0400, Bill Moran wrote: > Ceri Davies wrote: > > On Fri, Jul 09, 2004 at 10:38:52AM -0400, Leonard Zettel wrote: > >=20 > > > Things like DTD are not English, they > > > are jargon! They place an unnecessary > > > burden on the reader. This burden > > > falls most heavily on newbies and > > > (I would imagine) people to whom > > > English is a second (or third or fourth) > > > language - exactly the people who > > > most need the help of clear documentation. > > >=20 > > > At a minimum I plead for the following rule: > > > all uses of acronyms in any document > > > should include the term fully spelled out > > > at the first appearance of said acronym. > >=20 > > Well, there's a work in progress(ish) to have the first use of an > > acronym expand to a link to it's entry in the glossary. This can't > > happen until the glossary is full. Help to fill it. >=20 > I was going to _try_ to spend some time contributing to this over > the weekend. >=20 > Before I start, I have a policy question: If we look at tech terms > that are NOT FreeBSD-specific (such as DTD) should the FreeBSD > glossary contain a full definition, or possibly a link to another > source? Originally I had intended for this to be FreeBSD specific - I'm now of the opinion that this is kind of unworkable and a bit pointless to boot. The main things to focus on would be things that crop up a lot, and stuff marked up in firstterm or acronym elements. Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --ZjLa2K+dB9SFbrgo Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA7tFkocfcwTS3JF8RAiXVAJ4sP0gLuaRTtOBlSTfNcC5mg9gx1ACcDwXi Voch5kmsf9hQ9D5EgF6iRJA= =4893 -----END PGP SIGNATURE----- --ZjLa2K+dB9SFbrgo-- From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 17:11: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 3998016A4D0 for ; Fri, 9 Jul 2004 17:11:33 +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 C186943D31 for ; Fri, 9 Jul 2004 17:11:32 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.34; FreeBSD) id 1BiyuK-000MTQ-43; Fri, 09 Jul 2004 18:11:32 +0100 Date: Fri, 9 Jul 2004 18:11:32 +0100 From: Ceri Davies To: Leonard Zettel Message-ID: <20040709171132.GD29928@submonkey.net> Mail-Followup-To: Ceri Davies , Leonard Zettel , freebsd-doc@FreeBSD.org References: <200407091038.52304.zettel@acm.org> <20040709160642.GB29928@submonkey.net> <200407091237.04562.zettel@acm.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="mmR5Tf+WJGm+vTLg" Content-Disposition: inline In-Reply-To: <200407091237.04562.zettel@acm.org> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: freebsd-doc@FreeBSD.org Subject: Re: Acronyms believed harmful 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, 09 Jul 2004 17:11:33 -0000 --mmR5Tf+WJGm+vTLg Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Jul 09, 2004 at 12:37:04PM -0400, Leonard Zettel wrote: > On Friday 09 July 2004 12:06 pm, Ceri Davies wrote: > > On Fri, Jul 09, 2004 at 10:38:52AM -0400, Leonard Zettel wrote: > > > Things like DTD are not English, they > > > are jargon! They place an unnecessary > > > burden on the reader. This burden > > > falls most heavily on newbies and > > > (I would imagine) people to whom > > > English is a second (or third or fourth) > > > language - exactly the people who > > > most need the help of clear documentation. > > > > > > At a minimum I plead for the following rule: > > > all uses of acronyms in any document > > > should include the term fully spelled out > > > at the first appearance of said acronym. > > > > Well, there's a work in progress(ish) to have the first use of an > > acronym expand to a link to it's entry in the glossary. This can't > > happen until the glossary is full. Help to fill it. > > > Love to! How? You'll need to check out a copy of the doc tree and add entries to the glossary file doc/en_US.ISO8859-1/share/sgml/glossary/freebsd-glossary.sgml. See also my mail to Bill Moran for areas to focus on. Thanks for the help! Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --mmR5Tf+WJGm+vTLg Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA7tHDocfcwTS3JF8RAueQAJ9v4yBN1eQ0HnyXH8p2YQ52Kw8pPgCeIM07 bsEeQ1xuUkOuNmH1W5Q1cOc= =japq -----END PGP SIGNATURE----- --mmR5Tf+WJGm+vTLg-- From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 17:11: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 9DE9216A4CF for ; Fri, 9 Jul 2004 17:11:59 +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 5D46E43D2D for ; Fri, 9 Jul 2004 17:11:59 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.34; FreeBSD) id 1Biyuk-000MU5-Ne for freebsd-doc@freebsd.org; Fri, 09 Jul 2004 18:11:58 +0100 Date: Fri, 9 Jul 2004 18:11:58 +0100 From: Ceri Davies To: freebsd-doc@freebsd.org Message-ID: <20040709171158.GE29928@submonkey.net> Mail-Followup-To: Ceri Davies , freebsd-doc@freebsd.org References: <200407091038.52304.zettel@acm.org> <20040709160642.GB29928@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="WjpOG6URjntW8FAF" Content-Disposition: inline In-Reply-To: <20040709160642.GB29928@submonkey.net> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies Subject: Re: Acronyms believed harmful 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, 09 Jul 2004 17:11:59 -0000 --WjpOG6URjntW8FAF Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Jul 09, 2004 at 05:06:42PM +0100, Ceri Davies wrote: > On Fri, Jul 09, 2004 at 10:38:52AM -0400, Leonard Zettel wrote: >=20 > > Things like DTD are not English, they > > are jargon! They place an unnecessary > > burden on the reader. This burden > > falls most heavily on newbies and > > (I would imagine) people to whom > > English is a second (or third or fourth) > > language - exactly the people who > > most need the help of clear documentation. > >=20 > > At a minimum I plead for the following rule: > > all uses of acronyms in any document > > should include the term fully spelled out > > at the first appearance of said acronym. >=20 > Well, there's a work in progress(ish) to have the first use of an > acronym expand to a link to it's entry in the glossary. This can't ^^^^ Yeah, yeah, I know. Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --WjpOG6URjntW8FAF Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA7tHeocfcwTS3JF8RAptjAKClIs/eXi9AuxOgJ5/PFHI20zXAwwCgs3yk rf99Q7KoZ/EoGhSdbRsHXi4= =zdpR -----END PGP SIGNATURE----- --WjpOG6URjntW8FAF-- From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 17:33: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 A4A3E16A4CE for ; Fri, 9 Jul 2004 17:33:19 +0000 (GMT) Received: from mail.business.allstream.net (tor-vs6.business.allstream.net [207.181.89.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0C84543D1D for ; Fri, 9 Jul 2004 17:33:19 +0000 (GMT) (envelope-from derek@cpa-inc.net) Received: from derek (host-66-46-154-210.dnsalias.net [66.46.154.210]) i69HXIe5004797 for ; Fri, 9 Jul 2004 13:33:18 -0400 (EDT) Message-ID: <008701c465da$d232ff90$0301a8c0@office.cpainc.net> From: "Derek Marcotte" To: Date: Fri, 9 Jul 2004 13:33:17 -0400 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 6.00.2800.1106 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1106 Subject: http://www.freebsd.org/doc/en_US.ISO8859-1/articles/5-roadmap/schedule.html 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, 09 Jul 2004 17:33:19 -0000 Just FYI: The URL http://www.freebsd.org/doc/en_US.ISO8859-1/articles/5-roadmap/sch edule.html Shows 5.3-RELEASE ETA to be March 29, 2004... Perhaps someone with more current information would like to update this. Cheers, Derek From owner-freebsd-doc@FreeBSD.ORG Fri Jul 9 18:09: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 81F9B16A4CE; Fri, 9 Jul 2004 18:09:12 +0000 (GMT) Received: from wonkity.com (wonkity.com [65.173.111.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 12E9D43D48; Fri, 9 Jul 2004 18:09:12 +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 i69I9Buo056496; Fri, 9 Jul 2004 12:09:11 -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 i69I9Bmx056493; Fri, 9 Jul 2004 12:09:11 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Fri, 9 Jul 2004 12:09:11 -0600 (MDT) From: Warren Block To: Bill Moran In-Reply-To: <20040709125207.66591fc2.wmoran@potentialtech.com> Message-ID: <20040709120642.J56489@wonkity.com> References: <200407091038.52304.zettel@acm.org> <20040709160642.GB29928@submonkey.net> <20040709125207.66591fc2.wmoran@potentialtech.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]); Fri, 09 Jul 2004 12:09:11 -0600 (MDT) cc: Ceri Davies cc: freebsd-doc@freebsd.org Subject: Re: Acronyms believed harmful 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, 09 Jul 2004 18:09:12 -0000 On Fri, 9 Jul 2004, Bill Moran wrote: > Before I start, I have a policy question: If we look at tech terms > that are NOT FreeBSD-specific (such as DTD) should the FreeBSD > glossary contain a full definition, or possibly a link to another > source? Let me suggest both: a quick definition and then a link to another source for more information. For example: DTD: Document Type Definition. See (link to xml.org or some place more generic). -Warren Block * Rapid City, South Dakota USA From owner-freebsd-doc@FreeBSD.ORG Sat Jul 10 12:58: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 BBAFC16A4CE; Sat, 10 Jul 2004 12:58:54 +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 7338443D4C; Sat, 10 Jul 2004 12:58:54 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id 310C9119B1; Sat, 10 Jul 2004 14:58:53 +0200 (CEST) Date: Sat, 10 Jul 2004 14:58:52 +0200 From: "Simon L. Nielsen" To: Ceri Davies , Mark Linimon , Hiten Pandya , freebsd-www@FreeBSD.org, freebsd-doc@FreeBSD.org Message-ID: <20040710125852.GA762@zaphod.nitro.dk> References: <200407081120.i68BKBcK013201@freefall.freebsd.org> <20040708161517.GS29928@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="IJpNTDwzlM2Ie8A6" Content-Disposition: inline In-Reply-To: <20040708161517.GS29928@submonkey.net> User-Agent: Mutt/1.5.6i Subject: Re: docs/68595: [PATCH] add FAQ entry for lock order reversals 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, 10 Jul 2004 12:58:54 -0000 --IJpNTDwzlM2Ie8A6 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.07.08 17:15:17 +0100, Ceri Davies wrote: > On Thu, Jul 08, 2004 at 11:07:21AM -0500, Mark Linimon wrote: > > I added LOR to the glossary a few days ago. It includes a URL to the > > list page. > >=20 > > I noted that the glossary does not seem to be built in the version of > > the handbook that is displayed on the website as well at that time. > > There seems to be a Makefile flag to turn it on. Does anyone know > > why that flag is not on for the www page? >=20 > There simply wasn't enough content in it when I committed it. I think there is now, so how do you feel about just including it by default now? --=20 Simon L. Nielsen FreeBSD Documentation Team --IJpNTDwzlM2Ie8A6 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA7+gMh9pcDSc1mlERAuifAJ4srA0ZKl9V3XifUFwuoUMFbgboAACgugh3 2fvgwCs/fHOgjTAruRXTitg= =Hb+b -----END PGP SIGNATURE----- --IJpNTDwzlM2Ie8A6-- From owner-freebsd-doc@FreeBSD.ORG Sat Jul 10 13:40: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 6163E16A4CE; Sat, 10 Jul 2004 13:40:33 +0000 (GMT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id B8D3F43D1D; Sat, 10 Jul 2004 13:40:32 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost.pittgoth.com (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 i6ADeJSY011540 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sat, 10 Jul 2004 09:40:20 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Sat, 10 Jul 2004 09:40:51 -0400 From: Tom Rhodes To: Giorgos Keramidas Message-Id: <20040710094051.033eee5e@localhost.pittgoth.com> In-Reply-To: <20040709071429.GA10729@orion.daedalusnetworks.priv> References: <20040708232534.GA85731@gothmog.gr> <20040708205913.502f6911@localhost.pittgoth.com> <20040709071429.GA10729@orion.daedalusnetworks.priv> 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: Tom Rhodes cc: doc@FreeBSD.org cc: Ruslan Ermilov Subject: Re: RFC: pciconf.8 options diff 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, 10 Jul 2004 13:40:33 -0000 On Fri, 9 Jul 2004 10:14:29 +0300 Giorgos Keramidas wrote: Sorry for the lateness of this reply, I got tricked into being guest DJ Friday night. :( > On 2004-07-08 20:59, Tom Rhodes wrote: > > On Fri, 9 Jul 2004 02:25:34 +0300 > > Giorgos Keramidas wrote: > > > > > I've tried to convert the description of options in pciconf.8 to the > > > usual .Bl ... .El style. The changes I made locally are: > > I forgot to add that there are places where things can be rewritten, but > I didn't touch those. I planned to reorder/rearrange the text first and > then do grammar, syntax or other content changes. That is 'ok' with me. Content changes seperate. :) > > > > @@ -80,8 +74,10 @@ > > > [...] > > > +.Pp > > > The second column [...] > > > +.Pp > > > The third column [...] > > > > In place of all these .Pp macros, how about making them a list? > > Perhaps: > > > > .Bl -bullet > > .It > > I describe column one. > > .It > > I describe column two. > > ... > > That seems ok too. Even without making the change to a second-level > list, the manpage is IMHO a lot more readable when each one of `first', > `second', ... `sixth' are in separate paragraphs. > > The only argument I have against a second-level list is that I tend to > prefer avoiding deeply nested lists. If that's what everyone else > prefers though, it's fine too. Your first comment is very true; however, on the next comment, well, I don't really care much. I just thought the output would have looked 'neater' and it would make the separation between the parts more distinct. > > > > -determines whether any driver has been assigned to the device > > > +will attempt to load the vendor/device information database, and print > > > +vendor, device, class and subclass identification strings for each device. > > > +.It Fl a > > > +Determine whether any driver has been assigned to the device > > > identified by > > > > s/any/a here > > That's part of the original text, but thanks for catching it. No problem, please fix that too at some point. :) > > > > +.It Fl b > > > +When used in combination with > > > +.Fl r > > > +or > > > +.Fl w > > > > Perhaps a comma after w? > > Heh. I spent a few moments wondering about this one. It's probably ok > to add a comma. Does anyone have some sort of English syntax & style > pointer that could clarify which of the two is actually correct? My gut > feeling is that a comma *is* required. In English a comma designates a pause, hence if you read it out loud without a pause it sounds like a run on and/or an awful lot to say. As for a 'rule', well, my college English books are at home and I am at work. Want me to check for you? > > > > +indicate that the width of the operation is 1 half-word (two bytes). > > > +The default is to read or write a longword (four bytes). > > > +.El > > > +.Pp > > > +All invocations of > > > +.Nm > > > +except for > > > +.Fl l > > > +require a > > > +.Ar selector > > > +of the form > > > +.Li pci Ns Va bus Ns \&: Ns Va device > > > +(optionally followed by > > > +.Li \&: Ns Va function ) . > > > > I don't think we need '()' around this text. > > I think we do. Read the text in the formatted manpage. > > All invocations of pciconf except for -l require a selector of the > form pcibus:device (optionally followed by :function). > > Some sort of separation needs to be done. There are other ways to write > this too, such as: > > All invocations of pciconf except for -l require a selector of the > form pcibus:device[:function]. > > It's more compact and follows the well-known(?) convention of enclosing > optional parts in square brackets. My only problem was that it the separation seemed superfluous, the text would sound just fine as part of the sentence. Perhaps: ... of the form pcibus:device; optionally followed by a :function delimiter. would sound better? > > > > +A final colon may be appended and > > > +will be ignored; this is so that the first column in the output of > > > > s/that // > > > > > +.Nm > > > +.Fl l > > > +can be used without modification. > > I have better plans for this one after the options are made into a list, > are sorted and content changes are ok to make: > > A final colon may be appended and it will be ignored. This allows > using the first column of `pciconf -l' without modification. I really didn't understand you here, do you mean that this will be the new sentence eventually? > > > Remember, you are not required to take my advice. It's only when > > I demand you take my advice that you actually take my advice. :) > > Thanks. I appreciate it, but I see no comments about making the options > a list with `.Bl'. Does that mean it's ok? Yes, I think that would mean it's 'ok'. > > Note that there *is* a problem with the options list in the change I > posted, which I noticed this morning while reading the `nroff' output > for the changed manpage. The sample `pciconf -l' output gets indented > too much and crosses the 80-column boundary. I'm not sure how to solve > this without editing the pciconf output to make it look like: > > hostb0@pci0:0:0: class=NUM card=NUM chip=NUM rev=NUM hdr=NUM > hostb0@pci0:0:0: class=NUM card=NUM chip=NUM rev=NUM hdr=NUM > hostb0@pci0:0:0: class=NUM card=NUM chip=NUM rev=NUM hdr=NUM > > which solves the width problems, but loses us some information (namely, > the fact that the numbers printed by pciconf are in hexadecimal). Have you tried it with the .Dl macro? /me is too lazy to see how the current markup looks. -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Sat Jul 10 22:30: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 63D3516A4CE for ; Sat, 10 Jul 2004 22:30:28 +0000 (GMT) Received: from internet.potentialtech.com (h-66-167-251-6.phlapafg.covad.net [66.167.251.6]) by mx1.FreeBSD.org (Postfix) with ESMTP id 386BB43D41 for ; Sat, 10 Jul 2004 22:30:28 +0000 (GMT) (envelope-from wmoran@potentialtech.com) Received: from working.potentialtech.com (pa-plum-cmts1e-68-68-113-64.pittpa.adelphia.net [68.68.113.64]) by internet.potentialtech.com (Postfix) with ESMTP id 67F6F69A39 for ; Sat, 10 Jul 2004 18:30:27 -0400 (EDT) Date: Sat, 10 Jul 2004 18:30:26 -0400 From: Bill Moran To: doc@freebsd.org Message-Id: <20040710183026.0baf1e83.wmoran@potentialtech.com> Organization: Potential Technologies X-Mailer: Sylpheed version 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd4.9) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Subject: 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: Sat, 10 Jul 2004 22:30:28 -0000 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 From owner-freebsd-doc@FreeBSD.ORG Sat Jul 10 22:46: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 2E85616A4CE for ; Sat, 10 Jul 2004 22:46:54 +0000 (GMT) Received: from chello212186132026.chello.pl (chello212186132026.chello.pl [212.186.132.26]) by mx1.FreeBSD.org (Postfix) with ESMTP id C48CE43D1D for ; Sat, 10 Jul 2004 22:46:50 +0000 (GMT) (envelope-from anfi@priv.onet.pl) Received: from [127.0.0.1] (IDENT:2DDQVWyrkSrb8887kp4QVdptFDslWgKE@andrzej.adam.filip [127.0.0.1]) by andrzej.adam.filip (8.13.0/8.13.0) with ESMTP id i6AMkm5f014153 for ; Sun, 11 Jul 2004 00:46:48 +0200 Message-ID: <40F071D7.1080505@andrzej.adam.filip> Date: Sun, 11 Jul 2004 00:46:47 +0200 From: Andrzej Filip Organization: http://anfi.homeunix.net/ User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.7) Gecko/20040616 X-Accept-Language: en, pl MIME-Version: 1.0 To: doc@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 Subject: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/smtp-dialup.html 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, 10 Jul 2004 22:46:54 -0000 http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/smtp-dialup.html Could you put a link to pages listing alternative solutions for sendmail dialup configuration ? One of the possible aternatives is described at http://anfi.homeunix.net/sendmail/dialup10.html The pages contains links to a few more akteratives. -- Andrzej [en:Andrew] Adam Filip anfi@priv.onet.pl anfi@xl.wp.pl http://anfi.homeunix.net/ http://slashdot.org/~anfi