From 09efdbdbdd5bde06d1d01f58875d410d791f89d8 Mon Sep 17 00:00:00 2001
From: Julian Smart <julian@anthemion.co.uk>
Date: Mon, 5 Jun 2000 13:15:42 +0000
Subject: [PATCH] Added tech note

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/branches/WX_2_2_BRANCH@7532 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---
 distrib/msw/generic.rsp    |   1 +
 distrib/msw/tmake/vc.t     |   9 ++-
 distrib/msw/zipdist.bat    |   3 +
 docs/html/news.htm         |   2 +-
 docs/latex/wx/body.tex     |   2 +-
 docs/latex/wx/datespan.tex |   3 +-
 docs/latex/wx/dropsrc.tex  |   2 +-
 docs/latex/wx/droptrgt.tex |   2 +-
 docs/latex/wx/tdnd.tex     |   6 +-
 docs/readme.txt            |   3 +-
 docs/tech/index.txt        |   1 +
 docs/tech/tn0008.htm       | 144 +++++++++++++++++++++++++++++++++++++
 src/makeg95.env            |   2 +-
 src/msw/makefile.vc        |   9 ++-
 14 files changed, 176 insertions(+), 13 deletions(-)
 create mode 100644 docs/tech/tn0008.htm

diff --git a/distrib/msw/generic.rsp b/distrib/msw/generic.rsp
index b39b40ba85..8acd566e60 100644
--- a/distrib/msw/generic.rsp
+++ b/distrib/msw/generic.rsp
@@ -60,6 +60,7 @@ docs/html/icons/*.gif
 docs/html/icons/*.png
 docs/html/icons/*.jpg
 docs/tech/*.txt
+docs/tech/*.htm
 
 src/makeenvs/*.env
 src/make.env
diff --git a/distrib/msw/tmake/vc.t b/distrib/msw/tmake/vc.t
index 8219ff56b8..5a2ffd1646 100644
--- a/distrib/msw/tmake/vc.t
+++ b/distrib/msw/tmake/vc.t
@@ -452,7 +452,7 @@ clean: $(PERIPH_CLEAN_TARGET)
 
 
 # Making documents
-docs:   allhlp allhtml allpdfrtf
+docs:   allhlp allhtml allpdfrtf htb htmlhelp
 alldocs: docs
 hlp:    wxhlp
 wxhlp:  $(DOCDIR)/winhelp/wx.hlp
@@ -639,6 +639,13 @@ touchmanual:
 
 updatedocs: touchmanual alldocs
 
+cleandocs:
+    -erase /Y $(DOCDIR)\html\wx\wx.htm
+    -erase /Y $(DOCDIR)\pdf\wx.rtf
+    -erase /Y $(DOCDIR)\latex\wx\wx.rtf
+    -erase /Y $(DOCDIR)\htmlhelp\wx.chm
+    -erase /Y $(DOCDIR)\htb\wx.htb
+
 # Start Word, running the GeneratePDF macro. MakeManual.dot should be in the
 # Office StartUp folder, and PDFMaker should be installed.
 updatepdf:  # touchmanual pdfrtf
diff --git a/distrib/msw/zipdist.bat b/distrib/msw/zipdist.bat
index 9da852da6b..bf26c9418e 100755
--- a/distrib/msw/zipdist.bat
+++ b/distrib/msw/zipdist.bat
@@ -216,6 +216,9 @@ ren s setup.w06
 ren setup.w07 s
 ren s setup.w07
 
+ren setup.w08 s
+ren s setup.w08
+
 rem Put all the setup files into a single zip archive.
 zip32 wxMSW-%version%-setup.zip readme.txt setup.*
 
diff --git a/docs/html/news.htm b/docs/html/news.htm
index f2adc22645..ccc451b57a 100644
--- a/docs/html/news.htm
+++ b/docs/html/news.htm
@@ -18,7 +18,7 @@ News
 </tr>
 </table>
 
-<H3><a name="release2_1_16">May 24th, 2000</H3><P>
+<H3><a name="release2_1_16">June 4th, 2000</H3><P>
 
 <ul>
 <li><a href="download.htm" target=wxmain>wxWindows 2.1.16</a> contains fixes
diff --git a/docs/latex/wx/body.tex b/docs/latex/wx/body.tex
index d352ffab3b..f78cce22ce 100644
--- a/docs/latex/wx/body.tex
+++ b/docs/latex/wx/body.tex
@@ -190,7 +190,7 @@ Additions and changes:
 \item Many optical improvements to GTK port.
 \item Support for menu accelerators in GTK port.
 \item Enhanced and improved support for scrolling, including child windows.
-\item Complete rewrite of clipboard and drag'n'drop classes.
+\item Complete rewrite of clipboard and drag and drop classes.
 \item Improved support for ODBC databases.
 \item Improved tab traversal in dialogs.
 \end{itemize}
diff --git a/docs/latex/wx/datespan.tex b/docs/latex/wx/datespan.tex
index 0b684d01d9..bef43ef9c2 100644
--- a/docs/latex/wx/datespan.tex
+++ b/docs/latex/wx/datespan.tex
@@ -11,4 +11,5 @@
 
 \section{\class{wxDateSpan}}\label{wxdatespan}
 
-TODO
+The documentation for this section has not yet been written.
+
diff --git a/docs/latex/wx/dropsrc.tex b/docs/latex/wx/dropsrc.tex
index 2ba59c8779..9b306331ee 100644
--- a/docs/latex/wx/dropsrc.tex
+++ b/docs/latex/wx/dropsrc.tex
@@ -2,7 +2,7 @@
 
 This class represents a source for a drag and drop operation.
 
-See \helpref{Drag'n'Drop overview}{wxdndoverview} and \helpref{wxDataObject overview}{wxdataobjectoverview} 
+See \helpref{Drag and drop overview}{wxdndoverview} and \helpref{wxDataObject overview}{wxdataobjectoverview} 
 for more information.
 
 \wxheading{Derived from}
diff --git a/docs/latex/wx/droptrgt.tex b/docs/latex/wx/droptrgt.tex
index 235118dd32..eb9ca1eed6 100644
--- a/docs/latex/wx/droptrgt.tex
+++ b/docs/latex/wx/droptrgt.tex
@@ -11,7 +11,7 @@ the whole window area, but only a small portion of it. The normal sequence of ca
 \helpref{OnEnter}{wxdroptargetonenter}, possibly many times \helpref{OnDragOver}{wxdroptargetondragover},
 \helpref{OnDrop}{wxdroptargetondrop} and finally \helpref{OnData}{wxdroptargetondata}.
 
-See \helpref{Drag'n'Drop overview}{wxdndoverview} and \helpref{wxDataObject overview}{wxdataobjectoverview}
+See \helpref{Drag and drop overview}{wxdndoverview} and \helpref{wxDataObject overview}{wxdataobjectoverview}
 for more information.
 
 \wxheading{Derived from}
diff --git a/docs/latex/wx/tdnd.tex b/docs/latex/wx/tdnd.tex
index 0e1837d51b..3f57d7ab24 100644
--- a/docs/latex/wx/tdnd.tex
+++ b/docs/latex/wx/tdnd.tex
@@ -1,4 +1,4 @@
-\section{Drag'n'Drop overview}\label{wxdndoverview}
+\section{Drag and drop overview}\label{wxdndoverview}
 
 Classes: \helpref{wxDataObject}{wxdataobject}, 
 \helpref{wxTextDataObject}{wxtextdataobject}, 
@@ -8,12 +8,12 @@ Classes: \helpref{wxDataObject}{wxdataobject},
 \helpref{wxFileDropTarget}{wxfiledroptarget}
 
 Note that wxUSE\_DRAG\_AND\_DROP must be defined in setup.h in order
-to use Drag'n'Drop in wxWindows.
+to use drag and drop in wxWindows.
 
 See also: \helpref{wxDataObject overview}{wxdataobjectoverview} and \helpref{DnD sample}{samplednd}
 
 It may be noted that data transfer to and from the clipboard is quite
-similar to data transfer with Drag'n'Drop and the code to implement
+similar to data transfer with drag and drop and the code to implement
 these two types is almost the same. In particular, both data transfer
 mechanisms store data in some kind of \helpref{wxDataObject}{wxdataobject}
 and identify its format(s) using the \helpref{wxDataFormat}{wxdataformat}
diff --git a/docs/readme.txt b/docs/readme.txt
index 76742dd2a6..0c1481e51c 100644
--- a/docs/readme.txt
+++ b/docs/readme.txt
@@ -177,7 +177,6 @@ If you use JPEG image handler, documentation for your program should
 contain following sentence: "This software is based in part on the work of
 the Independent JPEG Group". See src/jpeg/README for details.
 
-
 Documentation
 -------------
 
@@ -216,5 +215,5 @@ web site) or contact Julian Smart <julian.smart@ukonline.co.uk>.
 
 Good luck!
 
-The wxWindows Team, 24th May, 2000
+The wxWindows Team, 4th June, 2000
 
diff --git a/docs/tech/index.txt b/docs/tech/index.txt
index 35cbcd4481..e13ccc311a 100644
--- a/docs/tech/index.txt
+++ b/docs/tech/index.txt
@@ -5,5 +5,6 @@ TN0004   Compiling a sample in the C++Builder IDE
 TN0005   Adding a wxWindows contribution
 TN0006   Making and installing RPMs for wxWindows
 TN0007   Using and modifying the BC++ IDE files
+TN0008   How to learn wxWindows programming
 
 Version: $Id$
diff --git a/docs/tech/tn0008.htm b/docs/tech/tn0008.htm
new file mode 100644
index 0000000000..dcbc731c92
--- /dev/null
+++ b/docs/tech/tn0008.htm
@@ -0,0 +1,144 @@
+<HTML>
+
+<HEAD>
+<TITLE>How to learn wxWindows programming</TITLE>
+</HEAD>
+
+<BODY BGCOLOR=#FFFFFF TEXT=#000000 LINK=#FF0000 VLINK=#000000>
+
+<font face="Arial, Lucida Sans, Helvetica">
+
+<a name="top"></a>
+
+<table align=center width=100% border=4 cellpadding=5 cellspacing=0>
+<tr>
+<td bgcolor="#660000" align=left colspan=2>
+<font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF">
+How to learn wxWindows programming
+</font>
+</td>
+</tr>
+</table>
+
+<P>
+
+The following is a response by Edward Ream to a common question,
+"What's the best way to learn wxWindows [and C++]?".<P>
+
+Date: Sun, 04 Jun 2000 14:37:06 -0500<BR>
+From: "Edward K. Ream" <edream@tds.net> <BR>
+To: wx-users@wxwindows.org<BR>
+Subject: Re: [wx-users] How to learn using wx-windows <BR>
+Reply-To: wx-users@wxwindows.org<P>
+
+> Reading the Linux Journal article on wxpython, and having used wxclips<BR>
+> I got interested in wxwindows as a development interface. However, the<BR>
+> programming experience I got is old, and from a former generation (For-<BR>
+> tran). I'd like to refresh my experience and start in C++.  Will<BR>
+> wx-windows be a very high step to take?<P>
+
+I'm new to wxWindows myself, but I'd like to answer this question
+anyway. In the past two years I've learned two similar frameworks
+(Apple's Yellow Box, aka NextStep/OpenStep and Borland's C++
+Builder/Delphi) and last year I became a C++ enthusiast after 20 years
+of using C.<P>
+
+<B>About C++.</B><P>
+
+The major Aha for me was that the complexity of C++ doesn't matter in
+practice.  What _does_ matter is that C++ allows you to do simple things
+simply, more simply than C.  With a system like wxWindows you will be
+creating objects and then using those objects to call methods.  So don't
+be afraid of C++: you'll only be using the easy tip of the
+iceberg.<P>
+
+Besides the C++ Programming Language, by Bjarne Stroustrup, the
+"official" guide to C++, I highly recommend Inside the C++ Object Model,
+by Stanley B. Lippman.  (Lipmann was one of the C++ honchos at Bell
+Labs.)  This book will tell you what _not_ to do, as well as why
+everything in C++ is as it is.  If you are confused by anything in C++,
+Lippman's book is the cure.<P>
+
+<B>About applications frameworks.</B><P>
+
+Application frameworks such as wxWindows are organized around a set of
+cooperating classes.  Take a look at the main application class, wxApp,
+some frame and panel classes, graphics classes, menu classes, control
+classes, etc.  In general, to do anything in a framework involves
+creating an object of the specified type, then doing something with that
+object.<P>
+
+For example, suppose you want to create a menu bar.  A menu bar is
+composed of a single menu bar object of type(class) wxMenuBar that
+contains menu objects of type wxMenu.  Each menu object contains menu
+item objects of type wxMenuItem.  So you create the menu bar object,
+then create all the menu objects (creating the menu item objects along
+the way) and finally "attach" the menu objects to the menu bar object
+using a call to the wxMenuBar::Append method.<P>
+
+As an overview I would look at the "Alphabetical class reference"
+section of the reference manual.  I find the HTML version to be the
+easiest to use:  you can browse very quickly through it.  Here's how to
+read this (very large) reference:<P>
+
+<ol>
+<li>Get an overview of the kinds of classes involved.  The class names
+will tell you a lot about what each class does.  Open some of the
+classes, in particular, wxApp (the main application object), wxFrame,
+wxControl (the base class for all controls) and one or two controls,
+like wxButton.
+
+<li>When scanning a class for the first several times, read the
+introductory remarks and quickly scan the list of methods of the class
+to get a general idea about what kinds of operations can be done to
+objects of the class.  You are not looking for detail at this stage,
+just for the big picture.  In particular, what classes exist and how do
+they work together.
+
+<li>Pay particular attention to the classes from which a class is
+derived.  For example, a button (an object of type wxButton) is derived
+from the wxControl, wxWindow, wxEvtHandler and wxObject classes.  What
+does this mean?  It means that a button _is_ a control, and a button
+_is_ a window, and a button _is_ an event handler and a button _is_ an
+object.  So you must understand the parent classes of an object to
+understand the object itself.
+
+For example, if b is a button you can invoke b.m for any of method m of
+the wxControl, wxWindow, wxEvtHandler or wxObject classes.  You are not
+limited to just the methods of wxButton!  This is one of the keys of
+object oriented programming.
+</ol>
+
+Some other tips:<P>
+
+Read some sample code.  You will find that almost none of the C++
+language is actually being used; it's just endlessly creating objects
+and then calling methods using those objects.<P>
+
+Learn as much as you can about the String class; after using a good
+String class you'll never want to use C's string functions again. 
+wxWindows contains other nifty utilty classes as well.<P>
+
+The application class, wxApp, contains the main event loop.  Learn about
+event handling and event tables (reading sample code will help). Almost
+everything in this kind of application framework happens as the result
+of an event and your app is essentially doing nothing but responding to
+events.  Having the event loop written for you is a major, major
+benefit.<P>
+
+I hope this helps. Perhaps we can work together in learning about
+wxWindows.  Please feel free to ask me any questions you might have.  If
+I've made any blunders in this posting I hope the wxWindows experts will
+correct me gently.<P>
+
+Edward<BR>
+--------------------------------------------------------------------<BR>
+Edward K. Ream   email:  edream@tds.net<BR>
+Leo: Literate Editor with Outlines<BR>
+Leo: http:&#47;&#47;personalpages.tds.net/~edream/front.html<BR>
+--------------------------------------------------------------------<P>
+
+</font>
+
+</body>
+</html>
diff --git a/src/makeg95.env b/src/makeg95.env
index 79786db36c..3d091c3035 100644
--- a/src/makeg95.env
+++ b/src/makeg95.env
@@ -18,7 +18,7 @@ MINGW32=1
 MINGW32VERSION=2.95
 
 # If building DLL, the version
-WXVERSION=21_11
+WXVERSION=21_16
 
 # Say yes if you have a "modern" linker that supports --shared option.
 # Note that you're probably going to wait forever for dlltool/gcc/etc
diff --git a/src/msw/makefile.vc b/src/msw/makefile.vc
index 8bd01adcee..7c99b30bcf 100644
--- a/src/msw/makefile.vc
+++ b/src/msw/makefile.vc
@@ -658,7 +658,7 @@ clean: $(PERIPH_CLEAN_TARGET)
 
 
 # Making documents
-docs:   allhlp allhtml allpdfrtf
+docs:   allhlp allhtml allpdfrtf htb htmlhelp
 alldocs: docs
 hlp:    wxhlp
 wxhlp:  $(DOCDIR)/winhelp/wx.hlp
@@ -845,6 +845,13 @@ touchmanual:
 
 updatedocs: touchmanual alldocs
 
+cleandocs:
+    -erase /Y $(DOCDIR)\html\wx\wx.htm
+    -erase /Y $(DOCDIR)\pdf\wx.rtf
+    -erase /Y $(DOCDIR)\latex\wx\wx.rtf
+    -erase /Y $(DOCDIR)\htmlhelp\wx.chm
+    -erase /Y $(DOCDIR)\htb\wx.htb
+
 # Start Word, running the GeneratePDF macro. MakeManual.dot should be in the
 # Office StartUp folder, and PDFMaker should be installed.
 updatepdf:  # touchmanual pdfrtf