civodul pushed a commit to branch master
in repository shepherd.
commit 853d1a0eb357f2e8c02d0e0848363320055f8926
Author: Ludovic Courtès <[email protected]>
AuthorDate: Tue Apr 11 21:46:09 2023 +0200
service: Turn 'doc' method into a procedure.
* modules/shepherd/service.scm (doc): Rename to...
(display-service-documentation): ... this. Turn into a regular
procedure. Keep private.
(action): Adjust accordingly.
---
modules/shepherd/service.scm | 19 +++++++++----------
1 file changed, 9 insertions(+), 10 deletions(-)
diff --git a/modules/shepherd/service.scm b/modules/shepherd/service.scm
index 60e8f79..769828f 100644
--- a/modules/shepherd/service.scm
+++ b/modules/shepherd/service.scm
@@ -77,7 +77,6 @@
start-in-the-background
stop
action
- doc
lookup-running
for-each-service
@@ -870,7 +869,7 @@ is not already running, and will return SERVICE's canonical
name in a list."
(service-canonical-name obj))))
((doc)
(lambda (_ . args)
- (apply doc obj args)))
+ (apply display-service-documentation obj args)))
(else
(lambda _
;; FIXME: Unknown service.
@@ -909,34 +908,34 @@ is not already running, and will return SERVICE's
canonical name in a list."
(report-exception the-action obj key args)))))))
;; Display documentation about the service.
-(define-method (doc (obj <service>) . args)
+(define (display-service-documentation service . args)
(if (null? args)
;; No further argument given -> Normal level of detail.
- (local-output (service-documentation obj))
+ (local-output (service-documentation service))
(case (string->symbol (car args)) ;; Does not work with strings.
((full)
;; FIXME
- (local-output (service-documentation obj)))
+ (local-output (service-documentation service)))
((short)
;; FIXME
- (local-output (service-documentation obj)))
+ (local-output (service-documentation service)))
((action)
;; Display documentation of given actions.
(for-each
(lambda (the-action)
(let ((action-object
- (lookup-service-action obj (string->symbol the-action))))
+ (lookup-service-action service (string->symbol the-action))))
(unless action-object
(raise (condition (&unknown-action-error
(action the-action)
- (service obj)))))
+ (service service)))))
(local-output "~a: ~a" the-action
(action-documentation action-object))))
(cdr args)))
((list-actions)
(local-output "~a ~a"
- (service-canonical-name obj)
- (action-list obj)))
+ (service-canonical-name service)
+ (action-list service)))
(else
;; FIXME: Implement doc-help.
(local-output (l10n "Unknown keyword. Try 'doc root help'."))))))