annotate doc/FAQ @ 10627:57589eb36449

[gaim-migrate @ 12102] " Using the request API with only a GAIM_REQUEST_FIELD_LIST would result in a squished tree view for the list (two rows high, but only the width of the scroll-bar buttons wide). This patch adjusts things so that list fields are displayed similarly to multi-line text fields, with the label on top and the field itself stretched to something more sane. Another nice addition would be to make the window resizable, but that's not part of this patch. I didn't do a lot of testing. The request dialogues from idle.c still work fine, so I guess nothing is broken..." --Christopher (siege) O'Brien committer: Tailor Script <tailor@pidgin.im>
author Luke Schierer <lschiere@pidgin.im>
date Wed, 23 Feb 2005 02:36:51 +0000
parents 3cfab4626bbf
children 75427cc95dfd
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
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
118 10.1. I'm getting lots of "Already in Opposite list" errors on MSN,
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
119 why?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
120 10.2. Is there a way to invite more than one person to an MSN chat?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
121 10.3. Is MSNP9 (MSN6) going to be supported?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
122 Will I be able to use Gaim for MSN after October 15th 2003?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
123 10.4. (The day they're preventing third party clients from
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
124 connecting)
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
125 10.5. I just upgraded Gaim and the MSN plugin will not load. Why?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
126 10.6. The MSN plugin won't load, but I have Mozilla NSS!
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
127 10.7. What does "MSN: S: 911 3" in the debug window mean when I
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
128 cannot connect to MSN?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
129 10.8. How do I set an MSN avatar?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
130 10.9. What does "Has you" in the buddy tooltip mean?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
131 10.10. How do I set my MSN Friendly Name (the name other users see)?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
132 10.11. What does "Error reading from switchboard server" mean?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
133
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
134 11. Gadu-Gadu Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
135
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
136 11.1. What is Gadu-Gadu?
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
137 11.2. Why doesn't it work right?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
138
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
139 12. Zephyr Protocol
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
140
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
141 12.1. What is Zephyr?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
142 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
143 "Couldn't initialize zephyr".
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
144 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
145 working on this machine.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
146 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
147 recompiling with kerberos support if needed?
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
148
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
149 13. SILC Protocol
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
150
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
151 13.1. What is SILC?
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
152
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
153 14. Novell Protocol
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
154
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
155 14.1. Are there any public servers for Novell?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
156 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
157
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
158 15. Scripts and Plugins
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
159
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
160 15.1. How do I use perl scripts with Gaim?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
161 15.2. How do I compile a plugin for Gaim?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
162 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
163 does not with the current version.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
164 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
165 scripts?
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
166
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
167 16. Development
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
168
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
169 16.1. Can I help?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
170 16.2. Gaim never leaves a core file.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
171 16.3. Where should I report bugs?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
172 16.4. Where should I submit patches?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
173 16.5. Did you guys reverse engineer it?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
174
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
175 17. Misc. Questions
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
176
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
177 17.1. Can I IM you guys?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
178 17.2. Hello?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
179 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
180 17.3. hocked for cash what with you all being students/
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
181 full-time-workers and helping to produce this wonderful software
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
182 instead of studying/sleeping?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
183 17.4. Does Gaim support secure instant messaging (encrypted IMs)?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
184 17.5. Why are the passwords in accounts.xml not encrypted?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
185 17.6. What is gaim-remote?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
186 17.7. When will the next version of Gaim be released?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
187 17.8. What will the next version be?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
188 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
189 Gaim?
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
190
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 | 1. Compiling and Installing
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
193 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
194
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
195 1.1 What does "Gaim" stand for?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
196
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
197 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
198 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
199 and "gaim" (and not "GAIM").
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
200
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
201 1.2 Why can't I compile Gaim?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
202
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
203 Make sure you have relatively recent versions of automake, autoconf, and
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
204 gettext. HOWEVER, generally speaking, having the absolute newest of them is
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
205 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
206 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
207 automake require certain ranges of gettext versions, and we are utterly
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
208 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
209
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
210 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
211 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
212 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
213 and the auto* packages.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
214
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
215 *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
216 the --no-verify from the configure script.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
217
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
218 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
219 faq-ssl.php for distribution specific hints.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
220
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
221 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
222 libgtkspell.so.0, from where can I get this?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
223
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
224 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
225 provide the "Highlight misspelled words" feature. You can find an RPM of
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
226 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
227 RPM at gtkspell.sourceforge.net.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
228
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
229 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
230
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
231 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
232 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
233 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
234 the ./configure --help for specifying the SILC includes and libs. If you're
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
235 compiling an SRPM, use "--with silc" to build the gaim-silc RPM.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
236
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
237 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
238
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
239 Yeah. There are actually three ways to do it.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
240
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
241 1. Use the --with-static-prpls option to ./configure along with
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
242 --disable-plugins. This will let you choose which protocols are compiled
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
243 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
244 plugins.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
245
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
246 You'll need to compile any protocols that you specified in
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
247 --with-static-prpls. Oscar and TOC are defaults.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
248
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
249 2. Use the --with-dynamic-prpls option to ./configure
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
250
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
251 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
252 /protocols/jabber), and run make from there. Then after you've compiled
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
253 all of them, change back to src/ and run make gaim.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
254
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
255 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
256 using the old version.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
257
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
258 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
259 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
260 work.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
261
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
262 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
263 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
264 usr/local.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
265
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
266 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
267
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
268 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
269 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
270 Ethan Blanton, Mark Doliner, or Christian Hammond. Usually the Mandrake and
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
271 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
272 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
273 http://pgp.mit.edu/ is popular.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
274
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
275 1.8 Can I use Gaim for GTK+1.2?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
276
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
277 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
278 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
279 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
280 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
281 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
282 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
283 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
284 breathtakingly beautiful.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
285
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
286 1.9 Can I run Gaim on IRIX?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
287
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
288 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
289 thread_id=725839&forum_id=665 at our SourceForge Forum.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
290
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
291 1.10 Can I run gaim on MacOSX?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
292
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
293 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
294 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
295 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
296 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
297 . 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
298 suggest trying Adium (http://www.adiumx.com/).
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
299
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
300 1.11 How do I apply the patch "something.diff"?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
301
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
302 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
303 doesn't work, try patch -p1 < something.diff.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
304
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
305 1.12 Why is gaim crashing when I start it?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
306
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
307 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
308 still have problems, try the following:
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
309
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
310 • 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
311 sometimes be useful for determining this.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
312 • "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
313 terminal.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
314 • 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
315 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
316 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
317 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
318 esd or arts.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
319 • Try disabling or deleting any 3rd party plugins, especially anything
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
320 related to encryption.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
321 • 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
322 • 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
323 away preference from -1 to 0.
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
324
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
325 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
326
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
327 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
328 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
329 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
330 and are hopefully fixed before a release is made.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
331
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
332 1.14 Why do you always say not to use CVS?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
333
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
334 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
335 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
336 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
337 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
338 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
339 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
340 behaviors like this are acceptable to some users (particularly developers,
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
341 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
342 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
343 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
344
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
345 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
346 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
347 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
348 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
349 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
350 collaboration. Unfortunately, when too many users are poking around in that
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
351 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
352 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
353 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
354 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
355 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
356 next release to see what new features it might hold.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
357
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
358 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
359 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
360 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
361 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
362 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
363 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
364 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
365 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
366 server administrators may be forced to take action. (This is particularly
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
367 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
368 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
369 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
370 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
371
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
372 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
373 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
374 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
375 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
376 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
377 for selfish reasons which are not entirely important.
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
378
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
379 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
380 | 2. Using Gaim
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
381 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
382
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
383 2.1 How do I register for a new account?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
384
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
385 This depends on the protocol.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
386
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
387 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
388 snshomepage&authLev=1&mcState=initialized&createSn=1.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
389
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
390 MSN (including Hotmail email): Go to http://registernet.passport.com/.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
391
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
392 MSN (using your own email address): Go to https://register.passport.net/
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
393 reg.srf?lc=1033&id=486&ru=
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
394 http%3A%2F%2Fwww%2Epassport%2Enet%2FConsumer%2FDefault%2Easp%3Flc%3D1033&sl=1
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
395
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
396 Yahoo: Go to http://edit.yahoo.com/config/eval_register.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
397
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
398 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
399
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
400 ICQ: Go to http://web.icq.com/register.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
401
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
402 Gadu-Gadu: Use the official client to create an account.
9178
3b25c1042973 [gaim-migrate @ 9973]
Luke Schierer <lschiere@pidgin.im>
parents: 8736
diff changeset
403
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
404 Novell: See your Novell server administrator.
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 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
407
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
408 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
409 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
410 checkbox in the account editor to sign online.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
411
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
412 2.3 How do I change the font Gaim uses?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
413
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
414 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
415 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
416 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
417 help you can see our example .gtkrc-2.0 (http://gaim.sf.net/gtkrc-2.0) file.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
418
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
419 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
420 (and information on using them) by visiting themes.freshmeat.net,
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
421 art.gnome.org, or searching on Google.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
422
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
423 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
424 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
425 Text.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
426
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
427 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
428
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
429 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
430 //gaim.sf.net/gtkrc-2.0.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
431
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
432 2.5 How do I use smiley themes?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
433
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
434 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
435 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
436 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
437 //gaim.sf.net/themes.php) page.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
438
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
439 You can also install themes manually by uncompressing them to their own
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
440 directory in ~/.gaim/smileys/
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
441
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
442 2.6 Why are the status icons so big?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
443
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
444 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
445 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
446 '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
447 concisely and attractively. It shows more than one status "emblem" for each
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
448 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
449 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
450 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
451 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
452 default.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
453
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
454 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
455 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
456 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
457
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
458 2.7 Why do the emblems move around the status icon?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
459
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
460 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
461 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
462 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
463 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
464 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
465 find out what he needs to know. Also, importantly, the lower-right corner
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
466 emblem is the only emblem that shows up when "Small list" is on, and only one
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
467 emblem would fit.
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
468
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
469 2.8 How do I get sound to work correctly?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
470
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
471 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
472 arts is no longer supported.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
473
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
474 `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
475 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
476 supports OSS (Open Sound System), ESD (ESounD), ALSA (Advanced Linux Sound
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
477 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
478 (Analog Realtime Synthesizer). '
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
479
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
480 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
481 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
482 wish to install these packages you can also just change your sound playing
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
483 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
484
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
485 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
486 "Automatic" option do?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
487
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
488 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
489 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
490 choosing "Automatic" lets it decide for itself.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
491
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
492 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
493 /.libao, and put one of the following lines in it:
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
494
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
495
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
496 default_driver=alsa
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
497
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
498 default_driver=oss
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
499
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
500 Other drivers, like alsa09, arts, esd, irix, macosx, and sun might also be
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
501 supported, depending on your platform, and how libao was compiled. See also
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
502 'man 5 libao.conf'.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
503
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
504 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
505 impossible to control window size and placement for the buddy list
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
506 separately from the conversations.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
507
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
508 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
509 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
510 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
511 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
512 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
513 then it should provide a WM_WINDOW_ROLE property."
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
514
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
515 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
516 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
517 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
518 to differentiate windows. If your window manager is having problems
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
519 differentiating between Gaim windows, please ensure that it uses the
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
520 WM_WINDOW_ROLE hint per the ICCCM.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
521
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
522 2.11 I blocked someone accidentally, how can I unblock them?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
523
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
524 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
525
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
526 2.12 What is a "Buddy Pounce"?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
527
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
528 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
529 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
530 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
531 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
532 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
533 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
534 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
535 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
536 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
537 your buddy list who you have pounced signs on.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
538
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
539 2.13 Where does gaim store its logs?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
540
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
541 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
542 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
543 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
544 yourscreenname/theirscreenname.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
545
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
546 2.14 How can I see my own status with Gaim?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
547
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
548 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
549 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
550 others, and is mimiced by gaim for MSN and Jabber.
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
551
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
552 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
553 isn't IM-related?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
554
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
555 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
556 client. Aside from the capabilities each protocol may support, the Gaim
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
557 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
558 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
559 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
560 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
561 undoubtedly do a better job.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
562
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
563 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
564 | 3. Features
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
565 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
566
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
567 3.1 Does Gaim support file transfer?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
568
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
569 Somewhat, yeah. As of 0.79 the following is supported:
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
570
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
571 • 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
572 • Sending and receiving files on IRC
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
573 • Sending and receiving files on Jabber
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
574 • Sending and receiving files on MSN
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
575 • Sending and receiving files on SILC
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
576 • 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
577
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
578 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
579 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
580 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
581 API.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
582
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
583 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
584 something?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
585
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
586 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
587 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
588 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
589 Tray Icon" plugin by going to Preferences and then Plugins.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
590
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
591 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
592 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
593 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
594 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
595 write one for your window manager of choice.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
596
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
597 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
598 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
599 about this.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
600
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
601 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
602
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
603 • Red - A message is waiting for you
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
604 • Blue - Someone sent a message containing your name
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
605 • Green - The buddy is typing
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
606 • Yellow - The buddy began typing, and then stopped
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
607 • 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
608 signed off
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
609
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
610 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
611
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
612 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
613 Novell and Yahoo!.
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.5 Can I import or export my buddy list?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
616
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
617 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
618 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
619 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
620 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
621 useful today than in the past.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
622
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
623 3.6 Does Gaim support animated smileys?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
624
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
625 Yes, as of version 0.70 Gaim supports animated smileys.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
626
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
627 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
628 like Trillian's Meta Contacts?
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 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
631 "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
632 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
633 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
634 buddies in the contact, and their order.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
635
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
636 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
637 Contacts in order to be able to edit an existing Contact.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
638
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
639 3.8 How do I get the old logging back?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
640
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
641 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
642 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
643 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
644
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
645 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
646
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
647 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
648 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
649 which account the messages were sent from).
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
650
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
651 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
652 or using the old_logger_* functions in gaim itself.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
653
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
654 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
655 his website (at the bottom).
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
656
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
657 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
658 | 4. ICQ Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
659 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
660
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
661 4.1 How do I use ICQ?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
662
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
663 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
664 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
665 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
666 (login.oscar.aol.com and port 5190).
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
667
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
668 4.2 Can I send SMS messages?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
669
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
670 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
671
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
672 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
673 | 5. TOC Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
674 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
675
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
676 5.1 What is the TOC protocol?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
677
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
678 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
679 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
680 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
681 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
682
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
683 +------------------------------------------------------------------------------
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
684 | 6. AIM/ICQ (OSCAR) Protocol
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
685 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
686
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
687 6.1 Can I set my profile?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
688
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
689 Yes you can. Go to Tools->Account Actions
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
690
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
691 6.2 Can I set a buddy icon?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
692
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
693 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
694 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
695 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
696 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
697 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
698 Windows understands, such as .bmp, .gif, and .jpg.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
699
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
700 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
701
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
702 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
703 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
704 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
705 corrupt.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
706
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
707 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
708 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
709
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
710 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
711
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
712 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
713 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
714 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
715 Programs" from the preferences menu. Add a service with protocol "aim" and
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
716 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
717 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
718 supported are goim, addbuddy, and gochat.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
719
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
720 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
721
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
722 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
723 over.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
724
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
725 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
726
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
727 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
728 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
729 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
730 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
731 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
732 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
733 the protocol supports it, try restarting Gaim.
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
734
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
735 6.6 Does Gaim support DirectIM and IM Image?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
736
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
737 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
738 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
739
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
740 6.7 Can I send SMS messages?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
741
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
742 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
743 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
744 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
745 and Canada).
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
746
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
747 Sending SMS messages using "the ICQ method" is not yet supported.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
748
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
749 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
750
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
751 Not currently. This functionality has been broken since around September
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
752 2003. There is no ETA for when it will be fixed.
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.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
755 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
756
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
757 Yes, AOL is slowly letting the two messaging networks interoperate with each
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
758 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
759 the message supports it. Gaim 0.60 supports sending and receiving messages
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
760 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
761 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
762 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
763 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
764 support receiving messages from AIM users. Windows ICQ Lite builds 1150 and
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
765 later support receiving messages from AIM users and sending messages to AIM
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
766 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
767 receiving messages to and from ICQ users.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
768
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
769 The same clients that support receiving messages from the alternate messaging
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
770 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
771 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
772 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
773 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
774
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
775 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
776
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
777 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
778 "ECN". It seems that the AOL servers are currently dropping packets marked as
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
779 "ECN-capable". In order to turn this off, run the command "echo 0 > /proc/sys
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
780 /net/ipv4/tcp_ecn" as root, or (if your distribution supports it) put the
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
781 line "net.ipv4.tcp_ecn = 0" in the file /etc/sysctl.conf.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
782
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
783 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
784 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
785 native language character set with ICQ?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
786
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
787 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
788 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
789
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
790 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
791 | 7. IRC Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
792 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
793
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
794 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
795
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
796 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
797 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
798 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
799 use /join to connect to a new channel.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
800
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
801 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
802 chats on login?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
803
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
804 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
805 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
806
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
807 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
808 it, and tell Gaim to auto-join it.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
809
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
810 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
811 | 8. Jabber Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
812 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
813
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
814 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
815
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
816 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
817 somebody@server.name. So when entering your Jabber "screen name", the server
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
818 is specified as part of your JID.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
819
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
820 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
821 Gaim"?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
822
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
823 When you create your account in Gaim, simply append the desired resource
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
824 identifier to your Jabber I.D. For example: somebody@server.name/resource
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
825
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
826 8.3 How do I register a new Jabber account?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
827
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
828 As of version 0.52 and up:
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
829
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
830 1. Click "Tools->Accounts->Add"
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
831 2. Select "Jabber" for the protocol.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
832 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
833 REQUIRED STEP
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
834 4. Check the "Register with server" check-box
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
835 5. Click "OK".
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 Note: You are strongly recommended to check the "Remember password" check-box
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
838 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
839 type in what you thought you did, you're hosed.
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 8.4 How do I use invisibility?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
842
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
843 Jabber invisibility support is available in Gaim version 0.60 and later.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
844
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
845 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
846 per-server basis.
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 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
849 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
850 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
851 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
852 currently invisible to that buddy or not.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
853
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
854 The "Temporarily" part is a dead give-away. Your invisibility to that
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
855 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
856 server invisibility (discussed next) on and off.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
857
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
858 To use per-server invisibility: click "Tools -> Away," select the Jabber
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
859 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
860 necessary) and select "Invisible." To become visible again: select anything
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
861 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
862 off the server and back on again.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
863
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
864 You can set yourself invisible per-server and subsequently make yourself
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
865 visible to selected buddies only.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
866
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
867 Gaim currently does not retain invisibility settings between logins, just as
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
868 it doesn't currently retain "away" status.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
869
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
870 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
871 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
872
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
873 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
874 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
875 now stored in ~/.gaim/blist.xml
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
876
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
877 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
878
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
879 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
880 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
881 retain "away" status.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
882
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
883 8.7 What does "Cancel Presence Notification" do?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
884
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
885 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
886 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
887 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
888
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
889 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
890 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
891
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
892 +------------------------------------------------------------------------------
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
893 | 9. Y!M (Yahoo) Protocol
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
894 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
895
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
896 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
897 a version of Gaim older than 0.79!
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
898
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
899 Make sure you have at least 0.79.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
900
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
901 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
902 Gaim have Yahoo's "Firewall with no proxy" option?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
903
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
904 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
905 YMSG protocol inside HTTP. Gaim currently doesn't support doing this.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
906
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
907 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
908 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
909 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
910 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
911 helps many users.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
912
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
913 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
914
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
915 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
916 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
917 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
918 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
919 to block them again.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
920
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
921 We suggest manually removing Yahoo! buddies before attempting to block them.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
922 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
923 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
924 working.
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 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
927
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
928 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
929 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
930 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
931 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
932 setting the hidden or invite-only type settings.
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
933
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
934 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
935 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
936 "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
937 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
938 list, you would use "http://de.insider.msg.yahoo.com/ycontent/".
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
939
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
940 The list of known country codes for this url is:
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
941
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
942 aa => Asia
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
943 ar => Argentina
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
944 au => Australia
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
945 br => Brazil
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
946 ca => Canada
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
947 cf => Central African Republic
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
948 cn => China
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
949 de => Germany
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
950 dk => Denmark
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
951 es => Spain
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
952 fr => France
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
953 hk => Hong Kong
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
954 in => India
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
955 it => Italy
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
956 kr => Korea, Republic of
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
957 mx => Mexico
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
958 no => Norway
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
959 se => Sweden
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
960 sg => Singapore
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
961 tw => Taiwan
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
962 uk => United Kingdom
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
963
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
964 9.5 What protocol does Gaim use to connect to Yahoo!?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
965
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
966 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
967 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
968 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
969 Messenger" method. This method still uses the YMSG protocol, but
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
970 authenticates differently, and connects to a different server.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
971
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
972 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
973 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
974 statuses are "Available" and "Invisible". In addition, the Yahoo! server
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
975 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
976 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
977 Messenger method.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
978
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
979 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
980 | 10. MSN Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
981 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
982
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
983 10.1 I'm getting lots of "Already in Opposite list" errors on MSN, why?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
984
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
985 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
986 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
987 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
988 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
989 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
990 buddy list for all accounts, and also stores the "Contact" grouping of
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
991 Buddies. Also, the MSN server stores the screen names of your contacts, but
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
992 does not store what group they are in, so you will have to re-sort your MSN
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
993 contacts into the appropriate groups.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
994
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
995 10.2 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
996
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
997 Not at this time. When the conversation framework gets another rewrite, it is
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
998 possible that it will be worked on. Until that time, sorry. :)
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
999
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1000 10.3 Is MSNP9 (MSN6) going to be supported?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1001
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1002 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
1003 features such as custom smileys aren't yet implemented.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1004
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1005 10.4 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
1006 they're preventing third party clients from connecting)
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1007
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1008 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
1009 after October 15th 2003.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1010
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1011 10.5 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
1012
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1013 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
1014 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
1015 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
1016 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
1017 question.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1018
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1019 10.6 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
1020
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1021 Some distributions, including Slackware, install Mozilla NSS to a
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1022 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
1023 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
1024 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
1025 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
1026 ./configure --help for the options.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1027
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1028 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
1029 files, and so will not be detected.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1030
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1031 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
1032
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1033 10.7 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
1034 to MSN?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1035
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1036 See http://gaim.sf.net/911.txt.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1037
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1038 10.8 How do I set an MSN avatar?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1039
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1040 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
1041 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
1042 Open button.
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1043
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1044 10.9 What does "Has you" in the buddy tooltip mean?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1045
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1046 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
1047 No" does not mean you can't talk to that person.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1048
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1049 10.10 How do I set my MSN Friendly Name (the name other users see)?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1050
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1051 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
1052 Name.
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 10.11 What does "Error reading from switchboard server" mean?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1055
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1056 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
1057 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
1058 for further information.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1059
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1060 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1061 | 11. Gadu-Gadu Protocol
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1062 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1063
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1064 11.1 What is Gadu-Gadu?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1065
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1066 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
1067 www.gadu-gadu.pl (website in Polish).
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1068
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1069 11.2 Why doesn't it work right?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1070
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1071 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
1072 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
1073 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
1074 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
1075 from the default builds.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1076
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1077 +------------------------------------------------------------------------------
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1078 | 12. Zephyr Protocol
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1079 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1080
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1081 12.1 What is Zephyr?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1082
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1083 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
1084 features include Kerberos IV authentication, multi-level chats (aka
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1085 "subscriptions"). You're probably using this because your college/employer/
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1086 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
1087 have a server to connect to.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1088
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1089 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
1090 initialize zephyr".
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1091
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1092 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
1093 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
1094 the --with-krb4 flag to point to the location of your Kerberos 4 devel files,
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1095 usually one of /usr, /usr/local, or /usr/athena , e.g. ./configure
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1096 --with-krb4=/path/to/kerberosIV
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1097
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1098 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
1099 this machine.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1100
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1101 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
1102 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
1103
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1104 zhm z1.example.com z2.example.com z3.example.com
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1105
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1106 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
1107 servers. Zephyr generally doesn't work in an environment where incoming
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1108 connections cannot be made to arbitrary UDP ports.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1109
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1110 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
1111 kerberos support if needed?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1112
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1113 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
1114 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
1115 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
1116 http://www.club.cc.cmu.edu/debian/dists/testing/contrib/source/
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1117 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
1118 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
1119 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
1120
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1121 /path/to/ssh username@hostname /path/to/tzc -e "%s"
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1122
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1123 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
1124 tzc", and set the tzc command to
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1125
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1126 /path/to/tzc -e "%s"
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1127
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1128 +------------------------------------------------------------------------------
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1129 | 13. SILC Protocol
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1130 +------------------------------------------------------------------------------
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1131
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1132 13.1 What is SILC?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1133
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1134 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
1135 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
1136 www.silcnet.org for more details.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1137
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1138 +------------------------------------------------------------------------------
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1139 | 14. Novell Protocol
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1140 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1141
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1142 14.1 Are there any public servers for Novell?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1143
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1144 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
1145 running on a corporate LAN.
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1146
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1147 14.2 I can't seem to get it to work.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1148
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1149 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
1150 GroupWise Messenger for Linux server or the GroupWise Messenger SP2 (or
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1151 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
1152 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
1153 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
1154 enough to continue active maintenance to the protocol plugin code they
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1155 provided us.
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 | 15. Scripts and Plugins
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1159 +------------------------------------------------------------------------------
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1160
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1161 15.1 How do I use perl scripts with Gaim?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1162
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1163 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
1164 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
1165 Plugins page in preferences.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1166
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1167 15.2 How do I compile a plugin for Gaim?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1168
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1169 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
1170 Gaim's source code, get the most recent tarball from http://
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1171 gaim.sourceforge.net/downloads.php (http://gaim.sf.net/downloads.php) and
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1172 untar it with the command:
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1173
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1174 tar zxvf filename
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1175
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1176 where filename is the file you downloaded.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1177
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1178 After you have a Gaim source code tree:
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1179
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1180 1. Change to the resulting directory and run the command:
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1181
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1182 ./configure
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1183
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1184 This will create the necessary make files.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1185 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
1186 Gaim source code tree.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1187 3. Change to the plugins/ directory.
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1188 4. On Unix/Linux Type:
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1189
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1190 make name.so
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1191
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1192 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
1193
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1194 On Win32 Type:
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1195
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1196 make -f Makefile.mingw name.dll
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1197
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1198 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
1199
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1200 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
1201 instead of name.so, it won't work.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1202
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1203 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
1204 convenient. $prefix/lib/gaim is suggested. If you installed Gaim by
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1205 compiling it yourself, $prefix is /usr/local by default. Otherwise,
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1206 $prefix is /usr.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1207
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1208 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
1209 with the current version.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1210
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1211 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
1212 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
1213 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
1214 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
1215 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
1216 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
1217 controlled from preferences.
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1218
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1219 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
1220
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1221 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
1222 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
1223 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
1224 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
1225 nice perl script HOWTO.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1226
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1227 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
1228 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
1229
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1230 +------------------------------------------------------------------------------
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1231 | 16. Development
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1232 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1233
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1234 16.1 Can I help?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1235
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1236 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
1237 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
1238 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
1239 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
1240 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
1241 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
1242 the core/UI split.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1243
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1244 16.2 Gaim never leaves a core file.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1245
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1246 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
1247 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
1248 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
1249 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
1250 directly in gdb with gdb gaim.
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1251
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1252 16.3 Where should I report bugs?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1253
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1254 http://gaim.sf.net/bug.php.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1255
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1256 16.4 Where should I submit patches?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1257
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1258 http://gaim.sf.net/patches.php.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1259
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1260 16.5 Did you guys reverse engineer it?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1261
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1262 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
1263 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
1264 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
1265 was written by one of the protocol's developers.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1266
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1267 +------------------------------------------------------------------------------
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1268 | 17. Misc. Questions
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1269 +------------------------------------------------------------------------------
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1270
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1271 17.1 Can I IM you guys?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1272
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1273 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
1274 page!
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1275
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1276 17.2 Hello?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1277
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1278 We don't know how to answer this question. Stop asking it.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1279
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1280 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
1281 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
1282 to produce this wonderful software instead of studying/sleeping?
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1283
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1284 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
1285 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
1286 everyone who has submitted patches. ;-)
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1287
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1288 17.4 Does Gaim support secure instant messaging (encrypted IMs)?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1289
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1290 Short answer: Yes, use the SILC protocol.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1291 Long Answer(for other protocols): Not natively. Doing secure instant
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1292 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
1293 authentication scheme. Simply encrypting your data stream without verifying
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1294 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
1295 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
1296 false sense of security that is more harmful than helpful.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1297
8736
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1298 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
1299 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
1300 model for authentication. If you are serious about secure instant messaging,
374477c0dd76 [gaim-migrate @ 9491]
Luke Schierer <lschiere@pidgin.im>
parents: 7842
diff changeset
1301 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
1302 and try out one of these.
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1303
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1304 17.5 Why are the passwords in accounts.xml not encrypted?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1305
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1306 This is a case of a really long answer to a short question. Read our
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1307 explanation at http://gaim.sf.net/plaintextpasswords.txt.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1308
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1309 17.6 What is gaim-remote?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1310
7842
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1311 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
1312 allows you to perform some actions to control/manipulate an existing Gaim
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1313 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
1314 we currently envision it doing.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1315
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1316 17.7 When will the next version of Gaim be released?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1317
9618
848e5fbcd520 [gaim-migrate @ 10462]
Luke Schierer <lschiere@pidgin.im>
parents: 9178
diff changeset
1318 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
1319 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
1320 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
1321 Therefore, some releases will take longer than others. Major rewrites means
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1322 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
1323 is possible to do so.
9227553c97dd [gaim-migrate @ 8495]
Luke Schierer <lschiere@pidgin.im>
parents:
diff changeset
1324
10473
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1325 17.8 What will the next version be?
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1326
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1327 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
1328 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
1329 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
1330 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
1331 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
1332 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
1333 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
1334 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
1335 features and bug fixes.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1336
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1337 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
1338
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1339 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
1340 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
1341 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
1342 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
1343 Get uhh... hmm.
3cfab4626bbf [gaim-migrate @ 11758]
Luke Schierer <lschiere@pidgin.im>
parents: 9618
diff changeset
1344