annotate libpurple/version.h.in @ 28875:8464e695c62b

Fixes a bad MSN bug where passwords with multi-byte utf8 characters near the 16 byte mark would cause a segmentation fault due to chopping the multi-byte character and turning the string into invalidate utf8. Thanks to Shaun Lindsay at Meebo for tracking this down and fixing it.
author Mark Doliner <mark@kingant.net>
date Wed, 04 Nov 2009 18:41:21 +0000
parents bb43dea90623
children 02a2e8183b1d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
16591
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
1 /**
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
2 * @file version.h Purple Versioning
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
3 *
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
4 * purple
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
5 *
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
6 * Purple is the legal property of its developers, whose names are too numerous
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
7 * to list here. Please refer to the COPYRIGHT file distributed with this
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
8 * source distribution.
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
9 *
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
10 * This program is free software; you can redistribute it and/or modify
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
11 * it under the terms of the GNU General Public License as published by
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
12 * the Free Software Foundation; either version 2 of the License, or
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
13 * (at your option) any later version.
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
14 *
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
15 * This program is distributed in the hope that it will be useful,
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
18 * GNU General Public License for more details.
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
19 *
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
20 * You should have received a copy of the GNU General Public License
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
21 * along with this program; if not, write to the Free Software
19680
44b4e8bd759b The FSF changed its address a while ago; our files were out of date.
John Bailey <rekkanoryo@rekkanoryo.org>
parents: 16827
diff changeset
22 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
16591
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
23 */
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
24 #ifndef _PURPLE_VERSION_H_
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
25 #define _PURPLE_VERSION_H_
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
26
25122
bb43dea90623 Document the PURPLE_MAJOR_VERSION, PURPLE_MINOR_VERSION, and
Etan Reisner <pidgin@unreliablesource.net>
parents: 21920
diff changeset
27 /** The major version of the running libpurple. */
16591
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
28 #define PURPLE_MAJOR_VERSION (@PURPLE_MAJOR_VERSION@)
25122
bb43dea90623 Document the PURPLE_MAJOR_VERSION, PURPLE_MINOR_VERSION, and
Etan Reisner <pidgin@unreliablesource.net>
parents: 21920
diff changeset
29 /** The minor version of the running libpurple. */
16591
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
30 #define PURPLE_MINOR_VERSION (@PURPLE_MINOR_VERSION@)
25122
bb43dea90623 Document the PURPLE_MAJOR_VERSION, PURPLE_MINOR_VERSION, and
Etan Reisner <pidgin@unreliablesource.net>
parents: 21920
diff changeset
31 /** The micro version of the running libpurple. */
16591
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
32 #define PURPLE_MICRO_VERSION (@PURPLE_MICRO_VERSION@)
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
33
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
34 #define PURPLE_VERSION_CHECK(x,y,z) ((x) == PURPLE_MAJOR_VERSION && \
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
35 ((y) < PURPLE_MINOR_VERSION || \
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
36 ((y) == PURPLE_MINOR_VERSION && (z) <= PURPLE_MICRO_VERSION)))
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
37
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
38 #ifdef __cplusplus
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
39 extern "C" {
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
40 #endif
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
41
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
42 /**
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
43 * Checks that the libpurple version is compatible with the requested
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
44 * version
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
45 *
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
46 * @param required_major: the required major version.
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
47 * @param required_minor: the required minor version.
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
48 * @param required_micro: the required micro version.
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
49 *
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
50 * @return NULL if the versions are compatible, or a string describing
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
51 * the version mismatch if not compatible.
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
52 */
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
53 const char *purple_version_check(guint required_major, guint required_minor, guint required_micro);
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
54
21920
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
55 /**
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
56 * The major version of the running libpurple. Contrast with
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
57 * #PURPLE_MAJOR_VERSION, which expands at compile time to the major version of
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
58 * libpurple being compiled against.
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
59 *
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
60 * @since 2.4.0
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
61 */
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
62 extern const guint purple_major_version;
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
63
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
64 /**
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
65 * The minor version of the running libpurple. Contrast with
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
66 * #PURPLE_MINOR_VERSION, which expands at compile time to the minor version of
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
67 * libpurple being compiled against.
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
68 *
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
69 * @since 2.4.0
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
70 */
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
71 extern const guint purple_minor_version;
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
72
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
73 /**
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
74 *
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
75 * The micro version of the running libpurple. Contrast with
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
76 * #PURPLE_MICRO_VERSION, which expands at compile time to the micro version of
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
77 * libpurple being compiled against.
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
78 *
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
79 * @since 2.4.0
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
80 */
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
81 extern const guint purple_micro_version;
76d025660d9e Export purple_*_version in version.h.
Will Thompson <will.thompson@collabora.co.uk>
parents: 21911
diff changeset
82
16591
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
83 #ifdef __cplusplus
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
84 }
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
85 #endif
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
86
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
87 #endif /* _PURPLE_VERSION_H_ */
ce049678a67b soname versioning of libpurple. Should help resolve debian bug 421282
Stu Tomlinson <stu@nosnilmot.com>
parents:
diff changeset
88