From 5a5c6461b163f00b9d4e2c8265b0ebb10c2be2e1 Mon Sep 17 00:00:00 2001 From: Tom Feist Date: Wed, 21 Jul 2010 20:58:21 +0100 Subject: added formats, and some copypasta from default.theme comments into theme --- docs/Irssi/Channel.pod | 67 +++++++++++++++++++++++++++---------------------- docs/Irssi/Irc/Dcc.pod | 8 +++--- docs/Irssi/Log.pod | 36 ++++++++++++++------------ docs/Irssi/Logitem.pod | 4 +-- docs/Irssi/Nick.pod | 3 ++- docs/Irssi/Rawlog.pod | 42 ++++++++++++++++++------------- docs/Irssi/UI/Theme.pod | 56 +++++++++++++++++++++++++++++++++++++++++ 7 files changed, 146 insertions(+), 70 deletions(-) (limited to 'docs/Irssi') diff --git a/docs/Irssi/Channel.pod b/docs/Irssi/Channel.pod index bb6789d..baeff6c 100644 --- a/docs/Irssi/Channel.pod +++ b/docs/Irssi/Channel.pod @@ -6,7 +6,8 @@ Irssi::Channel =head1 FIELDS -Channel->{} +C{}> + type - "CHANNEL" text chat_type - String ID of chat protocol, for example "IRC" @@ -35,45 +36,51 @@ Channel->{} -Server::channels_join(channels, automatic) - Join to channels in server. `channels' may also contain keys for - channels just like with /JOIN command. `automatic' specifies if this - channel was joined "automatically" or if it was joined because join - was requested by user. If channel join is "automatic", irssi doesn't - jump to the window where the channel was joined. +=head2 C + +Join to channels in server. `channels' may also contain keys for +channels just like with /JOIN command. `automatic' specifies if this +channel was joined "automatically" or if it was joined because join +was requested by user. If channel join is "automatic", irssi doesn't +jump to the window where the channel was joined. + +=head2 C + +Destroy channel. + +=head2 C + +Return a list of bans in channel. + +=head2 C + +Get ban mask for `nick'. + +=head2 C + +Add a new ban to channel. +=head2 C -Channel::destroy() - Destroy channel. +Remove a ban from channel. -Channel::bans() - Return a list of bans in channel. +=head2 C -Channel::ban_get_mask(nick) - Get ban mask for `nick'. +Add nick to nicklist. Returns a L. -Channel::banlist_add(ban, nick, time) - Add a new ban to channel. +=head2 C -Channel::banlist_remove(ban) - Remove a ban from channel. +Remove nick from nicklist. +=head2 C -Nick -Channel::nick_insert(nick, op, voice, send_massjoin) - Add nick to nicklist. +Find nick from nicklist. Returns L. -Channel::nick_remove(nick) - Remove nick from nicklist. +=head2 C -Nick -Channel::nick_find(nick) - Find nick from nicklist. +Find nick mask from nicklist, wildcards allowed. Returns L. -Nick -Channel::nick_find_mask(mask) - Find nick mask from nicklist, wildcards allowed. +=head2 C -Channel::nicks() - Return a list of all nicks in channel. +Return a list of all nicks in channel. diff --git a/docs/Irssi/Irc/Dcc.pod b/docs/Irssi/Irc/Dcc.pod index 5950a92..5ba52b9 100644 --- a/docs/Irssi/Irc/Dcc.pod +++ b/docs/Irssi/Irc/Dcc.pod @@ -6,7 +6,7 @@ Irssi::Irc::Dcc =head1 FIELDS -=head2 C{}> +=head2 C{}> type - Type of the DCC: chat, send, get orig_type - Original DCC type that was sent to us - same as type except @@ -29,13 +29,13 @@ Irssi::Irc::Dcc starttime - Unix time stamp when the DCC transfer was started transfd - Bytes transferred -=head2 C{}> +=head2 C{}> id - Unique identifier - usually same as nick mirc_ctcp - Send CTCPs without the CTCP_MESSAGE prefix connection_lost - Other side closed connection -=head2 C{}> +=head2 C{}> (..contains all the same data as core Dcc object..) size - File size @@ -47,7 +47,7 @@ Irssi::Irc::Dcc file - The real file name which we use. file_quoted - 1 if file name was received quoted ("file name") -=head2 C{}> +=head2 C{}> (..contains all the same data as core Dcc object..) size - File size diff --git a/docs/Irssi/Log.pod b/docs/Irssi/Log.pod index 673a183..68163a2 100644 --- a/docs/Irssi/Log.pod +++ b/docs/Irssi/Log.pod @@ -6,7 +6,8 @@ Irssi::Log =head1 FIELDS -Log->{} +C{}> + fname - Log file name real_fname - The actual opened log file (after %d.%m.Y etc. are expanded) opened - Log file is open @@ -20,27 +21,30 @@ Log->{} =head1 METHODS +=head2 C + +Add log to list of logs / save changes to config file. + +=head2 C + +Destroy log file. + +=head2 C -Log::update() - Add log to list of logs / save changes to config file. +Open log file and start logging. +=head2 C -Log::close() - Destroy log file. +Close log file. -Log::start_logging() - Open log file and start logging. +=head2 C -Log::stop_logging() - Close log file. +Add log item to log. -Log::item_add(type, name, server) - Add log item to log. +=head2 C -Log::item_destroy(item) - Remove log item from log. +Remove log item from log. +=head2 C -Logitem -Log::item_find(type, item, server) - Find item from log. +Find item from log. Returns L diff --git a/docs/Irssi/Logitem.pod b/docs/Irssi/Logitem.pod index 6db0c7b..f30d4b8 100644 --- a/docs/Irssi/Logitem.pod +++ b/docs/Irssi/Logitem.pod @@ -6,11 +6,11 @@ Irssi::Logitem =head1 FIELDS -Logitem->{} +C{}> + type - 0=target, 1=window refnum name - Name servertag - Server tag - =head1 METHODS diff --git a/docs/Irssi/Nick.pod b/docs/Irssi/Nick.pod index b20d43a..3e85256 100644 --- a/docs/Irssi/Nick.pod +++ b/docs/Irssi/Nick.pod @@ -6,7 +6,8 @@ Irssi::Nick =head1 FIELDS -Nick->{} +C{}> + type - "NICK" text chat_type - String ID of chat protocol, for example "IRC" diff --git a/docs/Irssi/Rawlog.pod b/docs/Irssi/Rawlog.pod index 7f89c64..a5428bf 100644 --- a/docs/Irssi/Rawlog.pod +++ b/docs/Irssi/Rawlog.pod @@ -7,34 +7,42 @@ Irssi::Rawlog =head1 FIELDS -Rawlog->{} +C{}> + logging - The rawlog is being written to file currently nlines - Number of lines in rawlog =head1 METHODS +=head2 C + +Destroy the rawlog. + +=head2 C + +Returns all lines in rawlog. + +=head2 C + +Start logging new messages in rawlog to specified file. + +=head2 C + +Stop logging to file. -Rawlog::destroy() - Destroy the rawlog. +=head2 C -Rawlog::get_lines() - Returns all lines in rawlog. +Save the current rawlog history to specified file. -Rawlog::open(filename) - Start logging new messages in rawlog to specified file. +=head2 C -Rawlog::close() - Stop logging to file. +Send `str' to raw log as input text. -Rawlog::save(filename) - Save the current rawlog history to specified file. +=head2 C -Rawlog::input(str) - Send `str' to raw log as input text. +Send `str' to raw log as output text. -Rawlog::output(str) - Send `str' to raw log as output text. +=head2 C -Rawlog::redirect(str) - Send `str' to raw log as redirection text. +Send `str' to raw log as redirection text. diff --git a/docs/Irssi/UI/Theme.pod b/docs/Irssi/UI/Theme.pod index 56e3a3f..4fff169 100644 --- a/docs/Irssi/UI/Theme.pod +++ b/docs/Irssi/UI/Theme.pod @@ -1,3 +1,5 @@ +__END__ + =head1 NAME Irssi::UI::Theme @@ -6,3 +8,57 @@ Irssi::UI::Theme =head1 METHODS +=head1 THEME DOCUMENTATION + +When testing changes, the easiest way to reload the theme is with /RELOAD. +This reloads the configuration file too, so if you did any changes remember +to /SAVE it first. Remember also that /SAVE overwrites the theme file with +old data so keep backups :) + +=head2 TEMPLATES + +The real text formats that irssi uses are the ones you can find with +/FORMAT command. Back in the old days all the colors and texts were mixed +up in those formats, and it was really hard to change the colors since you +might have had to change them in tens of different places. So, then came +this templating system. + +Now the Cs don't have any colors in them, and they also have very +little other styling. Most of the stuff you need to change is in this +theme file. If you can't change something here, you can always go back +to change the /FORMATs directly, they're also saved in these .theme files. + +So .. the templates. They're those C<{blahblah}> parts you see all over the +/FORMATs and here. Their usage is simply C<{name parameter1 parameter2}>. + +When irssi sees this kind of text, it goes to find "name" from abstracts block +below and sets C into C<$0> and C into C<$1> (you can +have more parameters of course). Templates can have subtemplates. Here's a +small example: + + /FORMAT format hello {colorify {underline world}} + + abstracts = { colorify = "%G$0-%n"; underline = "%U$0-%U"; } + +When irssi expands the templates in "format", the final string would be: + + hello %G%Uworld%U%n + +ie. underlined bright green "world" text. +and why C<$0->, why not C<$0>? C<$0> would only mean the first parameter, +$0- means all the parameters. With {underline hello world} you'd really +want to underline both of the words, not just the hello (and world would +actually be removed entirely). + +=head2 COLORS + +You can find definitions for the color format codes in L + +There's one difference here though. %n format. Normally it means the +default color of the terminal (white mostly), but here it means the +"reset color back to the one it was in higher template". For example +if there was /FORMAT test %g{foo}bar, and foo = "%Y$0%n", irssi would +print yellow "foo" (as set with %Y) but "bar" would be green, which was +set at the beginning before the {foo} template. If there wasn't the %g +at start, the normal behaviour of %n would occur. If you _really_ want +to use the terminal's default color, use %N. -- cgit v1.2.3