[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 13:28:43

Index: rcirc.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/rcirc.texi,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -b -r1.2 -r1.3
--- rcirc.texi  6 Sep 2007 05:10:09 -0000       1.2
+++ rcirc.texi  20 Dec 2007 13:28:42 -0000      1.3
@@ -54,6 +54,7 @@
 @menu
 * Basics::
 * Reference::
+* Fighting Information Overload::
 * Hacking and Tweaking::
 * GNU Free Documentation License::
 * Key Index::
@@ -74,6 +75,13 @@
 * Useful IRC commands::
 * Configuration::
 
+Fighting Information Overload
+
+* Channels::
+* People::
+* Keywords::
+* Notices::
+
 Hacking and Tweaking
 
 * Skipping /away messages using handlers::
@@ -225,7 +233,16 @@
 though.  Generally, IRC users don't like people pasting more than around
 four lines of code, so use with care.
 
address@hidden Reference, Hacking and Tweaking, Basics, Top
+As soon as you have joined a channel, you probably want to be notified
+of any activity on the the channels you joined. All you need to do is
+switch channel tracking on using @kbd{M-x rcirc-track-minor-mode}.  To
+make this permanent, add the following to your init file:
+
address@hidden
+(rcirc-track-minor-mode 1)
address@hidden example
+
address@hidden Reference, Fighting Information Overload, Basics, Top
 @chapter Reference
 @cindex reference
 
@@ -382,24 +399,6 @@
 @code{/quit ZZZzzz...}.)
 @end table
 
-Some commands may not have a key binding, but only be available as typed
-commands, such as:
-
address@hidden @code
address@hidden /ignore
address@hidden /ignore
address@hidden ignoring other people
address@hidden trolls, ignoring
address@hidden hide some posts
address@hidden idiots online
-This command toggles the ignore status of a nick, if you provide one.
-If you don't provide a nick, the command lists all the nicks you are
-ignoring.  All messages by ignored nicks are---you guessed it---ignored.
-Since only ``operators'' can kick people from channels, the
-ignore command is often the only way to deal with some of the more
-obnoxious fellows online.  Example: @code{/ignore xah}.
address@hidden table
-
 @node Useful IRC commands, Configuration, rcirc commands, Reference
 @section Useful IRC commands
 @cindex irc commands
@@ -556,8 +555,30 @@
 the other instant messaging services, and Bitlbee will log you in.  All
 @code{rcirc} needs to know, is the login to your Bitlbee account.  Don't
 confuse the Bitlbee account with all the other accounts.
+
 @end table
 
address@hidden Fighting Information Overload, Hacking and Tweaking, Reference, 
Top
address@hidden Fighting Information Overload
address@hidden information overload
+
+This is the section of the manual that caters to the busy person
+online. There are support channels with several hundred people in
+them. Trying to follow a conversation in these channels can be a
+daunting task. This chapters tells you how @code{rcirc} can help.
+
address@hidden
+* Channels::
+* People::
+* Keywords::
+* Notices::
address@hidden menu
+
address@hidden Channels, People, Fighting Information Overload, Fighting 
Information Overload
address@hidden Channels
address@hidden channels
address@hidden modeline
+
 @kindex C-c C-SPC
 @vindex rcirc-track-minor-mode
 @cindex switching channels
@@ -590,7 +611,137 @@
             (rcirc-track-minor-mode 1)))
 @end example
 
address@hidden Hacking and Tweaking, GNU Free Documentation License, Reference, 
Top
address@hidden busy channels
+If you've joined a very active support channel, tracking activity is
+no longer useful. The channel will be always active. Switching to
+active channels using @kbd{C-c address@hidden no longer works as
+expected.
+
address@hidden C-c C-l
address@hidden low priority channels
+The solution is to mark this channel as as a low priority channel.
+Use @kbd{C-c C-l} to make the current channel a low-priority
+channel. Low priority channels have the modeline indicator ``LowPri''.
address@hidden address@hidden will not switch to low priority channels unless
+you use the @kbd{C-u} prefix.
+
address@hidden C-c TAB
address@hidden ignored channels
+If you prefer a channel to never show up in the modeline, then you
+have to ignore it. Use @kbd{C-c @key{TAB}} to ignore the current
+channel.
+
address@hidden People, Keywords, Channels, Fighting Information Overload
address@hidden People
address@hidden people, how to ignore
address@hidden nicks, how to ignore
address@hidden friends
address@hidden buddies
address@hidden trolls
+
+The most important command available to the discerning IRC user is
address@hidden/ignore}. It's the big equalizer online: If people aggravate
+you, just ignore them.
+
+This is of course a crude all-or-nothing solution.  Fear not,
address@hidden offers alternatives: You can ``brighten'' your buddies
+and ``dim'' certain other nicks that you don't want to ignore
+altogether.
+
address@hidden @code
address@hidden /ignore
address@hidden /ignore
address@hidden ignoring other people
address@hidden trolls, ignoring
address@hidden hide some posts
address@hidden idiots online
+This command toggles the ignore status of a nick, if you provide one.
+If you don't provide a nick, the command lists all the nicks you are
+ignoring.  All messages by ignored nicks are---you guessed it---ignored.
+Since only ``operators'' can kick people from channels, the
+ignore command is often the only way to deal with some of the more
+obnoxious fellows online.  Example: @code{/ignore xah}.
+
address@hidden /bright
address@hidden /bright
address@hidden highlight other people
address@hidden friends, highlight
address@hidden buddies, highlight
address@hidden nicks, highlight
address@hidden brighten nicks
+This command toggles the bright status of a nick, if you provide one.
+If you don't provide a nick, the command lists all the ``brightened''
+nicks.  All messages by brightened nicks are---you guessed
+it---brightened. Use this for your friends.  Example: @code{/bright
+rcy}.
+
address@hidden /dim
address@hidden /dim
address@hidden soft-ignore other people
address@hidden obnoxious people online
address@hidden rabble online
+This command toggles the dim status of a nick, if you provide one.  If
+you don't provide a nick, the command lists all the ``dimmed'' nicks.
+All messages by dimmed nicks are---you guessed it---dimmed.  Use this
+for boring people and bots. If you are tracking channel activity,
+messages by dimmed nicks will not register as activity. Example:
address@hidden/dim fsbot}.
address@hidden table
+
+
address@hidden Keywords, Notices, People, Fighting Information Overload
address@hidden Keywords
address@hidden keywords
+
+On a busy channel, you might want to ignore all activity (using
address@hidden @key{TAB}}) and just watch for certain keywords. The
+following command allows you to highlight certain keywords:
+
address@hidden @code
address@hidden /keyword
address@hidden /keyword
+This command toggles the highlighting of a keyword, if you provide
+one. If you don't provide a keyword, the current keywords are
+listed. Example: @code{/keyword manual}.
address@hidden table
+
+A keyword is regular expression matching a word. Thus, if you add the
+keyword @code{wikis?} then this will match the words ``wiki'' and
+``wikis'' but not ``emacswiki''.
+
address@hidden Notices, , Keywords, Fighting Information Overload
address@hidden Notices
address@hidden part notices, how to omit 
address@hidden join notices, how to omit
address@hidden quit notices, how to omit
address@hidden nick notices, how to omit
+
address@hidden C-c C-o
address@hidden low priority channels
+In busy channels you might not be interested in all the joining,
+parting, quitting, and renaming that goes on. You can omit those
+notices using @kbd{C-c C-o}.
+
address@hidden rcirc-omit-responses
address@hidden away notices, how to omit
+You can control which notices get omitted via the
address@hidden variable. Here's an example of how to omit
+away messages:
+
address@hidden
+(setq rcirc-omit-responses '("JOIN" "PART" "QUIT" "NICK" "AWAY))
address@hidden example
+
address@hidden rcirc-omit-threshold
+Notice that these messages will not be omitted if the nick in question
+has recently been active. After all, you don't want to continue a
+conversation with somebody who just left. That's why @code{rcirc}
+checks recent lines in the buffer to figure out if a nick has been
+active and only omits a message if the nick has not been active. The
+window @code{rcirc} considers is controlled by the
address@hidden variable.
+
address@hidden Hacking and Tweaking, GNU Free Documentation License, Fighting 
Information Overload, Top
 @chapter Hacking and Tweaking
 @cindex hacking and tweaking