[Emacs-diffs] Changes to emacs/doc/misc/rcirc.texi,v

[Alex Schroeder]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Alex Schroeder <as>     07/12/20 21:47:03

Index: rcirc.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/rcirc.texi,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -b -r1.3 -r1.4
--- rcirc.texi  20 Dec 2007 13:28:42 -0000      1.3
+++ rcirc.texi  20 Dec 2007 21:47:02 -0000      1.4
@@ -435,68 +435,98 @@
 liking.
 
 @table @code
address@hidden rcirc-default-server
address@hidden rcirc-default-server
-the default server to connect to.
address@hidden rcirc-server-alist
address@hidden rcirc-server-alist
address@hidden channels, configuration
address@hidden initial channels, configuration
address@hidden startup channels, configuration
address@hidden servers, configuration
address@hidden initial servers, configuration
address@hidden startup servers, configuration
+This variable contains an alist of servers to connect to by default and
+the keywords parameters to use. The keyword parameters are optional. If
+you don't provide any, the defaults as documented below will be used.
 
address@hidden rcirc-default-port
address@hidden rcirc-default-port
-the default port to connect to.
+The most important parameter is the @code{:channels} parameter. It
+controls which channels you will join by default as soon as you are
+connected to the server.
+
+Here's an example of how to set it:
+
address@hidden
+(add-to-list 'rcirc-server-alist
+             '("otherworlders.org"
+               :channels ("#FUDGE" "#game-design")))
address@hidden example
+
+By default you will be connected to the @code{rcirc} support channel:
address@hidden on @code{irc.freenode.net}.
+
address@hidden @code
address@hidden :nick
+This overrides @code{rcirc-default-nick}.
+
address@hidden :port
+This overrides @code{rcirc-default-port}.
+
address@hidden :user-name
+This overrides @code{rcirc-default-user-name}.
+
address@hidden :full-name
+This overrides @code{rcirc-default-full-name}.
+
address@hidden :channels
+This describes which channels to join when connecting to the server. If
+absent, no channels will be connected to automatically.
+
address@hidden table
 
 @item rcirc-default-nick
 @vindex rcirc-default-nick
-the default nick to use.
address@hidden table
+This variable is used for the default nick. It defaults to the login
+name returned by @code{user-login-name}.
 
 @example
-(setq rcirc-default-server "irc.mozilla.org"
-      rcirc-default-port 6666
-      rcirc-default-nick "alx")
+(setq rcirc-default-nick "kensanata")
 @end example
 
address@hidden rcirc-default-port
address@hidden rcirc-default-port
address@hidden port
+This variable contains the default port to connect to. It is 6667 by
+default and rarely needs changing.
+
address@hidden rcirc-default-user-name
address@hidden rcirc-default-user-name
address@hidden user name
+This variable contains the default user name to report to the server. It
+defaults to the login name returned by @code{user-login-name}, just like
address@hidden
+
address@hidden rcirc-default-user-full-name
 @vindex rcirc-default-user-full-name
 @cindex full name
 @cindex real name
 @cindex surname
address@hidden is used to set your ``real name'' on
-IRC.  It defaults to @code{user-full-name}.  If you want to hide your
-full name, you might want to set it to some pseudonym.
+This variable is used to set your ``real name'' on
+IRC. It defaults to the name returned by @code{user-full-name}. If you
+want to hide your full name, you might want to set it to some pseudonym.
 
 @example
 (setq rcirc-default-user-full-name "Curious Minds Want To Know")
 @end example
 
address@hidden rcirc-startup-channels-alist
address@hidden channels, configuration
address@hidden initial channels, configuration
address@hidden startup channels, configuration
address@hidden is the alist of channels to join
-when connecting to a particular network.  An alist is a list of lists.
-Each sublist starts with a regular expression that is compared to the
-server address you're connecting to.  The remaining sublist items are
-the channels to join.
-
address@hidden
-(setq rcirc-startup-channels-alist
-      '(("\\.freenode\\.net$" "#emacs" "#rcirc" "#wiki")))
address@hidden example
-
-Note the subtle problem, here --- IRC clients connect to servers, and
-there is no way of knowing which servers belong to a particular network.
-In the example above we're exploiting a naming convention used by within
-the Freenode network --- all servers within the network have a host in
-the @code{freenode.net} domain.
-
address@hidden rcirc-authinfo
 @vindex rcirc-authinfo
 @cindex authentification
 @cindex identification
 @cindex nickserv
 @cindex login
address@hidden is an alist used to automatically identify
-yourself on networks.  Each sublist starts with a regular expression
-that is compared to the server address you're connecting to.  The second
-element in the list is a symbol representing the method to use, followed
-by the arguments this method requires.
+This variable is an alist used to automatically identify yourself on
+networks. Each sublist starts with a regular expression that is compared
+to the server address you're connecting to. The second element in the
+list is a symbol representing the method to use, followed by the
+arguments this method requires.
 
 Here is an example to illustrate how you would set it:
 
@@ -558,6 +588,8 @@
 
 @end table
 
address@hidden table
+
 @node Fighting Information Overload, Hacking and Tweaking, Reference, Top
 @chapter Fighting Information Overload
 @cindex information overload