annotate doc/FAQ @ 10674:9aa1d4adf3e9

[gaim-migrate @ 12214] we need to scale these both ways committer: Tailor Script <tailor@pidgin.im>
author Nathan Walp <nwalp@pidgin.im>
date Tue, 08 Mar 2005 23:56:20 +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