diff --git a/docs/help/in/alias.in b/docs/help/in/alias.in index e57ad194..13fcb55a 100644 --- a/docs/help/in/alias.in +++ b/docs/help/in/alias.in @@ -23,7 +23,7 @@ %9Examples:%9 /ALIAS - /ALIAS J JOIN + /ALIAS UH USERHOST /ALIAS COMEBACK SAY I was hoping for a battle of wits, but you seem to be unarmed. /ALIAS -COMEBACK /ALIAS UNACT SCRIPT EXEC \$_->activity(0) for Irssi::windows diff --git a/docs/help/in/lastlog.in b/docs/help/in/lastlog.in index b7cadf8a..41522cb2 100644 --- a/docs/help/in/lastlog.in +++ b/docs/help/in/lastlog.in @@ -1,22 +1,37 @@ +%9Syntax:%9 + @SYNTAX:lastlog@ - -clear: remove all lastlog lines from window +%9Parameters:%9 - -: don't print the "Lastlog:" and "End of Lastlog" messages. - -file: write lastlog to file instead of screen - -window: which window's lastlog to check (output is always to active) - -case: Case-sensitive matching - -force: Force displaying lastlog even if it's longer than 1000 lines - -new: show only lines since last /LASTLOG - -regexp: `text' is a regular expression - -word: `text' must match to full words - -: levels to check (default is all; /help levels for details) - : text to search for, or all if empty - : maximum number of lines to show - : skip the last `start' lines + -: Doesn't print the "Lastlog:" and "End of Lastlog" messages. + -file: Output the lastlog to a file instead of the active window. + -window: Specifies the window to check. + -new: Only displays results since the previous lastlog. + -away: Only displays results since you previous away status. + -level: Specifies the levels to check. + -clear: Removes the previous results from the active window. + -count: Displays how many lines match. + -case: Performs a case-sensitive matching. + -regexp: The given text pattern is a regular expression. + -word: The text must match full words. + -force: Forces to display the lastlog, even if it exceeds 1000 lines. + -after: Only displays results after the given line number. + -before: Only displays results before the given line number. -Shows the given number of lines of log from the current window. + The pattern to search for and the maximum of lines to display; if no + parameter is given, the entire window buffer will be displayed. -See also: +%9Description:%9 + + Searches the active window for a pattern and displays the result. + +%9Examples:%9 + + /LASTLOG holiday + /LASTLOG "is on vacation" + /LASTLOG -file -force ~/mike.log "mike" + +%9See also:%9 HILIGHT, SCROLLBACK diff --git a/docs/help/in/layout.in b/docs/help/in/layout.in index d5e81438..041549d1 100644 --- a/docs/help/in/layout.in +++ b/docs/help/in/layout.in @@ -1,13 +1,28 @@ +%9Syntax:%9 + @SYNTAX:layout@ -Saves the current window layout to configuration (yes, you'll still -need to use /SAVE to save the configuration to file). Next time you run -irssi, all the channels and queries are exactly in the same windows -where they were when you called /LAYOUT SAVE. +%9Parameters:%9 -Channels aren't actually joined in those windows immediately, they're -just marked "next time you join to '#channel' in server that has tag -'ircnet' place it to this window". + SAVE: Saves your layout to the configuration. + RESET: Removes the saved layout from the configuration. + +%9Descripton:%9 + + Saves the layout of your window configuration; the next time you connect + to the server, you will join the channels in the same window as before. + + This method enables you to keep the same window layout when you start Irssi + the next time. + + You will need to use the SAVE command to confirm and commit the changes + into the configuration file. + +%9Examples:%9 + + /LAYOUT SAVE + /LAYOUT RESET + +%9See also:%9 SAVE, WINDOW -/LAYOUT RESET removes the saved layout. diff --git a/docs/help/in/levels.in b/docs/help/in/levels.in index b6ebed7e..c44a551a 100644 --- a/docs/help/in/levels.in +++ b/docs/help/in/levels.in @@ -1,35 +1,40 @@ -Message levels (or in short, levels) are used almost everywhere. -They describe what kind of messages we're dealing with. Here's a -list of them all: - CRAP - Can be almost anything - MSGS - Private messages - PUBLIC - Public messages in channel - NOTICES - Notices - SNOTES - Server notices - CTCPS - CTCP messages - ACTIONS - Actions (/me) - usually ORed with PUBLIC or MSGS - JOINS - Someone joins a channel - PARTS - Someone parts a channel - QUITS - Someone quits IRC - KICKS - Someone gets kicked from channel - MODES - Channel mode is changed - TOPICS - Channel topic is changed - WALLOPS - Wallop is received - INVITES - Invite is received - NICKS - Someone changes nick - DCC - DCC related messages - DCCMSGS - DCC chat messages - CLIENTNOTICE - Irssi's notices - CLIENTERROR - Irssi's error messages - CLIENTCRAP - Some other messages from Irssi +%9Description:%9 -And a few special ones that could be included with the -levels above: + These are the message levels that are used throughout Irssi; they describe + what kind of message is displayed. - HILIGHT - Text is highlighted - NOHILIGHT - Don't check highlighting for this message - NO_ACT - Don't trigger channel activity when printing - this message - NEVER - Never ignore or log this message + These are the common levels you can use: + + ACTIONS Actions by a nickname. + CLIENTCRAP Irssi's internal messages. + CLIENTERROR Irssi's internal error messages. + CLIENTNOTICE Irssi's internal notices. + CRAP Can be almost anything. + CTCPS CTCP messages. + DCC DCC protocol related messages. + DCCMSGS DCC chat messages. + INVITES An invite is received. + JOINS A nickname joins a channel. + KICKS A nickname gets kicked from a channel. + MODES A channel mode is modified. + MSGS Private messages. + NICKS A nickname changes to another nickname. + NOTICES Notices sent from a nickname. + PARTS A nickname leaves a channel. + PUBLIC Public messages in a channel. + QUITS A nickname disconnects from IRC. + SNOTES Notices sent from a server. + TOPICS A channel topic is modified. + WALLOPS A wallop is received. + + These are the special levels you can use: + + HILIGHT The text is highlighted. + NEVER Never ignores or logs the message. + NO_ACT Doesn't trigger any activity in the statusbar. + NOHILIGHT The text is not highlighted. + + When using levels from Irssi scripts, you need to prepend the level with + "MSGLEVEL_"; for example "CRAP" will be "MSGLEVEL_CRAP". diff --git a/docs/help/in/links.in b/docs/help/in/links.in index 95ee07c5..a2aaa689 100644 --- a/docs/help/in/links.in +++ b/docs/help/in/links.in @@ -1,9 +1,22 @@ +%9Syntax:%9 + @SYNTAX:links@ -Shows the links between the IRC servers of the -current IRC network. If a wildcard parameter is -specified, shows only the matching entries. +%9Parameters:%9 -See also: MAP + The server to search on and the string to match on; if no arguments are + given, the list of links of the active server will be displayed. + +%9Description:%9 + + Displays the links between an IRC server and its connections. + +%9Examples:%9 + + /LINKS + /LINKS ircsource.irssi.org + /LINKS ircsource.irssi.org *.hub + +%9See also:%9 LUSERS, MAP diff --git a/docs/help/in/list.in b/docs/help/in/list.in index a1f697e7..cbce105e 100644 --- a/docs/help/in/list.in +++ b/docs/help/in/list.in @@ -1,16 +1,25 @@ +%9Syntax:%9 + @SYNTAX:list@ -Lists the channel names. Trying to list all the channel -names usually causes you to be disconnected from the -server with the reason "Excess flood", as usually all -40000 channels form together and server naively attempts -to send you them. +%9Parameters:%9 -Thus, on IRCNet, you should rather use service ALIS -(Advanced Listing Service), which will allow you to query -for channel with specific name, topic, mode or usercount. -Type /SQUERY ALIS HELP to get more info about it. + -yes: Comfirms that you want to receive a large amount of data. + + The text a channel must match; if no argument is given, the list of all + channels will be displayed. + +%9Description:%9 + + Displays the channel names that match your request; requesting all channels + may cause the server to disconnect you for flooding. + +%9Examples:%9 + + /LIST + /LIST -yes + /LIST -yes *ubuntu* See also: SQUERY diff --git a/docs/help/in/load.in b/docs/help/in/load.in index 867654c7..643d09d3 100644 --- a/docs/help/in/load.in +++ b/docs/help/in/load.in @@ -1,16 +1,23 @@ +%9Syntax:%9 + @SYNTAX:load@ -Load a plugin. If full path isn't given, irssi searches the plugin from -directories: +%9Parameters%9 - ~/.irssi/modules/ - /lib/irssi/modules/ + The name of the module and submodule to load. -See plugins page of http://www.irssi.org/ to see if there's any plugins -you'd want to use. +%9Description:%9 -To load a perl script you should use /SCRIPT. + Loads a plugin; if the full path isn't given, it will attempt to load from + common directories in your installation path. -See also: UNLOAD + To load a perl script, you must use the SCRIPT command. + +%9Examples:%9 + + /LOAD fish + /LOAD ~/irssi-fish/libfish.so + +%9See also:%9 SCRIPT, UNLOAD diff --git a/docs/help/in/log.in b/docs/help/in/log.in index 09580793..647d4560 100644 --- a/docs/help/in/log.in +++ b/docs/help/in/log.in @@ -1,41 +1,48 @@ +%9Syntax:%9 + @SYNTAX:log@ - -noopen: Create the entry to log list, but don't start logging - -autoopen: Automatically open this log file at startup - -: Targets are logged only in this server - -targets: Log only in specified channels/nicks (space separated list) - -window: Log output in the window. Active window is used by default, or - you can give the window's refnum in -targets. - : File name where to log, it is parsed with - strftime(), so %%d=day, etc. see "man strftime" for - more info. - : Defaults to ALL - : ID number of log. +%9Parameters:%9 -/SET log_create_mode - Specifies what file mode to use with - the created log files. Default is 0600. + OPEN: Opens a logfile. + CLOSE: Closes a logfile. + START: Starts logging a log entry. + STOP: Stops logging a log entry. -All of these are parsed with strftime(): -/SET log_timestamp - Specifies the time stamp format. - Default is "%%H:%%M ". -/SET log_open_string - Text written to log when it's opened -/SET log_close_string - Text written to log when it's closed -/SET log_day_changed - Text written to log when day changes + -noopen: Saves the entry in the configuration, but doesn't actually + start logging. + -autoopen: Automatically opens the log at startup. + -window: Displays the output to the active window, or the window + specified in the targets parameter. + -: The server tag the targets must be on. + -targets: Logs the specified nickhames or channels. + -colors: Also log the color codes of the messages. -NOTE: Log files are locked after opened, so two Irssis can't -accidentally try to write to the same log file. + The filename of the log and the levels to match; if no argument is given, + the list of open logs will be displayed. -Examples: - -/LOG OPEN -targets cras ~/irclogs/cras.log MSGS - - Logs all messages from/to nick `cras' +%9Description:%9 -/LOG OPEN -targets #linux ~/irclogs/linux/linux-%%Y-%%m-%%d - - Logs all messages in channel #linux. Log is rotated daily, so - logs in 1. May 2000 goes to file "linux-2000-05-01", when the - day is changed, Irssi closes the log and starts logging to - "linux-2000-05-02" etc. + Opens a logfile and stores the messages of the given targets into it; the + logfiles will be locked so multiple clients cannot log to the same file. -See also: SET LOG, WINDOW LOG + You may use any of the date formats to create a logrotation; we strongly + recommend you to enable autolog if you are interested in keeping logs. + +%9Examples:%9 + + /LOG OPEN -targets mike ~/irclogs/mike.log MSGS + /LOG OPEN -targets #irssi-freenode ~/irclogs/freenode/irssi-%%Y-%%m-%%d + /LOG CLOSE ~/irclogs/freenode/irssi-%%Y-%%m-%%d + /LOG STOP ~/irclogs/freenode/irssi-%%Y-%%m-%%d + /LOG START ~/irclogs/freenode/irssi-%%Y-%%m-%%d + + /SET autolog ON + +%9References:%9 + + https://github.com/irssi/irssi/blob/master/docs/formats.txt + +%9See also:%9 SET LOG, WINDOW LOG diff --git a/docs/help/in/lusers.in b/docs/help/in/lusers.in index abcd55c4..f9edf535 100644 --- a/docs/help/in/lusers.in +++ b/docs/help/in/lusers.in @@ -1,5 +1,24 @@ +%9Syntax:%9 + @SYNTAX:lusers@ -Shows user statistics of the current IRC network. +%9Parameters:%9 + + The server to search on and the remote sever to search on; if no arguments + are given, the active server will be used. + +%9Description:%9 + + Displays the user statistics of the active or remote server. + + The parameters to search on a remote server are no longer supported on most + IRC servers; we no longer provide examples for remote LUSERS to avoid all + confusion. + +%9Examples:%9 + + /LUSERS + +%9See also:%9 LINKS, MAP