Variable: rcirc-server-alist

rcirc-server-alist is a customizable variable defined in rcirc.el.gz.

Value

(("irc.libera.chat" :channels ("#emacs" "#rcirc") :port 6697
  :encryption tls))

Documentation

An alist of IRC connections to establish when running rcirc.

Each element looks like (SERVER-NAME PARAMETERS).

SERVER-NAME is a string describing the server to connect to.

The optional PARAMETERS come in pairs PARAMETER VALUE.

The following parameters are recognized:

:nick

VALUE must be a string. If absent, rcirc-default-nick is used for this connection.

:port

VALUE must be a number or string. If absent, rcirc-default-port is used.

:user-name

VALUE must be a string. If absent, rcirc-default-user-name is used.

:password

VALUE must be a string. If absent, no PASS command will be sent to the server.

:full-name

VALUE must be a string. If absent, rcirc-default-full-name is used.

:channels

VALUE must be a list of strings describing which channels to join when connecting to this server. If absent, no channels will be connected to automatically.

:encryption

VALUE must be plain (the default) for unencrypted connections, or tls for connections using SSL/TLS.

:server-alias

VALUE must be a string that will be used instead of the server name for display purposes. If absent, the real server name will be displayed instead.

This variable was added, or its default value changed, in Emacs 28.1.

Probably introduced at or before Emacs version 28.1.

Source Code

;; Defined in /usr/src/emacs/lisp/net/rcirc.el.gz
(defcustom rcirc-server-alist
  (if (gnutls-available-p)
      '(("irc.libera.chat" :channels ("#emacs" "#rcirc")
         :port 6697 :encryption tls))
    '(("irc.libera.chat" :channels ("#emacs" "#rcirc"))))
  "An alist of IRC connections to establish when running `rcirc'.
Each element looks like (SERVER-NAME PARAMETERS).

SERVER-NAME is a string describing the server to connect
to.

The optional PARAMETERS come in pairs PARAMETER VALUE.

The following parameters are recognized:

`:nick'

VALUE must be a string.  If absent, `rcirc-default-nick' is used
for this connection.

`:port'

VALUE must be a number or string.  If absent,
`rcirc-default-port' is used.

`:user-name'

VALUE must be a string.  If absent, `rcirc-default-user-name' is
used.

`:password'

VALUE must be a string.  If absent, no PASS command will be sent
to the server.

`:full-name'

VALUE must be a string.  If absent, `rcirc-default-full-name' is
used.

`:channels'

VALUE must be a list of strings describing which channels to join
when connecting to this server.  If absent, no channels will be
connected to automatically.

`:encryption'

VALUE must be `plain' (the default) for unencrypted connections, or `tls'
for connections using SSL/TLS.

`:server-alias'

VALUE must be a string that will be used instead of the server
name for display purposes.  If absent, the real server name will
be displayed instead."
  :type '(alist :key-type string
                :value-type (plist :options
                                   ((:nick string)
                                    (:port integer)
                                    (:user-name string)
                                    (:password string)
                                    (:full-name string)
                                    (:channels (repeat string))
                                    (:encryption (choice (const tls)
                                                         (const plain)))
                                    (:server-alias string))))
  :version "28.1")