[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
06/07: doc: Deprecate 'bitlbee-service' procedure.
From: |
Ludovic Courtès |
Subject: |
06/07: doc: Deprecate 'bitlbee-service' procedure. |
Date: |
Mon, 15 Jan 2018 17:29:41 -0500 (EST) |
civodul pushed a commit to branch master
in repository guix.
commit 37af37dcc9a5d4fbb16540d5972fd5333043b413
Author: Ludovic Courtès <address@hidden>
Date: Mon Jan 15 22:16:36 2018 +0100
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'.
---
doc/guix.texi | 46 ++++++++++++++++++++++++++++++++++------------
gnu/services/messaging.scm | 2 +-
2 files changed, 35 insertions(+), 13 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index be5577c..2f5749c 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
address@hidden IRC (Internet Relay Chat)
address@hidden IRC gateway
@url{http://bitlbee.org,BitlBee} is a gateway that provides an IRC
interface to a variety of messaging protocols such as XMPP.
address@hidden {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.
address@hidden {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:
+
address@hidden
+(service bitlbee-service-type)
address@hidden example
address@hidden defvr
+
address@hidden {Data Type} bitlbee-configuration
+This is the configuration for BitlBee, with the following fields:
+
address@hidden @asis
address@hidden @code{interface} (default: @code{"127.0.0.1"})
address@hidden @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.
+
address@hidden @code{package} (default: @code{bitlbee})
+The BitlBee package to use.
+
address@hidden @code{extra-settings} (default: @code{""})
+Configuration snippet added as-is to the BitlBee configuration file.
address@hidden table
address@hidden deftp
-In addition, @var{extra-settings} specifies a string to append to the
-configuration file.
address@hidden deffn
@node Telephony Services
@subsubsection Telephony Services
diff --git a/gnu/services/messaging.scm b/gnu/services/messaging.scm
index c0ccdba..427e212 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
- branch master updated (b640370 -> c181636), Ludovic Courtès, 2018/01/15
- 01/07: offload: Look at machine loads for the past minute., Ludovic Courtès, 2018/01/15
- 03/07: ui: Disable '%fresh-auto-compile' only for Guile 2.2.3., Ludovic Courtès, 2018/01/15
- 07/07: services: bitlbee: Add test., Ludovic Courtès, 2018/01/15
- 02/07: doc: Connect "guix archive", "guix pack", and co., Ludovic Courtès, 2018/01/15
- 06/07: doc: Deprecate 'bitlbee-service' procedure.,
Ludovic Courtès <=
- 04/07: linux-container: Work around EBADF errors upon exit., Ludovic Courtès, 2018/01/15
- 05/07: services: bitlbee: Move to (gnu services messaging)., Ludovic Courtès, 2018/01/15