From 91c93c992767c2399adcc18c51ac35d8606bc28b Mon Sep 17 00:00:00 2001 From: Julian Smart Date: Fri, 6 Aug 1999 15:59:31 +0000 Subject: [PATCH] Minor additions to FAQ git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@3305 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775 --- docs/html/faqgen.htm | 7 +++-- docs/html/faqmsw.htm | 73 ++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 78 insertions(+), 2 deletions(-) diff --git a/docs/html/faqgen.htm b/docs/html/faqgen.htm index e0f0fc6673..2cf955358a 100644 --- a/docs/html/faqgen.htm +++ b/docs/html/faqgen.htm @@ -192,6 +192,9 @@ We are using the CVS system to develop and maintain wxWind us to make alterations and upload them instantly to the server in Edinburgh, from which others can update their source.

+To build source from CVS, see the file BuildCVS.txt in the top-level wxWindows distribution +directory.

+

How is wxWindows 2 distributed?

By ftp, and via the wxWindows CD-ROM.

@@ -203,8 +206,8 @@ finished?) to think very far ahead. However, we know we want to make wxWindows a and well-publicised as possible. We also want to aim for better platform-independence of resources such as icons and bitmaps, standardising on the PNG for all platforms.

-Other possibilities include: DCOM/CORBA compatibility; a wxWindows book; an -IDE; +Other possibilities include: DCOM/CORBA compatibility; a wxWindows book; +wxStudio, an IDE; other platforms; other interface abilities such as speech output.

We will investigate the possibility of compiler or operating system vendors bundling wxWindows with diff --git a/docs/html/faqmsw.htm b/docs/html/faqmsw.htm index 984a87f3fc..085980f7b7 100644 --- a/docs/html/faqmsw.htm +++ b/docs/html/faqmsw.htm @@ -166,6 +166,79 @@ optimized. For example, in wxWindows project, set to 'Minimum Size'. In Dialog Editor project, set to 'Customize: Favor Small Code' (and no others). This will then work.

+

How are the wxWindows makefiles edited under Windows?

+ +As of wxWindows 2.1, there is a new system written by Vadim Zeitlin, that +generates the makefiles from templates using tmake.

+ +Here are Vadim's notes:

+ +

+To use these new makefiles, you don't need anything (but see below). +However, you should NOT modify them because these files will be +rewritten when I regenerate them using tmake the next time. So, if +you find a problem with any of these makefiles (say, makefile.b32) +you'll need to modify the corresponding template (b32.t in this +example) and regenerate the makefile using tmake.

+ +tmake can be found at +www.troll.no/freebies/tmake.html. +It's a Perl5 program and so it needs Perl (doh). There is a binary for +Windows (available from the same page), but I haven't used it, so +I don't know if it works as flawlessly as "perl tmake" does (note +for people knowing Perl: don't try to run tmake with -w, it won't +do you any good). Using it extremely simple: to regenerate makefile.b32 +just go to distrib/msw/tmake and type

+ +

tmake -t b32 wxwin.pro -o ../../src/msw/makefile.b32

+ +The makefiles are untested - I don't have any of Borland, Watcom or +Symantec and I don't have enough diskspace to recompile even with +VC6 using makefiles. The new makefiles are as close as possible to the +old ones, but not closer: in fact, there has been many strange things +(should I say bugs?) in some of makefiles, some files were not compiled +without any reason etc. Please test them and notify me about any problems. +Better yet, modify the template files to generate the correct makefiles +and check them in.

+ +The templates are described in tmake ref manual (1-2 pages of text) +and are quite simple. They do contain some Perl code, but my Perl is +primitive (very C like) so it should be possible for anybody to make +trivial modifications to it (I hope that only trivial modifications +will be needed). I've tagged the ol makefiles as MAKEFILES_WITHOUT_TMAKE +in the cvs, so you can always retrieve them and compare the new ones, +this will make it easier to solve the problems you might have.

+ +Another important file is filelist.txt: it contains the list of all +files to be compiled. Some of them are only compiled in 16/32 bit mode. +Some other are only compiled with some compilers (others can't compile +them) - all this info is contained in this file.

+ +So now adding a new file to wxWindows is as easy as modifying filelist.txt +(and Makefile.ams for Unix ports) and regenerating the makefiles - no +need to modify all files manually any more.

+ + Finally, there is also a file vc6.t which I use myself: this one +generates a project file for VC++ 6.0 (I didn't create vc5.t because +I don't need it and can't test it, but it should be trivial to create +one from vc6.t - probably the only things to change would be the +version number in the very beginning and the /Z option - VC5 doesn't +support edit-and=continue). This is not an officially supported way +of building wxWindows (that is, nobody guarantees that it will work), +but it has been very useful to me and I hope it will be also for +others. To generate wxWindows.dsp run

+ +

tmake -t vc6 wxwin.pro -o ../../wxWindows.dsp

+ +Then just include this project in any workspace or open it from VC IDE +and it will create a new workspace for you.

+ +If all goes well, I'm planning to create a template file for Makefile.ams +under src/gtk and src/motif and also replace all makefiles in the samples +subdirectories with the project files from which all the others will be +generated. At least it will divide the number of files in samples +directory by 10 (and the number of files to be maintained too). +