annotate doc/FAQ @ 10717:75427cc95dfd

[gaim-migrate @ 12312] Might as well update it here also committer: Tailor Script <tailor@pidgin.im>
author Luke Schierer <lschiere@pidgin.im>
date Tue, 22 Mar 2005 16:32:33 +0000
parents 3cfab4626bbf
children 364a2ef907ae
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1 Gaim: The Pimpin' Penguin IM Clone Thats Good For The Soul
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
2
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
3 1. Compiling and Installing
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
4
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
5 1.1. What does "Gaim" stand for?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
6 1.2. Why can't I compile Gaim?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
7 1.3. I'm trying to install Gaim, but it complains that I don't have
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
8 libgtkspell.so.0, from where can I get this?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
9 1.4. What do I need to use the SILC protocol?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
10 1.5. Is there some way I can compile just Gaim, without all of these
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
11 protocols?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
12 1.6. I installed a new version of Gaim, but the about window says I'm
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
13 still using the old version.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
14 1.7. Are the packages signed? If so, by who, and how can I get the
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
15 key?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
16 1.8. Can I use Gaim for GTK+1.2?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
17 1.9. Can I run Gaim on IRIX?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
18 1.10. Can I run gaim on MacOSX?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
19 1.11. How do I apply the patch "something.diff"?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
20 1.12. Why is gaim crashing when I start it?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
21 1.13. Gaim <non-current version> is buggy. Gaim CVS is buggy. Why?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
22 1.14. Why do you always say not to use CVS?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
23
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
24 2. Using Gaim
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
25
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
26 2.1. How do I register for a new account?
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
27 2.2. How do I use AIM, MSN, Yahoo!, Jabber, ICQ, or any other
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
28 protocol?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
29 2.3. How do I change the font Gaim uses?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
30 2.4. How do I make gaim use emacs-like keybindings?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
31 2.5. How do I use smiley themes?
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
32 2.6. Why are the status icons so big?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
33 2.7. Why do the emblems move around the status icon?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
34 2.8. How do I get sound to work correctly?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
35 2.9. How do I make Gaim use ALSA or OSS for playing sounds? What does
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
36 the "Automatic" option do?
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
37 Why does Gaim use the same WM_CLASS for every window? It makes
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
38 2.10. it impossible to control window size and placement for the buddy
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
39 list separately from the conversations.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
40 2.11. I blocked someone accidentally, how can I unblock them?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
41 2.12. What is a "Buddy Pounce"?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
42 2.13. Where does gaim store its logs?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
43 2.14. How can I see my own status with Gaim?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
44 2.15. Can I use Gaim for e-mail, blogging, an RSS feed, or something
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
45 else that isn't IM-related?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
46
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
47 3. Features
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
48
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
49 3.1. Does Gaim support file transfer?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
50 3.2. Is there a Gaim tray icon, or docklet, or gnome applet, or panel
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
51 icon, or something?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
52 3.3. What do those colors in the conversation tab mean?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
53 3.4. Will Gaim save my buddy list to the server?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
54 3.5. Can I import or export my buddy list?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
55 3.6. Does Gaim support animated smileys?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
56 3.7. Can I make Gaim group screen names by the person that owns them?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
57 You know, like Trillian's Meta Contacts?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
58 3.8. How do I get the old logging back?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
59 3.9. How can I convert my old logs to the new format?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
60
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
61 4. ICQ Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
62
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
63 4.1. How do I use ICQ?
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
64 4.2. Can I send SMS messages?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
65
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
66 5. TOC Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
67
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
68 5.1. What is the TOC protocol?
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
69
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
70 6. AIM/ICQ (OSCAR) Protocol
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
71
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
72 6.1. Can I set my profile?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
73 6.2. Can I set a buddy icon?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
74 6.3. Some of my buddies are not showing up as online, why is that?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
75 6.4. Can I use AIM URI's such as "aim:goim?screenname=robflynn"?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
76 6.5. I just changed my buddy icon, and I can't see the new one.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
77 6.6. Does Gaim support DirectIM and IM Image?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
78 6.7. Can I send SMS messages?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
79 6.8. Can I add SMS numbers to my buddy list?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
80 6.9. I heard AOL is combining ICQ and AIM, does that mean I can send
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
81 a message from an AIM account to an ICQ account and vice-versa?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
82 6.10. Why can't I connect via either Oscar or TOC?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
83 English is not my native language, and some of my friends have
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
84 6.11. trouble seeing my IMs/I have trouble seeing my friends' IMs. How
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
85 do I use a native language character set with ICQ?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
86
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
87 7. IRC Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
88
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
89 7.1. How do I join a channel with the IRC plugin?
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
90 7.2. Is there a way to make Gaim automatically identify me and/or join
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
91 IRC chats on login?
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
92
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
93 8. Jabber Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
94
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
95 8.1. How do I choose which Jabber server to use?
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
96 8.2. How do I change my Jabber resource to be other than the default
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
97 of "/Gaim"?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
98 8.3. How do I register a new Jabber account?
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
99 8.4. How do I use invisibility?
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
100 I've a buddy that I keep removing from my buddy list but the
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
101 8.5. entry keeps coming back every time I log in again! How can I stop
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
102 this?
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
103 8.6. Can I remove a buddy from my Jabber roster entirely?
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
104 8.7. What does "Cancel Presence Notification" do?
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
105
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
106 9. Y!M (Yahoo) Protocol
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
107
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
108 9.1. I cannot connect to Yahoo! and get "Invalid Password" errors, or
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
109 I'm using a version of Gaim older than 0.79!
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
110 9.2. I cannot connect to Yahoo! and I'm behind a firewall or NAT. Why
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
111 doesn't Gaim have Yahoo's "Firewall with no proxy" option?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
112 9.3. I blocked someone, but it doesn't seem to have worked.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
113 9.4. Can I get a list of Yahoo! Chat rooms? What about non-US lists?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
114 9.5. What protocol does Gaim use to connect to Yahoo!?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
115
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
116 10. MSN Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
117
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
118 10.1. Why are my file transfers so slow?
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
119 10.2. I'm getting lots of "Already in Opposite list" errors on MSN,
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
120 why?
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
121 10.3. Is there a way to invite more than one person to an MSN chat?
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
122 10.4. Is MSNP9 (MSN6) going to be supported?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
123 Will I be able to use Gaim for MSN after October 15th 2003?
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
124 10.5. (The day they're preventing third party clients from
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
125 connecting)
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
126 10.6. I just upgraded Gaim and the MSN plugin will not load. Why?
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
127 10.7. The MSN plugin won't load, but I have Mozilla NSS!
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
128 10.8. What does "MSN: S: 911 3" in the debug window mean when I
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
129 cannot connect to MSN?
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
130 10.9. How do I set an MSN avatar?
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
131 10.10. What does "Has you" in the buddy tooltip mean?
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
132 10.11. How do I set my MSN Friendly Name (the name other users see)?
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
133 10.12. What does "Error reading from switchboard server" mean?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
134
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
135 11. Gadu-Gadu Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
136
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
137 11.1. What is Gadu-Gadu?
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
138 11.2. Why doesn't it work right?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
139
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
140 12. Zephyr Protocol
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
141
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
142 12.1. What is Zephyr?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
143 12.2. Other Zephyr clients (zwgc,owl,tzc) work, but Gaim dies with
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
144 "Couldn't initialize zephyr".
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
145 12.3. Gaim isn't working, but I never got any other Zephyr client
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
146 working on this machine.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
147 12.4. How do I use Zephyr from behind my firewall, or without
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
148 recompiling with kerberos support if needed?
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
149
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
150 13. SILC Protocol
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
151
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
152 13.1. What is SILC?
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
153
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
154 14. Novell Protocol
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
155
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
156 14.1. Are there any public servers for Novell?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
157 14.2. I can't seem to get it to work.
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
158
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
159 15. Scripts and Plugins
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
160
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
161 15.1. How do I use perl scripts with Gaim?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
162 15.2. How do I compile a plugin for Gaim?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
163 15.3. I have a plugin or perl script for Gaim that used to work, but
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
164 does not with the current version.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
165 15.4. Where can I find documentation on writing plugins and Perl
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
166 scripts?
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
167
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
168 16. Development
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
169
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
170 16.1. Can I help?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
171 16.2. Gaim never leaves a core file.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
172 16.3. Where should I report bugs?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
173 16.4. Where should I submit patches?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
174 16.5. Did you guys reverse engineer it?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
175
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
176 17. Misc. Questions
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
177
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
178 17.1. Can I IM you guys?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
179 17.2. Hello?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
180 Can I give you money/hardware/other expensive things that can be
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
181 17.3. hocked for cash what with you all being students/
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
182 full-time-workers and helping to produce this wonderful software
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
183 instead of studying/sleeping?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
184 17.4. Does Gaim support secure instant messaging (encrypted IMs)?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
185 17.5. Why are the passwords in accounts.xml not encrypted?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
186 17.6. What is gaim-remote?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
187 17.7. When will the next version of Gaim be released?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
188 17.8. What will the next version be?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
189 17.9. So, can I look forward to mega-sexy super functionality with
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
190 Gaim?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
191
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
192 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
193 | 1. Compiling and Installing
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
194 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
195
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
196 1.1 What does "Gaim" stand for?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
197
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
198 For freedom! No, seriously, it doesn't stand for anything. It's our name and
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
199 we're sticking to it. The two acceptable forms of capitalization are "Gaim"
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
200 and "gaim" (and not "GAIM").
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
201
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
202 1.2 Why can't I compile Gaim?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
203
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
204 Make sure you have relatively recent versions of automake, autoconf, and
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
205 gettext. HOWEVER, generally speaking, having the absolute newest of them is
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
206 not as good as having one version short of newest since we might not have
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
207 found work-arounds for the latest set of changes. Also, some versions of
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
208 automake require certain ranges of gettext versions, and we are utterly
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
209 unable to keep track of what versions will work with what other versions.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
210
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
211 If you have Slackware < 9.1, you need to get non-slack packages for autoconf,
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
212 automake, gettext, and libtool. You also have to copy the contents of /usr/
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
213 local/share/aclocal to /usr/share/aclocal. This is due to bugs in Slackware
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
214 and the auto* packages.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
215
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
216 *BSD users may also have problems with libtool and will also have to remove
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
217 the --no-verify from the configure script.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
218
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
219 Having problems getting SSL and MSN working? See http://gaim.sf.net/
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
220 faq-ssl.php for distribution specific hints.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
221
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
222 1.3 I'm trying to install Gaim, but it complains that I don't have
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
223 libgtkspell.so.0, from where can I get this?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
224
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
225 libtgtkspell.so.0 is provided by gtkspell. This library is used by Gaim to
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
226 provide the "Highlight misspelled words" feature. You can find an RPM of
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
227 gtkspell at freshrpms.net. You can find the source and a non-Red Hat specific
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
228 RPM at gtkspell.sourceforge.net.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
229
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
230 1.4 What do I need to use the SILC protocol?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
231
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
232 You need to install the SILC toolkit (http://silcnet.org/software/download/
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
233 toolkit/) and the Gaim SILC plugin. This plugin is generally provided as a
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
234 separate package (such as a gaim-silc RPM). If you're compiling yourself, see
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
235 the ./configure --help for specifying the SILC includes and libs. If you're
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
236 compiling an SRPM, use --with silc to build the gaim-silc RPM.
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
237
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
238 In Windows, the SILC toolkit is installed with Gaim.
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
239
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
240 Some distributions provide the SILC toolkit and include Gaim's SILC plugin in
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
241 their Gaim package.
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
242
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
243 1.5 Is there some way I can compile just Gaim, without all of these protocols?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
244
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
245 Yeah. There are actually three ways to do it.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
246
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
247 1. Use the --with-static-prpls option to ./configure along with
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
248 --disable-plugins. This will let you choose which protocols are compiled
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
249 in with Gaim, but you will not be able to use any other protocols or
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
250 plugins.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
251
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
252 You'll need to compile any protocols that you specified in
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
253 --with-static-prpls. Oscar and TOC are defaults.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
254
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
255 2. Use the --with-dynamic-prpls option to ./configure
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
256
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
257 3. Change to the directories for the protocols you want to compile (e.g. src
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
258 /protocols/jabber), and run make from there. Then after you've compiled
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
259 all of them, change back to src/ and run make gaim.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
260
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
261 1.6 I installed a new version of Gaim, but the about window says I'm still
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
262 using the old version.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
263
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
264 If you compiled yourself, and you previously had an RPM or a Debian package
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
265 installed, you need to remove that first. rpm -e gaim or dpkg -p gaim should
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
266 work.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
267
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
268 Likewise, if you want to use an RPM or deb and you have previously compiled
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
269 Gaim from source, you need to make uninstall to remove all Gaim files from /
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
270 usr/local.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
271
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
272 1.7 Are the packages signed? If so, by who, and how can I get the key?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
273
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
274 Yes, all packages are signed. The signature for the tarball and bzip2 archive
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
275 are provided by separate downloads. The RPMs we provide are signed by either
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
276 Ethan Blanton, Mark Doliner, or Christian Hammond. Usually the Mandrake and
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
277 Fedora Core 1 RPMs are signed by Mark Doliner and the Red Hat 8 and 9 RPMs
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
278 are signed by Ethan Blanton. The keys can be obtained from any key server.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
279 http://pgp.mit.edu/ is popular.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
280
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
281 1.8 Can I use Gaim for GTK+1.2?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
282
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
283 As of version 0.60, Gaim has been completely converted to using GTK+2.0. We
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
284 really really really recommend using the most current version of Gaim and not
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
285 a GTK+1.2 version of Gaim. However, if you are living in the '90s, or you're
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
286 afraid GTK+2.0 will insult your mother, you can use Gaim 0.59.9, which is the
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
287 last version of Gaim that used GTK+1.2. We should warn you though, this
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
288 version of Gaim hasn't had any new features since the middle of 2002, and
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
289 some protocols likely do not work. Also, the 0.59.x releases aren't
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
290 breathtakingly beautiful.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
291
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
292 1.9 Can I run Gaim on IRIX?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
293
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
294 It has been done before. Please see http://sourceforge.net/forum/forum.php?
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
295 thread_id=725839&forum_id=665 at our SourceForge Forum.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
296
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
297 1.10 Can I run gaim on MacOSX?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
298
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
299 Yes you can, but we do not provide a package for it. The reason being is that
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
300 to use gaim on MacOSX, you need to install an X server and gtk, which we are
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
301 not prepared to support. You can either compile gaim (and its dependencies)
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
302 yourself, or you can use the fink installer available from http://fink.sf.net
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
303 . If you would like a native aqua interface or a user-friendly installer, we
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
304 suggest trying Adium (http://www.adiumx.com/).
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
305
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
306 1.11 How do I apply the patch "something.diff"?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
307
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
308 Type patch -p0 < something.diff from inside the gaim directory. If that
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
309 doesn't work, try patch -p1 < something.diff.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
310
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
311 1.12 Why is gaim crashing when I start it?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
312
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
313 First of all make sure you are using the most recent version of Gaim. If you
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
314 still have problems, try the following:
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
315
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
316 • Make sure only one version of Gaim is installed. "whereis gaim" can
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
317 sometimes be useful for determining this.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
318 • "export GDK_USE_XFT=0" in a terminal and then run Gaim from the same
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
319 terminal.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
320 • If gaim is not crashing, but is just sitting there not displaying
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
321 anything, try turning off anything else that might be using the sound
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
322 device (ie xmms) and then starting gaim. If this fixes the problem, it is
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
323 a libao issue, not a gaim issue, and can be worked around by the use of
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
324 esd or arts.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
325 • Try disabling or deleting any 3rd party plugins, especially anything
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
326 related to encryption.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
327 • If you use 0.75 or higher on win32, try deleting tcl.dll.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
328 • If you have ever installed 0.65, edit your ~/.gaimrc, changing your auto
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
329 away preference from -1 to 0.
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
330
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
331 1.13 Gaim <non-current version> is buggy. Gaim CVS is buggy. Why?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
332
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
333 Non-current versions have old bugs which may be fixed in the current
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
334 version--that's why we make new releases. CVS is frequently unusable because
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
335 of changes in the code. Bugs are introduced during the development process
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
336 and are hopefully fixed before a release is made.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
337
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
338 1.14 Why do you always say not to use CVS?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
339
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
340 That's a long story. For starters, see the previous question. It is often the
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
341 case that Gaim CVS exhibits bad behavior due to features and bugfixes which
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
342 are in a transitory state or which are not yet well understood. These bad
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
343 behaviors range from the harmless (maybe a graphical glitch in a dialog box)
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
344 to the irritating (a particular protocol may not work), to the downright
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
345 damaging (recently a bug in CVS destroyed the user's buddy lists). While
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
346 behaviors like this are acceptable to some users (particularly developers,
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
347 who are used to such things), they tend to cause many Gaim CVS users to
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
348 contact Gaim developers and report the same (usually egregious) bug over and
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
349 over - using time which could be better spent fixing the bugs.
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
350
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
351 A second major point involves public resources - a CVS checkout is not a
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
352 cheap operation. As many Sourceforge users are aware, at various points in
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
353 the recent past Sourceforge CVS has been less than pleasant to work with.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
354 This is, of course, because Sourceforge hosts dozens and dozens of useful and
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
355 active projects which use CVS as a primary method of source code
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
356 collaboration. Unfortunately, when too many users are poking around in that
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
357 CVS just for the sake of poking around, it prevents other users who are
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
358 trying to do work to improve those very same projects from accomplishing
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
359 their tasks. It is better for the community if an enterprising individual
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
360 wishing to fix a particular bug she has seen can get to the code and create a
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
361 patch, even if this means that some users have to wait a few weeks for the
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
362 next release to see what new features it might hold.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
363
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
364 The third point is not a problem which has yet come up, but it is in the back
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
365 of the mind of the developers who bring you Gaim. As a third-party IM client,
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
366 Gaim is not a priority (and indeed may be an irritant) for the IM service
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
367 providers. We do our best to keep Gaim playing nice and being friendly on the
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
368 IM networks it uses; however, at times there are bugs in the protocol
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
369 support. If a few dozen people are using this buggy client, the IM providers
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
370 are not likely to go out of their way to do anything about it. However, if
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
371 hundreds of people are pointing an ill-behaved client at an IM server, the
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
372 server administrators may be forced to take action. (This is particularly
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
373 likely if the buggy behavior is damaging in some way.) Gaim releases
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
374 represent code which the gaim developers feel is relatively well-behaved and
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
375 stable. This includes not only the interface seen by Gaim users, but the
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
376 traffic seen by IM service providers. Gaim CVS bears no such guarantees.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
377
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
378 In short, there are a lot of good reasons to not use Gaim CVS if one does not
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
379 wish to develop Gaim, Gaim plugins, or a codebase which interacts with Gaim
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
380 in some intimate way. There are, however, only a few reasons to use Gaim CVS
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
381 outside of the above. Please weigh these things carefully and decide whether
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
382 you wish to use Gaim CVS for a good reason which furthers the community, or
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
383 for selfish reasons which are not entirely important.
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
384
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
385 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
386 | 2. Using Gaim
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
387 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
388
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
389 2.1 How do I register for a new account?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
390
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
391 This depends on the protocol.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
392
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
393 AIM: Go to http://my.screenname.aol.com/_cqr/login/login.psp?siteId=
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
394 snshomepage&authLev=1&mcState=initialized&createSn=1.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
395
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
396 MSN (including Hotmail email): Go to http://registernet.passport.com/.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
397
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
398 MSN (using your own email address): Go to http://register.passport.net/.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
399
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
400 Yahoo: Go to http://edit.yahoo.com/config/eval_register.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
401
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
402 Jabber: See the question How do I register a new Jabber account? below.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
403
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
404 ICQ: Go to http://web.icq.com/register.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
405
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
406 Gadu-Gadu: Use the official client to create an account.
9178
3b25c1042973 [gaim-migrate @ 9973]
Luke Schierer <lschiere@pidgin.im>
parents: 8736
diff changeset
407
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
408 Novell: See your Novell server administrator.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
409
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
410 2.2 How do I use AIM, MSN, Yahoo!, Jabber, ICQ, or any other protocol?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
411
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
412 Use the Account Editor (Tools->Accounts, or the Accounts button on the start
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
413 screen) to add the account of the appropriate messaging service. Use the
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
414 checkbox in the account editor to sign online.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
415
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
416 2.3 How do I change the font Gaim uses?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
417
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
418 The font preference in Gaim is used only for the formatting of outgoing
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
419 messages. The display fonts used by the rest of Gaim are those specified by
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
420 GTK. To change this font you need to edit your ~/.gtkrc-2.0 file. If you need
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
421 help you can see our example .gtkrc-2.0 (http://gaim.sf.net/gtkrc-2.0) file.
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
422 On Windows, this file is located at C:\Documents and Settings\username
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
423 \.themes\Default\gtk-2.0\gtkrc.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
424
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
425 You can also just switch to a different GTK theme. You can find GTK themes
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
426 (and information on using them) by visiting themes.freshmeat.net,
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
427 art.gnome.org, or searching on Google.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
428
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
429 If you're having a problem with the font size used by a specific person, you
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
430 can try turning on the Ignore Font Sizes preference in Preferences->Message
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
431 Text.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
432
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
433 2.4 How do I make gaim use emacs-like keybindings?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
434
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
435 You need to edit your ~/.gtkrc-2.0 to contain the keybindings line from http:
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
436 //gaim.sf.net/gtkrc-2.0.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
437
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
438 2.5 How do I use smiley themes?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
439
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
440 To select a theme, open Gaim's preferences to the "Smiley Themes" page and
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
441 click on whichever theme you want to use. To install a theme, simply drag it
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
442 into the theme selector. You can find themes on the Gaim Smiley Themes (http:
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
443 //gaim.sf.net/themes.php) page.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
444
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
445 You can also install themes manually by uncompressing them to their own
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
446 directory in ~/.gaim/smileys/
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
447
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
448 2.6 Why are the status icons so big?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
449
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
450 We believe that, by adding a second line of text to each buddy list entry,
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
451 we're able to show more information about each buddy on the buddy list. The
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
452 'Big List,' as we call it, shows status text, idle time, and warning level
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
453 concisely and attractively. It shows more than one status "emblem" for each
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
454 buddy, indicating at the same time a mobile user who is away. Most
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
455 importantly, it puts the buddy icon in the list, making it far easier to
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
456 locate buddies within a large list where names are harder to pick out than
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
457 images. Due to the increased usability of this interface, we have made it the
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
458 default.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
459
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
460 We are aware that some people feel more comfortable using an interface more
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
461 similar to IM clients they may have used in the past. The 'Big List' can be
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
462 disabled by un-checking "Show buddy icons" in the Buddy List preferences.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
463
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
464 2.7 Why do the emblems move around the status icon?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
465
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
466 The four corners of the icon have different precedence. The lower-right is
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
467 the highest, lower-left is second-highest, etc. The most important emblem is
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
468 in the lower-right, always. When an AOL buddy is not away, the fact that [s]
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
469 he's an AOL user is the most important information shown in the icon. The
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
470 consistency is that the user can always look in the same place on the icon to
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
471 find out what he needs to know. Also, importantly, the lower-right corner
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
472 emblem is the only emblem that shows up when "Small list" is on, as only one
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
473 emblem would fit.
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
474
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
475 2.8 How do I get sound to work correctly?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
476
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
477 Gaim uses libao to play sounds. Playing sounds directly through esound or
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
478 arts is no longer supported.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
479
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
480 `Libao is a cross-platform library that allows programs to output PCM audio
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
481 data to the native audio devices on a wide variety of platforms. It currently
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
482 supports OSS (Open Sound System), ESD (ESounD), ALSA (Advanced Linux Sound
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
483 Architecture), Sun audio system (used in Solaris, OpenBSD, and NetBSD), aRts
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
484 (Analog Realtime Synthesizer). '
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
485
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
486 To compile Gaim with support for libao you need libao-devel and
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
487 audiofile-devel. To use libao you need libao and audiofile. If you do not
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
488 wish to install these packages you can also just change your sound playing
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
489 method in preferences to Command and use esdplay %s or artsplay %s.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
490
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
491 2.9 How do I make Gaim use ALSA or OSS for playing sounds? What does the
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
492 "Automatic" option do?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
493
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
494 If you choose "Automatic", "ESD", or "Arts", Gaim uses libao to play sounds.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
495 Choosing "ESD" or "Arts" forces libao to play sounds using that method, while
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
496 choosing "Automatic" lets it decide for itself.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
497
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
498 If you choose "Automatic", you can create a file, either /etc/libao.conf or ~
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
499 /.libao, and put one of the following lines in it:
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
500
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
501 default_driver=alsa
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
502
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
503 default_driver=oss
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
504
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
505 Other drivers, like alsa09, arts, esd, irix, macosx, and sun might also be
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
506 supported, depending on your platform and how libao was compiled. See also
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
507 man 5 libao.conf.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
508
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
509 2.10 Why does Gaim use the same WM_CLASS for every window? It makes it
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
510 impossible to control window size and placement for the buddy list
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
511 separately from the conversations.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
512
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
513 Both strings in the WM_CLASS property are supposed to be the same for all
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
514 windows in the same instance of an application. ICCCM states that one is
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
515 meant to be the same for all instances of the application, the other is meant
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
516 to be unique to that instance of the application. ICCCM also states "If a
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
517 client has multiple windows with identical WM_CLASS and WM_NAME properties,
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
518 then it should provide a WM_WINDOW_ROLE property."
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
519
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
520 Gtk+ sets these WM_CLASS values for us so that they are unique for Gaim
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
521 instances, and the documentation for the gtk_window_set_wmclass function says
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
522 explicitly not to use it for anything else. Gaim uses the WM_WINDOW_ROLE hint
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
523 to differentiate windows. If your window manager is having problems
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
524 differentiating between Gaim windows, please ensure that it uses the
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
525 WM_WINDOW_ROLE hint per the ICCCM.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
526
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
527 2.11 I blocked someone accidentally, how can I unblock them?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
528
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
529 See the "Privacy" option under the "Tools" menu of the Buddy List.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
530
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
531 2.12 What is a "Buddy Pounce"?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
532
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
533 Gaim introduced buddy pounces a few releases before AOL came out with "Buddy
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
534 Alerts." Despite this though, you could think of a buddy pounce as an Alert
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
535 and get an idea of the most minimal uses of a buddy pounce. In reality, a
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
536 buddy pounce is much like a macro, or a recorded action. When you set a
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
537 pounce on someone, you choose from a number of events, such as sign on or
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
538 someone going away, and then you choose from a number of actions. These
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
539 actions include everything from playing a sound (like an Alert would do) to
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
540 sending a message to the person, to executing a command. This action will
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
541 occur the next time gaim detects the event, ie the next time the person in
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
542 your buddy list who you have pounced signs on.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
543
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
544 2.13 Where does gaim store its logs?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
545
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
546 On unix, they are in ~/.gaim/logs, on win32 they are in the $drive\Documents
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
547 and Settings\user\Application Data\.gaim\logs directory. In either case, new
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
548 logs (new as of 0.73) are in subdirectories that correspond to protocol/
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
549 yourscreenname/theirscreenname.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
550
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
551 2.14 How can I see my own status with Gaim?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
552
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
553 Currently the only supported method to see your own status is to add yourself
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
554 to your buddy list. This works with Aim, ICQ, Y!M, IRC, and some of the
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
555 others, and is mimiced by gaim for MSN and Jabber.
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
556
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
557 2.15 Can I use Gaim for e-mail, blogging, an RSS feed, or something else that
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
558 isn't IM-related?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
559
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
560 No, you can't. We get requests for this often, but Gaim is indeed a messaging
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
561 client. Aside from the capabilities each protocol may support, the Gaim
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
562 developers have no intention to turn Gaim into a multi-feature Internet
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
563 client capable of doing everything under the sun. We also won't be helping to
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
564 develop plugins to turn it into that. There are many Internet applications
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
565 available for Linux, Windows, or whatever operating system you use that would
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
566 undoubtedly do a better job.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
567
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
568 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
569 | 3. Features
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
570 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
571
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
572 3.1 Does Gaim support file transfer?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
573
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
574 Somewhat, yeah. As of 0.79 the following is supported:
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
575
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
576 • Sending and receiving files on AIM (although it might be a bit buggy)
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
577 • Sending and receiving files on IRC
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
578 • Sending and receiving files on Jabber
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
579 • Sending and receiving files on MSN
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
580 • Sending and receiving files on SILC
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
581 • Sending and receiving files on Yahoo (sending is limited to 1Mb)
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
582
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
583 Most of the protocols themselves support file transfer, but Gaim has not been
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
584 written to support it yet. If you would like file transfer to work better or
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
585 be more complete, get CVS and submit a patch using the generic file transfer
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
586 API.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
587
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
588 3.2 Is there a Gaim tray icon, or docklet, or gnome applet, or panel icon, or
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
589 something?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
590
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
591 Yeah, Gaim supports what is called a system tray icon that conforms to the
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
592 standards at www.freedesktop.org. This tray icon is supported by Windows, KDE
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
593 3.1, Gnome 2.2, and Red Hat Gnome 2.0. All you have to do is load the "System
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
594 Tray Icon" plugin by going to Preferences and then Plugins.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
595
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
596 If you're using Gnome you need to make sure that your panel has a
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
597 Notification Area on it. To add one, right click on the panel, select Add To
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
598 Panel->Utility->Notification Area. Gaim will insert the tray icon in any
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
599 System Tray implementation that conforms to these standards, so feel free to
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
600 write one for your window manager of choice.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
601
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
602 Due to a flaw in these specs, KDE users may experience trouble with the
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
603 background color of the docklet. There is unfortunately nothing we can do
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
604 about this.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
605
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
606 3.3 What do those colors in the conversation tab mean?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
607
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
608 • Red - A message is waiting for you
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
609 • Blue - Someone sent a message containing your name
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
610 • Green - The buddy is typing
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
611 • Yellow - The buddy began typing, and then stopped
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
612 • Gray - There has been a join or a part in that chat, or the buddy has
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
613 signed off
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
614
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
615 3.4 Will Gaim save my buddy list to the server?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
616
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
617 Yes, Gaim saves your buddy list to the server for AIM, ICQ, Jabber, MSN,
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
618 Novell and Yahoo!.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
619
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
620 3.5 Can I import or export my buddy list?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
621
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
622 Sorry, no. Old versions of Gaim supported this, but new versions do not. All
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
623 the code for saving and loading buddy lists was rewritten, and support for
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
624 importing and exporting buddy lists was never re-added. However, with all
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
625 major protocols storing their buddy lists on the server, this feature is less
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
626 useful today than in the past.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
627
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
628 3.6 Does Gaim support animated smileys?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
629
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
630 Yes, as of version 0.70 Gaim supports animated smileys.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
631
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
632 3.7 Can I make Gaim group screen names by the person that owns them? You know,
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
633 like Trillian's Meta Contacts?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
634
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
635 Sure! Right click a buddy on your list and at the bottom of the menu click
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
636 "Expand". Then just drag other screen names to the same person below it. When
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
637 you're done, click on the arrow to collapse them. When the contact is
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
638 collapsed, Gaim will select a buddy to display based on the status of the
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
639 buddies in the contact, and their order.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
640
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
641 You may need to turn off the preference option to automatically expand
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
642 Contacts in order to be able to edit an existing Contact.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
643
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
644 3.8 How do I get the old logging back?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
645
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
646 The old logging was removed because it was deficient in many ways. There is
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
647 no way in Gaim itself to revert to the old logging, but the new logging is so
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
648 good you could implement something similar to the old logging as a plugin.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
649
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
650 3.9 How can I convert my old logs to the new format?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
651
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
652 It's not possible to perfectly convert from the old format to the new format
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
653 because the old format is missing some information necessary to do that (eg.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
654 which account the messages were sent from).
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
655
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
656 It shouldn't be too difficult to do a rough conversion using a small script,
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
657 or using the old_logger_* functions in gaim itself.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
658
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
659 Peter Johnson has written a python script to do just this, it is available on
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
660 his website (at the bottom).
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
661
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
662 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
663 | 4. ICQ Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
664 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
665
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
666 4.1 How do I use ICQ?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
667
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
668 ICQ support is part of the OSCAR protocol, labeled AIM/ICQ in Gaim. To use
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
669 it, simply put your account number in the "Screen Name" box and your password
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
670 in the "Password" box. Leave the server settings set to the default
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
671 (login.oscar.aol.com and port 5190).
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
672
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
673 4.2 Can I send SMS messages?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
674
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
675 Kind of. See our answer to this for the AIM/ICQ Protocol.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
676
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
677 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
678 | 5. TOC Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
679 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
680
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
681 5.1 What is the TOC protocol?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
682
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
683 It's an AIM protocol used by Quick Buddy and AIM Express. It's recommended
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
684 that you don't use it. You should use Gaim's OSCAR (AIM/ICQ) protocol
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
685 instead. We keep TOC around in case OSCAR ever stops working. However, we are
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
686 not actively supporting this code, and no longer distribute it in binaries.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
687
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
688 +------------------------------------------------------------------------------
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
689 | 6. AIM/ICQ (OSCAR) Protocol
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
690 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
691
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
692 6.1 Can I set my profile?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
693
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
694 Yes you can. Go to Tools->Account Actions
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
695
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
696 6.2 Can I set a buddy icon?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
697
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
698 Yes. Go to the Account Editor (Tools->Accounts from the buddy list), and
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
699 click to "Modify" the AIM/ICQ account you wish to have an icon. Enter the
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
700 full path to the image you wish to use in the box labeled "Buddy Icon File."
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
701 The file must be below 4KB. It can have any dimensions, and can be in any
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
702 format. However, if you wish Windows users to see it, it must be in a format
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
703 Windows understands, such as .bmp, .gif, and .jpg.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
704
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
705 6.3 Some of my buddies are not showing up as online, why is that?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
706
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
707 AOL has set a limit for the maximum number of people you can have in your
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
708 buddy list. This number is currently 200. If you don't think you are anywhere
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
709 near that limit, it is possible that your server-stored buddy list is
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
710 corrupt.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
711
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
712 If you think this might be the case, you can try signing on with an official
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
713 AIM program from AOL. This will usually correct any problems with the list.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
714
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
715 6.4 Can I use AIM URI's such as "aim:goim?screenname=robflynn"?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
716
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
717 Yes, with Gaim 0.60 and higher, but it can be difficult to set up. You need
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
718 to pass the entire URI to the gaim-remote program (included with gaim). To do
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
719 this with Gnome 2, run gnome-file-types-properties or "File Types and
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
720 Programs" from the preferences menu. Add a service with protocol "aim" and
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
721 set the program to gaim-remote uri "%s". This will make AIM URIs work in
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
722 Galeon 2. Also, not all types of AIM URI's are supported. The ones that are
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
723 supported are goim, addbuddy, and gochat.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
724
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
725 You'll need the "Remote Control" plugin loaded for this to work.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
726
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
727 If you use wingaim, this will not work as gaim-remote has not yet been ported
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
728 over.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
729
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
730 6.5 I just changed my buddy icon, and I can't see the new one.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
731
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
732 First, try IMing yourself a few times. Buddy icons are checked when you IM
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
733 people, so depending on the protocol, that may work. If it still doesn't
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
734 update, check the file size (buddy icons must be smaller than 4kb) and the
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
735 image size (it should be 48x48 or 50x50 in most cases). Also, check the file
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
736 type. GIF or JPEG images are best supported; most other formats do not work
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
737 at all. If all of that checks out and it still doesn't work, and you're sure
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
738 the protocol supports it, try restarting Gaim.
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
739
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
740 6.6 Does Gaim support DirectIM and IM Image?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
741
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
742 Yeah, kind of. This tends to be one of the buggier areas of Gaim. If it's not
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
743 working for you, make sure that at least one person is not behind a firewall.
9178
3b25c1042973 [gaim-migrate @ 9973]
Luke Schierer <lschiere@pidgin.im>
parents: 8736
diff changeset
744
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
745 6.7 Can I send SMS messages?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
746
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
747 Yep, just send an IM to the person's phone number. For example, if the phone
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
748 number is (919) 555-1234, you would IM the screen name +19195551234 We think
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
749 this should work for countries with a country code of 1 (the United States
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
750 and Canada).
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
751
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
752 Sending SMS messages using "the ICQ method" is not yet supported.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
753
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
754 6.8 Can I add SMS numbers to my buddy list?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
755
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
756 Not currently. This functionality has been broken since around September
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
757 2003. There is no ETA for when it will be fixed.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
758
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
759 6.9 I heard AOL is combining ICQ and AIM, does that mean I can send a message
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
760 from an AIM account to an ICQ account and vice-versa?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
761
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
762 Yes, AOL is slowly letting the two messaging networks interoperate with each
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
763 other. Messaging between the two protocols works as long as the receiver of
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
764 the message supports it. Gaim 0.60 supports sending and receiving messages
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
765 between AIM and ICQ, but the person receiving the message must support this.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
766 Gaim, of course, supports this for both ICQ and AIM accounts. Windows AIM
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
767 version 5.2.3139 supports receiving messages from ICQ users. It is unknown if
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
768 earlier versions of Windows AIM support this. Windows ICQ build 3800 does not
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
769 support receiving messages from AIM users. Windows ICQ Lite builds 1150 and
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
770 later support receiving messages from AIM users and sending messages to AIM
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
771 users. MacAIM versions 4.6 beta, build 1.1131 and newer support sending and
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
772 receiving messages to and from ICQ users.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
773
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
774 The same clients that support receiving messages from the alternate messaging
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
775 network will also show up in buddy lists of people using the alternate
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
776 network. This means that if you can message an ICQ user from an AIM account,
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
777 then the ICQ user will also show up in your AIM buddy list. So an AIM user
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
778 using Windows AIM version 5.2.3139 will show up in an ICQ buddy list.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
779
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
780 6.10 Why can't I connect via either Oscar or TOC?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
781
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
782 If you are using Linux, your kernel may be using a network option called
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
783 "ECN". It seems that the AOL servers are currently dropping packets marked as
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
784 "ECN-capable". In order to turn this off, run the command
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
785
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
786 echo 0 > /proc/sys/net/ipv4/tcp_ecn
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
787
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
788 as root, or (if your distribution supports it) put the line
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
789
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
790 net.ipv4.tcp_ecn = 0
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
791
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
792 in the file /etc/sysctl.conf.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
793
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
794 6.11 English is not my native language, and some of my friends have trouble
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
795 seeing my IMs/I have trouble seeing my friends' IMs. How do I use a
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
796 native language character set with ICQ?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
797
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
798 Gaim 0.82 and higher allow you to specify a character encoding to use when
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
799 conversing with ICQ users. Use the account editor to set this encoding.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
800
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
801 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
802 | 7. IRC Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
803 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
804
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
805 7.1 How do I join a channel with the IRC plugin?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
806
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
807 First create the account, then sign on. After you have signed on, you can use
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
808 File->Join A Chat on the buddy list to join a channel. In any window, either
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
809 a conversation or a chat, in which your IRC user is the sender, you can also
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
810 use /join to connect to a new channel.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
811
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
812 7.2 Is there a way to make Gaim automatically identify me and/or join IRC
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
813 chats on login?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
814
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
815 Yes. Add NickServ to your buddy list and place buddy pounces on him/her/it.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
816 Do not include "/msg nickserv" as part of the message to send.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
817
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
818 In version 0.64 or higher, you can add a chat to your buddy list, right click
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
819 it, and tell Gaim to auto-join it.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
820
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
821 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
822 | 8. Jabber Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
823 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
824
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
825 8.1 How do I choose which Jabber server to use?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
826
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
827 The Jabber server name is part of your Jabber I.D., such as
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
828 somebody@server.name. So when entering your Jabber "screen name", the server
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
829 is specified as part of your JID.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
830
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
831 8.2 How do I change my Jabber resource to be other than the default of "/
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
832 Gaim"?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
833
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
834 When you create your account in Gaim, simply append the desired resource
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
835 identifier to your Jabber I.D. For example: somebody@server.name/resource
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
836
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
837 8.3 How do I register a new Jabber account?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
838
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
839 As of version 0.52 and up:
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
840
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
841 1. Click "Tools->Accounts->Add"
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
842 2. Select "Jabber" for the protocol.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
843 3. Fill in screen name and password as you normally would. THIS IS A
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
844 REQUIRED STEP
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
845 4. Check the "Register with server" check-box
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
846 5. Click "OK".
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
847
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
848 Note: You are strongly recommended to check the "Remember password" check-box
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
849 as well, as Gaim presently does no password verification. So if you don't
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
850 type in what you thought you did, you're hosed.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
851
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
852 8.4 How do I use invisibility?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
853
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
854 Jabber invisibility support is available in Gaim version 0.60 and later.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
855
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
856 There are two ways to use Jabber invisibility: on a per-buddy and on a
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
857 per-server basis.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
858
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
859 To use per-buddy invisibility: right-click on the buddy on the Online buddy
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
860 list and select "Temporarily Hide From." You will appear to that buddy to be
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
861 off-line. To make yourself seen by that buddy again: right-click on the buddy
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
862 and select "Un-hide From." Note that the menu changes based on whether you're
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
863 currently invisible to that buddy or not.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
864
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
865 The "Temporarily" part is a dead give-away. Your invisibility to that
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
866 buddy will last only until the next time you log on or until you set
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
867 server invisibility (discussed next) on and off.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
868
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
869 To use per-server invisibility: click "Tools -> Away," select the Jabber
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
870 server login for the server upon which you wish to become invisible (if
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
871 necessary) and select "Invisible." To become visible again: select anything
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
872 else from that same menu (such as "Online"), or set your away status or log
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
873 off the server and back on again.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
874
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
875 You can set yourself invisible per-server and subsequently make yourself
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
876 visible to selected buddies only.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
877
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
878 Gaim currently does not retain invisibility settings between logins, just as
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
879 it doesn't currently retain "away" status.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
880
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
881 8.5 I've a buddy that I keep removing from my buddy list but the entry keeps
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
882 coming back every time I log in again! How can I stop this?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
883
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
884 With Gaim 0.60 or later, it might be continuing to import the old buddy
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
885 lists. Remove ~/.gaim/*.blist - these are no longer used, the buddy list is
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
886 now stored in ~/.gaim/blist.xml
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
887
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
888 8.6 Can I remove a buddy from my Jabber roster entirely?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
889
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
890 With Gaim 0.60 or later, the deletion code will do this. Gaim currently does
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
891 not retain invisibility settings between logins, just as it doesn't currently
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
892 retain "away" status.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
893
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
894 8.7 What does "Cancel Presence Notification" do?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
895
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
896 This selection, available in Gaim version 0.60 and later, and found by
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
897 right-clicking on a buddy entry in the buddy list, prevents that Jabber I.D.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
898 from receiving future presence notifications when you log on to the server.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
899
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
900 After you do this, that buddy will have to re-request a subscription to your
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
901 presence (and you will have to approve it) for them to again see you on-line.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
902
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
903 +------------------------------------------------------------------------------
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
904 | 9. Y!M (Yahoo) Protocol
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
905 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
906
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
907 9.1 I cannot connect to Yahoo! and get "Invalid Password" errors, or I'm using
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
908 a version of Gaim older than 0.79!
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
909
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
910 Make sure you have at least 0.79.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
911
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
912 9.2 I cannot connect to Yahoo! and I'm behind a firewall or NAT. Why doesn't
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
913 Gaim have Yahoo's "Firewall with no proxy" option?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
914
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
915 Yahoo!'s firewall with no proxy option connects to Yahoo! by wrapping the
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
916 YMSG protocol inside HTTP. Gaim currently doesn't support doing this.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
917
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
918 Gaim does support changing the port it connects to. Try changing the
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
919 Pager Port in the Account editor under "Show more options". Ports known to
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
920 work are: 20, 23, 25, 80, 119, 5050, 8001, and 8002. While this doesn't work
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
921 for as many people as actually tunneling through the HTTP protocol would, it
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
922 helps many users.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
923
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
924 9.3 I blocked someone, but it doesn't seem to have worked.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
925
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
926 As of 0.81, this is a known bug in our Yahoo code. We're not sure what
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
927 exactly is wrong, but it seems to fail most often when automatically removing
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
928 the buddy from your buddy list at the same time it blocks them. It also
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
929 always seems to fail if Gaim already thinks the buddy is blocked, and you try
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
930 to block them again.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
931
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
932 We suggest manually removing Yahoo! buddies before attempting to block them.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
933 For buddies which Gaim reports are blocked but which are not, unblocking them
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
934 and reblocking them from the Tools->Privacy dialog will often get things
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
935 working.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
936
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
937 9.4 Can I get a list of Yahoo! Chat rooms? What about non-US lists?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
938
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
939 Tools->Room List will let you list available Yahoo! Chat rooms. Yahoo! does
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
940 support hidden and invite-only rooms. If you know the name of the room you
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
941 wish to join, and it's not invite only, you can join it via Buddies->Join a
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
942 Chat. You can also create a chat room this way, although we don't support
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
943 setting the hidden or invite-only type settings.
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
944
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
945 To get a non-US room list, you'll need to change the Chat Room List Url in
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
946 the account editor, under "Show more options". By default this field contains
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
947 "http://insider.msg.yahoo.com/ycontent/". You can add a country code prefix
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
948 to the url to fetch the list for another country. For example, for the German
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
949 list, you would use "http://de.insider.msg.yahoo.com/ycontent/".
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
950
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
951 The list of known country codes for this url is:
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
952
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
953 • aa => Asia
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
954 • ar => Argentina
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
955 • au => Australia
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
956 • br => Brazil
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
957 • ca => Canada
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
958 • cf => Central African Republic
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
959 • cn => China
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
960 • de => Germany
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
961 • dk => Denmark
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
962 • es => Spain
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
963 • fr => France
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
964 • hk => Hong Kong
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
965 • in => India
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
966 • it => Italy
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
967 • kr => Korea, Republic of
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
968 • mx => Mexico
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
969 • no => Norway
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
970 • se => Sweden
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
971 • sg => Singapore
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
972 • tw => Taiwan
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
973 • uk => United Kingdom
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
974
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
975 9.5 What protocol does Gaim use to connect to Yahoo!?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
976
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
977 Normally Gaim uses the YMSG protocol, which is the same protocol that the
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
978 official Yahoo! clients use. If an attempt to login returns the "Invalid
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
979 Password" error code, Gaim automatically tries to log in using the "Web
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
980 Messenger" method. This method still uses the YMSG protocol, but
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
981 authenticates differently, and connects to a different server.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
982
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
983 While in Web Messenger mode, several things work differently or not at all.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
984 Adding, moving, and removing buddies doesn't work, and the only available
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
985 statuses are "Available" and "Invisible". In addition, the Yahoo! server
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
986 seems to ignore all Yahoo! Chat related packets. For this reason, we use the
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
987 YCHT protocol to join Yahoo! Chat rooms while connected using the Web
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
988 Messenger method.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
989
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
990 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
991 | 10. MSN Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
992 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
993
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
994 10.1 Why are my file transfers so slow?
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
995
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
996 Gaim only supports tranferring files over MSN via the MSN servers. This means
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
997 all your data is sent to an MSN server and then forwarded to the person at
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
998 the other end of the transfer. It is unknown whether we will support true
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
999 peer to peer file transfer over MSN.
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1000
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1001 10.2 I'm getting lots of "Already in Opposite list" errors on MSN, why?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1002
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1003 The reason this happens is because you have a screen name in both your permit
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1004 list and your deny list. There are two ways to fix this: the correct way and
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1005 the quick way. The correct way is to go to Tools->Privacy, and manually scan
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1006 the list and remove the duplicate entries. The quick way is to remove the
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1007 blist.xml file from the ~/.gaim directory. Be aware that this contains your
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1008 buddy list for all accounts, and also stores the "Contact" grouping of
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1009 Buddies.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1010
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1011 10.3 Is there a way to invite more than one person to an MSN chat?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1012
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1013 Yes. Right click a buddy on your list and choose "Initiate Chat". In the
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1014 conversation window that appears, choose "Invite" from the "Conversation"
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1015 menu to invite another user. When the conversation framework gets another
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1016 rewrite, it is possible that this will be simplified.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1017
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1018 10.4 Is MSNP9 (MSN6) going to be supported?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1019
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1020 MSNP9 support has existed in Gaim since 0.69. However, at this point,
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1021 features such as custom smileys aren't yet implemented.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1022
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1023 10.5 Will I be able to use Gaim for MSN after October 15th 2003? (The day
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1024 they're preventing third party clients from connecting)
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1025
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1026 Yes. We use MSNP9, which is available in 0.69 and up, and MSNP9 is supported
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1027 after October 15th 2003.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1028
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1029 10.6 I just upgraded Gaim and the MSN plugin will not load. Why?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1030
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1031 You did not compile with SSL support, or the SSL plugin failed to load. As of
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1032 protocol version 9, the MSN protocol requires the use of SSL, which Gaim
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1033 provides by either GnuTLS or the combination of NSS and NSPR from the Mozilla
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1034 project. Install one or both of these and recompile Gaim, and see the next
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1035 question.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1036
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1037 10.7 The MSN plugin won't load, but I have Mozilla NSS!
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1038
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1039 Some distributions, including Slackware, install Mozilla NSS to a
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1040 non-standard directory. The fix is simple. Edit /etc/ld.so.conf and add /usr/
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1041 lib/mozilla-1.4 (or whatever version you're using, but it's usually 1.4) to
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1042 the file, and run ldconfig as root. Then re-run configure and recompile Gaim.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1043 You may also need to specify where the include file are for NSS and NSPR, see
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1044 ./configure --help for the options.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1045
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1046 Mozilla 1.5 has a broken .pc file and does not install the necessary .h
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1047 files, and so will not be detected.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1048
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1049 See http://gaim.sf.net/faq-ssl.php on getting SSL to work with Gaim.
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1050
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1051 10.8 What does "MSN: S: 911 3" in the debug window mean when I cannot connect
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1052 to MSN?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1053
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1054 See http://gaim.sf.net/911.txt.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1055
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1056 10.9 How do I set an MSN avatar?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1057
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1058 Gaim calls these Buddy Icons. Go to Tools->Accounts and click to Modify your
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1059 MSN account. You can drag and drop a file to the resulting dialog, or use the
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1060 Open button.
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1061
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1062 10.10 What does "Has you" in the buddy tooltip mean?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1063
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1064 It shows you if that MSN user has added you to his/her buddy list. "Has you:
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1065 No" does not mean you can't talk to that person.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1066
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1067 10.11 How do I set my MSN Friendly Name (the name other users see)?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1068
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1069 In the Buddy List window, go to Tools->Account Actions->account->Set Friendly
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1070 Name.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1071
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1072 10.12 What does "Error reading from switchboard server" mean?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1073
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1074 We haven't fully figured that out yet, but even Microsoft's client seems to
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1075 get similar errors, although with less frequency than we do. See Bug 1060205
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1076 for further information.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1077
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1078 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1079 | 11. Gadu-Gadu Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1080 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1081
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1082 11.1 What is Gadu-Gadu?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1083
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1084 Gadu-Gadu is an IM protocol popular in Poland. You can find more about it at
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1085 www.gadu-gadu.pl (website in Polish).
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1086
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1087 11.2 Why doesn't it work right?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1088
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1089 We have not had a Gadu-Gadu maintainer in some time and are currently
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1090 struggling to keep this protocol functional. If you have any problems, you
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1091 will need to submit a patch for them, as we are unlikely to have much luck
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1092 fixing it. If things get too bad, we will be forced to remove this protocol
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1093 from the default builds.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1094
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1095 +------------------------------------------------------------------------------
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1096 | 12. Zephyr Protocol
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1097 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1098
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1099 12.1 What is Zephyr?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1100
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1101 Zephyr is an IM protocol developed at MIT for use with Project Athena. Its
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1102 features include Kerberos IV authentication, multi-level chats (aka
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1103 "subscriptions"). You're probably using this because your college/employer/
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1104 organization uses it as a local IM/chat system. If not, you probably don't
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1105 have a server to connect to.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1106
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1107 12.2 Other Zephyr clients (zwgc,owl,tzc) work, but Gaim dies with "Couldn't
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1108 initialize zephyr".
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1109
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1110 Your site might require the use of Kerberos 4 for authentication, though few
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1111 prepackaged Gaim binaries use Kerberos. One solution is to compile Gaim with
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1112 the --with-krb4 flag to point to the location of your Kerberos 4 devel files,
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1113 usually one of /usr, /usr/local, or /usr/athena, e.g. ./configure --with-krb4
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1114 =/path/to/kerberosIV
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1115
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1116 12.3 Gaim isn't working, but I never got any other Zephyr client working on
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1117 this machine.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1118
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1119 You need to have zhm (which comes with the standard Zephyr distribution)
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1120 installed, and running, and pointed at your Zephyr servers. e.g.
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1121
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1122 zhm z1.example.com z2.example.com z3.example.com
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1123
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1124 Alternatively, there might be a firewall or a NAT between you and the Zephyr
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1125 servers. Zephyr generally doesn't work in an environment where incoming
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1126 connections cannot be made to arbitrary UDP ports.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1127
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1128 12.4 How do I use Zephyr from behind my firewall, or without recompiling with
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1129 kerberos support if needed?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1130
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1131 You can use tzc, "Trivial Zephyr Client" and ssh to run Zephyr from a machine
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1132 that is behind a firewall or NAT. First, make sure that tzc is installed and
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1133 working on the remote machine. The best version of tzc to use can be found
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1134 http://www.club.cc.cmu.edu/debian/dists/testing/contrib/source/
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1135 tzc-cclub_001-3.tar.gz. Second, make sure that you can make a passwordless
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1136 ssh connection to the remote machine and get kerberos 4 tickets. Then, click
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1137 on "Show more options", enable "Use tzc", and set the tzc command to
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1138
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1139 /path/to/ssh username@hostname /path/to/tzc -e "%s"
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1140
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1141 Alternately, if you have tzc working on your machine, you can enable "Use
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1142 tzc", and set the tzc command to
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1143
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1144 /path/to/tzc -e "%s"
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1145
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1146
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1147 +------------------------------------------------------------------------------
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1148 | 13. SILC Protocol
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1149 +------------------------------------------------------------------------------
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1150
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1151 13.1 What is SILC?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1152
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1153 SILC is an open protocol designed from the ground up with security in mind.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1154 It is, or should be, the protocol of choice for the paranoid. See http://
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1155 www.silcnet.org for more details.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1156
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1157 +------------------------------------------------------------------------------
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1158 | 14. Novell Protocol
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1159 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1160
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1161 14.1 Are there any public servers for Novell?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1162
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1163 Not really. This protocol is designed to connect to a Novell GroupWise server
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1164 running on a corporate LAN.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1165
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1166 14.2 I can't seem to get it to work.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1167
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1168 Novell tells us that this protocol plugin will only work with either the
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1169 GroupWise Messenger for Linux server or the GroupWise Messenger SP2 (or
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1170 higher) server for NetWare and Windows. In addition, the server must be
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1171 secure (SSL enabled). If you have any trouble, see the FAQ question about
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1172 submitting bugs, and they will be forwarded to Novell, who have been kind
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1173 enough to continue active maintenance to the protocol plugin code they
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1174 provided us.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1175
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1176 +------------------------------------------------------------------------------
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1177 | 15. Scripts and Plugins
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1178 +------------------------------------------------------------------------------
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1179
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1180 15.1 How do I use perl scripts with Gaim?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1181
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1182 Save the perl script to ~/.gaim/plugins/ or $prefix/lib/gaim/, restart Gaim,
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1183 and load the perl script by checking the check box next to its name on the
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1184 Plugins page in preferences.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1185
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1186 15.2 How do I compile a plugin for Gaim?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1187
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1188 To compile a plugin for Gaim, you must have Gaim's source code. To download
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1189 Gaim's source code, get the most recent tarball from http://
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1190 gaim.sourceforge.net/downloads.php (http://gaim.sf.net/downloads.php) and
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1191 untar it with the command: tar zxvf filename where filename is the file you
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1192 downloaded.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1193
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1194 After you have a Gaim source code tree:
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1195
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1196 1. Change to the resulting directory and run the command: ./configure This
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1197 will create the necessary make files.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1198 2. Move the plugin you wish to compile into the plugins/ directory in the
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1199 Gaim source code tree.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1200 3. Change to the plugins/ directory.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1201 4. On Unix/Linux Type:
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1202
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1203 make name.so
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1204
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1205 where the name of the file you wish to compile is name.c.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1206
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1207 On Win32 Type:
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1208
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1209 make -f Makefile.mingw name.dll
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1210
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1211 where the name of the file you wish to compile is name.c.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1212
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1213 Note well the difference in the extensions. If you type make name.c
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1214 instead of name.so, it won't work.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1215
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1216 5. After make finishes, you can move the plugin to a place that is more
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1217 convenient. $prefix/lib/gaim is suggested. If you installed Gaim by
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1218 compiling it yourself, $prefix is /usr/local by default. Otherwise,
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1219 $prefix is /usr.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1220
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1221 15.3 I have a plugin or perl script for Gaim that used to work, but does not
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1222 with the current version.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1223
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1224 The plugin and perl script API has changed several times, which means plugins
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1225 and perl scripts must be modified in order to work. The plugin or perl script
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1226 must be located in $prefix/lib/gaim/ or in ~/.gaim/plugins/, and must
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1227 implement the new API, as documented by the make docs command from the root
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1228 of the Gaim source code tree. This will generated html documentation in the
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1229 doc/html directory. Also note that plugins and perl scripts are now
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1230 controlled from preferences.
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1231
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1232 15.4 Where can I find documentation on writing plugins and Perl scripts?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1233
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1234 If you look in the plugins/ directory in the Gaim source, you should see a
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1235 HOWTO file with some details for C plugins. Also be sure to check out our
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1236 online documentation (http://gaim.sf.net/api/index.html). Be especially sure
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1237 to look at the Related Pages, which lists all of Gaim's signals, as well as a
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1238 nice perl script HOWTO.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1239
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1240 This documentation can be generated directly from the Gaim source by running
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1241 make docs. You will need doxygen and graphviz dot installed for this to work.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1242
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1243 +------------------------------------------------------------------------------
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1244 | 16. Development
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1245 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1246
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1247 16.1 Can I help?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1248
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1249 But of course. Just find something that's bugging you and fix it. There are a
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1250 slew of a bug reports in Gaim's bug report tracker - you could pick one and
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1251 try to tackle it and submit a patch. You could also help with general bug
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1252 triage by going through the bug reports and leaving comments such as "this
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1253 has been fixed" or "this is a duplicate of bug #12345." As always, make sure
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1254 you follow the same coding style used in Gaim, and make sure you don't break
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1255 the core/UI split.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1256
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1257 16.2 Gaim never leaves a core file.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1258
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1259 On most installs core files are limited in size to 0 bytes, and are therefore
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1260 not created. To rectify this situation, add ulimit -c unlimited to your
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1261 startup scripts (~/.bash_profile is a good place) or run it manually in a
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1262 terminal before starting Gaim from that terminal. You can also run Gaim
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1263 directly in gdb with gdb gaim.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1264
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1265 16.3 Where should I report bugs?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1266
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1267 http://gaim.sf.net/bug.php.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1268
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1269 16.4 Where should I submit patches?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1270
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1271 http://gaim.sf.net/patches.php.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1272
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1273 16.5 Did you guys reverse engineer it?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1274
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1275 TOC, Jabber, MSN, Napster, and IRC are published protocols, so we didn't have
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1276 to reverse engineer those. Oscar, ICQ, and Yahoo are not published, and were
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1277 reverse engineered by other people. Novell was provided by Novell, and SILC
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1278 was written by one of the protocol's developers.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1279
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1280 +------------------------------------------------------------------------------
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1281 | 17. Misc. Questions
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1282 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1283
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1284 17.1 Can I IM you guys?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1285
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1286 Sure! Look at the Contact Information (http://gaim.sf.net/contactinfo.php)
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1287 page!
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1288
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1289 17.2 Hello?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1290
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1291 We don't know how to answer this question. Stop asking it.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1292
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1293 17.3 Can I give you money/hardware/other expensive things that can be hocked
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1294 for cash what with you all being students/full-time-workers and helping
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1295 to produce this wonderful software instead of studying/sleeping?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1296
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1297 No. We're completely fool-hardy and won't accept any gratuities with no
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1298 strings attached for just being good guys. That and we'd have to share with
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1299 everyone who has submitted patches. ;-)
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1300
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1301 17.4 Does Gaim support secure instant messaging (encrypted IMs)?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1302
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1303 Short answer: Yes, use the SILC protocol.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1304 Long Answer(for other protocols): Not natively. Doing secure instant
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1305 messaging right is a big deal and requires, among other things, an
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1306 authentication scheme. Simply encrypting your data stream without verifying
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1307 the party with whom you are chatting is not secure in any way; some other
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1308 clients offer options like this, but we feel that such measures instill a
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1309 false sense of security that is more harmful than helpful.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1310
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1311 There are a number of 3rd party plugin developers working on developing a
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1312 secure IM framework, the better ones using the GnuPG and the OpenPGP trust
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1313 model for authentication. If you are serious about secure instant messaging,
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1314 read the documentation on the "web of trust" model available at www.gnupg.org
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1315 and try out one of these.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1316
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1317 17.5 Why are the passwords in accounts.xml not encrypted?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1318
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1319 This is a case of a really long answer to a short question. Read our
10717
75427cc95dfd [gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents: 10473
diff changeset
1320 explanation at http://gaim.sf.net/plaintextpasswords.php.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1321
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1322 17.6 What is gaim-remote?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1323
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1324 gaim-remote is a second executable included with Gaim starting with 0.60. It
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1325 allows you to perform some actions to control/manipulate an existing Gaim
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1326 process from the command line. Run gaim-remote --help to get an idea of what
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1327 we currently envision it doing.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1328
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1329 17.7 When will the next version of Gaim be released?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1330
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1331 The schedule for releases is every third Thursday. However, a new version
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1332 will only be released if it meets a certain standard of quality (i.e., it
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1333 will not be released if it still has a large number of serious bugs).
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1334 Therefore, some releases will take longer than others. Major rewrites means
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1335 lots of new bugs to work out. The new version will be released as soon as it
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1336 is possible to do so.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1337
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1338 17.8 What will the next version be?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1339
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1340 Starting with version 1.0.0, Gaim version numbers have 3 parts to them. The
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1341 format is major.minor.micro. If we change something internally in Gaim such
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1342 that some plugins won't work with the newer version, we will increment the
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1343 major version number. If we don't increment the major version number, and
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1344 we've added things to the Gaim API that won't break any older stuff, we will
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1345 increment the minor version number. In any other cases, we will increment the
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1346 micro version number. Even and odd numbers have nothing to do with stability,
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1347 and you should always be running the latest release of Gaim to get new
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1348 features and bug fixes.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1349
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1350 17.9 So, can I look forward to mega-sexy super functionality with Gaim?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1351
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1352 Yes, that is the intended idea. In fact, there have been quite a number of
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1353 unpopular geeks who have made the switch to gaim. In a matter of days, the
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1354 number of dates and awesomeness points received by the geek increased ten
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1355 fold! You, too, can have an exciting life with Gaim. Get Gaim. Get the babes.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1356 Get uhh... hmm.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1357