no way to compare when less than two revisions

Differences

This shows you the differences between two versions of the page.

@@ Line 1: / Line 1: @@
+# $EPIC: server.txt,v 1.9 2006/10/06 00:38:30 jnelson Exp $
+======Synopsis:======
+__server__ \\
+__server__ [<server description>|<server refnum>] \\
+__server__ [+|-][<server name>] \\
+__server__ [-add] <server description>       [see below] \\
+__server__ [-delete <server refnum>]
+__server__ [-update <server description>]
+======About irc servers:======
+The nexus of irc is the server, also known as "ircd", which comes in
+different classes, such as "irc2.8", "irc2.9", "EFNext", "ircu2.8"
+"ircu2.9", "hybrid5", "hybrid6", "hybrid7", "dreamforge", "bahamut",
+and a huge list of others.  The above list classifies the most likely
+types of servers you will encounter.  There are some irc-like
+implementations, most of which have been devised for microsoft windows
+operating systems.  EPIC does not promise to work on any server that
+diverges significantly from traditional irc (which these servers usually
+do) and so we will not consider these servers at all in this discussion.
+At the most basic level, all unix irc servers in widespread use have a
+direct lineage to one common ancestor, ircd2.8.  Therefore, the features
+provided by ircd2.8 are portable to all irc servers.  This includes the
+ability to join channels, to send messages to other users, to set topics,
+channel and user modes, to kick users from channels, and the like.  How-
+ever, through the course of time many extensions have been added to the
+ircd software, and a particular set of extensions to ircd are distributed
+as a software package and typically are used by an entire network.  Each
+server "class" defines a loose set of extended functionality that is
+available to the user whenever you use that class of server.  That server's
+extensions may not be available on other servers, or it may be available
+in a different way.
+======How EPIC gets your server list:======
+How does EPIC know what servers you want to use?  EPIC always tries
+to keep a server list, even if it contains only one server.
+The contents of the server list will always contain:
+     * All servers, if any, you list on the command line.
+     * The value, if any, of the **IRCSERVER** environment variable.
+If the server list is still empty *or* if you use the -a command line
+option, then EPIC will read the "servers file", which is:
+     * The value of the **IRC_SERVERS_FILE** environment variable, if any.
+     * Otherwise the value of #define SERVERS_FILE (usually ircII.servers)
+The "servers file" can be an absolute path or start with a tilde (for
+home directory expansion), but if it is neither, then the file will be
+looked for in the IRCLIB directory, which is:
+     * The value of the **IRCLIB** environment variable, if any
+     * The value of #define IRCLIB in config.h
+If all of the above fails, EPIC will use the value of
+#define DEFAULT_SERVER_LIST which is there only as a failsafe and not
+as a useful default server list.
+======About server descriptions:======
+See [[server description]] for more information about server descriptions
+and server refnums.
+======Referring to servers:======
+See [[referring to servers]] for more information about how to refer to your
+servers once you've added them to the server list.
+======About servers and windows:======
+Windows and servers have a many-to-one relationship.  Each window is
+always connected to exactly one server at a time; no more and no less.
+You can have as many windows connected to a server as you want.
+You can have as many servers open as you want.  A server is automatically
+opened when the first window is connected to it.  There is always one
+window connected to every open server; a server is automatically closed
+when the last window is disconnected from it.
+======Description:======
+The __SERVER__ command manages EPIC's server list, letting you add,
+remove, connect, or disconnect servers as you need to.
+======Options:======
+| /SERVER                         | Show the server list. |
+| /SERVER -DELETE <refnum or desc>   | Remove server <refnum> (or <desc>) from server list. \\ Fails if you do not give it a refnum or desc. \\ Fails if server does not exist. \\ Fails if server is open. |
+| /SERVER -ADD <desc>             | Add server <desc> to server list. \\ Fails if you do not give it a <desc> |
+| /SERVER -UPDATE <refnum> <desc> | Change server <refnum> changing any fields to new values specified in <desc>.  \\ You cannot update a server that is open.|
+| /SERVER +<refnum or desc>          | If the server's state is "CLOSED", change it to "RECONNECT". \\ This allows the server to reconnect if windows are pointed to it. \\ Note: server reconnection is asynchronous |
+| /SERVER -<refnum or desc>          | Unconditionally close a server connection \\ Note: server disconnection is synchronous! |
+| /SERVER +                       | Switch windows from current server to next server in same group |
+| /SERVER -                       | Switch windows from current server to previous server in same group |
+| /SERVER <refnum or desc>           | Switch windows from current server to another server. |
+======Note:======
+As the colon is already used by EPIC as an argument seperator, IPv6
+adresses need to be surrounded in square brackets [] to prevent the
+colons from being interpeted.
+======Examples:======
+To change to a new server, irc.foobar.com, on port 6668:
+      /server irc.foobar.com 6668
+      /server irc.foobar.com:6668
+To change to a new server and register with the nickname "JoeBob":
+      /server irc.foobar.com:::JoeBob
+To switch to the next, or previous, server in the same group
+      /server +
+      /server -
+To associate a new server, irc.booya.net, to your current window:
+      /server +irc.booya.net
+To delete server 5 from your list:
+      /server -delete 5
+To add server "irc.foo.com" on port 6667 with nick "blah" to your list:
+      /server -add irc.foo.com:6667::blah
+To connect to an SSL server:
+     /server irc.foobar.com:::::IRC-SSL