Mercurial > pidgin.yaz
annotate README @ 22937:4798de46bf4a
merge of '994f8bdccfcf73a73924e593d2c398c8d416e5e9'
and 'e1c49c9ec5c6869ed9813feccd8ee41d2ca40f35'
author | Ka-Hing Cheung <khc@hxbc.us> |
---|---|
date | Wed, 14 May 2008 04:58:36 +0000 |
parents | 56042b2f8b64 |
children |
rev | line source |
---|---|
15937 | 1 Purple, Pidgin and Finch |
0 | 2 ======================== |
15937 | 3 See AUTHORS and COPYRIGHT for the list of contributors. |
4 | |
5 libpurple is a library intended to be used by programmers seeking | |
6 to write an IM client that connects to many IM networks. It supports | |
16915
56042b2f8b64
s/Jabber/XMPP in user-visible places.
Richard Laager <rlaager@wiktel.com>
parents:
16728
diff
changeset
|
7 AIM, ICQ, XMPP, MSN and Yahoo!, among others. |
0 | 8 |
15937 | 9 Pidgin is an graphical IM client written in C which uses the GTK+ |
10 toolkit. | |
2608
cad63750f3bb
[gaim-migrate @ 2621]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2536
diff
changeset
|
11 |
15941 | 12 Finch is a text-based IM client written in C which uses the ncurses |
15937 | 13 toolkit. |
14 | |
15 These programs are not endorsed by, nor affiliated with, AOL nor any | |
16 other company in any way. | |
2862
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
17 |
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
18 BUILD |
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
19 ===== |
0 | 20 |
2862
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
21 Read the 'INSTALL' file for more detailed directions. |
0 | 22 |
15937 | 23 These programs use the standard ./configure ; make. You need to use |
24 gmake, BSD make probably won't work. Remember, run ./configure --help | |
25 to see what build options are available. | |
2862
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
26 |
15937 | 27 In order to compile Pidgin you need to have GTK+ 2.0 installed (as |
2862
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
28 well as the development files!). The configure script will fail if you |
15941 | 29 don't. If you don't have GTK+ 2.0 installed, you should install it |
30 using your distribution's package management tools. | |
0 | 31 |
15310
82a2e909e10e
[gaim-migrate @ 18100]
Luke Schierer <lschiere@pidgin.im>
parents:
13632
diff
changeset
|
32 For sound support, you also need gstreamer 0.10 or higher. For |
82a2e909e10e
[gaim-migrate @ 18100]
Luke Schierer <lschiere@pidgin.im>
parents:
13632
diff
changeset
|
33 spellchecking support, you need libgtkspell (http://gtkspell.sf.net/). |
82a2e909e10e
[gaim-migrate @ 18100]
Luke Schierer <lschiere@pidgin.im>
parents:
13632
diff
changeset
|
34 Your distro of choice probably already includes these, just be sure to |
82a2e909e10e
[gaim-migrate @ 18100]
Luke Schierer <lschiere@pidgin.im>
parents:
13632
diff
changeset
|
35 install the development packages. |
2862
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
36 |
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
37 RUN |
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
38 === |
0 | 39 |
2862
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
40 You should run 'make install' as root to make sure plugins and other files |
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
41 get installed into locations they want to be in. Once you've done that, |
15937 | 42 you only need to run 'pidgin' or 'finch'. |
0 | 43 |
16176
83ec0b408926
Beat some older documentation into submission.
Richard Laager <rlaager@wiktel.com>
parents:
15941
diff
changeset
|
44 To get started, simply add a new account. |
1400
476b24cdfa32
[gaim-migrate @ 1410]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
1161
diff
changeset
|
45 |
16176
83ec0b408926
Beat some older documentation into submission.
Richard Laager <rlaager@wiktel.com>
parents:
15941
diff
changeset
|
46 If you come across a bug, please report it at: http://pidgin.im |
0 | 47 |
2862
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
48 PLUGINS |
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
49 ======= |
2318
a7bfb5dfab25
[gaim-migrate @ 2328]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2142
diff
changeset
|
50 |
15937 | 51 If you do not wish to enable the plugin support within Purple, run the |
2318
a7bfb5dfab25
[gaim-migrate @ 2328]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2142
diff
changeset
|
52 ./configure script with the --disable-plugins option and recompile your |
a7bfb5dfab25
[gaim-migrate @ 2328]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2142
diff
changeset
|
53 source code. This will prevent the ability to load plugins. |
a7bfb5dfab25
[gaim-migrate @ 2328]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2142
diff
changeset
|
54 |
15937 | 55 'make install' puts the plugins in $PREFIX/lib/purple (PREFIX being what |
56 you specified when you ./configure'd - it defaults to /usr/local). Purple | |
16176
83ec0b408926
Beat some older documentation into submission.
Richard Laager <rlaager@wiktel.com>
parents:
15941
diff
changeset
|
57 looks for the plugins in that directory by default. Plugins can be installed |
83ec0b408926
Beat some older documentation into submission.
Richard Laager <rlaager@wiktel.com>
parents:
15941
diff
changeset
|
58 per-user in ~/.purple/plugins as well. Pidgin and Finch also look in |
83ec0b408926
Beat some older documentation into submission.
Richard Laager <rlaager@wiktel.com>
parents:
15941
diff
changeset
|
59 $PREFIX/lib/pidgin and $PREFIX/lib/finch for UI-specific, respectively. |
2862
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
60 |
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
61 To build a plugin from a .c file, put it in the plugins/ directory in |
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
62 the source and run 'make filename.so', e.g. if you have the .c file |
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
63 'kickass.c', put it in the plugins/ directory, and from that directory, |
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
64 run 'make kickass.so'. |
ad4057cb228f
[gaim-migrate @ 2875]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
2777
diff
changeset
|
65 |