From edwin@mavetju.org  Tue Mar 18 09:03:31 2008
Return-Path: <edwin@mavetju.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 78623106566B
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 18 Mar 2008 09:03:31 +0000 (UTC)
	(envelope-from edwin@mavetju.org)
Received: from mail5out.barnet.com.au (mail5.barnet.com.au [202.83.178.78])
	by mx1.freebsd.org (Postfix) with ESMTP id 3679D8FC2C
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 18 Mar 2008 09:03:31 +0000 (UTC)
	(envelope-from edwin@mavetju.org)
Received: by mail5out.barnet.com.au (Postfix, from userid 1001)
	id 3B8C82218A71; Tue, 18 Mar 2008 20:03:30 +1100 (EST)
Received: from mail5auth.barnet.com.au (mail5.barnet.com.au [202.83.178.78])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(Client CN "mail5auth.barnet.com.au", Issuer "*.barnet.com.au" (verified OK))
	by mail5.barnet.com.au (Postfix) with ESMTP id 0679A21B20DE
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 18 Mar 2008 20:03:30 +1100 (EST)
Received: from k7.mavetju (k7.mavetju.org [10.251.1.18])
	by mail5auth.barnet.com.au (Postfix) with ESMTP id B380A2218A6B
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 18 Mar 2008 20:03:29 +1100 (EST)
Received: by k7.mavetju (Postfix, from userid 1001)
	id 75ED222B; Tue, 18 Mar 2008 20:03:29 +1100 (EST)
Message-Id: <20080318090329.75ED222B@k7.mavetju>
Date: Tue, 18 Mar 2008 20:03:29 +1100 (EST)
From: Edwin Groothuis <edwin@mavetju.org>
Reply-To: Edwin Groothuis <edwin@mavetju.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] wpa_supplicant.conf.5 - provide pointer to sample configuration file 
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         121821
>Category:       docs
>Synopsis:       [patch] wpa_supplicant.conf.5 - provide pointer to sample configuration file
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    danger
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Mar 18 09:10:01 UTC 2008
>Closed-Date:    Tue Jan 06 12:40:05 UTC 2009
>Last-Modified:  Tue Jan  6 12:50:01 UTC 2009
>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 ,
>Release-Note:
>Audit-Trail:

From: John Baldwin <jhb@freebsd.org>
To: freebsd-doc@freebsd.org,
 Edwin Groothuis <edwin@mavetju.org>
Cc: FreeBSD-gnats-submit@freebsd.org,
 sam@freebsd.org
Subject: Re: docs/121821: [patch] wpa_supplicant.conf.5 - provide pointer to sample configuration file
Date: Tue, 18 Mar 2008 09:21:55 -0400

 > +.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.
 
 -- 
 John Baldwin

From: Sam Leffler <sam@freebsd.org>
To: John Baldwin <jhb@freebsd.org>
Cc: freebsd-doc@freebsd.org, Edwin Groothuis <edwin@mavetju.org>,
        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

 > 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.
 
     Sam
 
 
Responsible-Changed-From-To: freebsd-doc->danger 
Responsible-Changed-By: danger 
Responsible-Changed-When: Tue Jul 1 21:54:39 UTC 2008 
Responsible-Changed-Why:  
Track 

http://www.freebsd.org/cgi/query-pr.cgi?pr=121821 
State-Changed-From-To: open->patched 
State-Changed-By: danger 
State-Changed-When: Tue Jul 1 21:54:52 UTC 2008 
State-Changed-Why:  
I have moved the example configuration file to the share/examples/etc 
directory and added a corresponding FILES section to the man page. 
I hope it's sufficient solution for your PR. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=121821 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/121821: commit references a PR
Date: Tue,  1 Jul 2008 21:53:07 +0000 (UTC)

 danger      2008-07-01 21:52:49 UTC
 
   FreeBSD src repository
 
   Modified files:
     usr.sbin/wpa/wpa_supplicant Makefile wpa_supplicant.conf.5 
   Log:
   SVN rev 180158 on 2008-07-01 21:52:49Z by danger
   
   - install the example wpa_supplicant.conf file to the share/examples/etc
     directory [1]
   - add the FILES section to the wpa_supplicant.conf.5 file, so that people
     will be able to detect the example configuration file easier. [2]
   
   PR:             docs/121821 [2]
   Approved by:    brooks [1]
   MFC after:      3 days
   
   Revision  Changes    Path
   1.16      +1 -1      src/usr.sbin/wpa/wpa_supplicant/Makefile
   1.10      +5 -0      src/usr.sbin/wpa/wpa_supplicant/wpa_supplicant.conf.5
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/121821: commit references a PR
Date: Sat,  5 Jul 2008 11:08:55 +0000 (UTC)

 danger      2008-07-05 11:08:26 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_7)
     usr.sbin/wpa/wpa_supplicant Makefile wpa_supplicant.conf.5 
   Log:
   SVN rev 180290 on 2008-07-05 11:08:26Z by danger
   
   MFC r180158:
   
   - install the example wpa_supplicant.conf file to the share/examples/etc
     directory [1]
   - add the FILES section to the wpa_supplicant.conf.5 file, so that people
     will be able to detect the example configuration file easier. [2]
   
   PR:             docs/121821 [2]
   
   Revision  Changes    Path
   1.11.2.5  +1 -1      src/usr.sbin/wpa/wpa_supplicant/Makefile
   1.9.2.1   +5 -0      src/usr.sbin/wpa/wpa_supplicant/wpa_supplicant.conf.5
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: danger 
State-Changed-When: Tue Jan 6 12:39:35 UTC 2009 
State-Changed-Why:  
- the changes are now in RELENG_7 as well as RELENG_6 

http://www.freebsd.org/cgi/query-pr.cgi?pr=121821 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/121821: commit references a PR
Date: Tue,  6 Jan 2009 12:39:57 +0000 (UTC)

 Author: danger (doc committer)
 Date: Tue Jan  6 12:39:28 2009
 New Revision: 186816
 URL: http://svn.freebsd.org/changeset/base/186816
 
 Log:
   MFC r180158:
   
   - install the example wpa_supplicant.conf file to the share/examples/etc
     directory [1]
   - add the FILES section to the wpa_supplicant.conf.5 file, so that people
     will be able to detect the example configuration file easier. [2]
   
   PR:		docs/121821 [2]
   Submitted by:	edwin [2]
   Approved by:	brooks [1]
 
 Modified:
   stable/6/usr.sbin/wpa/   (props changed)
   stable/6/usr.sbin/wpa/wpa_supplicant/Makefile
   stable/6/usr.sbin/wpa/wpa_supplicant/wpa_supplicant.conf.5
 
 Modified: stable/6/usr.sbin/wpa/wpa_supplicant/Makefile
 ==============================================================================
 --- stable/6/usr.sbin/wpa/wpa_supplicant/Makefile	Tue Jan  6 12:23:19 2009	(r186815)
 +++ stable/6/usr.sbin/wpa/wpa_supplicant/Makefile	Tue Jan  6 12:39:28 2009	(r186816)
 @@ -11,6 +11,11 @@ SRCS=	config.c eloop.c common.c md5.c rc
  
  MAN=	wpa_supplicant.8 wpa_supplicant.conf.5
  
 +.if ${MK_EXAMPLES} != "no"
 +FILESDIR= ${SHAREDIR}/examples/etc
 +FILES=	wpa_supplicant.conf
 +.endif
 +
  CFLAGS+= -I${.CURDIR} -I${WPA_SUPPLICANT_DISTDIR}
  CFLAGS+= -DCONFIG_DRIVER_BSD
  CFLAGS+= -DCONFIG_DRIVER_NDIS
 
 Modified: stable/6/usr.sbin/wpa/wpa_supplicant/wpa_supplicant.conf.5
 ==============================================================================
 --- stable/6/usr.sbin/wpa/wpa_supplicant/wpa_supplicant.conf.5	Tue Jan  6 12:23:19 2009	(r186815)
 +++ stable/6/usr.sbin/wpa/wpa_supplicant/wpa_supplicant.conf.5	Tue Jan  6 12:39:28 2009	(r186816)
 @@ -514,6 +514,11 @@ network={
          wep_key0=42FEEDDEAFBABEDEAFBEEFAA55
  }
  .Ed
 +.Sh FILES
 +.Bl -tag -width ".Pa /usr/share/examples/etc/wpa_supplicant.conf" -compact
 +.It Pa /etc/wpa_supplicant.conf
 +.It Pa /usr/share/examples/etc/wpa_supplicant.conf
 +.El
  .Sh SEE ALSO
  .Xr wpa_cli 8 ,
  .Xr wpa_passphrase 8 ,
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
>Unformatted:
