* [bug#46421] [PATCH] doc: Expand sane-service-type documentation.
@ 2021-02-10 13:06 raid5atemyhomework via Guix-patches via
2021-02-21 12:21 ` raid5atemyhomework via Guix-patches via
2021-02-23 14:45 ` Nicolas Goaziou
0 siblings, 2 replies; 3+ messages in thread
From: raid5atemyhomework via Guix-patches via @ 2021-02-10 13:06 UTC (permalink / raw)
To: 46421
SANE documentation in `info guix` is lacking, this patch gives decent documentation about it. PLEASE merge soon, it's not like this is code.
From e0728dbab926e4670ec067865053331a02d5d171 Mon Sep 17 00:00:00 2001
From: raid5atemyhomework <raid5atemyhomework@protonmail.com>
Date: Wed, 10 Feb 2021 21:01:23 +0800
Subject: [PATCH] doc: Expand sane-service-type documentation.
* doc/guix.texi (sane-service-type): Move from between documentation
about geoclue, expand slightly.
(sane-backends-minimal): New description.
(sane-backends): New description, new example.
---
doc/guix.texi | 47 ++++++++++++++++++++++++++++++++++++++++-------
1 file changed, 40 insertions(+), 7 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index 7d18703283..7b9145aa06 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -19178,6 +19178,46 @@ tool. See @uref{https://www.freedesktop.org/software/colord/, the colord web
site} for more information.
@end deffn
+@cindex scanner access
+@defvr {Scheme Variable} sane-service-type
+This service provides access to scanners @i{via}
+@uref{http://www.sane-project.org, SANE} by installing the necessary udev
+rules. This service is already included in @code{%desktop-services} with
+@code{sane-backends-minimal} configured.
+@end defvr
+
+@defvr {Scheme Variable} sane-backends-minimal
+The default package which the @code{sane-service-type} will install, this will
+support many recent scanners out-of-the-box.
+@end defvr
+
+@defvr {Scheme Variable} sane-backends
+A package which includes support for all scanners that @code{sane-backends-minimal}
+supports, plus older Hewlett-Packard scanners supported by @code{hplip}. In order
+to use this on a system which uses @code{%desktop-services}, you can use
+@code{modify-services} to change the @code{sane-service-type} configuration:
+
+@lisp
+(use-modules (gnu))
+(use-service-modules
+ ; @dots{}
+ desktop)
+(use-package-modules
+ ; @dots{}
+ scanner)
+
+(operating-system
+ ;; @dots{}
+ (services
+ (append
+ ;; @dots{}
+ (modify-services %desktop-services
+ (sane-service-type _ => sane-backends))))
+ ;; @dots{}
+ )
+@end lisp
+@end defvr
+
@deffn {Scheme Procedure} geoclue-application name [#:allowed? #t] [#:system? #f] [#:users '()]
Return a configuration allowing an application to access GeoClue
location data. @var{name} is the Desktop ID of the application, without
@@ -19189,13 +19229,6 @@ this application is allowed location info access. An empty users list
means that all users are allowed.
@end deffn
-@cindex scanner access
-@deffn {Scheme Procedure} sane-service-type
-This service provides access to scanners @i{via}
-@uref{http://www.sane-project.org, SANE} by installing the necessary udev
-rules.
-@end deffn
-
@defvr {Scheme Variable} %standard-geoclue-applications
The standard list of well-known GeoClue application configurations,
granting authority to the GNOME date-and-time utility to ask for the
--
2.30.0
^ permalink raw reply related [flat|nested] 3+ messages in thread
* [bug#46421] [PATCH] doc: Expand sane-service-type documentation.
2021-02-10 13:06 [bug#46421] [PATCH] doc: Expand sane-service-type documentation raid5atemyhomework via Guix-patches via
@ 2021-02-21 12:21 ` raid5atemyhomework via Guix-patches via
2021-02-23 14:45 ` Nicolas Goaziou
1 sibling, 0 replies; 3+ messages in thread
From: raid5atemyhomework via Guix-patches via @ 2021-02-21 12:21 UTC (permalink / raw)
To: 46421@debbugs.gnu.org
Hi Guix reviewers,
Please review and merge.
Thanks
raid5atemyhomework
^ permalink raw reply [flat|nested] 3+ messages in thread
* [bug#46421] [PATCH] doc: Expand sane-service-type documentation.
2021-02-10 13:06 [bug#46421] [PATCH] doc: Expand sane-service-type documentation raid5atemyhomework via Guix-patches via
2021-02-21 12:21 ` raid5atemyhomework via Guix-patches via
@ 2021-02-23 14:45 ` Nicolas Goaziou
1 sibling, 0 replies; 3+ messages in thread
From: Nicolas Goaziou @ 2021-02-23 14:45 UTC (permalink / raw)
To: 46421; +Cc: raid5atemyhomework, 46421-done
Hello,
raid5atemyhomework via Guix-patches via <guix-patches@gnu.org> writes:
> SANE documentation in `info guix` is lacking, this patch gives decent
> documentation about it.
Thank you!
I applied it with minor tweaks. Please let me know if it makes your
original text less clear.
> PLEASE merge soon, it's not like this is code.
That's true, this is not code. Yet, I think documentation requires as
much care, albeit for different reasons.
Regards,
--
Nicolas Goaziou
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2021-02-23 14:46 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2021-02-10 13:06 [bug#46421] [PATCH] doc: Expand sane-service-type documentation raid5atemyhomework via Guix-patches via
2021-02-21 12:21 ` raid5atemyhomework via Guix-patches via
2021-02-23 14:45 ` Nicolas Goaziou
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/guix.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).