X-Git-Url: http://git.silcnet.org/gitweb/?p=silc.git;a=blobdiff_plain;f=apps%2Firssi%2Fdocs%2Fstartup-HOWTO.html;h=af92b83e4a30660951d0371a03acb8ef4ad99c82;hp=ddd5d025ba1de271fbf93d4d1e467fc23dfdc411;hb=f6ace22529aa51fa32b4957a63eca20b952be947;hpb=a5ae6ba34518dbaa3396a5ea1cd5c3bf212570b4 diff --git a/apps/irssi/docs/startup-HOWTO.html b/apps/irssi/docs/startup-HOWTO.html index ddd5d025..af92b83e 100644 --- a/apps/irssi/docs/startup-HOWTO.html +++ b/apps/irssi/docs/startup-HOWTO.html @@ -9,6 +9,9 @@
  1. For all the lazy people
  2. +
  3. Basic user interface usage
  4. Proxies and IRC bouncers
  5. Irssi's settings
  6. +
  7. Statusbar +

1. For all the lazy people

These settings should give you pretty good defaults (the ones I use):

+

If colors don't work, and you know you're not going to use some +weird non-VT compatible terminal (you most probably aren't), just +say:

+ +
+     /SET term_force_colors ON
+
+

I don't like automatic query windows, I don't like status window, I do like msgs window where all messages go:

@@ -67,6 +82,22 @@ query:

/SET reuse_unused_windows ON +

Here's the settings that make irssi work exactly like ircII in window +management (send me a note if you can think of more):

+ +
+     /SET autocreate_own_query OFF
+     /SET autocreate_query_level NONE
+     /SET use_status_window OFF
+     /SET use_msgs_window OFF
+     /SET reuse_unused_windows ON
+     /SET windows_auto_renumber OFF
+
+     /SET autostick_split_windows OFF
+     /SET autoclose_windows OFF
+     /SET print_active_channel ON
+
+

And example how to add servers:

(openprojects network, identify with nickserv and wait for 2 seconds before @@ -202,6 +233,13 @@ automatic creating of them with

/SET autocreate_windows OFF +

And if you keep all channels in one window, you most probably want +the channel name printed in each line:

+ +
+     /SET print_active_channel ON
+
+

If you want to group only some channels or queries in one window, use

@@ -539,8 +577,44 @@ be better to use eg.:

10. Proxies and IRC bouncers

-

Irssi supports connecting to IRC servers via a proxy. All proxies have -these settings in common:

+

Irssi supports connecting to IRC servers via a proxy. All server +connections are then made through it, and if you've set up everything +properly, you don't need to do any /QUOTE SERVER commands manually.

+ +

Here's an example: You have your bouncer (lets say, BNC or BNC-like) +listening in irc.bouncer.org port 5000. You want to use it to connect +to servers irc.dalnet and irc.efnet.org. First you'd need to setup the +bouncer:

+ +
+     /SET use_proxy ON
+     /SET proxy_address irc.bouncer.org
+     /SET proxy_port 5000
+
+     /SET proxy_password YOUR_BNC_PASSWORD_HERE
+     /SET -clear proxy_string
+     /SET proxy_string_after conn %s %d
+
+ +

Then you'll need to add the server connections. These are done +exactly as if you'd want to connect directly to them. Nothing special +about them:

+ +
+     /SERVER ADD -auto -ircnet dalnet irc.dal.net
+     /SERVER ADD -auto -ircnet efnet irc.efnet.org
+
+ +

With the proxy /SETs however, irssi now connects to those servers +through your BNC. All server connections are made through them so you +can just forget that your bouncer even exists.

+ +

If you don't want to use the proxy for some reason, there's -noproxy +option which you can give to /SERVER and /SERVER ADD commands.

+ +

Proxy specific settings:

+ +

All proxies have these settings in common:

      /SET use_proxy ON
@@ -562,7 +636,7 @@ these settings in common:

      /SET proxy_password your_pass
      /SET -clear proxy_string
-     /SET proxy_string conn %s %d
+     /SET proxy_string_after conn %s %d
 

dircproxy

@@ -583,6 +657,26 @@ this:

The server name and port you give isn't used anywhere, so you can put anything you want in there.

+

psyBNC

+ +

psyBNC has internal support for multiple servers. However, it could +be a bit annoying to use, and some people just use different users for +connecting to different servers. You can manage this in a bit same way +as with dircproxy, by creating fake connections:

+ +
+    /SET -clear proxy_password
+    /SET -clear proxy_string
+
+    /IRCNET ADD -user ircnetuser ircnet
+    /SERVER ADD -auto -ircnet ircnet fake.ircnet 6667 ircpass
+    /IRCNET ADD -user opnuser opn
+    /SERVER ADD -auto -ircnet opn fake.opn 6667 opnpass
+
+ +

So, you'll specify the usernames with /IRCNET ADD command, and the +user's password with /SERVER ADD.

+

Irssi proxy

Irssi contains it's own proxy which you can build giving @@ -796,6 +890,7 @@ of them you might want to change (the default value is shown):

or queries, list them here. For example "#boringchannel =bot1 =bot2". If any highlighted text or message for you appears in that window, this setting is ignored and the activity is shown. +

Nick completion

@@ -808,3 +903,50 @@ of them you might want to change (the default value is shown):

/SET completion_char :
Completion character to use.
+ +

12. Statusbar

+ +

/STATUSBAR displays a list of statusbars:

+ +
+Name                           Type   Placement Position Visible
+window                         window bottom    0        always
+window_inact                   window bottom    1        inactive
+prompt                         root   bottom    100      always
+topic                          root   top       1        always
+
+ +

/STATUSBAR <name> prints the statusbar +settings and it's items. /STATUSBAR <name> +ENABLE|DISABLE enables/disables the statusbar. +/STATUSBAR <name> RESET resets the statusbar to +it's default settings, or if the statusbar was created by you, it will be +removed.

+ +

Type can be window or root, meaning if the statusbar should be +created for each split window, or just once. Placement can be top or +bottom. Position is a number, the higher the value the lower in screen +it is. Visible can be always, active or inactive. Active/inactive is +useful only with split windows, one split window is active and the rest +are inactive. These settings can be changed with:

+ + + +

When loading a new statusbar scripts, you'll need to also specify +where you want to show it. Statusbar items can be modified with:

+ + + +

The item name with statusbar scripts is usually same as the script's +name. Script's documentation should tell if this isn't the case. So, to +add mail.pl before the window activity item (see the list with +/STATUSBAR window), use: /STATUSBAR window ADD -before act +mail.