summaryrefslogtreecommitdiff
path: root/docs/design.txt
blob: a1c371f39494ae744c9c229635a9f897d412c47a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150

 Irssi's hierarchy is something like this:


         sub1 sub2
            \ /
       xxx  IRC       COMMON ICQ  yyy
        |____|___________|____|____|
                   |
                  GUI (gtk/gnome, qt/kde, text, none)
                   |
         sub1 sub2 |
            \ /    |
       xxx  IRC    |  COMMON ICQ  yyy
        |____|_____|_____|____|____|
                   |
               COMMON UI
                   |
         sub1 sub2 |
            \ /    |
       xxx  IRC    |    ICQ  yyy
        |____|_____|_____|____|
                   |
                 CORE
                 /
        lib-config


 (IRC, ICQ, xxx and yyy are chat protocols ..)
 (sub1 and sub2 are submodules of IRC module, like DCC and flood protect)


 Chat protocols and frontends are kept in separate modules. Common UI
 and GUI modules also have the common parts which don't know anything
 about the chat protocols. This should allow implementing modules to
 whatever chat protocols and with whatever frontends easily.

 ** Signals

 Communication between different modules are done with "signals". They are
 not related to UNIX signals in any way, you could more like think of them
 as "events" - which might be a better name for them, but I don't really
 want to change it anymore :)

 So, you send signal with signal_emit() and it's sent to all modules that
 have grabbed it by calling signal_add() in their init function. For
 example:

   signal_emit("mysignal", 1, "hello");

 Sends a "mysignal" function with one argument "hello" - before that, you
 should have grabbed the signal somewhere else with:

   static void sig_mysignal(const char *arg1)
   {
     /* arg1 contains "hello" */
   }

   signal_add("mysignal", (SIGNAL_FUNC) sig_mysignal);

 There are three different signal_add() functions which you can use to
 specify if you want to grab the signal first, "normally" or last. You can
 also stop the signal from going any further.

 Emitting signal with it's name creates a small overhead since it has to
 look up the signal's numeric ID first, after which it looks up the signal
 structure. This is done because if you call a signal _really_ often,
 it's faster to find it with it's numeric ID instead of the string. You
 can use signal_get_uniq_id() macro to convert the signal name into ID -
 you'll have to do this only once! - and use signal_emit_id() to emit the
 signal. Don't bother to do this unless your signal is sent (or could be
 sent) several times in a second.

 See src/core/signals.h for defination of the signal function, and
 signals.txt for a list of signals.


 ** lib-config

   Irssi depends on this for reading and saving configuration.
   (created by me for irssi)


 ** CORE module

 Provides some functionality that all other modules can use:
   - signal handling
   - keeping list of settings
   - keeping list of /commands
   - keeping track of loaded modules
   - networking functions (with nonblocking connects, IPv6 support)
   - handles connecting to servers
   - raw logging of server's input/output data
   - /EVAL support
   - fgets() like function line_split() without any maximum line limits
   - command line parameter handling
   - miscellaneous useful little functions
   - handles logging


 ** COMMON UI module

   - knows basics about windows and window items (=channels, queries, ..)
   - printtext() - parsing texts and feeding it for GUI to print.
   - themes
   - translation tables
   - text hilighting
   - command history
   - user interface (/commands) for CORE's functionality


 ** GUI modules

   - all the rest of the functionality needed for a working client.


 ** IRC module

   * CORE

     - IRC specific /commands
     - flood protecting commands sent to server
     - creating IRC masks based on nick/address for bans, ignores, etc.
     - keeps list of channels, nicks, channel modes, bans, etc.
     - keeps list of servers, server settings, irc networks,
       server reconnections and irc network splits
     - redirection of commands' replies
     - lag detection
     - ctcp support and flood protection
     - Handles ignoring people

   * DCC

     - DCC chat, send and get

   * FLOOD

     - detects private or channel flooding and sends "flood" signal
     - automatic ignoring when flooding

   * NOTIFYLIST

     - handles notifylist


 ** IRC UI module

   - placing channels and queries in windows
   - nick completion
   - printing infomation of some events