summaryrefslogtreecommitdiff
path: root/qt4/TelepathyQt4/main.dox
blob: 10042ba2632aea1e49f012ff22e135f5be7f4304 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
/*
 * This file is part of TelepathyQt4
 *
 * @copyright Copyright (C) 2008 Collabora Ltd. <http://www.collabora.co.uk/>
 * @copyright Copyright (C) 2008 Nokia Corporation
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */

/**
 * \mainpage Telepathy-Qt4
 *
 * \section Introduction
 *
 * Telepathy-Qt4 is a Qt4 high-level binding for \telepathy.
 *
 * \telepathy is a \dbus framework for unifying real time communication, including instant
 * messaging, voice calls and video calls. It abstracts differences between protocols to
 * provide a unified interface for applications.
 *
 * Releases can be found <a
 * href="http://telepathy.freedesktop.org/releases/telepathy-qt4">here</a>.
 *
 * Development is done in the git repository found <a
 * href="http://cgit.freedesktop.org/telepathy/telepathy-qt4/">here</a>.
 *
 * \li <a href="classes.html">All Classes</a>
 *
 * \section getting_started Getting Started
 * \li \subpage installation
 *
 * \section examples Examples
 *
 * This is the list of examples in Telepathy-Qt4's examples directory.
 * The examples demonstrate Telepathy-Qt4 features in small, self-contained
 * programs. They are not all designed to be impressive when you run them,
 * but their source code is carefully written to show good Telepathy-Qt4
 * programming practices.
 *
 * \li \subpage accounts_example
 * \li \subpage contact_messenger_example
 * \li \subpage protocols_example
 * \li \subpage roster_example
 *
 * \section developer_resources Further Information
 * \li \subpage bugreport
 * \li \subpage mailing_lists
 * \li \subpage async_model
 * \li \subpage shared_ptr
 */

/**
 * \page installation Installation
 *
 * \section installation_from_source Installing from source on Linux
 *
 * \subsection installation_from_source_requirements Requirements
 *
 * Building Telepathy-Qt4 requires:
 * \li Qt, including QtDBus <http://www.qtsoftware.com/>
 * \li GNU make <http://www.gnu.org/software/make/>
 * \li pkg-config <http://ftp.gnome.org/pub/GNOME/sources/pkg-config/>
 * \li libxslt, xsltproc <http://xmlsoft.org/XSLT/>
 * \li Python <http://www.python.org/>
 *
 * For the full set of regression tests to run, you'll also need:
 * \li telepathy-glib <http://telepathy.freedesktop.org/releases/telepathy-glib/>
 *
 * and to build the example VoIP call UI (examples/call), you'll need:
 * \li telepathy-glib <http://telepathy.freedesktop.org/releases/telepathy-glib/>
 * \li telepathy-farsight
 *  <http://telepathy.freedesktop.org/releases/telepathy-farsight/>
 * \li GStreamer <http://gstreamer.freedesktop.org/>\n
 *
 * Building also requires the cmake build system.
 *
 * \subsection installation_from_source_building Building
 *
 * After installing all dependencies, run:
 *
 * \verbatim
   $ mkdir build; cd build
   $ cmake ..
   $ make
   $ make install \endverbatim
 */

/**
 * \page bugreport How to report a bug
 *
 * Before reporting a bug, please check the <a
 * href="https://bugs.freedesktop.org/query.cgi?product=Telepathy&component=telepathy-qt4">
 * Bug Tracker</a> to see if the issue is already known.
 *
 * Always include the following information in your bug report:
 * \li The version of Telepathy-Qt4 you are using
 *
 * Please submit the bug report, feature request or "to-do" item
 * <a
 * href="https://bugs.freedesktop.org/enter_bug.cgi?product=Telepathy&component=telepathy-qt4">
 * here</a>.
 */

/**
 * \page mailing_lists Mailing Lists
 *
 * <a href="http://lists.freedesktop.org/mailman/listinfo/telepathy">General
 * discussion list</a>\n
 * This list should be used for general discussion about \telepathy usage,
 * development.
 *
 * <a
 * href="http://lists.freedesktop.org/mailman/listinfo/telepathy-commits">
 * Commits list</a>\n
 * Subscribe to this list to follow the commits.
 *
 * <a
 * href="http://lists.freedesktop.org/mailman/listinfo/telepathy-bugs">
 * Bugs list</a>\n
 * Subscribe to this list to follow the bug reports.
 */