NAME `String::Tagged::IRC' - parse and format IRC messages using `String::Tagged' TAGS This module provides the following tags, conforming to the String::Tagged::Formatting API specification. bold, under, italic, reverse Boolean values indicating bold, underline, italics, or reverse-video. fg, bg Convert::Color objects encoding the color. These will likely be instances of Convert::Color::mIRC, unless a full RGB triplet colour code has been provided; in which case it will be an instance of Convert::Color::RGB8. METHODS $st = String::Tagged::IRC->parse_irc( $raw, %opts ) Parses a text string containing IRC formatting codes and returns a new `String::Tagged::IRC' instance. Takes the following named options: parse_plain_formatting => BOOL If true, also parse "poor-man's" plain-text formatting of *bold*, */italic/* and _underline_. In this case, formatting tags are added but the original text formatting is preserved. $raw = $st->build_irc Returns a plain text string containing IRC formatting codes built from the given instance. When outputting a colour index, this method always outputs it as a two-digit number, to avoid parsing ambiguity if the coloured text starts with a digit. Currently this will only output mIRC-style formatting, not irssi-style. Takes the following options: default_fg => INT Default foreground colour to emit for extents that have only the `bg' tag set. This is required because mIRC formatting codes cannot set just the background colour without setting the foreground as well. TODO * Define a nicer way to do the ANSI terminal colour space of irssi-style formatting codes. AUTHOR Paul Evans