added messagelevel docs to irssi.pod, more stuff in guide, and a little script to dump .xs func definitions

1 files changed, 16 insertions, 17 deletions

diff --git a/docs/Irssi/UI/Theme.pod b/docs/Irssi/UI/Theme.pod
index 4fff169..2e69186 100644
--- a/docs/Irssi/UI/Theme.pod
+++ b/docs/Irssi/UI/Theme.pod
@@ -13,7 +13,7 @@ Irssi::UI::Theme
 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 :)
+old data so keep backups C<:)>
 
 =head2 TEMPLATES
 
@@ -26,9 +26,9 @@ this templating system.
 Now the C</FORMAT>s 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.
+to change the /FORMATs directly, they're also saved in the  F<*.theme> files.
 
-So .. the templates. They're those C<{blahblah}> parts you see all over the
+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
@@ -44,21 +44,20 @@ 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).
+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
+=head2 COLOURS
 
 You can find definitions for the color format codes in L<Formats>
 
-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.
+There's one difference here though. C<%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 C</FORMAT test
+%g{foo}bar>, and C<foo = "%Y$0%n">, irssi would print yellow C<"foo"> (as set
+with C<%Y>) but C<"bar"> would be green, which was set at the beginning before
+the C<{foo}> template. If there wasn't the C<%g> at start, the normal behaviour
+of C<%n> would occur. If you I<really> want to use the terminal's default color,
+use C<%N>.