]>
Commit | Line | Data |
---|---|---|
8c9f8f91 | 1 | wxWidgets 2.5.5 |
f6bcfd97 | 2 | --------------- |
41c09d48 | 3 | |
940718f0 JS |
4 | *** Please note that this is an UNSTABLE DEVELOPMENT SNAPSHOT. |
5 | *** Unless you need the new features and bug fixes, you may wish to | |
dca9009b VZ |
6 | *** use the official 2.4.x stable series. You are still encouraged |
7 | *** to try the releases from 2.5.x branch, of course, and unstable | |
8 | *** doesn't mean that they crash all the time -- just that the API | |
3980000c | 9 | *** may change in a backwards incompatible way. If this doesn't frighten |
dca9009b | 10 | *** you, do try this release and please let us know what you think! |
940718f0 | 11 | |
fc2171bd | 12 | Welcome to wxWidgets, a sophisticated cross-platform C++ |
2dc5505e JS |
13 | framework for writing advanced GUI applications using (where |
14 | possible) the native controls. | |
15 | ||
940718f0 JS |
16 | In addition to common and advanced GUI facilities such as |
17 | frames, scrolling windows, toolbars, tree controls, icons, | |
18 | device contexts, printing, splitter windows and so on, there are | |
19 | wrappers for common file operations, and facilities for writing | |
20 | TCP/IP applications, thread handling, and more. Where certain | |
21 | features are not available on a platform, such as MDI and tree | |
22 | controls on Unix, they are emulated. | |
2dc5505e | 23 | |
4e3ad7c0 | 24 | A detailed 1800-page reference manual is supplied in HTML, PDF |
940718f0 | 25 | and Windows Help form: see the docs hierarchy. |
41c09d48 | 26 | |
940718f0 JS |
27 | For a quick start, point your Web browser at docs/html/index.htm |
28 | for a list of important documents and samples. | |
7921cf2b | 29 | |
ee1aaf99 JS |
30 | Changes in this release |
31 | ----------------------- | |
32 | ||
9bb3479c | 33 | Please see changes.txt for details. |
ee1aaf99 | 34 | |
41c09d48 | 35 | Platforms supported |
c801d85f KB |
36 | ------------------- |
37 | ||
fc2171bd | 38 | wxWidgets currently supports the following platforms: |
41c09d48 | 39 | |
77ffb593 | 40 | - Windows 95/98/ME, Windows NT, Windows 2000, Windows XP, Pocket PC |
8dfe337a JS |
41 | - Most Unix variants with GTK+ 1 and GTK+ 2 |
42 | - Most Unix variants with X11 (beta) | |
c4077b34 | 43 | - Most Unix variants with Motif/Lesstif |
8dfe337a JS |
44 | - MacOS 9.x and 10.x using Carbon (10.3 and above preferred) |
45 | - MacOS 10.x using Cocoa (beta) | |
46 | - OS/2 (beta) | |
8870c26e | 47 | |
9bb3479c JS |
48 | Most popular C++ compilers are supported; see the install.txt |
49 | file for each platform (available via docs/html/index.htm) for details. | |
fc2171bd | 50 | See also http://www.wxwidgets.org/platform.htm. |
41c09d48 JS |
51 | |
52 | Files | |
53 | ----- | |
54 | ||
f6bcfd97 | 55 | The distribution is available in archive formats appropriate to the |
8dfe337a | 56 | target system. See the download pages for details. |
0bc9b25e | 57 | |
41c09d48 JS |
58 | Installation |
59 | ------------ | |
60 | ||
2a3476f2 JS |
61 | wxWidgets needs to be compiled before you can test out the samples |
62 | or write your own applications. For installation information, please | |
63 | see the install.txt file in the individual directories: | |
38d24a39 JS |
64 | |
65 | docs/msw | |
66 | docs/gtk | |
67 | docs/motif | |
ab85e6cd | 68 | docs/mac |
2a3476f2 | 69 | docs/cocoa |
2c7b88e6 JS |
70 | docs/x11 |
71 | docs/mgl | |
4e3ad7c0 | 72 | docs/os2 |
c801d85f | 73 | |
2dc5505e | 74 | Licence information |
41c09d48 JS |
75 | ------------------- |
76 | ||
77 | For licensing information, please see the files: | |
78 | ||
79 | docs/preamble.txt | |
80 | docs/licence.txt | |
81 | docs/licendoc.txt | |
82 | docs/gpl.txt | |
83 | docs/lgpl.txt | |
84 | ||
2dc5505e | 85 | Although this may seem complex, it is there to allow authors of |
fc2171bd | 86 | proprietary/commercial applications to use wxWidgets in |
2dc5505e | 87 | addition to those writing GPL'ed applications. In summary, |
9922de0b | 88 | the licence is LGPL plus a clause allowing unrestricted |
2dc5505e JS |
89 | distribution of application binaries. To answer a FAQ, you |
90 | don't have to distribute any source if you wish to write | |
fc2171bd | 91 | commercial applications using wxWidgets. |
9922de0b VS |
92 | |
93 | However, if you distribute wxGTK or wxMotif (with Lesstif) version | |
94 | of your application, don't forget that it is linked against | |
95 | GTK+ (or Lesstif) which is covered by LGPL *without* exception | |
96 | notice. Under Linux systems your app is probably linked | |
2edb0bde | 97 | against LGPL glibc as well. Please read carefully LGPL, section 6. |
9922de0b | 98 | which describes conditions for distribution of closed source applications |
2edb0bde | 99 | linked against LGPL library. Basically you should link dynamically and |
9922de0b VS |
100 | include source code of LGPL libraries with your product (unless it is |
101 | already present in user's system - like glibc usually is). | |
fc2171bd | 102 | If compiled with --enable-odbc (Unix only), wxWidgets library will |
9922de0b VS |
103 | contain iODBC library which is covered by LGPL. |
104 | ||
26de8b7d | 105 | If you use TIFF image handler, please see src/tiff/COPYRIGHT |
cb128243 | 106 | for libtiff licence details. |
26de8b7d VS |
107 | |
108 | If you use JPEG image handler, documentation for your program should | |
109 | contain following sentence: "This software is based in part on the work of | |
110 | the Independent JPEG Group". See src/jpeg/README for details. | |
111 | ||
a553cb8b VZ |
112 | If you use wxRegEx class on a system without native regular expressions |
113 | support (i.e. MS Windows), see src/regex/COPYRIGHT file for Henry Spencer's | |
114 | regular expression library copyright. | |
115 | ||
cb128243 VS |
116 | If you use wxXML classes or XRC, see src/expat/COPYING for licence details. |
117 | ||
2dc5505e JS |
118 | Documentation |
119 | ------------- | |
120 | ||
2dc5505e JS |
121 | See docs/html/index.htm for an HTML index of the major documents. |
122 | ||
2a3476f2 | 123 | See docs/changes.txt for a summary of changes to wxWidgets. |
9ba09ba5 JS |
124 | |
125 | See docs/tech for an archive of technical notes. | |
6adaedf0 | 126 | |
fc2171bd | 127 | The wxWidgets bug database can be browsed at: |
4e3ad7c0 JS |
128 | |
129 | http://sourceforge.net/bugs/?group_id=9863 | |
130 | ||
2dc5505e JS |
131 | The Windows help files are located in docs/winhelp. |
132 | The PDF help files are located in docs/pdf. | |
133 | ||
134 | Further information | |
135 | ------------------- | |
136 | ||
fc2171bd | 137 | The wxWidgets Web site is located at: |
2dc5505e | 138 | |
fc2171bd | 139 | http://www.wxwidgets.org |
2dc5505e | 140 | |
fc2171bd | 141 | The main wxWidgets ftp site is at: |
2dc5505e | 142 | |
f44b23b6 | 143 | ftp://biolpc22.york.ac.uk/pub |
2dc5505e | 144 | |
fc2171bd | 145 | A wxWidgets CD-ROM with the latest distribution plus an HTML |
2dc5505e | 146 | front-end and hundreds of MB of compilers, utilities and other |
fc2171bd | 147 | material may be ordered from the CD-ROM page: see the wxWidgets |
ab85e6cd | 148 | web site. |
2dc5505e | 149 | |
bc00e715 | 150 | Have fun! |
2dc5505e | 151 | |
8b36c71c | 152 | The wxWidgets Team, April 2005 |
41c09d48 | 153 |