05/07: doc: Expound on inputattach service.

[guix-commits]

civodul pushed a commit to branch master
in repository guix.

commit 62b86d66fdfd045956a8fd15ba6733ebef054ebc
Author: Ludovic Courtès <address@hidden>
Date:   Mon Mar 18 10:22:57 2019 +0100

    doc: Expound on inputattach service.
    
    * doc/guix.texi (Miscellaneous Services): Expound documentation of
    inputattach service.
---
 doc/guix.texi | 28 ++++++++++++++++++++--------
 1 file changed, 20 insertions(+), 8 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 601afed..63581bb 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -22506,19 +22506,31 @@ resolution when the graphical console window resizes.
 @cindex inputattach
 @subsubheading inputattach Service
 
address@hidden tablet input, for Xorg
address@hidden touchscreen input, for Xorg
+The @uref{https://linuxwacom.github.io/, inputattach} service allows you to
+use input devices such as Wacom tablets, touchscreens, or joysticks with the
+Xorg display server.
+
address@hidden {Scheme Variable} inputattach-service-type
+Type of a service that runs @command{inputattach} on a device and
+dispatches events from it.
address@hidden deffn
+
 @deftp {Data Type} inputattach-configuration
 @table @asis
address@hidden @code{device-type} The type of device to connect to.
address@hidden @code{device} The device file to connect to the device.
address@hidden @code{log-file} The file to log messages to.
address@hidden @code{device-type} (default: @code{"wacom"})
+The type of device to connect to.  Run @command{inputattach --help}, from the
address@hidden package, to see the list of supported device types.
+
address@hidden @code{device} (default: @code{"/dev/ttyS0"})
+The device file to connect to the device.
+
address@hidden @code{log-file} (default: @code{#f})
+If true, this must be the name of a file to log messages to.
 @end table
 @end deftp
 
address@hidden {Scheme Procedure} inputattach-service-type
-Return a service that runs inputattach on a device and
-dispatches events from it.
address@hidden deffn
-
 @subsection Dictionary Services
 @cindex dictionary
 The @code{(gnu services dict)} module provides the following service: