01/01: doc: Document 'wpa-supplicant-service-type'.

[Ludovic Courtès]

civodul pushed a commit to branch master
in repository guix.

commit cbf1024e9907c7402e66c0c225dba7406fbd82e8
Author: Ludovic Courtès <address@hidden>
Date:   Thu Nov 24 21:53:57 2016 +0100

    doc: Document 'wpa-supplicant-service-type'.
    
    Reported by Chris Marusich <address@hidden>.
    
    * doc/guix.texi (Networking Services): Remove 'wpa-supplicant-service'
    procedure, which doesn't exist, and document
    'wpa-supplicant-service-type'.
---
 doc/guix.texi |   19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 0055d09..4d9c107 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -8431,13 +8431,22 @@ configure networking."
 @end deffn
 
 @cindex WPA Supplicant
address@hidden {Scheme Procedure} wpa-supplicant-service @
-       [#:wpa-supplicant @var{wpa-supplicant}]
-Return a service that runs @url{https://w1.fi/wpa_supplicant/,WPA
address@hidden {Scheme Variable} wpa-supplicant-service-type
+This is the service type to run @url{https://w1.fi/wpa_supplicant/,WPA
 supplicant}, an authentication daemon required to authenticate against
-encrypted WiFi or ethernet networks. Service is started to listen for
+encrypted WiFi or ethernet networks.  It is configured to listen for
 requests on D-Bus.
address@hidden deffn
+
+The value of this service is the @code{wpa-supplicant} package to use.
+Thus, it can be instantiated like this:
+
address@hidden
+(use-modules (gnu services networking)
+             (gnu packages admin))
+
+(service wpa-supplicant-type wpa-supplicant)
address@hidden lisp
address@hidden defvr
 
 @cindex NTP
 @cindex real time clock