diff options
| author | Ludovic Courtès <ludo@gnu.org> | 2018-01-15 22:16:36 +0100 |
|---|---|---|
| committer | Ludovic Courtès <ludo@gnu.org> | 2018-01-15 23:29:33 +0100 |
| commit | 37af37dcc9a5d4fbb16540d5972fd5333043b413 (patch) | |
| tree | 1eea6ab48752c709efbc18f6f7be40bedcbd874d | |
| parent | f2bee4210ff7da38696d8e49999282e27b4a6364 (diff) | |
| download | guix-37af37dcc9a5d4fbb16540d5972fd5333043b413.tar guix-37af37dcc9a5d4fbb16540d5972fd5333043b413.tar.gz | |
doc: Deprecate 'bitlbee-service' procedure.
* gnu/services/messaging.scm (bitlbee-service): Mark as deprecated.
* doc/guix.texi (Messaging Services): Document 'bitlbee-service-type'
and 'bitlbee-configuration'. Remove 'bitlbee-service'.
| -rw-r--r-- | doc/guix.texi | 46 | ||||
| -rw-r--r-- | gnu/services/messaging.scm | 2 |
2 files changed, 35 insertions, 13 deletions
diff --git a/doc/guix.texi b/doc/guix.texi index be5577c20f..2f5749cbfb 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -14424,23 +14424,45 @@ string, you could instantiate a prosody service like this: @subsubheading BitlBee Service +@cindex IRC (Internet Relay Chat) +@cindex IRC gateway @url{http://bitlbee.org,BitlBee} is a gateway that provides an IRC interface to a variety of messaging protocols such as XMPP. -@deffn {Scheme Procedure} bitlbee-service [#:bitlbee bitlbee] @ - [#:interface "127.0.0.1"] [#:port 6667] @ - [#:extra-settings ""] -Return a service that runs @url{http://bitlbee.org,BitlBee}, a daemon that -acts as a gateway between IRC and chat networks. +@defvr {Scheme Variable} bitlbee-service-type +This is the service type for the @url{http://bitlbee.org,BitlBee} IRC +gateway daemon. Its value is a @code{bitlbee-configuration} (see +below). -The daemon will listen to the interface corresponding to the IP address -specified in @var{interface}, on @var{port}. @code{127.0.0.1} means that only -local clients can connect, whereas @code{0.0.0.0} means that connections can -come from any networking interface. +To have BitlBee listen on port 6667 on localhost, add this line to your +services: + +@example +(service bitlbee-service-type) +@end example +@end defvr + +@deftp {Data Type} bitlbee-configuration +This is the configuration for BitlBee, with the following fields: + +@table @asis +@item @code{interface} (default: @code{"127.0.0.1"}) +@itemx @code{port} (default: @code{6667}) +Listen on the network interface corresponding to the IP address +specified in @var{interface}, on @var{port}. + +When @var{interface} is @code{127.0.0.1}, only local clients can +connect; when it is @code{0.0.0.0}, connections can come from any +networking interface. + +@item @code{package} (default: @code{bitlbee}) +The BitlBee package to use. + +@item @code{extra-settings} (default: @code{""}) +Configuration snippet added as-is to the BitlBee configuration file. +@end table +@end deftp -In addition, @var{extra-settings} specifies a string to append to the -configuration file. -@end deffn @node Telephony Services @subsubsection Telephony Services diff --git a/gnu/services/messaging.scm b/gnu/services/messaging.scm index c0ccdbad33..427e2121f6 100644 --- a/gnu/services/messaging.scm +++ b/gnu/services/messaging.scm @@ -848,7 +848,7 @@ string, you could instantiate a prosody service like this: "Run @url{http://bitlbee.org,BitlBee}, a daemon that acts as a gateway between IRC and chat networks."))) -(define* (bitlbee-service #:key (bitlbee bitlbee) +(define* (bitlbee-service #:key (bitlbee bitlbee) ;deprecated (interface "127.0.0.1") (port 6667) (extra-settings "")) "Return a service that runs @url{http://bitlbee.org,BitlBee}, a daemon that |