From b854223178414450aef93787dbbfbf06143c9b95 Mon Sep 17 00:00:00 2001 From: Emanuele Giaquinta Date: Wed, 5 Mar 2008 10:41:22 +0000 Subject: Add recode documentation. git-svn-id: http://svn.irssi.org/repos/irssi/trunk@4730 dbcabf3a-b0e7-0310-adc4-f8d773084564 --- docs/manual.txt | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) (limited to 'docs/manual.txt') diff --git a/docs/manual.txt b/docs/manual.txt index 4bcb11f3..3ac48b1a 100644 --- a/docs/manual.txt +++ b/docs/manual.txt @@ -24,7 +24,7 @@ 13. Themes 14. Last log (currently text version only) 15. Nick and word completion - 16. Translation tables + 16. Recode 17. Windowing system (text version) 18. Keyboard (text version) 19. Perl scripting @@ -977,6 +977,31 @@ If is a You can disable this feature by setting awaylog_level to NONE. + 16. Recode + + irssi supports selective encoding of incoming/outgoing messages + through the recode system. All incoming/outgoing messages can be + optionally converted to/from the charset specified by the + `term_charset' variable (which defaults to the locale encoding and + should _not_ be changed in most cases), by setting the `recode' + variable to 'ON'. + Since there is no way in IRC to know the encoding associated to a + message, for incoming messages irssi uses the following algorithm: + + if `recode_autodetect_utf8' is 'ON' and the message is valid UTF-8 the + encoding is assumed to be UTF-8. + if an encoding is set for the target (through /recode) use it, + otherwise fallback to the value of `recode_fallback'. + + For outgoing messages it is simpler: + + if an encoding is set for the target (through /recode) use it, + otherwise fallback to the value of `recode_out_default_charset'. + + /SET recode_transliterate - Append '//TRANSLIT' to the destination + encoding for both incoming/outgoing messages. '//TRANSLIT' is a GNU + iconv specific extension to peform transliteration (locale dependent) + when a character is not representable in the destination encoding. .. no, the docs end here, I got bored of writing these after a few days and haven't touched these since then. -- cgit v1.2.3