From owner-freebsd-doc@FreeBSD.ORG Wed Mar 19 13:24:54 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B6FB9106566B; Wed, 19 Mar 2008 13:24:54 +0000 (UTC) (envelope-from jhb@freebsd.org) Received: from elvis.mu.org (elvis.mu.org [192.203.228.196]) by mx1.freebsd.org (Postfix) with ESMTP id 9B8EF8FC1E; Wed, 19 Mar 2008 13:24:54 +0000 (UTC) (envelope-from jhb@freebsd.org) Received: from zion.baldwin.cx (66-23-211-162.clients.speedfactory.net [66.23.211.162]) by elvis.mu.org (Postfix) with ESMTP id 946541A4D84; Wed, 19 Mar 2008 06:23:31 -0700 (PDT) From: John Baldwin To: freebsd-doc@freebsd.org, Sam Leffler Date: Wed, 19 Mar 2008 09:13:23 -0400 User-Agent: KMail/1.9.7 References: <200803182140.m2ILe446017411@freefall.freebsd.org> In-Reply-To: <200803182140.m2ILe446017411@freefall.freebsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-15" Content-Transfer-Encoding: 7bit Content-Disposition: inline Message-Id: <200803190913.24046.jhb@freebsd.org> Cc: Subject: Re: docs/121821: [patch] wpa_supplicant.conf.5 - provide pointer to sample configuration file X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 19 Mar 2008 13:24:54 -0000 On Tuesday 18 March 2008 05:40:04 pm Sam Leffler wrote: > The following reply was made to PR docs/121821; it has been noted by GNATS. > > From: Sam Leffler > To: John Baldwin > Cc: freebsd-doc@freebsd.org, Edwin Groothuis , > FreeBSD-gnats-submit@freebsd.org > Subject: Re: docs/121821: [patch] wpa_supplicant.conf.5 - provide pointer > to sample configuration file > Date: Tue, 18 Mar 2008 14:18:52 -0700 > > John Baldwin wrote: > > On Tuesday 18 March 2008 05:03:29 am Edwin Groothuis wrote: > >>> Number: 121821 > >>> Category: docs > >>> Synopsis: [patch] wpa_supplicant.conf.5 - provide pointer to > >>> sample configuration file Confidential: no > >>> Severity: non-critical > >>> Priority: low > >>> Responsible: freebsd-doc > >>> State: open > >>> Quarter: > >>> Keywords: > >>> Date-Required: > >>> Class: change-request > >>> Submitter-Id: current-users > >>> Arrival-Date: Tue Mar 18 09:10:01 UTC 2008 > >>> Closed-Date: > >>> Last-Modified: > >>> Originator: Edwin Groothuis > >>> Release: FreeBSD 6.3-RELEASE i386 > >>> Organization: > >> > >> - > >> > >>> Environment: > >> > >> System: FreeBSD k7.mavetju 6.3-RELEASE FreeBSD 6.3-RELEASE #0: Sun Feb > >> 17 22:11:52 EST 2008 edwin@k7.mavetju:/usr/src/sys/i386/compile/SMP > >> i386 > >> > >>> Description: > >> > >> It took me a while to figure out how to properly use a WEP (silly > >> Nintendo DS doesn't know about WPA so I needed to reconfigure my > >> network) configuration. Once I had read through the wpa_supplicant.conf > >> in /usr/src/contrib/wpa_supplicant it was clear at once. > >> > >>> How-To-Repeat: > >>> Fix: > >> > >> Index: wpa_supplicant.conf.5 > >> =================================================================== > >> RCS file: > >> /home/ncvs/src/usr.sbin/wpa/wpa_supplicant/wpa_supplicant.conf.5,v > >> retrieving revision 1.9 > >> diff -u -r1.9 wpa_supplicant.conf.5 > >> --- wpa_supplicant.conf.5 11 Jul 2007 16:04:08 -0000 1.9 > >> +++ wpa_supplicant.conf.5 18 Mar 2008 08:59:02 -0000 > >> @@ -518,6 +518,11 @@ > >> wep_key0=42FEEDDEAFBABEDEAFBEEFAA55 > >> } > >> .Ed > >> +.Pp > >> +More examples can be found in the supplied > >> +.Pa wpa_supplicant.conf > >> +in > >> +.Pa /usr/src/contrib/wpa_supplicant/ . > >> .Sh SEE ALSO > >> .Xr wpa_cli 8 , > >> .Xr wpa_passphrase 8 , > > > > This should > > reference /usr/share/examples/etc/wpa_supplicant/wpa_supplicant.conf > > instead since HEAD installs it there and /usr/src/ is not installed on > > all machines. > > > > BTW, it seems to me that wpa_supplicant.conf should just go > > in /usr/share/examples/etc/ since it lives in /etc and is only a single > > file rather than having its own subdirectory. > > I believe there were other files that could go in examples and/or I > followed existing practice from another app. But feel free to change it. Hmm, so there is the src/contrib/wpa_supplicant/examples subdirectory which contains some simple examples. Do you think those are suitable to install? Also, my path above is wrong it is /usr/share/examples/wpa_supplicant (no etc) which is quite common among other apps and I wouldn't move it from there. A nested directory in etc would have been odd, but that isn't the case. :) -- John Baldwin