From owner-freebsd-doc@FreeBSD.ORG Sun Aug 29 03:36: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 1192116A4CE for ; Sun, 29 Aug 2004 03:36:39 +0000 (GMT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 27EB243D39 for ; Sun, 29 Aug 2004 03:36:37 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost.pittgoth.com ([192.168.0.5]) (authenticated bits=0) by pittgoth.com (8.12.10/8.12.10) with ESMTP id i7T3aSX1059908 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sat, 28 Aug 2004 23:36:29 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Sat, 28 Aug 2004 23:37:03 -0400 From: Tom Rhodes To: Giorgos Keramidas Message-Id: <20040828233703.78fa4591@localhost.pittgoth.com> In-Reply-To: <20040828083013.GA79584@gothmog.gr> References: <20040822161153.GB68929@gothmog.gr> <20040823000443.GA17709@daemon.li> <25513.199.201.236.2.1093379054.squirrel@199.201.236.2> <20040824174508.578a0828@localhost.pittgoth.com> <20040825014453.GB49637@gothmog.gr> <20040825023601.GD326@cox.net> <20040827062355.GD78182@hub.freebsd.org> <20040828012542.3ecb6ac7@localhost.pittgoth.com> <20040828083013.GA79584@gothmog.gr> X-Mailer: Sylpheed-Claws 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd5.2) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: freebsd-doc@FreeBSD.org Subject: Re: The daemon is not a religious symbol, but... 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, 29 Aug 2004 03:36:39 -0000 On Sat, 28 Aug 2004 11:30:14 +0300 Giorgos Keramidas wrote: > On 2004-08-28 01:25, Tom Rhodes wrote: > > > > The *REAL* Tom Rhodes endorses black shirts from *BSD retailers. > > The *FLOAT* Tom Rhodes you mean? How about the *DOUBLE* or the > *LONG DOUBLE* versions? > > /me ducks and runs laughing madly > > ./reply *click* *whirl* *beep* Tom Rhodes doesn't run after people so you seem safe. Tom Rhodes will have his revenge. You should fear Tom Rhodes because he's geek ... PANIC ... -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Sun Aug 29 05:37: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 1EB2E16A4CF for ; Sun, 29 Aug 2004 05:37:31 +0000 (GMT) Received: from digital-security.org (digital-security.org [216.254.116.252]) by mx1.FreeBSD.org (Postfix) with ESMTP id E112543D1D for ; Sun, 29 Aug 2004 05:37:30 +0000 (GMT) (envelope-from necro@digital-security.org) Received: from digital-security.org ([216.254.116.252]) by digital-security.org with esmtp (Exim 4.41 (FreeBSD)) id 1C1GtR-0000NO-WE for freebsd-doc@freebsd.org; Sun, 29 Aug 2004 00:02:15 -0400 Date: Sun, 29 Aug 2004 00:02:13 -0400 (EDT) From: Val Polyakov To: freebsd-doc@freebsd.org Message-ID: <20040829000133.D1449@digital-security.org> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-Spam-Score: 0.0 (/) X-Spam-Report: Spam detection software, running on the system "digital-security.org", hasmessageblock similar future email. If you have any questions, see the administrator of that system for details.thatlists functions in them, goes through the functions and explains what the function does / how it does it and may be lists where these functions are called and for what purpose. [...] Content analysis details: (0.0 points, 3.0 required) pts rule name description -------------------------------------------------- Subject: Kernel documentation X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 29 Aug 2004 05:37:31 -0000 Hi, I was looking around for some type of resource that goes through /sys/kern and explains what each *.c file there is, lists functions in them, goes through the functions and explains what the function does / how it does it and may be lists where these functions are called and for what purpose. Is there such a beast? If not, would it help if I tried to write it? And how fast would it get obsolete? :) Any answers / comments / suggestions are appreciated. Val From owner-freebsd-doc@FreeBSD.ORG Sun Aug 29 15:12: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 07EAA16A4CE for ; Sun, 29 Aug 2004 15:12:26 +0000 (GMT) Received: from hotmail.com (bay17-f28.bay17.hotmail.com [64.4.43.78]) by mx1.FreeBSD.org (Postfix) with ESMTP id E2D3B43D39 for ; Sun, 29 Aug 2004 15:12:25 +0000 (GMT) (envelope-from snoyt@hotmail.com) Received: from mail pickup service by hotmail.com with Microsoft SMTPSVC; Sun, 29 Aug 2004 08:01:00 -0700 Received: from 131.155.243.230 by by17fd.bay17.hotmail.msn.com with HTTP; Sun, 29 Aug 2004 15:00:59 GMT X-Originating-IP: [131.155.243.230] X-Originating-Email: [snoyt@hotmail.com] X-Sender: snoyt@hotmail.com From: "Gert van der Plas" To: doc@FreeBSD.org Date: Sun, 29 Aug 2004 17:00:59 +0200 Mime-Version: 1.0 Content-Type: text/plain; format=flowed Message-ID: X-OriginalArrivalTime: 29 Aug 2004 15:01:00.0409 (UTC) FILETIME=[FF038690:01C48DD8] Subject: update for FreeBSD Architecture Handbook: 13.4 Character Devices 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, 29 Aug 2004 15:12:26 -0000 Hi doc@FreeBSD.org, I wanted to write a kernel module and accessed your example 13-2: 'Example of a Sample Echo Pseudo-Device Driver for FreeBSD 5.X'. The source seems slightly outdated and did not work for FreeBSD 5.2-CURRENT of 30th of june. I fixed it and submit to you the updated version. Regards, Gert van der Plas /* * Simple Echo pseudo-device KLD * * Murray Stokely * * Converted to 5.X by Søren (Xride) Straarup * Updated 29 August 2004 by Gert van der Plas */ #include #include #include /* uprintf */ #include #include /* defines used in kernel.h */ #include /* types used in module initialization */ #include /* cdevsw struct */ #include /* uio struct */ #include #define BUFFERSIZE 256 #define CDEV_MAJOR 33 /* Function prototypes */ static d_open_t echo_open; static d_close_t echo_close; static d_read_t echo_read; static d_write_t echo_write; /* Character device entry points */ static struct cdevsw echo_cdevsw = { .d_open = echo_open, .d_close = echo_close, .d_maj = CDEV_MAJOR, .d_name = "echo", .d_read = echo_read, .d_write = echo_write, .d_version = D_VERSION }; typedef struct s_echo { char msg[BUFFERSIZE]; int len; } t_echo; /* vars */ static struct cdev *echo_dev; static int count; static t_echo *echomsg; MALLOC_DECLARE(M_ECHOBUF); MALLOC_DEFINE(M_ECHOBUF, "echobuffer", "buffer for echo module"); /* * This function is called by the kld[un]load(2) system calls to * determine what actions to take when a module is loaded or unloaded. */ static int echo_loader(struct module *m, int what, void *arg) { int err = 0; switch (what) { case MOD_LOAD: /* kldload */ echo_dev = make_dev(&echo_cdevsw, 0, UID_ROOT, GID_WHEEL, 0600, "echo"); /* kmalloc memory for use by this driver */ MALLOC(echomsg, t_echo *, sizeof(t_echo), M_ECHOBUF, M_WAITOK); printf("Echo device loaded.\n"); break; case MOD_UNLOAD: destroy_dev(echo_dev); FREE(echomsg,M_ECHOBUF); printf("Echo device unloaded.\n"); break; default: err = EINVAL; break; } return(err); } static int echo_open(struct cdev *dev, int oflags, int devtype, struct thread *p) { int err = 0; uprintf("Opened device \"echo\" successfully.\n"); return(err); } static int echo_close(struct cdev *dev, int fflag, int devtype, struct thread *p) { uprintf("Closing device \"echo.\"\n"); return(0); } /* * The read function just takes the buf that was saved via * echo_write() and returns it to userland for accessing. * uio(9) */ static int echo_read(struct cdev *dev, struct uio *uio, int ioflag) { int err = 0; int amt; /* * How big is this read operation? Either as big as the user wants, * or as big as the remaining data */ amt = MIN(uio->uio_resid, (echomsg->len - uio->uio_offset > 0) ? echomsg->len - uio->uio_offset : 0); if ((err = uiomove(echomsg->msg + uio->uio_offset,amt,uio)) != 0) { uprintf("uiomove failed!\n"); } return(err); } /* * echo_write takes in a character string and saves it * to buf for later accessing. */ static int echo_write(struct cdev *dev, struct uio *uio, int ioflag) { int err = 0; /* Copy the string in from user memory to kernel memory */ err = copyin(uio->uio_iov->iov_base, echomsg->msg, MIN(uio->uio_iov->iov_len,BUFFERSIZE)); /* Now we need to null terminate, then record the length */ *(echomsg->msg + MIN(uio->uio_iov->iov_len,BUFFERSIZE)) = 0; echomsg->len = MIN(uio->uio_iov->iov_len,BUFFERSIZE); if (err != 0) { uprintf("Write failed: bad address!\n"); } count++; return(err); } DEV_MODULE(echo,echo_loader,NULL); _________________________________________________________________ Talk with your online friends with MSN Messenger http://messenger.msn.nl/ From owner-freebsd-doc@FreeBSD.ORG Sun Aug 29 16:35: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 CA3C116A4CE for ; Sun, 29 Aug 2004 16:35:59 +0000 (GMT) Received: from twilight.cs.hut.fi (twilight.cs.hut.fi [130.233.40.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 92BC743D3F for ; Sun, 29 Aug 2004 16:35:59 +0000 (GMT) (envelope-from mkomu@twilight.cs.hut.fi) Received: from kekkonen.cs.hut.fi (kekkonen.cs.hut.fi [130.233.41.50]) by twilight.cs.hut.fi (Postfix) with ESMTP id 7E8551EBC2 for ; Sun, 29 Aug 2004 19:35:51 +0300 (EEST) Received: (from mkomu@localhost) by kekkonen.cs.hut.fi (8.11.7p1+Sun/8.10.2) id i7TGZrx27891; Sun, 29 Aug 2004 19:35:53 +0300 (EEST) Date: Sun, 29 Aug 2004 19:35:53 +0300 (EEST) From: Miika Komu X-X-Sender: mkomu@kekkonen.cs.hut.fi To: doc@FreeBSD.org Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Subject: sound setup in freebsd handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 29 Aug 2004 16:35:59 -0000 Chapter "7.2 Setting Up the Sound Card" is somewhat deprecated in the handbook. There is no "device pcm" in FreeBSD 5.3-BETA2 anymore. For example, if you have a sound card with es137x chip you need to configure the kernel with: device sound device "snd_es137x" instead of: device pcm -- Miika Komu miika@iki.fi http://www.iki.fi/miika/ From owner-freebsd-doc@FreeBSD.ORG Sun Aug 29 16:37:38 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id CDDE116A4CE for ; Sun, 29 Aug 2004 16:37:38 +0000 (GMT) Received: from twilight.cs.hut.fi (twilight.cs.hut.fi [130.233.40.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9541943D3F for ; Sun, 29 Aug 2004 16:37:38 +0000 (GMT) (envelope-from mkomu@twilight.cs.hut.fi) Received: from kekkonen.cs.hut.fi (kekkonen.cs.hut.fi [130.233.41.50]) by twilight.cs.hut.fi (Postfix) with ESMTP id 4DA791EBC2 for ; Sun, 29 Aug 2004 19:37:35 +0300 (EEST) Received: (from mkomu@localhost) by kekkonen.cs.hut.fi (8.11.7p1+Sun/8.10.2) id i7TGbbl27961; Sun, 29 Aug 2004 19:37:37 +0300 (EEST) Date: Sun, 29 Aug 2004 19:37:37 +0300 (EEST) From: Miika Komu X-X-Sender: mkomu@kekkonen.cs.hut.fi To: doc@FreeBSD.org In-Reply-To: Message-ID: References: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Subject: Re: sound setup in freebsd handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 29 Aug 2004 16:37:38 -0000 On Sun, 29 Aug 2004, Miika Komu wrote: > Chapter "7.2 Setting Up the Sound Card" is somewhat deprecated in the > handbook. There is no "device pcm" in FreeBSD 5.3-BETA2 anymore. For > example, if you have a sound card with es137x chip you need to configure > the kernel with: > > device sound > device "snd_es137x" > > instead of: > > device pcm See e.g. http://lists.freebsd.org/pipermail/freebsd-questions/2004-August/054789.html -- Miika Komu miika@iki.fi http://www.iki.fi/miika/ From owner-freebsd-doc@FreeBSD.ORG Sun Aug 29 16:43:44 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 E396216A4CE for ; Sun, 29 Aug 2004 16:43:44 +0000 (GMT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9E0F543D4C for ; Sun, 29 Aug 2004 16:43:43 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) i7TGhe17054996; Sun, 29 Aug 2004 18:43:40 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.11/8.12.11/Submit) id i7TGhdQY054994; Sun, 29 Aug 2004 18:43:39 +0200 (CEST) (envelope-from marc) Date: Sun, 29 Aug 2004 18:43:38 +0200 From: Marc Fonvieille To: Miika Komu Message-ID: <20040829164338.GC54085@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: doc@FreeBSD.org Subject: Re: sound setup in freebsd handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 29 Aug 2004 16:43:45 -0000 On Sun, Aug 29, 2004 at 07:35:53PM +0300, Miika Komu wrote: > Chapter "7.2 Setting Up the Sound Card" is somewhat deprecated in the > handbook. There is no "device pcm" in FreeBSD 5.3-BETA2 anymore. For > example, if you have a sound card with es137x chip you need to configure > the kernel with: > > device sound > device "snd_es137x" > > instead of: > > device pcm > It's a known problem, this part is currently under rewritting and will be up-to-date for 5.3-RELEASE Marc From owner-freebsd-doc@FreeBSD.ORG Sun Aug 29 16:48: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 AB76816A4CE; Sun, 29 Aug 2004 16:48:54 +0000 (GMT) Received: from twilight.cs.hut.fi (twilight.cs.hut.fi [130.233.40.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 718A443D53; Sun, 29 Aug 2004 16:48:54 +0000 (GMT) (envelope-from mkomu@twilight.cs.hut.fi) Received: from kekkonen.cs.hut.fi (kekkonen.cs.hut.fi [130.233.41.50]) by twilight.cs.hut.fi (Postfix) with ESMTP id D60321EB49; Sun, 29 Aug 2004 19:48:50 +0300 (EEST) Received: (from mkomu@localhost) by kekkonen.cs.hut.fi (8.11.7p1+Sun/8.10.2) id i7TGmqO28430; Sun, 29 Aug 2004 19:48:52 +0300 (EEST) Date: Sun, 29 Aug 2004 19:48:52 +0300 (EEST) From: Miika Komu X-X-Sender: mkomu@kekkonen.cs.hut.fi To: Marc Fonvieille In-Reply-To: <20040829164338.GC54085@abigail.blackend.org> Message-ID: References: <20040829164338.GC54085@abigail.blackend.org> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: doc@FreeBSD.org Subject: Re: sound setup in freebsd handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 29 Aug 2004 16:48:54 -0000 On Sun, 29 Aug 2004, Marc Fonvieille wrote: > On Sun, Aug 29, 2004 at 07:35:53PM +0300, Miika Komu wrote: > > Chapter "7.2 Setting Up the Sound Card" is somewhat deprecated in the > > handbook. There is no "device pcm" in FreeBSD 5.3-BETA2 anymore. For > > example, if you have a sound card with es137x chip you need to configure > > the kernel with: > > > > device sound > > device "snd_es137x" > > > > instead of: > > > > device pcm > > > > It's a known problem, this part is currently under rewritting and will > be up-to-date for 5.3-RELEASE Excellent! Thanks. -- Miika Komu miika@iki.fi http://www.iki.fi/miika/ From owner-freebsd-doc@FreeBSD.ORG Sun Aug 29 19:53: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 212FA16A4CE; Sun, 29 Aug 2004 19:53:50 +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 C227843D1F; Sun, 29 Aug 2004 19:53:49 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id 7BDEF11AB1; Sun, 29 Aug 2004 21:53:48 +0200 (CEST) Date: Sun, 29 Aug 2004 21:53:48 +0200 From: "Simon L. Nielsen" To: Tom Rhodes Message-ID: <20040829195348.GC760@zaphod.nitro.dk> References: <20040827180724.GZ24054@arved.at> <20040827182012.GD774@zaphod.nitro.dk> <1093631012.634.5.camel@tl.kom.tuwien.ac.at> <20040827184829.GE774@zaphod.nitro.dk> <20040827202755.GZ37255@submonkey.net> <20040828013249.7b3f1de7@localhost.pittgoth.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="KN5l+BnMqAQyZLvT" Content-Disposition: inline In-Reply-To: <20040828013249.7b3f1de7@localhost.pittgoth.com> User-Agent: Mutt/1.5.6i cc: Tilman Linneweh cc: Ceri Davies cc: Ruslan Ermilov cc: freebsd-doc@FreeBSD.org Subject: Re: ar.4 missing 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, 29 Aug 2004 19:53:50 -0000 --KN5l+BnMqAQyZLvT Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.08.28 01:32:49 -0400, Tom Rhodes wrote: > On Fri, 27 Aug 2004 21:27:55 +0100 > Ceri Davies wrote: >=20 > > On Fri, Aug 27, 2004 at 08:48:29PM +0200, Simon L. Nielsen wrote: > > > On 2004.08.27 20:23:32 +0200, Tilman Linneweh wrote: > > > > Am Fr, den 27.08.2004 schrieb Simon L. Nielsen um 20:20: > > > > > On 2004.08.27 20:07:25 +0200, Tilman Linneweh wrote: > > > > > > Hello, > > > > > >=20 > > > > > > Noticed that ar.4 is missing, although mentioned in ata.4, plea= se commit or > > > > > > approve this small diff: > > > > > >=20 > > > > > > http://people.freebsd.org/~arved/stuff/ar.diff > > > > >=20 > > > > > That's unfortunatly not the right solution... since we have anoth= er > > > > > ar(4) device, which is a NIC driver: :-/ > > > > >=20 > > > > > ar -- synchronous Digi/Arnet device driver > > > > >=20 > > > > > It is very unfortunate IMO, but I think it's way to late to fix. > > > >=20 > > > > Oops, you are right, i was confused because the NIC driver is i386 = only, > > > > and i tried "man 4 ar" on amd64. > > > > So maybe add the MLINKS only on !i386? > > >=20 > > > I'm not really sure if that would break POLA (as in, confusing people > > > more). I have CC'ed ru, perhaps he (or someone else) has a good idea > > > on how to make this situation better. > >=20 > > Personally, I don't see a problem with having "man 4 ar" give you > > something different on, say, sparc64 and i386; I vaguely remember a > > similar discussion when the second ar driver was added, and the > > conclusion was that this wouldn't be a problem, I believe. OK, that's fine with me then, and since Ruslan hasn't complained I assume he has no strong feelings against it :-). > Put a note in the description: >=20 > If you are looking for ... please see .Xr blah. Sounds like a good idea. I will add it to my "TODO list for things that has do be done after the stuff that needs to be done by 5.3 list", unless somebody fixes it before :-). --=20 Simon L. Nielsen FreeBSD Documentation Team --KN5l+BnMqAQyZLvT Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.5 (FreeBSD) iD8DBQFBMjRMh9pcDSc1mlERAvI0AKCYNPCp6+8V2q70n9pbeXfEWb02agCfb+tJ GurIIzIQShNjQ4vOIDW2rGc= =JU+Y -----END PGP SIGNATURE----- --KN5l+BnMqAQyZLvT-- From owner-freebsd-doc@FreeBSD.ORG Sun Aug 29 20:02: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 E7A6116A4CE; Sun, 29 Aug 2004 20:02:11 +0000 (GMT) Received: from tigra.ip.net.ua (tigra.ip.net.ua [82.193.96.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id 03BB643D1D; Sun, 29 Aug 2004 20:02:11 +0000 (GMT) (envelope-from ru@ip.net.ua) Received: from heffalump.ip.net.ua (heffalump.ip.net.ua [82.193.96.213]) by tigra.ip.net.ua (8.12.11/8.12.11) with ESMTP id i7TK25gm050560 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sun, 29 Aug 2004 23:02:06 +0300 (EEST) (envelope-from ru@ip.net.ua) Received: (from ru@localhost) by heffalump.ip.net.ua (8.13.1/8.13.1) id i7TK2AD7039929; Sun, 29 Aug 2004 23:02:10 +0300 (EEST) (envelope-from ru) Date: Sun, 29 Aug 2004 23:02:10 +0300 From: Ruslan Ermilov To: "Simon L. Nielsen" Message-ID: <20040829200210.GB39813@ip.net.ua> References: <20040827180724.GZ24054@arved.at> <20040827182012.GD774@zaphod.nitro.dk> <1093631012.634.5.camel@tl.kom.tuwien.ac.at> <20040827184829.GE774@zaphod.nitro.dk> <20040827202755.GZ37255@submonkey.net> <20040828013249.7b3f1de7@localhost.pittgoth.com> <20040829195348.GC760@zaphod.nitro.dk> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="9UV9rz0O2dU/yYYn" Content-Disposition: inline In-Reply-To: <20040829195348.GC760@zaphod.nitro.dk> User-Agent: Mutt/1.5.6i X-Virus-Scanned: by amavisd-new cc: Tom Rhodes cc: Tilman Linneweh cc: Ceri Davies cc: freebsd-doc@FreeBSD.org Subject: Re: ar.4 missing 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, 29 Aug 2004 20:02:12 -0000 --9UV9rz0O2dU/yYYn Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sun, Aug 29, 2004 at 09:53:48PM +0200, Simon L. Nielsen wrote: > On 2004.08.28 01:32:49 -0400, Tom Rhodes wrote: > > On Fri, 27 Aug 2004 21:27:55 +0100 > > Ceri Davies wrote: > >=20 > > > On Fri, Aug 27, 2004 at 08:48:29PM +0200, Simon L. Nielsen wrote: > > > > On 2004.08.27 20:23:32 +0200, Tilman Linneweh wrote: > > > > > Am Fr, den 27.08.2004 schrieb Simon L. Nielsen um 20:20: > > > > > > On 2004.08.27 20:07:25 +0200, Tilman Linneweh wrote: > > > > > > > Hello, > > > > > > >=20 > > > > > > > Noticed that ar.4 is missing, although mentioned in ata.4, pl= ease commit or > > > > > > > approve this small diff: > > > > > > >=20 > > > > > > > http://people.freebsd.org/~arved/stuff/ar.diff > > > > > >=20 > > > > > > That's unfortunatly not the right solution... since we have ano= ther > > > > > > ar(4) device, which is a NIC driver: :-/ > > > > > >=20 > > > > > > ar -- synchronous Digi/Arnet device driver > > > > > >=20 > > > > > > It is very unfortunate IMO, but I think it's way to late to fix. > > > > >=20 > > > > > Oops, you are right, i was confused because the NIC driver is i38= 6 only, > > > > > and i tried "man 4 ar" on amd64. > > > > > So maybe add the MLINKS only on !i386? > > > >=20 > > > > I'm not really sure if that would break POLA (as in, confusing peop= le > > > > more). I have CC'ed ru, perhaps he (or someone else) has a good id= ea > > > > on how to make this situation better. > > >=20 > > > Personally, I don't see a problem with having "man 4 ar" give you > > > something different on, say, sparc64 and i386; I vaguely remember a > > > similar discussion when the second ar driver was added, and the > > > conclusion was that this wouldn't be a problem, I believe. >=20 > OK, that's fine with me then, and since Ruslan hasn't complained I > assume he has no strong feelings against it :-). >=20 I did complain. Did you miss my email? Cheers, --=20 Ruslan Ermilov ru@FreeBSD.org FreeBSD committer --9UV9rz0O2dU/yYYn Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.5 (FreeBSD) iD8DBQFBMjZCqRfpzJluFF4RAoGuAJ4jBpXF1IeCjspahOo3Q2unCqbzhQCggbj5 BIMrRw7e+HXG6TeRrhvNEL0= =qdVz -----END PGP SIGNATURE----- --9UV9rz0O2dU/yYYn-- From owner-freebsd-doc@FreeBSD.ORG Sun Aug 29 20:09: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 C69C116A4CE; Sun, 29 Aug 2004 20:09:00 +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 64CA943D2D; Sun, 29 Aug 2004 20:09:00 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id 5EA0711AB1; Sun, 29 Aug 2004 22:08:59 +0200 (CEST) Date: Sun, 29 Aug 2004 22:08:59 +0200 From: "Simon L. Nielsen" To: Ruslan Ermilov Message-ID: <20040829200859.GD760@zaphod.nitro.dk> References: <20040827180724.GZ24054@arved.at> <20040827182012.GD774@zaphod.nitro.dk> <1093631012.634.5.camel@tl.kom.tuwien.ac.at> <20040827184829.GE774@zaphod.nitro.dk> <20040827202755.GZ37255@submonkey.net> <20040828013249.7b3f1de7@localhost.pittgoth.com> <20040829195348.GC760@zaphod.nitro.dk> <20040829200210.GB39813@ip.net.ua> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="JwB53PgKC5A7+0Ej" Content-Disposition: inline In-Reply-To: <20040829200210.GB39813@ip.net.ua> User-Agent: Mutt/1.5.6i cc: Tom Rhodes cc: Tilman Linneweh cc: Ceri Davies cc: freebsd-doc@FreeBSD.org Subject: Re: ar.4 missing 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, 29 Aug 2004 20:09:00 -0000 --JwB53PgKC5A7+0Ej Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.08.29 23:02:10 +0300, Ruslan Ermilov wrote: > On Sun, Aug 29, 2004 at 09:53:48PM +0200, Simon L. Nielsen wrote: > > On 2004.08.28 01:32:49 -0400, Tom Rhodes wrote: > > > On Fri, 27 Aug 2004 21:27:55 +0100 > > > Ceri Davies wrote: > > >=20 > > > > On Fri, Aug 27, 2004 at 08:48:29PM +0200, Simon L. Nielsen wrote: > > > > > On 2004.08.27 20:23:32 +0200, Tilman Linneweh wrote: > > > > > > Am Fr, den 27.08.2004 schrieb Simon L. Nielsen um 20:20: > > > > > > > On 2004.08.27 20:07:25 +0200, Tilman Linneweh wrote: > > > > > > > > Hello, > > > > > > > >=20 > > > > > > > > Noticed that ar.4 is missing, although mentioned in ata.4, = please commit or > > > > > > > > approve this small diff: > > > > > > > >=20 > > > > > > > > http://people.freebsd.org/~arved/stuff/ar.diff > > > > > > >=20 > > > > > > > That's unfortunatly not the right solution... since we have a= nother > > > > > > > ar(4) device, which is a NIC driver: :-/ > > > > > > >=20 > > > > > > > ar -- synchronous Digi/Arnet device driver > > > > > > >=20 > > > > > > > It is very unfortunate IMO, but I think it's way to late to f= ix. > > > > > >=20 > > > > > > Oops, you are right, i was confused because the NIC driver is i= 386 only, > > > > > > and i tried "man 4 ar" on amd64. > > > > > > So maybe add the MLINKS only on !i386? > > > > >=20 > > > > > I'm not really sure if that would break POLA (as in, confusing pe= ople > > > > > more). I have CC'ed ru, perhaps he (or someone else) has a good = idea > > > > > on how to make this situation better. > > > >=20 > > > > Personally, I don't see a problem with having "man 4 ar" give you > > > > something different on, say, sparc64 and i386; I vaguely remember a > > > > similar discussion when the second ar driver was added, and the > > > > conclusion was that this wouldn't be a problem, I believe. > >=20 > > OK, that's fine with me then, and since Ruslan hasn't complained I > > assume he has no strong feelings against it :-). > >=20 > I did complain. Did you miss my email? I haven't seen an email from you in this thread, and I just checked that it's not in the freebsd-doc archives either... --=20 Simon L. Nielsen FreeBSD Documentation Team --JwB53PgKC5A7+0Ej Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.5 (FreeBSD) iD8DBQFBMjfbh9pcDSc1mlERAlfYAKCMKXTvglMD1fqcA43WUD7SRvf4YwCcCfhR 0eMAY7vTqFQifaMCIwOkc18= =K5mA -----END PGP SIGNATURE----- --JwB53PgKC5A7+0Ej-- From owner-freebsd-doc@FreeBSD.ORG Sun Aug 29 21:08:03 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1499E16A4CE; Sun, 29 Aug 2004 21:08:03 +0000 (GMT) Received: from tigra.ip.net.ua (tigra.ip.net.ua [82.193.96.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2788343D31; Sun, 29 Aug 2004 21:08:02 +0000 (GMT) (envelope-from ru@ip.net.ua) Received: from heffalump.ip.net.ua (heffalump.ip.net.ua [82.193.96.213]) by tigra.ip.net.ua (8.12.11/8.12.11) with ESMTP id i7TL7vWo051486 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Mon, 30 Aug 2004 00:07:58 +0300 (EEST) (envelope-from ru@ip.net.ua) Received: (from ru@localhost) by heffalump.ip.net.ua (8.13.1/8.13.1) id i7TL82gC040401; Mon, 30 Aug 2004 00:08:03 +0300 (EEST) (envelope-from ru) Date: Mon, 30 Aug 2004 00:08:02 +0300 From: Ruslan Ermilov To: "Simon L. Nielsen" Message-ID: <20040829210802.GA40369@ip.net.ua> References: <20040827180724.GZ24054@arved.at> <20040827182012.GD774@zaphod.nitro.dk> <1093631012.634.5.camel@tl.kom.tuwien.ac.at> <20040827184829.GE774@zaphod.nitro.dk> <20040827202755.GZ37255@submonkey.net> <20040828013249.7b3f1de7@localhost.pittgoth.com> <20040829195348.GC760@zaphod.nitro.dk> <20040829200210.GB39813@ip.net.ua> <20040829200859.GD760@zaphod.nitro.dk> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="VbJkn9YxBvnuCH5J" Content-Disposition: inline In-Reply-To: <20040829200859.GD760@zaphod.nitro.dk> User-Agent: Mutt/1.5.6i X-Virus-Scanned: by amavisd-new cc: Tom Rhodes cc: Ceri Davies cc: freebsd-doc@freebsd.org Subject: Re: ar.4 missing 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, 29 Aug 2004 21:08:03 -0000 --VbJkn9YxBvnuCH5J Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sun, Aug 29, 2004 at 10:08:59PM +0200, Simon L. Nielsen wrote: > On 2004.08.29 23:02:10 +0300, Ruslan Ermilov wrote: > > On Sun, Aug 29, 2004 at 09:53:48PM +0200, Simon L. Nielsen wrote: > > > On 2004.08.28 01:32:49 -0400, Tom Rhodes wrote: > > > > On Fri, 27 Aug 2004 21:27:55 +0100 > > > > Ceri Davies wrote: > > > >=20 > > > > > On Fri, Aug 27, 2004 at 08:48:29PM +0200, Simon L. Nielsen wrote: > > > > > > On 2004.08.27 20:23:32 +0200, Tilman Linneweh wrote: > > > > > > > Am Fr, den 27.08.2004 schrieb Simon L. Nielsen um 20:20: > > > > > > > > On 2004.08.27 20:07:25 +0200, Tilman Linneweh wrote: > > > > > > > > > Hello, > > > > > > > > >=20 > > > > > > > > > Noticed that ar.4 is missing, although mentioned in ata.4= , please commit or > > > > > > > > > approve this small diff: > > > > > > > > >=20 > > > > > > > > > http://people.freebsd.org/~arved/stuff/ar.diff > > > > > > > >=20 > > > > > > > > That's unfortunatly not the right solution... since we have= another > > > > > > > > ar(4) device, which is a NIC driver: :-/ > > > > > > > >=20 > > > > > > > > ar -- synchronous Digi/Arnet device driver > > > > > > > >=20 > > > > > > > > It is very unfortunate IMO, but I think it's way to late to= fix. > > > > > > >=20 > > > > > > > Oops, you are right, i was confused because the NIC driver is= i386 only, > > > > > > > and i tried "man 4 ar" on amd64. > > > > > > > So maybe add the MLINKS only on !i386? > > > > > >=20 > > > > > > I'm not really sure if that would break POLA (as in, confusing = people > > > > > > more). I have CC'ed ru, perhaps he (or someone else) has a goo= d idea > > > > > > on how to make this situation better. > > > > >=20 > > > > > Personally, I don't see a problem with having "man 4 ar" give you > > > > > something different on, say, sparc64 and i386; I vaguely remember= a > > > > > similar discussion when the second ar driver was added, and the > > > > > conclusion was that this wouldn't be a problem, I believe. > > >=20 > > > OK, that's fine with me then, and since Ruslan hasn't complained I > > > assume he has no strong feelings against it :-). > > >=20 > > I did complain. Did you miss my email? >=20 > I haven't seen an email from you in this thread, and I just checked > that it's not in the freebsd-doc archives either... >=20 Odd, it looks like my mailer did something wrong, because I have it in my mailbox, but cannot find its Message-ID: in /var/log/maillog on my host and on our mail server. I will resend my mail now. Cheers, --=20 Ruslan Ermilov ru@FreeBSD.org FreeBSD committer --VbJkn9YxBvnuCH5J Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.5 (FreeBSD) iD8DBQFBMkWyqRfpzJluFF4RAhbtAJ9yDdt6R2cm8l7ZeR/fGLI8Liz/5QCdGzPI ZFvn+AYQ40+PWYsKKXEr/P8= =2eQ3 -----END PGP SIGNATURE----- --VbJkn9YxBvnuCH5J-- From owner-freebsd-doc@FreeBSD.ORG Sun Aug 29 21:08:56 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 93E5A16A4CE; Sun, 29 Aug 2004 21:08:56 +0000 (GMT) Received: from tigra.ip.net.ua (tigra.ip.net.ua [82.193.96.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id DBB2B43D41; Sun, 29 Aug 2004 21:08:55 +0000 (GMT) (envelope-from ru@ip.net.ua) Received: from heffalump.ip.net.ua (heffalump.ip.net.ua [82.193.96.213]) by tigra.ip.net.ua (8.12.11/8.12.11) with ESMTP id i7TL8pft051493 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Mon, 30 Aug 2004 00:08:52 +0300 (EEST) (envelope-from ru@ip.net.ua) Received: (from ru@localhost) by heffalump.ip.net.ua (8.13.1/8.13.1) id i7TL8uv0040427; Mon, 30 Aug 2004 00:08:56 +0300 (EEST) (envelope-from ru) Date: Mon, 30 Aug 2004 00:08:56 +0300 From: Ruslan Ermilov To: Tom Rhodes Message-ID: <20040829210856.GB40369@ip.net.ua> References: <20040827180724.GZ24054@arved.at> <20040827182012.GD774@zaphod.nitro.dk> <1093631012.634.5.camel@tl.kom.tuwien.ac.at> <20040827184829.GE774@zaphod.nitro.dk> <20040827202755.GZ37255@submonkey.net> <20040828013249.7b3f1de7@localhost.pittgoth.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="qcHopEYAB45HaUaB" Content-Disposition: inline In-Reply-To: <20040828013249.7b3f1de7@localhost.pittgoth.com> User-Agent: Mutt/1.5.6i X-Virus-Scanned: by amavisd-new cc: Tilman Linneweh cc: Ceri Davies cc: freebsd-doc@FreeBSD.org cc: "Simon L. Nielsen" Subject: Re: ar.4 missing 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, 29 Aug 2004 21:08:56 -0000 --qcHopEYAB45HaUaB Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, Aug 28, 2004 at 01:32:49AM -0400, Tom Rhodes wrote: > On Fri, 27 Aug 2004 21:27:55 +0100 > Ceri Davies wrote: >=20 > > On Fri, Aug 27, 2004 at 08:48:29PM +0200, Simon L. Nielsen wrote: > > > On 2004.08.27 20:23:32 +0200, Tilman Linneweh wrote: > > > > Am Fr, den 27.08.2004 schrieb Simon L. Nielsen um 20:20: > > > > > On 2004.08.27 20:07:25 +0200, Tilman Linneweh wrote: > > > > > > Hello, > > > > > >=20 > > > > > > Noticed that ar.4 is missing, although mentioned in ata.4, plea= se commit or > > > > > > approve this small diff: > > > > > >=20 > > > > > > http://people.freebsd.org/~arved/stuff/ar.diff > > > > >=20 > > > > > That's unfortunatly not the right solution... since we have anoth= er > > > > > ar(4) device, which is a NIC driver: :-/ > > > > >=20 > > > > > ar -- synchronous Digi/Arnet device driver > > > > >=20 > > > > > It is very unfortunate IMO, but I think it's way to late to fix. > > > >=20 > > > > Oops, you are right, i was confused because the NIC driver is i386 = only, > > > > and i tried "man 4 ar" on amd64. > > > > So maybe add the MLINKS only on !i386? > > >=20 > > > I'm not really sure if that would break POLA (as in, confusing people > > > more). I have CC'ed ru, perhaps he (or someone else) has a good idea > > > on how to make this situation better. > >=20 Note that actual devices aren't "ar", "acd", "ad", "afd", "ast", but "ataraid", "atapicd", "atadisk", "atapifd", and "atapist" (and the SYNOPSIS section of the manpage gets this right). I personally think that former MLINKS can be replaced by real device MLINKS. We have many other manpages with similar situation: - the sio(4) manpage documents "device sio" but is not MLINK'ed to "cuaa", "ttyd", etc.; - the psm(4) manpage documents "device psm" but is not MLINK'ed to "bpsm"; - and so on. I mean, it's very good when /dev entries match device driver name, but it's not required and not always possible. The /dev entries should be documented in the FILES section of the manpage. The SYNOPSIS should show the actual device driver names, not the /dev entries. > > Personally, I don't see a problem with having "man 4 ar" give you > > something different on, say, sparc64 and i386; I vaguely remember a > > similar discussion when the second ar driver was added, and the > > conclusion was that this wouldn't be a problem, I believe. >=20 "device ataraid" is MI, according to sys/conf/{NOTES,files}. > Put a note in the description: >=20 > If you are looking for ... please see .Xr blah. >=20 This is pointless: referencing to ar(4) when you're reading ar(4). Cheers, --=20 Ruslan Ermilov ru@FreeBSD.org FreeBSD committer --qcHopEYAB45HaUaB Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.5 (FreeBSD) iD8DBQFBMkXoqRfpzJluFF4RAuTRAKCb2cDSesvKafifMIS+qHzz2ff3IwCcCIhG r1mmy1LKFb43clWqor/DdsQ= =Ha5d -----END PGP SIGNATURE----- --qcHopEYAB45HaUaB-- From owner-freebsd-doc@FreeBSD.ORG Mon Aug 30 09:47: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 B6CD816A4CE; Mon, 30 Aug 2004 09:47:48 +0000 (GMT) Received: from vscan02.westnet.com.au (vscan02.westnet.com.au [203.10.1.132]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1ADC143D4C; Mon, 30 Aug 2004 09:47:48 +0000 (GMT) (envelope-from summer@computerdatasafe.com.au) Received: from localhost (localhost.localdomain [127.0.0.1]) by localhost (Postfix) with ESMTP id 03B921198F1; Mon, 30 Aug 2004 17:47:46 +0800 (WST) Received: from ns.computerdatasafe.com.au (dip-220-235-45-218.wa.westnet.com.au [220.235.45.218]) by vscan02.westnet.com.au (Postfix) with ESMTP id 444BB118A07; Mon, 30 Aug 2004 17:47:45 +0800 (WST) Received: from computerdatasafe.com.au (Dolphin.demo.room [192.168.9.114]) by ns.computerdatasafe.com.au (Postfix) with ESMTP id 17BCB53835; Mon, 30 Aug 2004 17:47:44 +0800 (WST) Message-ID: <4132F7BF.8090209@computerdatasafe.com.au> Date: Mon, 30 Aug 2004 17:47:43 +0800 From: John User-Agent: Mozilla Thunderbird 0.5 (X11/20040306) X-Accept-Language: en-us, en MIME-Version: 1.0 References: <200408301318.40078.summer@computerdatasafe.com.au> <4132C51F.4090203@computerdatasafe.com.au> <4132D526.2010007@cds.merseine.nu> <20040830085504.GA1843@kayjay.xs4all.nl> In-Reply-To: <20040830085504.GA1843@kayjay.xs4all.nl> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org cc: "freebsd-questions@FreeBSD. ORG" Subject: Re: Which disk is which 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, 30 Aug 2004 09:47:49 -0000 Karel J. Bosschaart wrote: > On Mon, Aug 30, 2004 at 03:20:06PM +0800, John wrote: > >>Subhro wrote: >> >> >>>What do u mean by difference? >>> >>> >> >>That page does not mention da devices at all. >> >> >>>The device ad represents a IDE/ATA disk and the da device represents a >>>SCSI disk. As you have got one IDE hard disk and one SCSI hard disk in >>>your box, its showing up as ad0 and da0. But as you say that there is >>>no SCSI in that box, then something seems to be wrong. Check your BIOS >>>and disable any onboard SCSI controllers if present >>> >>> >> >>There are no SCSI controllers. It's your basic cheap Acer desktop >>Pentium III of a few years ago. >> >>As I said already, "I have no SCSI in this box." > > > External USB disks and USB pens (using umass) will also show up as a da0 > device. Perhaps you have one of them attached while booting? > > Karel. > Thanks Karel I do have a USB drive attached. It's a point which I think needs clarification on the web document I mentioned in another post. When I started this, I actually thought I was writing to someone who had the power to fix the problem. I've rechecked the page and now see I clicked the wrong link. I'm ccing doc in the hope the content of the page will be clarified. Doc: See fig 2-20 at http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/install-steps.html From owner-freebsd-doc@FreeBSD.ORG Mon Aug 30 11:01: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 8805D16A4CE for ; Mon, 30 Aug 2004 11:01:12 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 64F6543D46 for ; Mon, 30 Aug 2004 11:01:12 +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 i7UB1CaV033006 for ; Mon, 30 Aug 2004 11:01:12 GMT (envelope-from owner-bugmaster@freebsd.org) Received: (from peter@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i7UB1Atg033001 for freebsd-doc@freebsd.org; Mon, 30 Aug 2004 11:01:10 GMT (envelope-from owner-bugmaster@freebsd.org) Date: Mon, 30 Aug 2004 11:01:10 GMT Message-Id: <200408301101.i7UB1Atg033001@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, 30 Aug 2004 11:01:12 -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/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 o [2004/08/18] docs/70616 doc incompleteness and error in su(1) man pag o [2004/08/25] docs/70952 doc Handbook section 16.6.2 has bad example 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/02] docs/26286 doc *printf(3) etc should gain format string 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/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 p [2003/07/11] docs/54391 doc Document that glob(3) respects LC_COLLATE o [2003/07/13] docs/54451 doc [patch] i386_{get|set}_ldt manual page is o [2003/07/26] docs/54879 doc man 1 jot, -r description 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/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/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 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/13] docs/65477 doc Installation Instruction fail to mention o [2004/04/14] docs/65530 doc minor improvement to getgrent.3 o [2004/04/22] docs/65895 doc incorrect "omshell" link in "dhclient" ma o [2004/04/26] docs/65988 doc incorrect references to ppp.conf in handb o [2004/04/29] docs/66091 doc ppp(8) docs out-of-date for -CURRENT o [2004/05/04] docs/66264 doc [patch] libexec/rtld/rtld.1 typo fixes no o [2004/05/04] docs/66265 doc [patch] Document what -f and LD_TRACE_LOA o [2004/05/05] docs/66296 doc [patch] contrib/amd/amq/amq.8 uses log_op o [2004/05/07] docs/66343 doc unlisted supported card on man page for w o [2004/05/09] docs/66426 doc handbook update (desktop section): web br o [2004/05/10] docs/66483 doc [patch] share/man/man4/csa.4 grammar nits o [2004/05/17] docs/66768 doc 4_RELENG share/man/man4/ng_one2many.4 MFC o [2004/05/17] docs/66770 doc [patch] share/man/man4/ng_pppoe.4 tyops, o [2004/05/23] docs/67078 doc [patch] MFC of a rtld(1) man page is inco f [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/17] docs/68038 doc Attempt to make the terse part of 17.6.2 o [2004/06/28] docs/68453 doc [patch] rc.subr.8 o [2004/07/02] docs/68606 doc Porter's Handbook: document how to write o [2004/07/09] docs/68843 doc Dates on rc.subr(8) & rc(8) are whack. o [2004/07/09] docs/68845 doc The .At macro produces unexpected results o [2004/07/19] docs/69271 doc Porter's Handbook: hint on proper pkg-mes o [2004/07/21] docs/69383 doc disklabel = bsdlabel in 5.X or later o [2004/08/03] docs/69968 doc minor clarification in mac glossary o [2004/08/09] docs/70217 doc Suggested rewrite of docproj/sgml.sgml o [2004/08/11] docs/70310 doc [PATCH] Add information about DragonFly o [2004/08/16] docs/70506 doc re_format(7) contains many extra '=' o [2004/08/17] docs/70583 doc [PATCH] Update freebsd-glossary o [2004/08/19] docs/70652 doc New man page: portindex(5) o [2004/08/23] docs/70856 doc List of flags and their aliases in `man 1 o [2004/08/24] docs/70916 doc msync.2 manpage update o [2004/08/25] docs/70943 doc remove -k from gdb.1 manual 148 problems total. From owner-freebsd-doc@FreeBSD.ORG Mon Aug 30 16:17:22 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1555816A4CE; Mon, 30 Aug 2004 16:17:22 +0000 (GMT) Received: from mailhost.stack.nl (vaak.stack.nl [131.155.140.140]) by mx1.FreeBSD.org (Postfix) with ESMTP id 818FF43D39; Mon, 30 Aug 2004 16:17:21 +0000 (GMT) (envelope-from jilles@stack.nl) Received: from snail.stack.nl (snail.stack.nl [IPv6:2001:610:1108:5010::131]) by mailhost.stack.nl (Postfix) with ESMTP id 7DD1E1F062; Mon, 30 Aug 2004 18:17:20 +0200 (CEST) Received: by snail.stack.nl (Postfix, from userid 1677) id 6C72C2287B; Mon, 30 Aug 2004 18:17:20 +0200 (CEST) Date: Mon, 30 Aug 2004 18:17:20 +0200 From: Jilles Tjoelker To: "Simon L. Nielsen" Message-ID: <20040830161720.GC17909@stack.nl> References: <200408261254.i7QCsA4P092588@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200408261254.i7QCsA4P092588@freefall.freebsd.org> X-Operating-System: FreeBSD 5.2.1-RELEASE-p9 i386 User-Agent: Mutt/1.5.6i cc: freebsd-doc@FreeBSD.org cc: freebsd-standards@FreeBSD.org Subject: Re: docs/70985: [patch] sh(1): incomplete documentation of 'trap' builtin 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, 30 Aug 2004 16:17:22 -0000 On Thu, Aug 26, 2004 at 12:54:10PM +0000, Simon L. Nielsen wrote: > Synopsis: [patch] sh(1): incomplete documentation of 'trap' builtin > > Responsible-Changed-From-To: freebsd-doc->freebsd-standards > Responsible-Changed-By: simon > Responsible-Changed-When: Thu Aug 26 12:50:29 GMT 2004 > Responsible-Changed-Why: > Over to the standards people so they can decide if we want to document > that our shell is not fully standard complaint (according the to the > PR - I haven't checked further) or if our sh should rather be changed. > If the standards people think it should be documented, as described in > the PR, feel free to throw this PR back to freebsd-doc. > http://www.freebsd.org/cgi/query-pr.cgi?pr=70985 Documenting the POSIX way trap - action... seems good. The non-compliancy in the PR is using trap with two or more actions to reset the signal to default. For example "trap INT TERM" should set the action for SIGTERM to "INT" but instead resets both SIGINT and SIGTERM to default. The results from invoking trap with a single argument (excluding options) are undefined in POSIX. A small comparison with other shells: bash changed that from 2.x to 3.x -- bash2 bahaves as FreeBSD sh here, while bash3 is POSIX-compliant here (but allows resetting a signal to default with a single argument, like "trap USR1"). zsh (4.2.0) and pdksh (5.2.14p2) behave as FreeBSD sh. ksh93 behaves according to POSIX. -- Jilles Tjoelker From owner-freebsd-doc@FreeBSD.ORG Mon Aug 30 16:22: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 153C616A4CE; Mon, 30 Aug 2004 16:22:57 +0000 (GMT) Received: from ns1.tiadon.com (SMTP.tiadon.com [69.27.132.161]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8ECA343D31; Mon, 30 Aug 2004 16:22:56 +0000 (GMT) (envelope-from kdk@daleco.biz) Received: from [69.27.131.0] ([69.27.131.0]) by ns1.tiadon.com with Microsoft SMTPSVC(6.0.3790.0); Mon, 30 Aug 2004 11:26:31 -0500 Message-ID: <4133545B.5080704@daleco.biz> Date: Mon, 30 Aug 2004 11:22:51 -0500 From: "Kevin D. Kinsey, DaleCo, S.P." User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.7) Gecko/20040712 X-Accept-Language: en-us, en MIME-Version: 1.0 To: John Summerfield References: <200408301318.40078.summer@computerdatasafe.com.au> In-Reply-To: <200408301318.40078.summer@computerdatasafe.com.au> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-OriginalArrivalTime: 30 Aug 2004 16:26:31.0821 (UTC) FILETIME=[1BFC9BD0:01C48EAE] cc: questions@freebsd.org cc: doc@freebsd.org Subject: Re: Which disk is which 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, 30 Aug 2004 16:22:57 -0000 Hi, John ... As you cc'ed doc@, I'm sending your original mail to them also, so they'll have some background. Comments inline. John Summerfield wrote: >I've booted a 5.2.1 miniinstall CD and got to the point where I choose which >disk to install onto. > >My choices are >ad0 >da0 > >Great. How do I know which disk is which? _I_ could work it out if the panel >displayed information such as >Brand >Capacity > > > Read the *text* in the handbook. As an example, the following appears on the page that you linked in your recent crosspost to doc@: "Consider what would happen if you had two IDE hard disks, one as the master on the first IDE controller, and one as the master on the second IDE controller. If FreeBSD numbered these as it found them, as ad0 and ad1 then everything would work. But if you then added a third disk, as the slave device on the first IDE controller, it would now be ad1, and the previous ad1 would " .... <>This goes on for another 3-4 paragraphs; it is a discussion of why FreeBSD has basically "hardcoded" disk drive names/numbers into the kernel, (e.g., why IDE primary master will always be ad0, why secondary slave will always be ad3, etc). Then again, just above figure 2-16 (which is the same as figure 2-20 but without an "X" in the checkbox): Figure 2-16 shows an example from a system with two IDE disks. They have been called ad0 and ad2. Based on reading these sections/statements of the manual, it would seem somewhat obvious that ad0 is the primary master IDE hard disk. It is hard, then, at least for me, to see this as a fault of the documentation. It was also unfortunate that no one on questions@ mentioned the USB drive angle until late in the conversation, perhaps.... >Note: DOS names would be worse than useless because I don't use DOS, and the >BIOS doesn't detect all my drives. > > It doesn't have to, because the kernel ignores the BIOS drive information anyway .... >The website doesn't help. > > > That seems to be debatable, as I noted above, maybe? The information was there; I would grant that the search engine(s) may not have found it for you. I've found FreeBSD works better for me if I take the time to read the whole chapter or book rather than the "quick skimming" habit that the sheer volume of information on the Internet has forced me into.... >I'm not on any list. Please respond by >a) Fixing the web page >b) Mailing me the necessary info (eg the fixed page when it's done) in case I >can't discover by other means which is which. > > I'm not a docteam member, although I read the list and think I have one sentence in the handbook (so that may make me one "technically speaking" --- it's a somewhat loose assocation, apart from those members who are actually committers). I certainly don't represent the FreeBSD organization as a whole --- I'm simply a user, like so many others. I apologize if I seem curt, it is certainly not my intention, and I'm not writing to "flame" or "offend" you or anyone else. Your suggestion "if the panel displayed information such as Brand (&) Capacity" is certainly valid from an end-user standpoint. Some operating systems might well do that; that's a totally different subject, though. And that isn't about the docs, either, it's about the installation program, which is a years-old hydra that no Heracles has yet stepped up to behead.... Kevin Kinsey DaleCo, S.P. From owner-freebsd-doc@FreeBSD.ORG Mon Aug 30 16:30: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 2E8A116A4CE for ; Mon, 30 Aug 2004 16:30:21 +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 D97E843D5A for ; Mon, 30 Aug 2004 16:30:20 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.42 (FreeBSD)) id 1C1p2x-000D6z-Gy; Mon, 30 Aug 2004 17:30:19 +0100 Date: Mon, 30 Aug 2004 17:30:19 +0100 From: Ceri Davies To: Gert van der Plas Message-ID: <20040830163019.GD36133@submonkey.net> Mail-Followup-To: Ceri Davies , Gert van der Plas , doc@FreeBSD.org References: Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="WplhKdTI2c8ulnbP" Content-Disposition: inline In-Reply-To: X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: doc@FreeBSD.org Subject: Re: update for FreeBSD Architecture Handbook: 13.4 Character Devices 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, 30 Aug 2004 16:30:21 -0000 --WplhKdTI2c8ulnbP Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sun, Aug 29, 2004 at 05:00:59PM +0200, Gert van der Plas wrote: > Hi doc@FreeBSD.org, >=20 > I wanted to write a kernel module and accessed your example 13-2: 'Exampl= e=20 > of a Sample Echo Pseudo-Device Driver for FreeBSD 5.X'. The source seems= =20 > slightly outdated and did not work for FreeBSD 5.2-CURRENT of 30th of jun= e. > I fixed it and submit to you the updated version. Hi Gert, Thanks for this. Would it be possible for you to help us a little bit more by submitting this with the send-pr tool so that it doesn't get lost? If I can really push our luck, it would be nice if you could also submit a diff against the old one. Thanks, Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --WplhKdTI2c8ulnbP Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.5 (FreeBSD) iD8DBQFBM1YbocfcwTS3JF8RAq6GAJ48aZ0qKZGuq7AQ5Iwoa6FKC1FV4gCeOIP5 a0bNkEDXGFZjEIKFIO2yhVM= =b9rb -----END PGP SIGNATURE----- --WplhKdTI2c8ulnbP-- From owner-freebsd-doc@FreeBSD.ORG Mon Aug 30 16:30:33 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 B9DD516A4CF for ; Mon, 30 Aug 2004 16:30:33 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 815CD43D55 for ; Mon, 30 Aug 2004 16:30:33 +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 i7UGUXqY078143 for ; Mon, 30 Aug 2004 16:30:33 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i7UGUXAQ078142; Mon, 30 Aug 2004 16:30:33 GMT (envelope-from gnats) Resent-Date: Mon, 30 Aug 2004 16:30:33 GMT Resent-Message-Id: <200408301630.i7UGUXAQ078142@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, Ceri Davies Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8E40916A4CE for ; Mon, 30 Aug 2004 16:25:56 +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 3AD5443D48 for ; Mon, 30 Aug 2004 16:25:54 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.42 (FreeBSD)) id 1C1oyf-000D1E-Dv for FreeBSD-gnats-submit@freebsd.org; Mon, 30 Aug 2004 17:25:53 +0100 Message-Id: Date: Mon, 30 Aug 2004 17:25:53 +0100 From: Ceri Davies Sender: Ceri Davies To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/71153: Doc packages install in /local0 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Ceri Davies List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 30 Aug 2004 16:30:33 -0000 >Number: 71153 >Category: docs >Synopsis: Doc packages install in /local0 >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Aug 30 16:30:33 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Ceri Davies >Release: FreeBSD 4.10-STABLE i386 >Organization: Submonkey >Environment: System: FreeBSD shrike.private.submonkey.net 4.10-STABLE FreeBSD 4.10-STABLE #39: Sat Jul 17 23:00:18 BST 2004 root@shrike.private.submonkey.net:/usr/obj/usr/src/sys/SHRIKE i386 >Description: The prebuilt doc packages on ftp.FreeBSD.org install under /local0; they really should go into /usr/share/doc. >How-To-Repeat: {root@shrike}-{~} # pkg_add -v ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/packages/faq.en_US.ISO8859-1.pdf.tgz looking up ftp.FreeBSD.org connecting to ftp.FreeBSD.org:21 setting passive mode opening data connection initiating transfer Fetching ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/packages/faq.en_US.ISO8859-1.pdf.tgz...+CONTENTS +COMMENT +DESC book.pdf book.pdf.bz2 book.pdf.zip tar command returns 0 status Done. extract: Package name is faq.en_US.ISO8859-1.pdf extract: CWD to /local0/docbuild/build/out/en_US.ISO8859-1/books/faq extract: /local0/docbuild/build/out/en_US.ISO8859-1/books/faq/book.pdf extract: /local0/docbuild/build/out/en_US.ISO8859-1/books/faq/book.pdf.bz2 extract: /local0/docbuild/build/out/en_US.ISO8859-1/books/faq/book.pdf.zip extract: CWD to . Attempting to record package into /var/db/pkg/faq.en_US.ISO8859-1.pdf.. Package faq.en_US.ISO8859-1.pdf registered in /var/db/pkg/faq.en_US.ISO8859-1.pdf {root@shrike}-{~} # ls /local0/ docbuild {root@shrike}-{~} # >Fix: Unsure - I don't know where these packages are generated. >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon Aug 30 19:10: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 784FD16A4D5 for ; Mon, 30 Aug 2004 19:10:42 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6D96C43D31 for ; Mon, 30 Aug 2004 19:10:42 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i7UJAgNA001055 for ; Mon, 30 Aug 2004 19:10:42 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i7UJAf5P001052; Mon, 30 Aug 2004 19:10:41 GMT (envelope-from gnats) Date: Mon, 30 Aug 2004 19:10:41 GMT Message-Id: <200408301910.i7UJAf5P001052@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: "Simon L. Nielsen" Subject: Re: docs/71153: Doc packages install in /local0 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: Mon, 30 Aug 2004 19:10:42 -0000 The following reply was made to PR docs/71153; it has been noted by GNATS. From: "Simon L. Nielsen" To: Ceri Davies Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/71153: Doc packages install in /local0 Date: Mon, 30 Aug 2004 21:04:58 +0200 --sdtB3X0nJg68CQEu Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.08.30 17:25:53 +0100, Ceri Davies wrote: >=20 > >Description: >=20 > The prebuilt doc packages on ftp.FreeBSD.org install under > /local0; they really should go into /usr/share/doc. > >Fix: >=20 > Unsure - I don't know where these packages are generated. That would be my cue. The docs are build on builder.freebsd.org under my user account and then mirrored to ftp-master. The build dir on builder is /local0/docbuild so that's where that comes from. I will have a look at why the packages include this path. Anyway, I personally don't really see the point in the doc packages, so I got the ftp logs from ftp.freebsd.org some time ago to see if they were actually being downloaded, but I got sidetracked by.. well everything else :-). --=20 Simon L. Nielsen FreeBSD Documentation Team --sdtB3X0nJg68CQEu Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.5 (FreeBSD) iD8DBQFBM3pah9pcDSc1mlERAi9PAKC3bUD9BF/dLKN/ea6i0zUGdr0VlACcDw0u 8xuCpFI5WqwgNCBoX8sUFUY= =eEiK -----END PGP SIGNATURE----- --sdtB3X0nJg68CQEu-- From owner-freebsd-doc@FreeBSD.ORG Mon Aug 30 19:13:40 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 AE66A16A4CE; Mon, 30 Aug 2004 19:13:40 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9250E43D54; Mon, 30 Aug 2004 19:13:40 +0000 (GMT) (envelope-from simon@FreeBSD.org) Received: from freefall.freebsd.org (simon@localhost [127.0.0.1]) i7UJDeWD001262; Mon, 30 Aug 2004 19:13:40 GMT (envelope-from simon@freefall.freebsd.org) Received: (from simon@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i7UJDeN6001258; Mon, 30 Aug 2004 19:13:40 GMT (envelope-from simon) Date: Mon, 30 Aug 2004 19:13:40 GMT From: "Simon L. Nielsen" Message-Id: <200408301913.i7UJDeN6001258@freefall.freebsd.org> To: simon@FreeBSD.org, freebsd-doc@FreeBSD.org, simon@FreeBSD.org Subject: Re: docs/71153: Doc packages install in /local0 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, 30 Aug 2004 19:13:41 -0000 Synopsis: Doc packages install in /local0 Responsible-Changed-From-To: freebsd-doc->simon Responsible-Changed-By: simon Responsible-Changed-When: Mon Aug 30 19:13:31 GMT 2004 Responsible-Changed-Why: I will have a look at this one. http://www.freebsd.org/cgi/query-pr.cgi?pr=71153 From owner-freebsd-doc@FreeBSD.ORG Mon Aug 30 21:55:53 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id DA05016A4CE; Mon, 30 Aug 2004 21:55:53 +0000 (GMT) Received: from vscan01.westnet.com.au (vscan01.westnet.com.au [203.10.1.131]) by mx1.FreeBSD.org (Postfix) with ESMTP id 16F4F43D4C; Mon, 30 Aug 2004 21:55:53 +0000 (GMT) (envelope-from summer@computerdatasafe.com.au) Received: from localhost (localhost.localdomain [127.0.0.1]) by localhost (Postfix) with ESMTP id 44C3C51AE1; Tue, 31 Aug 2004 05:55:51 +0800 (WST) Received: from ns.computerdatasafe.com.au (dip-220-235-39-167.wa.westnet.com.au [220.235.39.167]) by vscan01.westnet.com.au (Postfix) with ESMTP id 74A4451A81; Tue, 31 Aug 2004 05:55:50 +0800 (WST) Received: from computerdatasafe.com.au (Dolphin.demo.room [192.168.9.114]) by ns.computerdatasafe.com.au (Postfix) with ESMTP id 778795382D; Tue, 31 Aug 2004 05:55:48 +0800 (WST) Message-ID: <4133A263.7050501@computerdatasafe.com.au> Date: Tue, 31 Aug 2004 05:55:47 +0800 From: John User-Agent: Mozilla Thunderbird 0.5 (X11/20040306) X-Accept-Language: en-us, en MIME-Version: 1.0 References: <200408301318.40078.summer@computerdatasafe.com.au> <4133545B.5080704@daleco.biz> In-Reply-To: <4133545B.5080704@daleco.biz> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit cc: questions@freebsd.org cc: doc@freebsd.org Subject: Re: Which disk is which 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, 30 Aug 2004 21:55:54 -0000 Kevin D. Kinsey, DaleCo, S.P. wrote: > Hi, John ... > > As you cc'ed doc@, I'm sending your original mail to them > also, so they'll have some background. Comments inline. > > John Summerfield wrote: > >> I've booted a 5.2.1 miniinstall CD and got to the point where I choose >> which disk to install onto. >> >> My choices are >> ad0 >> da0 >> >> Great. How do I know which disk is which? _I_ could work it out if the >> panel displayed information such as >> Brand >> Capacity >> >> >> > > Read the *text* in the handbook. As an example, the following > appears on the page that you linked in your recent crosspost to doc@: > > "Consider what would happen if you had two IDE hard disks, one > as the master on the first IDE controller, and one as the master > on the second IDE controller. If FreeBSD numbered these as it > found them, as ad0 and ad1 then everything would work. > > But if you then added a third disk, as the slave device on the first > IDE controller, it would now be ad1, and the previous ad1 would " .... > > <>This goes on for another 3-4 paragraphs; it is a discussion of why > FreeBSD > has basically "hardcoded" disk drive names/numbers into the kernel, (e.g., > why IDE primary master will always be ad0, why secondary slave will always > be ad3, etc). > Then again, just above figure 2-16 (which is the same as figure 2-20 > but without an "X" in the checkbox): > > Figure 2-16 > > shows an example from a system with two IDE disks. > They have been called ad0 and ad2. > > > Based on reading these sections/statements of the manual, it would seem > somewhat obvious that ad0 is the primary master IDE hard disk. It is > hard, then, at least for me, to see this as a fault of the documentation. > The drawback to this is that you're writing from the POV of someone who knows all this. I'm not, I don't. I have booted some other installers on this setup and find they do provide more information than the bare OS-dependant name. Ideally, on my system, the installer would say: AD0 Internal IDE drive, primary master, WD102AA 10.2 Gb DA0 External USB drive, Cypress ATMR04-0 40 Gb so most, even modestly, technical people could instantly recognise which disk is which. From owner-freebsd-doc@FreeBSD.ORG Tue Aug 31 00:10:56 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B744D16A4CE for ; Tue, 31 Aug 2004 00:10:56 +0000 (GMT) Received: from omoikane.mb.skyweb.ca (64-42-246-34.mb.skyweb.ca [64.42.246.34]) by mx1.FreeBSD.org (Postfix) with ESMTP id 65ED243D55 for ; Tue, 31 Aug 2004 00:10:56 +0000 (GMT) (envelope-from mark@skyweb.ca) Received: by omoikane.mb.skyweb.ca (Postfix, from userid 1001) id A180A61E4B; Mon, 30 Aug 2004 19:10:55 -0500 (CDT) From: Mark Johnston To: doc@freebsd.org Date: Mon, 30 Aug 2004 19:10:55 -0500 User-Agent: KMail/1.6.1 MIME-Version: 1.0 Content-Disposition: inline Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Message-Id: <200408301910.55379.mjohnston@skyweb.ca> Subject: Hardware note auto-generation - status? 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, 31 Aug 2004 00:10:56 -0000 What's up, -doc? * In summarizing the cvs-src commits lately, I've noticed a fair bit of work going into retrofitting the man pages to support auto-generation of hardware notes. I'm afraid I haven't followed the doc@ list since that was a WIBNI instead of a WIP, so I'm not sure of the status of the project. I would like to mention it in the cvs-src summary when it's all through; is there a certain src commit I should be watching for to tip me off when it's done? Alternatively, would it be possible for someone involved to drop me a brief note when a mention would be most appropriate? BTW, I'm not averse to mentioning other significant doc@ commits, although I don't have time to follow the doc cvs. If there are commits or general changes that you'd like to see me note in a summary, please drop me a mail. Please don't go out of your way, though. Much thanks, Mark * Sorry, you've probably heard it a million times. :) From owner-freebsd-doc@FreeBSD.ORG Tue Aug 31 04:00: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 0829816A4D5 for ; Tue, 31 Aug 2004 04:00:42 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 10B3143D60 for ; Tue, 31 Aug 2004 04:00:39 +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 i7V40clO071565 for ; Tue, 31 Aug 2004 04:00:38 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i7V40cAL071558; Tue, 31 Aug 2004 04:00:38 GMT (envelope-from gnats) Resent-Date: Tue, 31 Aug 2004 04:00:38 GMT Resent-Message-Id: <200408310400.i7V40cAL071558@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, Kevin Kinsey Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C8E7F16A4CE for ; Tue, 31 Aug 2004 03:57:44 +0000 (GMT) Received: from ezekiel.daleco.biz (cdm-66-76-92-18.cart.cox-internet.com [66.76.92.18]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3800D43D1D for ; Tue, 31 Aug 2004 03:57:44 +0000 (GMT) (envelope-from kadmin@ezekiel.daleco.biz) Received: from localhost (localhost [127.0.0.1]) by ezekiel.daleco.biz (8.12.10/8.12.10) with ESMTP id i7V3vhCP046323 for ; Mon, 30 Aug 2004 22:57:43 -0500 (CDT) (envelope-from kadmin@ezekiel.daleco.biz) Received: from ezekiel.daleco.biz ([127.0.0.1]) by localhost (ezekiel.daleco.biz [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 45780-09 for ; Mon, 30 Aug 2004 22:57:40 -0500 (CDT) Received: from ezekiel.daleco.biz (localhost [127.0.0.1]) by ezekiel.daleco.biz (8.12.10/8.12.10) with ESMTP id i7V3vcES046318 for ; Mon, 30 Aug 2004 22:57:38 -0500 (CDT) (envelope-from kadmin@ezekiel.daleco.biz) Received: (from kadmin@localhost) by ezekiel.daleco.biz (8.12.10/8.12.10/Submit) id i7V3vccl046317; Mon, 30 Aug 2004 22:57:38 -0500 (CDT) (envelope-from kadmin) Message-Id: <200408310357.i7V3vccl046317@ezekiel.daleco.biz> Date: Mon, 30 Aug 2004 22:57:38 -0500 (CDT) From: Kevin Kinsey To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/71175: (PATCH) Bad link in "explaining BSD" article, (EN) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Kevin Kinsey List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 31 Aug 2004 04:00:42 -0000 >Number: 71175 >Category: docs >Synopsis: (PATCH) Bad link in "explaining BSD" article, (EN) >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Aug 31 04:00:38 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Kevin Kinsey >Release: FreeBSD 5.2.1-RELEASE-p9 i386 >Organization: DaleCo, S.P. >Environment: System: FreeBSD ezekiel.daleco.biz 5.2.1-RELEASE-p9 FreeBSD 5.2.1-RELEASE-p9 #0: Fri Aug 6 12:44:00 CDT 2004 root@ezekiel.daleco.biz:/usr/obj/usr/src/sys/GENERIC i386 >Description: I was reading Grog's "Explaining BSD" at the site. The "FreeBSD Consulting" link points to "consulting_bycat.html", which 404s. The actual page is "consult_bycat.html". Minor point, to be sure, but with new handbook/RELEASE soon, everything counts, right? ;-) Anyone *really* interested can note that I tested the links for the other two projects, they are OK... >How-To-Repeat: See above. >Fix: --- /usr/doc/en_US.ISO8859-1/articles/explaining-bsd/article.sgml Wed Aug 25 16:32:41 2004 +++ /usr/doc/en_US.ISO8859-1/articles/explaining-bsd/article.edit.sgml Mon Aug 30 22:49:03 2004 @@ -546,7 +546,7 @@ In addition, each of the projects has a list of consultants for hire: - FreeBSD, + FreeBSD, NetBSD, and OpenBSD. >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Tue Aug 31 06:53:04 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1D25A16A4CE; Tue, 31 Aug 2004 06:53:04 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id F165643D46; Tue, 31 Aug 2004 06:53:03 +0000 (GMT) (envelope-from simon@FreeBSD.org) Received: from freefall.freebsd.org (simon@localhost [127.0.0.1]) i7V6r3NL006687; Tue, 31 Aug 2004 06:53:03 GMT (envelope-from simon@freefall.freebsd.org) Received: (from simon@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i7V6r36K006683; Tue, 31 Aug 2004 06:53:03 GMT (envelope-from simon) Date: Tue, 31 Aug 2004 06:53:03 GMT From: "Simon L. Nielsen" Message-Id: <200408310653.i7V6r36K006683@freefall.freebsd.org> To: kdk@daleco.biz, simon@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/71175: (PATCH) Bad link in "explaining BSD" article, (EN) 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, 31 Aug 2004 06:53:04 -0000 Synopsis: (PATCH) Bad link in "explaining BSD" article, (EN) State-Changed-From-To: open->closed State-Changed-By: simon State-Changed-When: Tue Aug 31 06:52:00 GMT 2004 State-Changed-Why: Committed, thanks! BTW. small fixes like this one are also very important to make the docs as good as possible :-). http://www.freebsd.org/cgi/query-pr.cgi?pr=71175 From owner-freebsd-doc@FreeBSD.ORG Tue Aug 31 08:47: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 BC3E116A4CE; Tue, 31 Aug 2004 08:47:29 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9C0C043D60; Tue, 31 Aug 2004 08:47:29 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from freefall.freebsd.org (trhodes@localhost [127.0.0.1]) i7V8lTNu021240; Tue, 31 Aug 2004 08:47:29 GMT (envelope-from trhodes@freefall.freebsd.org) Received: (from trhodes@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i7V8lTQe021236; Tue, 31 Aug 2004 08:47:29 GMT (envelope-from trhodes) Date: Tue, 31 Aug 2004 08:47:29 GMT From: Tom Rhodes Message-Id: <200408310847.i7V8lTQe021236@freefall.freebsd.org> To: trhodes@FreeBSD.org, freebsd-doc@FreeBSD.org, trhodes@FreeBSD.org Subject: Re: docs/68038: Attempt to make the terse part of 17.6.2 a bit easier 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, 31 Aug 2004 08:47:29 -0000 Synopsis: Attempt to make the terse part of 17.6.2 a bit easier Responsible-Changed-From-To: freebsd-doc->trhodes Responsible-Changed-By: trhodes Responsible-Changed-When: Tue Aug 31 08:47:16 GMT 2004 Responsible-Changed-Why: Take this PR. http://www.freebsd.org/cgi/query-pr.cgi?pr=68038 From owner-freebsd-doc@FreeBSD.ORG Tue Aug 31 12:20: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 9899216A4CE; Tue, 31 Aug 2004 12:20:26 +0000 (GMT) Received: from frontend1.messagingengine.com (frontend1.messagingengine.com [66.111.4.30]) by mx1.FreeBSD.org (Postfix) with ESMTP id 268A643D4C; Tue, 31 Aug 2004 12:20:25 +0000 (GMT) (envelope-from judmarc@fastmail.fm) Received: from server2.messagingengine.com (server2.internal [10.202.2.133]) by frontend1.messagingengine.com (Postfix) with ESMTP id 87EE6C15330; Tue, 31 Aug 2004 08:20:18 -0400 (EDT) Received: by server2.messagingengine.com (Postfix, from userid 99) id 3944484D5D; Tue, 31 Aug 2004 08:20:18 -0400 (EDT) Content-Disposition: inline Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="ISO-8859-1" MIME-Version: 1.0 X-Mailer: MIME::Lite 1.5 (F2.72; T1.001; A1.62; B3.01; Q3.01) References: <200408301318.40078.summer@computerdatasafe.com.au> <4133545B.5080704@daleco.biz> <4133A263.7050501@computerdatasafe.com.au> In-Reply-To: <4133A263.7050501@computerdatasafe.com.au> To: "John" Date: Tue, 31 Aug 2004 08:20:18 -0400 From: "Jud" X-Sasl-Enc: d3SOD5jTTH+9hisNdzf9SQ 1093954818 Message-Id: <1093954818.11664.203399878@webmail.messagingengine.com> cc: questions@freebsd.org cc: doc@freebsd.org Subject: Re: Which disk is which 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, 31 Aug 2004 12:20:26 -0000 On Tue, 31 Aug 2004 05:55:47 +0800, "John" said: > Kevin D. Kinsey, DaleCo, S.P. wrote: > > Hi, John ... > > > > As you cc'ed doc@, I'm sending your original mail to them > > also, so they'll have some background. Comments inline. > > > > John Summerfield wrote: > > > >> I've booted a 5.2.1 miniinstall CD and got to the point where I choose > >> which disk to install onto. > >> > >> My choices are > >> ad0 > >> da0 > >> > >> Great. How do I know which disk is which? _I_ could work it out if the > >> panel displayed information such as > >> Brand > >> Capacity > >> > >> > >> > > > > Read the *text* in the handbook. As an example, the following > > appears on the page that you linked in your recent crosspost to doc@: > > > > "Consider what would happen if you had two IDE hard disks, one > > as the master on the first IDE controller, and one as the master > > on the second IDE controller. If FreeBSD numbered these as it > > found them, as ad0 and ad1 then everything would work. > > > > But if you then added a third disk, as the slave device on the first > > IDE controller, it would now be ad1, and the previous ad1 would " .... > > > > <>This goes on for another 3-4 paragraphs; it is a discussion of why > > FreeBSD > > has basically "hardcoded" disk drive names/numbers into the kernel, (e.g., > > why IDE primary master will always be ad0, why secondary slave will always > > be ad3, etc). > > Then again, just above figure 2-16 (which is the same as figure 2-20 > > but without an "X" in the checkbox): > > > > Figure 2-16 > > > > shows an example from a system with two IDE disks. > > They have been called ad0 and ad2. > > > > > > Based on reading these sections/statements of the manual, it would seem > > somewhat obvious that ad0 is the primary master IDE hard disk. It is > > hard, then, at least for me, to see this as a fault of the documentation. > > > > > The drawback to this is that you're writing from the POV of someone who > knows all this. > > I'm not, I don't. > > I have booted some other installers on this setup and find they do > provide more information than the bare OS-dependant name. > > Ideally, on my system, the installer would say: > AD0 Internal IDE drive, primary master, WD102AA 10.2 Gb > DA0 External USB drive, Cypress ATMR04-0 40 Gb > > so most, even modestly, technical people could instantly recognise which > disk is which. Not my intent to join in beating you about the head and shoulders, but what some folks have been trying to say (perhaps tersely, granted) is that you're writing to people who (1) all have lots of things to do in the Real World(tm), (2) have far less idea of how you think the documentation should read than you do, and (3) if they share your ideas about what the installer should show, which is not certain, haven't had time to do anything about it. Particularly regarding the installer, it would appear that the change you want is either not trivial, not a priority, or both. Here's how you ought to proceed: Regarding the documentation, read the Handbook and any other sources you can find regarding submitting a "patch" (a requested change) to the docs, do so, and see if someone with authority to make ("commit") the change agrees with you. Regarding the installer, see if you can find someone (reading the freebsd-hackers mailing list might be a place to start) interested in and capable of making the types of changes you envision, who has time to spend on the project. Otherwise, things will remain as they are (actually not horrible from my point of view - absolutely there is a learning curve, but I strangely enjoy that sort of thing), since, as others have pointed out, you're dealing with volunteers. Hope this helps, Jud From owner-freebsd-doc@FreeBSD.ORG Tue Aug 31 20:58:25 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 4033C16A4CF for ; Tue, 31 Aug 2004 20:58:25 +0000 (GMT) Received: from smtp-send.myrealbox.com (smtp-send.myrealbox.com [192.108.102.143]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0029E43D4C for ; Tue, 31 Aug 2004 20:58:24 +0000 (GMT) (envelope-from lumsden@myrealbox.com) Received: from lumsden [154.32.142.224] by myrealbox.com with NetMail ModWeb Module; Tue, 31 Aug 2004 21:58:29 +0100 From: "mark" To: doc@FreeBSD.org Date: Tue, 31 Aug 2004 21:58:29 +0100 X-Mailer: NetMail ModWeb Module X-Sender: lumsden MIME-Version: 1.0 Message-ID: <1093985909.d6849c9clumsden@myrealbox.com> Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Subject: ipsec 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, 31 Aug 2004 20:58:25 -0000 hi, Just a small error I think, in the handbook at 14.10.3.2: ``If a packet leaves from A.B.C.D, and that packet is encapsulating another= packet, and it is destined for W.X.Y.Z, then encrypt it, using the neces= sary security associations.'' ``If a packet arrives from W.X.Y.Z, and that packet is encapsulating anothe= r packet, and it is destined for A.B.C.D, then encrypt it, using the nece= ssary security associations.'' I think the 2 lines above should read: ``If a packet leaves from A.B.C.D, and that packet is encapsulating another= packet, and it is destined for W.X.Y.Z, then encrypt it, using the neces= sary security associations.'' ``If a packet arrives from W.X.Y.Z, and that packet is encapsulating anothe= r packet, and it is destined for A.B.C.D, then _decrypt_ it, using the ne= cessary security associations.'' The change makes more sense especially when read with these 2 lines found i= n the handbook (just before the previous ones): `If a packet leaves from A.B.C.D, and it is destined for W.X.Y.Z, then >enc= rypt< it, using the necessary security associations.'' ``If a packet arrives from W.X.Y.Z, and it is destined for A.B.C.D, then >d= ecrypt< it, using the necessary security associations.'' Regards Mark From owner-freebsd-doc@FreeBSD.ORG Wed Sep 1 01:06:22 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8C79B16A4CE; Wed, 1 Sep 2004 01:06:22 +0000 (GMT) Received: from valentine.liquidneon.com (valentine.liquidneon.com [216.38.206.180]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5266443D5D; Wed, 1 Sep 2004 01:06:22 +0000 (GMT) (envelope-from so14k@so14k.com) Received: from localhost (localhost [127.0.0.1]) by valentine.liquidneon.com (Postfix) with ESMTP id 7B17A6D6; Tue, 31 Aug 2004 19:06:21 -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 52724-01; Tue, 31 Aug 2004 19:06:21 -0600 (MDT) Received: from webmail.liquidneon.com (valentine.liquidneon.com [216.38.206.180]) by valentine.liquidneon.com (Postfix) with ESMTP id 18D045D6; Tue, 31 Aug 2004 19:06:21 -0600 (MDT) Received: from 24.8.191.71 (SquirrelMail authenticated user so14k@so14k.com); by webmail.liquidneon.com with HTTP; Tue, 31 Aug 2004 19:06:21 -0600 (MDT) Message-ID: <52303.24.8.191.71.1094000781.squirrel@24.8.191.71> Date: Tue, 31 Aug 2004 19:06:21 -0600 (MDT) From: "Brad Davis" To: trhodes@FreeBSD.org, doc@freebsd.org User-Agent: SquirrelMail/1.4.3a X-Mailer: SquirrelMail/1.4.3a MIME-Version: 1.0 Content-Type: text/plain;charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Priority: 3 (Normal) Importance: Normal X-Virus-Scanned: by amavisd-new at liquidneon.com Subject: The New and Improved Firewall section :) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 01 Sep 2004 01:06:22 -0000 Hi All, Please feel free to rip this apart so I can put it together again. :) I need someone that has IPF and IPFW experience to check the technical details, as I lack the knowledge to do so myself. http://freebsd.so14k.com/firewall/firewalls.html Regards, Brad Davis From owner-freebsd-doc@FreeBSD.ORG Wed Sep 1 05:53:45 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 43C3E16A4CE for ; Wed, 1 Sep 2004 05:53:45 +0000 (GMT) Received: from t-rex.incirlik.af.mil (t-rex.incirlik.af.mil [132.27.151.12]) by mx1.FreeBSD.org (Postfix) with ESMTP id 758EE43D2F for ; Wed, 1 Sep 2004 05:53:13 +0000 (GMT) (envelope-from Ozgur.Ozdemircili@izmir.af.mil) Received: from t-rex.incirlik.af.mil (root@localhost) by t-rex.incirlik.af.mil with ESMTP id i815rAQ27957 for ; Wed, 1 Sep 2004 08:53:10 +0300 (EEST) Received: from inc-svr-navieg.incirlik.usafe.ds.af.mil (inc-svr-navieg.incirlik.af.mil [132.27.152.16]) by t-rex.incirlik.af.mil with SMTP id i815r9Y27953 for ; Wed, 1 Sep 2004 08:53:10 +0300 (EEST) Received: from izm-exch-01.incirlik.usafe.ds.af.mil ([132.27.180.200]) id M2004090108530818302 for ; Wed, 01 Sep 2004 08:53:08 +0300 Received: by izm-exch-01.incirlik.usafe.ds.af.mil with Internet Mail Service (5.5.2653.19) id ; Wed, 1 Sep 2004 08:53:09 +0300 Message-ID: <7373DB1CFB205549B6A952E10BE0E69075A297@izm-exch-01.incirlik.usafe.ds.af.mil> From: Ozdemircili Ozgur NMI Civ TR 425 ABS/SGST To: "'FreeBSD-doc@FreeBSD.org'" Date: Wed, 1 Sep 2004 08:53:08 +0300 MIME-Version: 1.0 X-Mailer: Internet Mail Service (5.5.2653.19) Content-Type: text/plain; charset="iso-8859-1" Subject: 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, 01 Sep 2004 05:53:45 -0000 Ozgur Ozdemircili 425 SG M.A.S Contact: 675-3236 From owner-freebsd-doc@FreeBSD.ORG Wed Sep 1 11:06:16 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id EE0E516A4CE; Wed, 1 Sep 2004 11:06:16 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id CF20643D41; Wed, 1 Sep 2004 11:06:16 +0000 (GMT) (envelope-from tjr@FreeBSD.org) Received: from freefall.freebsd.org (tjr@localhost [127.0.0.1]) i81B6GB9036615; Wed, 1 Sep 2004 11:06:16 GMT (envelope-from tjr@freefall.freebsd.org) Received: (from tjr@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i81B6GDB036611; Wed, 1 Sep 2004 11:06:16 GMT (envelope-from tjr) Date: Wed, 1 Sep 2004 11:06:16 GMT From: "Tim J. Robbins" Message-Id: <200409011106.i81B6GDB036611@freefall.freebsd.org> To: tmseck@netcologne.de, tjr@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/54391: Document that glob(3) respects LC_COLLATE 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, 01 Sep 2004 11:06:17 -0000 Synopsis: Document that glob(3) respects LC_COLLATE State-Changed-From-To: patched->closed State-Changed-By: tjr State-Changed-When: Wed Sep 1 11:03:53 GMT 2004 State-Changed-Why: glob() does not actually respect LC_COLLATE, and the change to the manual page has been backed out in -current. Your shell must not be using glob() from libc. http://www.freebsd.org/cgi/query-pr.cgi?pr=54391 From owner-freebsd-doc@FreeBSD.ORG Thu Sep 2 07:19:52 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B106116A4CE; Thu, 2 Sep 2004 07:19:52 +0000 (GMT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2AF8243D39; Thu, 2 Sep 2004 07:19:52 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost.pittgoth.com ([192.168.0.5]) (authenticated bits=0) by pittgoth.com (8.12.10/8.12.10) with ESMTP id i827Jp0p025648 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 2 Sep 2004 03:19:51 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Thu, 26 Aug 2004 17:13:58 -0400 From: Tom Rhodes To: Josh Paetzel Message-Id: <20040826171358.42d9da84@localhost.pittgoth.com> In-Reply-To: <200408260809.27146.josh@tcbug.org> References: <20040824211131.GK760@zaphod.nitro.dk> <1093383676.725.123.camel@localhost> <20040826124356.GD707@arthur.nitro.dk> <200408260809.27146.josh@tcbug.org> X-Mailer: Sylpheed-Claws 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd5.2) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org cc: "Simon L. Nielsen" Subject: Re: Tracking down devices in the Hardware Notes 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, 02 Sep 2004 07:19:52 -0000 On Thu, 26 Aug 2004 08:09:27 -0500 Josh Paetzel wrote: > On Thursday 26 August 2004 07:43, you wrote: > > On 2004.08.24 14:41:17 -0700, Bruce A. Mah wrote: > > > On Tue, 2004-08-24 at 14:11, Simon L. Nielsen wrote: > > > > While working on the Harware Notes I have found two device > > > > entries where I can't really determine which driver is supposed > > > > to support them. > > > > > > > > Both were in version 1.1 of common/dev.sgml and not in the old > > > > HARDWARE.TXT. I also tried grepping in the source tree, but > > > > that hasn't helped in finding in the guilty drivers... The > > > > devices are: > > > > > > > > Seagate ST01/02 SCSI controllers > > > > Future Domain 8xx/950 series SCSI controllers > > > > > > I just popped in disc1 from 4.1-RELEASE/i386 (the oldest CD-ROM > > > set in front of me right now [1]) and both of these devices are > > > mentioned in RELNOTES.TXT as being "not supported by the new CAM > > > subsystem". This was a time when the release notes listed > > > supported hardware, partially (but not completely) duplicating > > > HARDWARE.TXT. > > > > > > I'm not sure what the state of these devices are now, or what > > > drivers they were mapped to. But that gives you a pretty good > > > idea how old they are. If no one speaks up after a suitable > > > amount of time, I'd say just nuke 'em. :-) > > > > OK, thanks I think I will just poke -current and see if anybody > > knows these devices, and nuke them if not. > > > > > [1] It still had the shrink wrap on it until ten minutes ago. I > > > hope this wasn't like cutting the tag off a Beanie Baby. > > > > Hehe :-). > > I'm not sure if I'm following this thread correctly. :-/ > > The Future Domain 850/9** SCSI controllers haven't been supported > since the 2.x days. (Not really a big loss, they are 8 bit ISA > cards) > > -- > Thanks, > > Josh Paetzel > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Thu Sep 2 11:57:54 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 87EAC16A4CF; Thu, 2 Sep 2004 11:57:54 +0000 (GMT) Date: Thu, 2 Sep 2004 11:57:54 +0000 From: Murray Stokely To: doc@freebsd.org Message-ID: <20040902115754.GA3031@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D Subject: Maintaining two bibliographies 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, 02 Sep 2004 11:57:54 -0000 Is anyone interested in working on integrating the bibliography in doc/share/sgml/bibliography.sgml into the Handbook? It's been sitting there for several years now but it hasn't been added to the Handbook. It's not clear where I should add new bibliography entires. - Murray From owner-freebsd-doc@FreeBSD.ORG Thu Sep 2 12:34: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 B490F16A4CF; Thu, 2 Sep 2004 12:34:12 +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 65F4B43D31; Thu, 2 Sep 2004 12:34:12 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.42 (FreeBSD)) id 1C2qn4-0005iw-Tg; Thu, 02 Sep 2004 13:34:10 +0100 Date: Thu, 2 Sep 2004 13:34:10 +0100 From: Ceri Davies To: Murray Stokely Message-ID: <20040902123410.GI94956@submonkey.net> Mail-Followup-To: Ceri Davies , Murray Stokely , doc@freebsd.org References: <20040902115754.GA3031@hub.freebsd.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="JwB53PgKC5A7+0Ej" Content-Disposition: inline In-Reply-To: <20040902115754.GA3031@hub.freebsd.org> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: doc@freebsd.org Subject: Re: Maintaining two bibliographies 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, 02 Sep 2004 12:34:12 -0000 --JwB53PgKC5A7+0Ej Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, Sep 02, 2004 at 11:57:54AM +0000, Murray Stokely wrote: > Is anyone interested in working on integrating the bibliography in > doc/share/sgml/bibliography.sgml into the Handbook? It's been sitting > there for several years now but it hasn't been added to the Handbook. > It's not clear where I should add new bibliography entires. They've previously been added to both, so it would be good to reconcile them. Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --JwB53PgKC5A7+0Ej Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.6 (FreeBSD) iD8DBQFBNxNCocfcwTS3JF8RAhIZAKCjU1htXzCqjjeMG1O1MzD86CwobwCfXN8v xJ0wgekokfDt4vsG74MdYzA= =jaMC -----END PGP SIGNATURE----- --JwB53PgKC5A7+0Ej-- From owner-freebsd-doc@FreeBSD.ORG Thu Sep 2 14:12:55 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0679916A4CE for ; Thu, 2 Sep 2004 14:12:55 +0000 (GMT) Received: from mail.dkd.lt (mail.dkd.lt [82.135.148.91]) by mx1.FreeBSD.org (Postfix) with ESMTP id 548AB43D53 for ; Thu, 2 Sep 2004 14:12:54 +0000 (GMT) (envelope-from gadmin@dkd.lt) Received: from localhost (localhost [127.0.0.1]) by mail.dkd.lt (Postfix) with ESMTP id 98B851DB9BD for ; Thu, 2 Sep 2004 16:13:03 +0200 (EET) Received: from mail.dkd.lt ([127.0.0.1]) by localhost (dkd [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 20907-19 for ; Thu, 2 Sep 2004 16:12:47 +0200 (EET) Received: from gadmin (unknown [82.135.148.201]) by mail.dkd.lt (Postfix) with SMTP id AC3FF1DB767 for ; Thu, 2 Sep 2004 16:12:49 +0200 (EET) Message-ID: <000801c490f6$f006ab60$d2faa8c0@gadmin> From: "Soft Support" To: Date: Thu, 2 Sep 2004 17:12:52 +0300 MIME-Version: 1.0 X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 6.00.2800.1437 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1441 X-Virus-Scanned: by amavisd-new at dkd.lt Content-Type: text/plain; charset="koi8-r" Content-Transfer-Encoding: quoted-printable X-Content-Filtered-By: Mailman/MimeDel 2.1.1 Subject: License 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, 02 Sep 2004 14:12:55 -0000 Hello, i'm sorry my english is not very well. I need to know about FreeBSD licensing, how to use it? FreeBSD system is always Free?? Or for corporate using is this Not Free? Thank you! Best regards DKD From owner-freebsd-doc@FreeBSD.ORG Thu Sep 2 14:19:13 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 43F7116A4CE for ; Thu, 2 Sep 2004 14:19:13 +0000 (GMT) Received: from gandalf.online.bg (gandalf.online.bg [217.75.128.9]) by mx1.FreeBSD.org (Postfix) with SMTP id 9AB7443D60 for ; Thu, 2 Sep 2004 14:19:11 +0000 (GMT) (envelope-from roam@ringlet.net) Received: (qmail 6120 invoked from network); 2 Sep 2004 14:17:40 -0000 Received: from unknown (HELO straylight.m.ringlet.net) (217.75.134.254) by gandalf.online.bg with SMTP; 2 Sep 2004 14:17:40 -0000 Received: (qmail 86281 invoked by uid 1000); 2 Sep 2004 14:19:27 -0000 Date: Thu, 2 Sep 2004 17:19:27 +0300 From: Peter Pentchev To: Soft Support Message-ID: <20040902141927.GF1469@straylight.m.ringlet.net> Mail-Followup-To: Soft Support , freebsd-doc@FreeBSD.org References: <000801c490f6$f006ab60$d2faa8c0@gadmin> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="Pgaa2uWPnPrfixyx" Content-Disposition: inline In-Reply-To: <000801c490f6$f006ab60$d2faa8c0@gadmin> User-Agent: Mutt/1.5.6i cc: freebsd-doc@FreeBSD.org Subject: Re: License 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, 02 Sep 2004 14:19:13 -0000 --Pgaa2uWPnPrfixyx Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, Sep 02, 2004 at 05:12:52PM +0300, Soft Support wrote: > Hello, i'm sorry my english is not very well. > I need to know about FreeBSD licensing, how to use it? > FreeBSD system is always Free?? Or for corporate using is this Not Free? > Thank you! In the sense you're asking, it's always free. However, there are a couple of restrictions on software you distribute that includes parts of the FreeBSD code - but those restrictions mostly say that you should include the FreeBSD copyright, nothing more. http://www.FreeBSD.org/copyright/freebsd-license.html G'luck, Peter --=20 Peter Pentchev roam@ringlet.net roam@cnsys.bg roam@FreeBSD.org PGP key: http://people.FreeBSD.org/~roam/roam.key.asc Key fingerprint FDBA FD79 C26F 3C51 C95E DF9E ED18 B68D 1619 4553 Do you think anybody has ever had *precisely this thought* before? --Pgaa2uWPnPrfixyx Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.6 (FreeBSD) iD8DBQFBNyvv7Ri2jRYZRVMRAoKWAJ9/Lm8hSAJpieIP7uunMNxOwA+BUACfW3Zp PysJOMgOXMcYEYEsSAm5guc= =hkn0 -----END PGP SIGNATURE----- --Pgaa2uWPnPrfixyx-- From owner-freebsd-doc@FreeBSD.ORG Thu Sep 2 17:20:45 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8D17F16A4CE; Thu, 2 Sep 2004 17:20:45 +0000 (GMT) Received: from ns1.tiadon.com (SMTP.tiadon.com [69.27.132.161]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4A94143D45; Thu, 2 Sep 2004 17:20:45 +0000 (GMT) (envelope-from kdk@daleco.biz) Received: from [69.27.131.0] ([69.27.131.0]) by ns1.tiadon.com with Microsoft SMTPSVC(6.0.3790.0); Thu, 2 Sep 2004 12:20:10 -0500 Message-ID: <4137566A.2040106@daleco.biz> Date: Thu, 02 Sep 2004 12:20:42 -0500 From: "Kevin D. Kinsey, DaleCo, S.P." User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.7) Gecko/20040712 X-Accept-Language: en-us, en MIME-Version: 1.0 To: "Simon L. Nielsen" References: <200408310653.i7V6r36K006683@freefall.freebsd.org> In-Reply-To: <200408310653.i7V6r36K006683@freefall.freebsd.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-OriginalArrivalTime: 02 Sep 2004 17:20:10.0655 (UTC) FILETIME=[19CCF2F0:01C49111] cc: doc@freebsd.org Subject: Re: docs/71175: (PATCH) Bad link in "explaining BSD" article, (EN) 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, 02 Sep 2004 17:20:45 -0000 Simon L. Nielsen wrote: >Synopsis: (PATCH) Bad link in "explaining BSD" article, (EN) > >State-Changed-From-To: open->closed >State-Changed-By: simon >State-Changed-When: Tue Aug 31 06:52:00 GMT 2004 >State-Changed-Why: >Committed, thanks! > >BTW. small fixes like this one are also very important to make the >docs as good as possible :-). > >http://www.freebsd.org/cgi/query-pr.cgi?pr=71175 > > Yes; thank you. Do you mind if I ask a small & stupid question? I cvsup'ed doc-all and built the en tree. Now the article reads correctly in "article.html", but the "paginated" version "xN.html", "xNN.html" ... I think the last page is "x91.html", didn't get updated by the build. Just off the top of your head, do you have any idea what I did wrong? Kevin Kinsey From owner-freebsd-doc@FreeBSD.ORG Thu Sep 2 17:21:01 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id DC83116A4CF; Thu, 2 Sep 2004 17:21:01 +0000 (GMT) Date: Thu, 2 Sep 2004 17:21:01 +0000 From: Murray Stokely To: doc@freebsd.org Message-ID: <20040902172101.GB3031@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D Subject: [murray@FreeBSD.org: cvs commit: doc/share/mk doc.docbook.mk doc.project.mk doc.slides.mk] 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, 02 Sep 2004 17:21:02 -0000 FYI. "make clean" doesn't work right for HTML output because I don't see how to generate a manifest of the chunked files created by the XSLT stylesheets. Please let me know if you have experience with the DocBook slides DTD. doc.slides.mk could be extended in many ways to control what type of HTML or PDF is created. I think we first need some presentations in the tree, though. =) - Murray ----- Forwarded message from Murray Stokely ----- From: Murray Stokely Date: Thu, 2 Sep 2004 17:12:14 +0000 (UTC) To: doc-committers@FreeBSD.org, cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org Subject: cvs commit: doc/share/mk doc.docbook.mk doc.project.mk doc.slides.mk murray 2004-09-02 17:12:14 UTC FreeBSD doc repository Modified files: share/mk doc.docbook.mk doc.project.mk Added files: share/mk doc.slides.mk Log: Add support for building documents in our doc/ tree marked up in Norman Walsh's DocBook Slides DTD. This DTD offers the vocabulary of simplified DocBook for presentations. Initially, the supported output formats are PDF and HTML. XSL stylesheets are used so libxslt is required. PassiveTeX is used for the PDF generation to convert the XSL-FO directly to PDF. This commit moves various TeX definitions out of doc.docbook.mk and into doc.project.mk, since docbook is no longer the only back-end to utilize TeX. An example Makefile would look like : ---- DOCFORMAT= slides DOC= slides SRCS= slides.xml DOC_PREFIX?= ${.CURDIR}/../../.. .include "${DOC_PREFIX}/share/mk/doc.project.mk" --- And an example slides file (slides.xml) looks like : --- What's new in FreeBSD 5.3 FreeBSD 5.3 Introduction Slide Content --- You could then build the HTML and PDF versions of the slides by typing "make FORMATS='pdf html'". Enjoy. Please coordinate with doceng@ before importing any presentations to doc/. Revision Changes Path 1.117 +0 -5 doc/share/mk/doc.docbook.mk 1.21 +8 -0 doc/share/mk/doc.project.mk 1.1 +63 -0 doc/share/mk/doc.slides.mk (new) ----- End forwarded message ----- From owner-freebsd-doc@FreeBSD.ORG Thu Sep 2 17:41: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 E3A7D16A4CE for ; Thu, 2 Sep 2004 17:41:33 +0000 (GMT) Received: from ts2-c167.Nsk.dial.rol.ru (ts2-c167.Nsk.dial.rol.ru [195.239.107.167]) by mx1.FreeBSD.org (Postfix) with ESMTP id 97E7143D53 for ; Thu, 2 Sep 2004 17:41:31 +0000 (GMT) (envelope-from soft_development@fromru.com) Date: Thu, 2 Sep 2004 21:20:57 +0700 From: soft_development@fromru.com X-Mailer: The Bat! (v2.12.00) UNREG / CD5BF9353B3B7091 X-Priority: 3 (Normal) Message-ID: <1514383947.20040902212057@fromru.com> To: doc@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Subject: question X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: soft_development@fromru.com List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 02 Sep 2004 17:41:34 -0000 Hello, We are .NET, J2ME and Web software development company from Russia and we are interested in possible collaboration with your company. What we can offer: 1. Cost effective development of J2ME and SMS games and software. 2. Java, C#, C++ and PHP software development outsourcing. 3. Possibility to publish our complete games and other software. Could such kind of collaboration be interesting for your company? Whom I can speak about it? Thanks. Best regards, Ivan Losev, Senior sales manager From owner-freebsd-doc@FreeBSD.ORG Thu Sep 2 21:56: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 A187D16A4CE for ; Thu, 2 Sep 2004 21:56:28 +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 E60F143D1F for ; Thu, 2 Sep 2004 21:56:27 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id E785011AB6; Thu, 2 Sep 2004 23:56:25 +0200 (CEST) Date: Thu, 2 Sep 2004 23:56:25 +0200 From: "Simon L. Nielsen" To: "Kevin D. Kinsey, DaleCo, S.P." Message-ID: <20040902215625.GA760@zaphod.nitro.dk> References: <200408310653.i7V6r36K006683@freefall.freebsd.org> <4137566A.2040106@daleco.biz> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="SUOF0GtieIMvvwua" Content-Disposition: inline In-Reply-To: <4137566A.2040106@daleco.biz> User-Agent: Mutt/1.5.6i cc: doc@freebsd.org Subject: Re: docs/71175: (PATCH) Bad link in "explaining BSD" article, (EN) 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, 02 Sep 2004 21:56:28 -0000 --SUOF0GtieIMvvwua Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.09.02 12:20:42 -0500, Kevin D. Kinsey, DaleCo, S.P. wrote: > Simon L. Nielsen wrote: >=20 > >Synopsis: (PATCH) Bad link in "explaining BSD" article, (EN) > > > >State-Changed-From-To: open->closed > >State-Changed-By: simon > >State-Changed-When: Tue Aug 31 06:52:00 GMT 2004 > >State-Changed-Why:=20 > >Committed, thanks! > > > >BTW. small fixes like this one are also very important to make the > >docs as good as possible :-). > > Yes; thank you. Do you mind if I ask a small & stupid > question? Sure, I don't think it's really stupid, there is a bit in the FDP Primer - but not really that much. > I cvsup'ed doc-all and built the en tree. Now the article > reads correctly in "article.html", but the "paginated" version > "xN.html", "xNN.html" ... I think the last page is "x91.html", > didn't get updated by the build. Just off the top of your head, > do you have any idea what I did wrong? The doc build system supports many different types of output (HTML, HTML split/paginated, PS,PDF...). It takes quite long to build all types, so by default most articles only create HTML (single page) output. You have override it by settting the FORMATS variable for make. E.g.: make all FORMATS=3D"html html-split" to create both the single file HTML version and the split/paginated. --=20 Simon L. Nielsen FreeBSD Documentation Team --SUOF0GtieIMvvwua Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.5 (FreeBSD) iD8DBQFBN5cJh9pcDSc1mlERAv0/AJ93ExTlz12wMpTHCs2ysK2+Y5O7hACfSBvp Dpwbp30tXoM44LqiOzXqlT8= =1Nll -----END PGP SIGNATURE----- --SUOF0GtieIMvvwua-- From owner-freebsd-doc@FreeBSD.ORG Fri Sep 3 10:06:49 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 E899A16A4CE; Fri, 3 Sep 2004 10:06:49 +0000 (GMT) Received: from rosebud.otenet.gr (rosebud.otenet.gr [195.170.0.26]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2CDDA43D3F; Fri, 3 Sep 2004 10:06:49 +0000 (GMT) (envelope-from keramida@freebsd.org) Received: from orion.daedalusnetworks.priv (aris.bedc.ondsl.gr [62.103.39.226])i83A6jUI017830; Fri, 3 Sep 2004 13:06:46 +0300 Received: from orion.daedalusnetworks.priv (orion [127.0.0.1]) i83A6YiP012128; Fri, 3 Sep 2004 13:06:34 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost)i83A6Ymj012127; Fri, 3 Sep 2004 13:06:34 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Fri, 3 Sep 2004 13:06:34 +0300 From: Giorgos Keramidas To: Murray Stokely Message-ID: <20040903100634.GA12037@orion.daedalusnetworks.priv> References: <20040902115754.GA3031@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040902115754.GA3031@hub.freebsd.org> cc: doc@freebsd.org Subject: Re: Maintaining two bibliographies 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, 03 Sep 2004 10:06:50 -0000 On 2004-09-02 11:57, Murray Stokely wrote: > Is anyone interested in working on integrating the bibliography in > doc/share/sgml/bibliography.sgml into the Handbook? It's been sitting > there for several years now but it hasn't been added to the Handbook. > It's not clear where I should add new bibliography entires. I can do that. I already have some local patches that group bibliographic entries by language, which seems a bit more useful (i.e. all Chinese books together, then all Japanese, etc). From owner-freebsd-doc@FreeBSD.ORG Fri Sep 3 10:32:03 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id F36F816A4CE for ; Fri, 3 Sep 2004 10:32:02 +0000 (GMT) Received: from rosebud.otenet.gr (rosebud.otenet.gr [195.170.0.26]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4C63143D58 for ; Fri, 3 Sep 2004 10:32:02 +0000 (GMT) (envelope-from keramida@freebsd.org) Received: from orion.daedalusnetworks.priv (aris.bedc.ondsl.gr [62.103.39.226])i83AVwbq025258 for ; Fri, 3 Sep 2004 13:31:59 +0300 Received: from orion.daedalusnetworks.priv (orion [127.0.0.1]) i83AVlLX012273 for ; Fri, 3 Sep 2004 13:31:47 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost)i83AVlfG012272 for doc@freebsd.org; Fri, 3 Sep 2004 13:31:47 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Fri, 3 Sep 2004 13:31:47 +0300 From: Giorgos Keramidas To: doc@freebsd.org Message-ID: <20040903103147.GA12219@orion.daedalusnetworks.priv> References: <20040902115754.GA3031@hub.freebsd.org> <20040903100634.GA12037@orion.daedalusnetworks.priv> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040903100634.GA12037@orion.daedalusnetworks.priv> Subject: Re: Maintaining two bibliographies 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, 03 Sep 2004 10:32:03 -0000 On 2004-09-03 13:06, Giorgos Keramidas wrote: > On 2004-09-02 11:57, Murray Stokely wrote: > > Is anyone interested in working on integrating the bibliography in > > doc/share/sgml/bibliography.sgml into the Handbook? > [...] > > I can do that. I already have some local patches that group > bibliographic entries by language, which seems a bit more useful > (i.e. all Chinese books together, then all Japanese, etc). Before I make extensive changes to the bibliography chapter of the Handbook, I think that a call for translator feedback is necessary. One of the resulting formats that I've considered for this file is: Books and magazines English Books & Magazines ... Chinese Books & Magazines ... Japanese Books & Magazines ... The diff from the current version is going to be large if I make it look this way though. Essentially, it's going to be a rewrite of the chapter. My opinion is that this will look a bit better than what we have now, which looks like this: Books and Magazines International Books & Magazines ... Chinese Books & Magazines ... Japanese Books & Magazines ... English Language Books & Magazines ... The separation of international vs. language categories and English entries is not very clear and some entries are in seemingly random places[1]: [1] Take a look at this this entry, for instance: FreeBSD Install and Utilization Manual (in Japanese), published by Mainichi Communications Inc.. which is clearly a Japanese book, but is currently far apart from the rest of the Japanese books, between German books and an Indonesian book. Is a rewrite of this chapter too disruptive a change to make close to a release like we're now for the translation teams? From owner-freebsd-doc@FreeBSD.ORG Fri Sep 3 15:17:34 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id D61EE16A4CF; Fri, 3 Sep 2004 15:17:34 +0000 (GMT) Date: Fri, 3 Sep 2004 15:17:34 +0000 From: Murray Stokely To: Giorgos Keramidas Message-ID: <20040903151734.GA64167@hub.freebsd.org> References: <20040902115754.GA3031@hub.freebsd.org> <20040903100634.GA12037@orion.daedalusnetworks.priv> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040903100634.GA12037@orion.daedalusnetworks.priv> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: doc@freebsd.org Subject: Re: Maintaining two bibliographies 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, 03 Sep 2004 15:17:35 -0000 On Fri, Sep 03, 2004 at 01:06:34PM +0300, Giorgos Keramidas wrote: > I can do that. I already have some local patches that group > bibliographic entries by language, which seems a bit more useful > (i.e. all Chinese books together, then all Japanese, etc). Yea that would be great to have to maintain only one bibliography and have them grouped by language. thanks! - Murray From owner-freebsd-doc@FreeBSD.ORG Sat Sep 4 03:40: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 128C216A4D2 for ; Sat, 4 Sep 2004 03:40:28 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5ABD043D55 for ; Sat, 4 Sep 2004 03:40:20 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i843eKig023304 for ; Sat, 4 Sep 2004 03:40:20 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i843eKbi023303; Sat, 4 Sep 2004 03:40:20 GMT (envelope-from gnats) Resent-Date: Sat, 4 Sep 2004 03:40:20 GMT Resent-Message-Id: <200409040340.i843eKbi023303@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 459E816A4CE for ; Sat, 4 Sep 2004 03:31:47 +0000 (GMT) Received: from www.reppep.com (www.reppep.com [66.92.104.200]) by mx1.FreeBSD.org (Postfix) with ESMTP id F06CD43D5C for ; Sat, 4 Sep 2004 03:31:44 +0000 (GMT) (envelope-from pepper@reppep.com) Received: by www.reppep.com (Postfix, from userid 501) id 57909FE6F; Fri, 3 Sep 2004 23:31:44 -0400 (EDT) Message-Id: <20040904033144.57909FE6F@www.reppep.com> Date: Fri, 3 Sep 2004 23:31:44 -0400 (EDT) From: Chris Pepper To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 cc: Paul Mather Subject: docs/71359: /usr/share/examples/etc/make.conf contains broken CXXFLAGS 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: Sat, 04 Sep 2004 03:40:28 -0000 >Number: 71359 >Category: docs >Synopsis: /usr/share/examples/etc/make.conf contains broken CXXFLAGS >Confidential: no >Severity: serious >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Sep 04 03:40:19 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Chris Pepper >Release: FreeBSD 4.10-STABLE i386 >Organization: >Environment: System: FreeBSD www.reppep.com 4.10-STABLE FreeBSD 4.10-STABLE #16: Wed Jul 21 18:25:39 EDT 2004 root@www.reppep.com:/usr/obj/usr/src/sys/REPPEP i386 >Description: /usr/share/examples/etc/make.conf suggests: CXXFLAGS+= -fmemoize-lookups -fsave-memoized but this prevents make buildworld in RELENG_5. See also http://news.gw.com/freebsd.current/65460 . >How-To-Repeat: CXXFLAGS+= -fmemoize-lookups -fsave-memoized" >> /etc/make.conf && cd /usr/src && make buildworld >Fix: Remove this sample from the example, or replace it with one that's safe under RELENG_5 >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sat Sep 4 13:20:23 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C415F16A4CE for ; Sat, 4 Sep 2004 13:20:23 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id B014B43D4C for ; Sat, 4 Sep 2004 13:20:23 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i84DKNe5006623 for ; Sat, 4 Sep 2004 13:20:23 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i84DKNuG006622; Sat, 4 Sep 2004 13:20:23 GMT (envelope-from gnats) Date: Sat, 4 Sep 2004 13:20:23 GMT Message-Id: <200409041320.i84DKNuG006622@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Giorgos Keramidas Subject: Re: docs/71359: /usr/share/examples/etc/make.conf contains broken CXXFLAGS 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: Sat, 04 Sep 2004 13:20:23 -0000 The following reply was made to PR docs/71359; it has been noted by GNATS. From: Giorgos Keramidas To: Chris Pepper , Paul Mather Cc: bug-followup@freebsd.org Subject: Re: docs/71359: /usr/share/examples/etc/make.conf contains broken CXXFLAGS Date: Sat, 4 Sep 2004 15:46:52 +0300 On 2004-09-03 23:31, Chris Pepper wrote: > >Description: > /usr/share/examples/etc/make.conf suggests: > CXXFLAGS+= -fmemoize-lookups -fsave-memoized > but this prevents make buildworld in RELENG_5. > [...] > >Fix: > Remove this sample from the example, or replace it with one that's > safe under RELENG_5 You don't *have* to use the same CXXFLAGS options as the ones of the example. It's an example, after all. Anyway, would you prefer something like this instead? # CXXFLAGS controls the compiler settings used when compiling C++ code. # Note that CXXFLAGS is initially set to the value of CFLAGS. If you wish # to add to CXXFLAGS value, "+=" must be used rather than "=". Using "=" # alone will remove the often needed contents of CFLAGS from CXXFLAGS. +# For a description of the options recognized by the GNU C++ compiler +# please refer to the c++(1) manpage and the info documentation of GCC. # -#CXXFLAGS+= -fmemoize-lookups -fsave-memoized +#CXXFLAGS+= -O -pipe From owner-freebsd-doc@FreeBSD.ORG Sat Sep 4 16:30:23 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2B5A716A4D0 for ; Sat, 4 Sep 2004 16:30:23 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 03D7C43D4C for ; Sat, 4 Sep 2004 16:30:23 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i84GUM8k027499 for ; Sat, 4 Sep 2004 16:30:22 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i84GUMXt027498; Sat, 4 Sep 2004 16:30:22 GMT (envelope-from gnats) Date: Sat, 4 Sep 2004 16:30:22 GMT Message-Id: <200409041630.i84GUMXt027498@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Chris Pepper Subject: Re: docs/71359: /usr/share/examples/etc/make.conf contains broken CXXFLAGS 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: Sat, 04 Sep 2004 16:30:23 -0000 The following reply was made to PR docs/71359; it has been noted by GNATS. From: Chris Pepper To: Giorgos Keramidas Cc: Paul Mather , bug-followup@freebsd.org Subject: Re: docs/71359: /usr/share/examples/etc/make.conf contains broken CXXFLAGS Date: Sat, 4 Sep 2004 11:31:51 -0400 At 3:46 PM +0300 2004/09/04, Giorgos Keramidas wrote: >On 2004-09-03 23:31, Chris Pepper wrote: >> >Description: > > /usr/share/examples/etc/make.conf suggests: >> CXXFLAGS+= -fmemoize-lookups -fsave-memoized >> but this prevents make buildworld in RELENG_5. >> [...] >> >Fix: >> Remove this sample from the example, or replace it with one that's >> safe under RELENG_5 > >You don't *have* to use the same CXXFLAGS options as the ones of the >example. It's an example, after all. Anyway, would you prefer something >like this instead? Of course, but the examples should all be valid. This one prevents make buildworld, so should be replaced by something that doesn't. > # CXXFLAGS controls the compiler settings used when compiling C++ code. > # Note that CXXFLAGS is initially set to the value of CFLAGS. If you wish > # to add to CXXFLAGS value, "+=" must be used rather than "=". Using "=" > # alone will remove the often needed contents of CFLAGS from CXXFLAGS. > +# For a description of the options recognized by the GNU C++ compiler > +# please refer to the c++(1) manpage and the info documentation of GCC. > # > -#CXXFLAGS+= -fmemoize-lookups -fsave-memoized > +#CXXFLAGS+= -O -pipe Except that's provided already with the example of CFLAGS, so would make sense iff CFLAGS had another example value. # CFLAGS controls the compiler settings used when compiling C code. # Note that optimization settings other than -O and -O2 are not recommended # or supported for compiling the world or the kernel - please revert any # nonstandard optimization settings to "-O" before submitting bug reports # without patches to the developers. # Note also that at this time the -O2 setting is known to expose bugs in # libalias(3), and possibly other parts of the system. # #CFLAGS= -O -pipe # # CXXFLAGS controls the compiler settings used when compiling C++ code. # Note that CXXFLAGS is initially set to the value of CFLAGS. If you wish # to add to CXXFLAGS value, "+=" must be used rather than "=". Using "=" # alone will remove the often needed contents of CFLAGS from CXXFLAGS. # #CXXFLAGS+= -fmemoize-lookups -fsave-memoized Regards, Chris Pepper -- Chris Pepper: Rockefeller University: From owner-freebsd-doc@FreeBSD.ORG Sat Sep 4 17:50:27 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 25E6216A4CE for ; Sat, 4 Sep 2004 17:50:27 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1908943D31 for ; Sat, 4 Sep 2004 17:50:27 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i84HoQaL035445 for ; Sat, 4 Sep 2004 17: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 i84HoQtx035444; Sat, 4 Sep 2004 17:50:26 GMT (envelope-from gnats) Date: Sat, 4 Sep 2004 17:50:26 GMT Message-Id: <200409041750.i84HoQtx035444@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Giorgos Keramidas Subject: Re: docs/71359: /usr/share/examples/etc/make.conf contains broken CXXFLAGS 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: Sat, 04 Sep 2004 17:50:27 -0000 The following reply was made to PR docs/71359; it has been noted by GNATS. From: Giorgos Keramidas To: Chris Pepper Cc: Paul Mather , bug-followup@freebsd.org Subject: Re: docs/71359: /usr/share/examples/etc/make.conf contains broken CXXFLAGS Date: Sat, 4 Sep 2004 20:47:44 +0300 On 2004-09-04 11:31, Chris Pepper wrote: > > Of course, but the examples should all be valid. This one > prevents make buildworld, so should be replaced by something that > doesn't. True, true. > > # CXXFLAGS controls the compiler settings used when compiling C++ code. > > # Note that CXXFLAGS is initially set to the value of CFLAGS. If you > > wish > > # to add to CXXFLAGS value, "+=" must be used rather than "=". Using > > "=" > > # alone will remove the often needed contents of CFLAGS from CXXFLAGS. > > +# For a description of the options recognized by the GNU C++ compiler > > +# please refer to the c++(1) manpage and the info documentation of GCC. > > # > > -#CXXFLAGS+= -fmemoize-lookups -fsave-memoized > > +#CXXFLAGS+= -O -pipe > > Except that's provided already with the example of CFLAGS, so > would make sense iff CFLAGS had another example value. I don't use C++ so much, so perhaps I'm not the right person to choose a "nice set of default flags" for this. Any ideas from you, Chris? From owner-freebsd-doc@FreeBSD.ORG Sat Sep 4 23:40: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 4964716A4CE for ; Sat, 4 Sep 2004 23:40:28 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3896643D2D for ; Sat, 4 Sep 2004 23:40:28 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i84NeSAU074572 for ; Sat, 4 Sep 2004 23:40:28 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i84NeSPZ074571; Sat, 4 Sep 2004 23:40:28 GMT (envelope-from gnats) Date: Sat, 4 Sep 2004 23:40:28 GMT Message-Id: <200409042340.i84NeSPZ074571@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Chris Pepper Subject: Re: docs/71359: /usr/share/examples/etc/make.conf contains broken CXXFLAGS 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: Sat, 04 Sep 2004 23:40:28 -0000 The following reply was made to PR docs/71359; it has been noted by GNATS. From: Chris Pepper To: Giorgos Keramidas Cc: Paul Mather , bug-followup@freebsd.org Subject: Re: docs/71359: /usr/share/examples/etc/make.conf contains broken CXXFLAGS Date: Sat, 4 Sep 2004 19:31:32 -0400 At 8:47 PM +0300 2004/09/04, Giorgos Keramidas wrote: >On 2004-09-04 11:31, Chris Pepper wrote: >> >> Of course, but the examples should all be valid. This one >> prevents make buildworld, so should be replaced by something that >> doesn't. > >True, true. > >> > # CXXFLAGS controls the compiler settings used when compiling C++ code. >> > # Note that CXXFLAGS is initially set to the value of CFLAGS. If you >> > wish >> > # to add to CXXFLAGS value, "+=" must be used rather than "=". Using >> > "=" >> > # alone will remove the often needed contents of CFLAGS from CXXFLAGS. >> > +# For a description of the options recognized by the GNU C++ compiler >> > +# please refer to the c++(1) manpage and the info documentation of GCC. >> > # >> > -#CXXFLAGS+= -fmemoize-lookups -fsave-memoized > > > +#CXXFLAGS+= -O -pipe >> >> Except that's provided already with the example of CFLAGS, so >> would make sense iff CFLAGS had another example value. > >I don't use C++ so much, so perhaps I'm not the right person to choose a >"nice set of default flags" for this. > >Any ideas from you, Chris? No idea, sorry. If we don't have (get) one, it should probably be left blank (e.g., "#CXXFLAGS+="), and the explanation will have to serve. That would still be a substantial improvement over the current state of affairs. Chris Pepper -- Chris Pepper: Rockefeller University: