Cured some small doc typos; some WIN16 fixes; transferred DLL WinMain to

IMPLEMENT_APP() macro so dummy.obj doesn't have to be linked; lexer.l fix
for LEX (I hope)


git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@1672 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

docs/changes.txt

@@ -1,6 +1,28 @@
 wxWindows 2 Change Log
 ----------------------
 
+Beta 4, February 1999
+-------------------------
+
+wxGTK:
+
+- Miscellaneous fixes.
+
+wxMSW:
+
+- Makefiles for more compilers and samples; Cygwin makefiles
+  rationalised.
+- Added DLL support to VC++ makefiles.
+
+wxMotif:
+
+
+General:
+
+- Further doc improvements.
+- wxGenericValidator added.
+
+
 Beta 3, January 31st 1999
 -------------------------
 

docs/latex/wx/manual.tex

@@ -26,11 +26,11 @@
 \parskip=10pt
 \parindent=0pt
 \title{User Manual for wxWindows 2.0: a portable C++ GUI toolkit}
-\winhelponly{\author{by Julian Smart
+\winhelponly{\author{by Julian Smart et al
 %\winhelponly{\\$$\image{1cm;0cm}{wxwin.wmf}$$}
 }}
-\winhelpignore{\author{Julian Smart}
-\date{December 27th 1998}
+\winhelpignore{\author{Julian Smart et al}
+\date{February 10th 1999}
 }
 \makeindex
 \begin{document}

docs/latex/wx/stream.tex

@@ -61,7 +61,7 @@ But you should care about destroying the stream buffer \it{YOURSELF}.
 
 \wxheading{See also}
 
-\helpref{wxStreamBuffer:SetBufferIO}{wxstreambufsetbufferio}
+\helpref{wxStreamBuffer:SetBufferIO}{wxstreambuffersetbufferio}
 
 \func{}{wxStreamBuffer}{\param{const wxStreamBuffer &}{buffer}}
 
@@ -90,7 +90,7 @@ The "Write-Back" buffer is freed.
 % -----------
 % Filtered IO
 % -----------
-\membersection{wxStreamBuffer::Read}\label{wxstreambufread}
+\membersection{wxStreamBuffer::Read}\label{wxstreambufferread}
 
 \func{size\_t}{Read}{\param{void *}{buffer}, \param{size\_t }{size}}
 
@@ -108,14 +108,14 @@ It returns the real read size. If returned size is different of the specified
 
 \wxheading{See also}
 
-\helpref{wxStreamBuffer::WriteBack}{wxstreambufwriteback}
+\helpref{wxStreamBuffer::WriteBack}{wxstreambufferwriteback}
 
 \func{size\_t}{Read}{\param{wxStreamBuffer *}{buffer}}
 
 Reads a \it{buffer}. The function returns when \it{buffer} is full or
 when there aren't datas anymore in the current buffer.
 
-\membersection{wxStreamBuffer::Write}
+\membersection{wxStreamBuffer::Write}\label{wxstreambufferwrite}
 
 \func{size\_t}{Write}{\param{const void *}{buffer}, \param{size\_t }{size}}
 
@@ -124,9 +124,9 @@ are cached in a buffer before being sent in one block to the stream.
 
 \func{size\_t}{Write}{\param{wxStreamBuffer *}{buffer}}
 
-See \helpref{Read}{wxstreambufreadbuf}
+See \helpref{Read}{wxstreambufferread}.
 
-\membersection{wxStreamBuffer::WriteBack}\label{wxstreambufwriteback}
+\membersection{wxStreamBuffer::WriteBack}\label{wxstreambufferwriteback}
 
 \func{size\_t}{WriteBack}{\param{const char*}{ buffer}, \param{size\_t}{ size}}
 
@@ -157,7 +157,7 @@ You aren't directly notified if an error occured during the IO call.
 
 \wxheading{See also}
 
-\helpref{wxStreamBuffer::Read}{wxstreambufread}
+\helpref{wxStreamBuffer::Read}{wxstreambufferread}
 
 \membersection{wxStreamBuffer::PutChar}
 
@@ -171,7 +171,7 @@ You aren't directly notified if an error occured during the IO call.
 
 \wxheading{See also}
 
-\helpref{wxStreamBuffer::Read}{wxstreambufwrite}
+\helpref{wxStreamBuffer::Read}{wxstreambufferwrite}
 
 \membersection{wxStreamBuffer::Tell}
 
@@ -216,7 +216,7 @@ the beginning of the stream. Otherwise, it returns wxInvalidOffset.
 
 Resets to the initial state variables concerning the buffer.
 
-\membersection{wxStreamBuffer::SetBufferIO}\label{wxstreambufsetbufferio}
+\membersection{wxStreamBuffer::SetBufferIO}\label{wxstreambuffersetbufferio}
 
 \func{void}{SetBufferIO}{\param{char*}{ buffer\_start}, \param{char*}{ buffer\_end}}
 
@@ -235,8 +235,8 @@ it when it is full.
 \wxheading{See also}
 
 \helpref{wxStreamBuffer constructor}{wxstreambufconst}\\
-\helpref{wxStreamBuffer::Fixed}{wxstreambuffixed}\\
-\helpref{wxStreamBuffer::Flushable}{wxstreambufflushable}
+\helpref{wxStreamBuffer::Fixed}{wxstreambufferfixed}\\
+\helpref{wxStreamBuffer::Flushable}{wxstreambufferflushable}
 
 \func{void}{SetBufferIO}{\param{size\_t}{ bufsize}}
 
@@ -253,8 +253,8 @@ The created IO buffer is growable by the object.
 
 \wxheading{See also}
 
-\helpref{wxStreamBuffer::Fixed}{wxstreambuffixed}\\
-\helpref{wxStreamBuffer::Flushable}{wxstreambufflushable}
+\helpref{wxStreamBuffer::Fixed}{wxstreambufferfixed}\\
+\helpref{wxStreamBuffer::Flushable}{wxstreambufferflushable}
 
 \membersection{wxStreamBuffer::GetBufferStart}
 
@@ -292,7 +292,7 @@ Sets the current position in the stream buffer.
 
 Returns the amount of bytes read during the last IO call to the parent stream.
 
-\membersection{wxStreamBuffer::Fixed}
+\membersection{wxStreamBuffer::Fixed}\label{wxstreambufferfixed}
 
 \func{void}{Fixed}{\param{bool}{ fixed}}
 
@@ -302,9 +302,9 @@ Toggles the fixed flag. Usually this flag is toggled at the same time as
 
 \wxheading{See also}
 
-\helpref{wxStreamBuffer::SetBufferIO}{wxstreambufsetbufferio}
+\helpref{wxStreamBuffer::SetBufferIO}{wxstreambuffersetbufferio}
 
-\membersection{wxStreamBuffer::Flushable}
+\membersection{wxStreamBuffer::Flushable}\label{wxstreambufferflushable}
 
 \func{void}{Flushable}{\param{bool}{ flushable}}
 

docs/latex/wx/strmbase.tex

@@ -42,7 +42,7 @@ This function returns the last error.
 \twocolitem{{\bf wxStream_NOERROR}}{No error occured.}
 \twocolitem{{\bf wxStream_EOF}}{An End-Of-File occured.}
 \twocolitem{{\bf wxStream_WRITE_ERR}}{A generic error occured on the last write call.}
-\twocolitem{\bf wxStream_READ_ERR}{A generic error occured on the last read call.}
+\twocolitem{{\bf wxStream_READ_ERR}}{A generic error occured on the last read call.}
 \end{twocollist}
 
 \membersection{wxStreamBase::StreamSize}

docs/latex/wx/strmzlib.tex

@@ -1,7 +1,7 @@
 % -----------------------------------------------------------------------------
 % wxZlibInputStream
 % -----------------------------------------------------------------------------
-\section{\class{wxZlibInputStream}}
+\section{\class{wxZlibInputStream}}\label{wxzlibinputstream}
 
 \wxheading{Derived from}
 
@@ -19,7 +19,7 @@ stream to get new compressed data.
 % -----------------------------------------------------------------------------
 % wxZlibOutputStream
 % -----------------------------------------------------------------------------
-\section{\class{wxZlibOutputStream}}
+\section{\class{wxZlibOutputStream}}\label{wxzliboutputstream}
 
 \wxheading{Derived from}
 
@@ -31,6 +31,6 @@ stream to get new compressed data.
 
 \wxheading{Short description}
 
-This stream compresses all data written to it and passed the compressed data
+This stream compresses all data written to it, and passes the compressed data
 to the ``filtered'' stream.
 

docs/latex/wx/textdlg.tex

@@ -18,8 +18,8 @@ It is implemented as a generic wxWindows dialog.
 
 \membersection{wxTextEntryDialog::wxTextEntryDialog}\label{wxtextentrydialogconstr}
 
-\func{}{wxTextEntryDialog}{\param{wxWindow* }{parent}, \param{const wxString\& }{message = "Please enter text"},\rtfsp
-\param{const wxString\& }{defaultValue = ""}, \param{long }{style = wxOK \pipe wxCANCEL \pipe wxCENTRE}, \param{const wxPoint\& }{pos = wxDefaultPosition}}
+\func{}{wxTextEntryDialog}{\param{wxWindow* }{parent}, \param{const wxString\& }{message},\rtfsp
+\param{const wxString\& }{caption = "Please enter text"}, \param{const wxString\& }{defaultValue = ""}, \param{long }{style = wxOK \pipe wxCANCEL \pipe wxCENTRE}, \param{const wxPoint\& }{pos = wxDefaultPosition}}
 
 Constructor. Use \helpref{wxTextEntryDialog::ShowModal}{wxtextentrydialogshowmodal} to show the dialog.
 

docs/motif/install.txt

@@ -105,8 +105,21 @@ COMPILING USING MAKEFILES
 
   and run the resulting minimal_motif binary.
 
-Notes:
-------
+Troubleshooting
+---------------
+
+- If you have trouble compiling the file y_tab.c, or have strange
+  linking errors, check whether you're using a C or C++ compiler for this file.
+  You should specify a C compiler in the CCLEX variable in src/make.env.
+  You could also try using bison and flex instead of yacc and
+  lex.
+
+- Solaris compilation with gcc: if the compiler has problems with the variable argument
+  functions, try putting the gcc fixinclude file paths early in the
+  include path.
+
+Other Notes
+-----------
 
 - Better installation and makefile systems are
   required. A revised configure system is in preparation.
@@ -128,10 +141,6 @@ Notes:
   For Linux, the problem is expected to go away with future
   distributions of the operating system.
 
-- If you have trouble compiling the file y_tab.c, or have strange
-  linking errors, check whether you're using a C or C++ compiler for this file.
-  You should specify a C compiler in the CCLEX variable in src/make.env.
-
 - If you run into problems with a missing X11/Xpm.h header, you
   need to install the XPM package. It can be obtained from:
 
@@ -146,8 +155,11 @@ Notes:
   to 0, and recompile. You will not be able to load any XPMs,
   though (currently the only supported colour bitmap format).
 
-- Please send bug reports with a description of your environment,
-  compiler and the error message(s) to the wxwin-users mailing list at:
+Bug reports
+-----------
+
+Please send bug reports with a description of your environment,
+compiler and the error message(s) to the wxwin-users mailing list at:
 
     wxwin-users@wx.dent.med.uni-muenchen.de
 

docs/msw/install.txt

@@ -98,6 +98,16 @@ Note (2): libraries and applications generated with makefiles and
 project files are unlikely to be compatible, so use one method or
 the other.
 
+Note (3): VC++ 5's optimization code seems to be broken and can
+cause problems: this can be seen when deleting an object Dialog
+Editor, in Release mode with optimizations on. If in doubt,
+switch off optimisations, although this will result in much
+larger executables. It seems possible that the library can be created with
+strong optimization, so long as the application is not strongly
+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.
+
 Visual C++ 1.5 compilation
 --------------------------
 

docs/msw/todo.txt

@@ -14,10 +14,7 @@ Update manual.
     wxListBox changes (for ownerdraw functionality)
     wxThread            DONE (except for topic overview)
     wxString            PARTLY DONE
-    wxBaseArray, other arrays
-    (wxOwnerDrawn)
     Document the include file for each class
-    Stream classes
     wxSocket topic overview
     Functions
 
@@ -35,15 +32,12 @@ Supply correct ctl3d/odbc lib files for BC++, Watcom (corrupt?)
 
 Implement new wxClipboard and DnD (Vadim)
 
-Implement wxToolTip
+Implement wxToolTip (Vadim)
 
 LOW PRIORITY (MEDIUM TERM)
 --------------------------
 
-Get wxMSW's wxGLCanvas working with non-VC++ compilers.
-
-Generate VC++ lib project files and supply VC++ project
-generator utility.
+Supply VC++ project generator utility.
 
 Convert remaining utilities e.g. wxGraphLayout.
 

docs/readme.txt

@@ -1,4 +1,4 @@
-wxWindows 2 beta 3
+wxWindows 2 beta 4
 ------------------
 
 Welcome to wxWindows 2, a sophisticated cross-platform C++

docs/todo.txt

@@ -20,14 +20,6 @@ Please see also:
 
 - Fix TCP/IP mode in dde sample (how to use; why does it crash).
 
-- Remove trashed CVS files:
-
-  include/wx/msw/magnif1.cur
-  src/msw/ctl3d/*
-  utils/glcanvas/samples/isosurf/isosurf.dat.gz
-
-  and re-add them.
-
 - wxDB ODBC classes: it seems that there are too many
   Sybase-specific features for it to work on e.g. MySQL,
   PostgreSQL. Find out what Remstar uses and document
@@ -36,5 +28,7 @@ Please see also:
 - In doc/view file selector, document type is selected by
   extension, not the type selected in the (Windows) file selector.
 
+- Add all makefiles/documentation for utils/serialize.
+
 - Complete this ToDo list :-)