01/05: doc: Show (service ...) form in 'home-openssh-service-type' example.

[guix-commits]

civodul pushed a commit to branch master
in repository guix.

commit 6337f62dde24ceaf50c25a0133346bba68c2d849
Author: Ludovic Courtès <ludo@gnu.org>
AuthorDate: Sun Jun 19 16:05:19 2022 +0200

    doc: Show (service ...) form in 'home-openssh-service-type' example.
    
    * doc/guix.texi (Secure Shell): Include the (service ...) form in the
    example.
---
 doc/guix.texi | 26 ++++++++++++++------------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 86348fc02c..43a5fc85bd 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -39718,18 +39718,20 @@ optionally providing a @file{~/.ssh/known_hosts} file 
so that @file{ssh}
 can authenticate hosts you connect to.
 @end itemize
 
-Here is a sample configuration you could add to the @code{services}
-field of your @code{home-environment}:
-
-@lisp
-(home-openssh-configuration
- (hosts (list (openssh-host (name "ci.guix.gnu.org")
-                            (user "charlie"))
-              (openssh-host (name "chbouib")
-                            (host-name "chbouib.example.org")
-                            (user "supercharlie")
-                            (port 10022))))
- (authorized-keys (list (local-file "alice.pub"))))
+Here is an example of a service and its configuration that you could add
+to the @code{services} field of your @code{home-environment}:
+
+@lisp
+(service home-openssh-service-type
+         (home-openssh-configuration
+          (hosts
+           (list (openssh-host (name "ci.guix.gnu.org")
+                               (user "charlie"))
+                 (openssh-host (name "chbouib")
+                               (host-name "chbouib.example.org")
+                               (user "supercharlie")
+                               (port 10022))))
+          (authorized-keys (list (local-file "alice.pub")))))
 @end lisp
 
 The example above lists two hosts and their parameters.  For instance,