~ubuntu-branches/ubuntu/utopic/libmsn/utopic

« back to all changes in this revision

Viewing changes to README

  • Committer: Bazaar Package Importer
  • Author(s): Jonathan Riddell
  • Date: 2008-12-10 20:20:14 UTC
  • Revision ID: james.westby@ubuntu.com-20081210202014-bqgd3j5qn04ro9xr
Tags: upstream-4.0~beta1svn77
ImportĀ upstreamĀ versionĀ 4.0~beta1svn77

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
libmsn 4.0
 
2
===========
 
3
 
 
4
:Author: Mark Rowe
 
5
:Contact: bdash@users.sourceforge.net
 
6
 
 
7
:Author: Tiago Salem Herrmann
 
8
:Contact: tiagosalem@users.sourceforge.net
 
9
 
 
10
libmsn is a C++ library for Microsoft's MSN Messenger service. It provides a high-level 
 
11
interface that allows an application to access instant messaging features with ease.
 
12
 
 
13
libmsn is licensed under the terms of the GPL.  Please see the file `COPYING' included
 
14
with the distribution for more information.
 
15
 
 
16
Whats New?
 
17
----------
 
18
In 4.0:    libmsn 4.0 was refactored to support MSNP15 protocol.
 
19
           Many features were added to this version, like offline messaging, file transfer with
 
20
           preview, nugdes, custom emoticons, ink and winks sending and receiving, avatar support,
 
21
           address book management with soap actions, and so on.
 
22
 
 
23
In 3.2:    With the release of libmsn 3.2 comes support for multiple simultaneous connections.  The
 
24
           callback mechanism has been refactored so that it is easy to distinguish between each
 
25
           connection's callbacks.  A large number of bug fixes have also been rolled in to this
 
26
           release.
 
27
In 3.1.1:  libmsn 3.1.1 is primarily a bug fix release.  Changes include fixing up the #include's
 
28
           so that it compiles cleanly on a wider range of platforms, working file transfer
 
29
           support and improved error handling.
 
30
In 3.1:    libmsn 3.1 brings support for server-side groups for managing buddies.  It also
 
31
           features rewritten network code that should help reduce CPU usage, and the amount
 
32
           of time spent waiting for network data.
 
33
In 3.0b2:  3.0b2 tidies up the external API to be more consistent with the rest of libmsn.
 
34
           The build system has also been adjusted so that the same program, msntest, is
 
35
           built.
 
36
 
 
37
Installation
 
38
------------
 
39
You need to use cmake to build libmsn. (http://www.cmake.org/)
 
40
The basic installation procedure is similar to::
 
41
 
 
42
  $ cd libmsn; mkdir build; cd build
 
43
  $ cmake ..
 
44
  # make install
 
45
 
 
46
See `INSTALL' for more information.
 
47
 
 
48
Note:: On Mac OS X 10.3, problems have been experienced when libmsn is built as a shared library.
 
49
       Work is being done to resolve these problems.  To work around these problems, it is advised
 
50
       that libmsn is configured as a static library.  This can be done by providing the following
 
51
       arguments to ./configure --disable-shared --enable-static
 
52
 
 
53
Documentation
 
54
-------------
 
55
Documentation for libmsn is available in the `doc/' subdirectory.  A brief overview of
 
56
the library can be found in `doc/overview.html', while more details API documentation is
 
57
inside the `doc/api/' directory.
 
58
 
 
59
A sample program that uses libmsn can be found in `msn/msntest.cpp'.
 
60
 
 
61
Support
 
62
-------
 
63
For questions about usage of libmsn, please use the libmsn-discuss mailing list.  A web
 
64
interface for subscribing to this mailing list is available at 
 
65
http://lists.sourceforge.net/lists/listinfo/libmsn-discuss/.  If you prefer real-time
 
66
discussion, please look to the #libmsn channel on irc.freenode.net.