Mercurial > pidgin
annotate plugins/ChangeLog @ 1038:daad2440a642
[gaim-migrate @ 1048]
i have homework i need to be doing. it's due in less than 7 hours, and i haven't started and i need to sleep.
committer: Tailor Script <tailor@pidgin.im>
author | Eric Warmenhoven <eric@warmenhoven.org> |
---|---|
date | Tue, 31 Oct 2000 10:49:53 +0000 |
parents | 91b7377e7b45 |
children | ece2d1543b20 |
rev | line source |
---|---|
1000
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
1 version 0.11.0: |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
2 Gaim is now multi-connection based. This represents a significant |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
3 change. Most of the code was modified, though most of the modifications |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
4 were small (referencing an int as part of a struct as opposed to as a |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
5 global int). Such changes will require most plugins to be modified to |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
6 match the new function declarations and such. |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
7 |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
8 The plugin system itself was only slightly modified. However, the |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
9 arguments passed to signal handlers have been modified in some cases. |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
10 Look at the updates SIGNALS file to see what the new arguments passed |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
11 to your handlers are. In some cases the only change necessary will be |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
12 to modify the function declaration; in many cases the changes will be |
1038
daad2440a642
[gaim-migrate @ 1048]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
1000
diff
changeset
|
13 much more substantial. The only thing really to say here is that there |
daad2440a642
[gaim-migrate @ 1048]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
1000
diff
changeset
|
14 is no more event_blist_update. This event may make a comeback, but |
daad2440a642
[gaim-migrate @ 1048]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
1000
diff
changeset
|
15 that seems doubtful at this point. The good news is that you shouldn't |
daad2440a642
[gaim-migrate @ 1048]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
1000
diff
changeset
|
16 need it anymore anyway. |
1000
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
17 |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
18 The new system allows for protocol plugins. New protocols (including |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
19 Yahoo, MSN, IRC, ICQ, etc) can be loaded dynamically. However, most |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
20 of these plugins are going to be controlled by the gaim maintainers. |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
21 If you have interest in writing a protocol plugin, please talk to one |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
22 of us before you start. |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
23 |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
24 That's about all that I'm going to talk about. My SN is EWarmenhoven |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
25 if you have any questions (like what the hell struct gaim_connection is |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
26 and what its relation to struct aim_user is). |
91b7377e7b45
[gaim-migrate @ 1010]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
834
diff
changeset
|
27 |
591
a26eb4c472d8
[gaim-migrate @ 601]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
445
diff
changeset
|
28 version 0.10.0: |
a26eb4c472d8
[gaim-migrate @ 601]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
445
diff
changeset
|
29 Rather than have a separate CFLAGS and LDFLAGS for the plugins than |
a26eb4c472d8
[gaim-migrate @ 601]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
445
diff
changeset
|
30 for gaim, and doing all kinds of crazy things to work around the |
a26eb4c472d8
[gaim-migrate @ 601]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
445
diff
changeset
|
31 problems that creates, the plugins now have the same CFLAGS and LIBS. |
a26eb4c472d8
[gaim-migrate @ 601]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
445
diff
changeset
|
32 The plugins also have PLUGIN_LIBS which can be passed at make time. |
a26eb4c472d8
[gaim-migrate @ 601]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
445
diff
changeset
|
33 This makes things like #ifdef USE_APPLET and #ifdef USE_PERL much more |
775
9614e69f68ca
[gaim-migrate @ 785]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
591
diff
changeset
|
34 reliable. (#include "config.h" in order to get all the #defines) |
591
a26eb4c472d8
[gaim-migrate @ 601]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
445
diff
changeset
|
35 |
780
c714def9cebb
[gaim-migrate @ 790]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
775
diff
changeset
|
36 The internals of gaim plugin events got modified slightly. It should |
c714def9cebb
[gaim-migrate @ 790]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
775
diff
changeset
|
37 have no effect on existing plugins or the way plugins are made. The |
c714def9cebb
[gaim-migrate @ 790]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
775
diff
changeset
|
38 change was to make my life easier adding perl. It should also make |
c714def9cebb
[gaim-migrate @ 790]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
775
diff
changeset
|
39 adding new plugin events even easier than before (though I doubt that |
834
bac7089491c1
[gaim-migrate @ 844]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
808
diff
changeset
|
40 any more will ever be added). Also, events are printed to the debug |
bac7089491c1
[gaim-migrate @ 844]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
808
diff
changeset
|
41 window. |
780
c714def9cebb
[gaim-migrate @ 790]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
775
diff
changeset
|
42 |
c714def9cebb
[gaim-migrate @ 790]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
775
diff
changeset
|
43 event_buddy_away was being triggered every blist_update for every away |
c714def9cebb
[gaim-migrate @ 790]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
775
diff
changeset
|
44 buddy. This got fixed, but now when you sign on, event_buddy_away may |
c714def9cebb
[gaim-migrate @ 790]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
775
diff
changeset
|
45 be called before event_buddy_signon. Not that it should matter much. |
c714def9cebb
[gaim-migrate @ 790]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
775
diff
changeset
|
46 |
808
9d61f3d01046
[gaim-migrate @ 818]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
780
diff
changeset
|
47 Just after I finish saying that no more events will be added, I go and |
9d61f3d01046
[gaim-migrate @ 818]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
780
diff
changeset
|
48 add one. Go figure. Anyway, it's event_new_conversation. Enough people |
9d61f3d01046
[gaim-migrate @ 818]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
780
diff
changeset
|
49 asked me to add it, and I found it useful enough, that I finally did |
9d61f3d01046
[gaim-migrate @ 818]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
780
diff
changeset
|
50 add it. It gets passed a char *, the name of the person who the |
9d61f3d01046
[gaim-migrate @ 818]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
780
diff
changeset
|
51 conversation is with. This gets triggered when a new conversation |
9d61f3d01046
[gaim-migrate @ 818]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
780
diff
changeset
|
52 window is created, in case you couldn't figure it out on your own. |
9d61f3d01046
[gaim-migrate @ 818]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
780
diff
changeset
|
53 |
834
bac7089491c1
[gaim-migrate @ 844]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
808
diff
changeset
|
54 event_blist_update wasn't being called if you weren't reporting idle |
bac7089491c1
[gaim-migrate @ 844]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
808
diff
changeset
|
55 time or if you were idle. This got fixed. |
bac7089491c1
[gaim-migrate @ 844]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
808
diff
changeset
|
56 |
391 | 57 version 0.9.20: |
58 It's 3 am the night before finals, it's obviously a good time to hack | |
59 gaim. | |
60 | |
425
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
61 This became quite long, and if you don't want to read it all, here's |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
62 the important stuff summed up: |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
63 - 9 new events (see SIGNALS file for more details) |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
64 - int gaim_plugin_init(void *) (no longer returns void, see error.c) |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
65 - void gaim_plugin_unload(void *) (to allow plugin to remove itself) |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
66 - can only load 1 instance of the same plugin |
445
e4c34ca88d9b
[gaim-migrate @ 455]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
425
diff
changeset
|
67 - PLUGIN_LIBS for extra libraries for plugin |
425
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
68 |
391 | 69 The first thing to note is that there are about 9 new events plugins |
70 can attach to, most of them dealing with chat, since I know that was a | |
71 big thing that was missing. Please note that I was nice and decided to | |
72 tack these extra events onto the end of the enum, which means that | |
73 plugins do not have to be recompiled in order for them to still work. | |
74 | |
425
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
75 The big change is that gaim_plugin_init no longer returns void, but |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
76 int. If it returns 0+, gaim interprets this as there being no error, |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
77 and continues with loading as normal. (This should be backwards- |
398
59d97cd251ff
[gaim-migrate @ 408]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
394
diff
changeset
|
78 compatible: returning 0/1 is the equivalent of returning void.) If it |
59d97cd251ff
[gaim-migrate @ 408]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
394
diff
changeset
|
79 returns a number less than 0, there was an error loading detected by |
394
f73dc7d32ede
[gaim-migrate @ 404]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
392
diff
changeset
|
80 the plugin. At that point, gaim will try to clean things up by removing |
f73dc7d32ede
[gaim-migrate @ 404]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
392
diff
changeset
|
81 any callbacks that have been added by the plugin. It will then try to |
f73dc7d32ede
[gaim-migrate @ 404]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
392
diff
changeset
|
82 call the plugin's gaim_plugin_error function, if there is one. The |
f73dc7d32ede
[gaim-migrate @ 404]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
392
diff
changeset
|
83 function should take an int (the int returned by gaim_plugin_init) and |
f73dc7d32ede
[gaim-migrate @ 404]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
392
diff
changeset
|
84 return a char*. If the char* is not NULL, it is displayed by gaim as an |
f73dc7d32ede
[gaim-migrate @ 404]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
392
diff
changeset
|
85 error message. The plugin is then unloaded and closed and life goes |
f73dc7d32ede
[gaim-migrate @ 404]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
392
diff
changeset
|
86 back to normal. If any of that was confusing, it was confusing to me, |
f73dc7d32ede
[gaim-migrate @ 404]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
392
diff
changeset
|
87 too. I added a plugin, error.c, which should help clear things up. |
392
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
88 |
425
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
89 Another big thing to note is that plugins can unload themselves. A good |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
90 example of why this is useful is a ticker plugin. If the user closes |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
91 the ticker window, they obviously want the plugin to be unloaded. Gaim |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
92 has no way of knowing that; therefore, the plugin must tell gaim that |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
93 it is to be unloaded. To have a plugin unload itself, simply call |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
94 gaim_plugin_unload(void *) (the void* is the handle passed to |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
95 gaim_plugin_init). Because you are explicitly asking to be removed, |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
96 gaim assumes that you have done any cleanup already, and so does not |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
97 call gaim_plugin_remove. Rather, it simply removes your callbacks and |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
98 unloads the plugin. (There is some trickery to this. Think about it: |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
99 your plugin calls the function, your plugin is unloaded, and execution |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
100 returns to your plugin, which no longer exists. This would cause a |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
101 segfault if it behaved exactly as described. Instead, the plugin is |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
102 removed from the list of plugins, and removed 5 seconds later. By then |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
103 the plugin should be effectively gone, though still in memory.) |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
104 |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
105 In previous versions of gaim, you could load multiple copies of the |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
106 same plugin. This is no longer the case. The reason for this was that |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
107 there were not two instances of the plugin in memory; rather, one copy |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
108 and two structures representing the same plugin. Then, the callbacks |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
109 would be called twice (since the plugin would most likely act the same |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
110 across multiple instances), and when one was unloaded, all callbacks |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
111 for both instances would be removed. Rather than deal with two copies |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
112 of the same plugin, it is easier and cleaner to only handle one. |
ae7c762775cd
[gaim-migrate @ 435]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
404
diff
changeset
|
113 |
445
e4c34ca88d9b
[gaim-migrate @ 455]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
425
diff
changeset
|
114 Sometimes it's necessary to link a plugin with libraries other than the |
e4c34ca88d9b
[gaim-migrate @ 455]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
425
diff
changeset
|
115 ones needed for GTK. Before, it was necessary to modify the Makefile to |
e4c34ca88d9b
[gaim-migrate @ 455]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
425
diff
changeset
|
116 do so (which was usually messy since it's generated by GNU automake). |
e4c34ca88d9b
[gaim-migrate @ 455]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
425
diff
changeset
|
117 Now, you can simply set the environment variable PLUGIN_LIBS to be the |
e4c34ca88d9b
[gaim-migrate @ 455]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
425
diff
changeset
|
118 extra libraries you want to link in. For example, to link plugin.c with |
e4c34ca88d9b
[gaim-migrate @ 455]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
425
diff
changeset
|
119 the math library, you can run the command |
e4c34ca88d9b
[gaim-migrate @ 455]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
425
diff
changeset
|
120 PLUGIN_LIBS=-lm make plugin.so |
e4c34ca88d9b
[gaim-migrate @ 455]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
425
diff
changeset
|
121 To link with multiple plugins, make sure to indicate spaces, e.g. |
e4c34ca88d9b
[gaim-migrate @ 455]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
425
diff
changeset
|
122 PLUGIN_LIBS='-lm -lcrypt' make encrypt.so |
e4c34ca88d9b
[gaim-migrate @ 455]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
425
diff
changeset
|
123 |
392
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
124 There is a new event, event_quit, which signifies that gaim has exited |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
125 correctly (i.e. didn't segfault). Also, after this event is called, all |
404
3d94cc1dc424
[gaim-migrate @ 414]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
398
diff
changeset
|
126 plugins are removed, and their gaim_plugin_remove function is called. |
392
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
127 This behavior is different from previous versions; however, it is the |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
128 proper way of doing things, and should have no effect on current |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
129 plugins. The reason event_quit exists despite plugins being removed at |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
130 quit is because a plugin can be removed without gaim quitting. They are |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
131 distinctly separate events. |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
132 |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
133 The new events mean that some versions of gaim have certain events, |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
134 others don't. The thing I find fascinating though is that even if a |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
135 plugin is compiled for a later version, it will still be backwards- |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
136 compatible, even if it makes use of the newer events. The reason why |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
137 is the names of the events are stored as integers, and those integers |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
138 will never match an event in a prior version. This means you don't |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
139 have to worry about which version the person is using, only which |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
140 version the person is compiling against. For simplicity's sake, please |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
141 assume people are compiling against the latest version. For |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
142 practicality's sake, VERSION is #define'd to be the version you're |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
143 compiling against, starting with 0.9.20. Prior versions do not have |
df5127560034
[gaim-migrate @ 402]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
391
diff
changeset
|
144 this defined in the standard plugin Makefile. |