From bf910884ccd3b3fb0655799feee83adcbc35a3a9 Mon Sep 17 00:00:00 2001
From: Michael R Sweet <michael.r.sweet@gmail.com>
Date: Mon, 18 Oct 2004 20:22:25 +0000
Subject: Documentation updates (STR #570)

Added DESTDIR support and now remove all man pages for the
"uninstall" target (STR #545)

Fix PNG drawing on buggy WIN32 graphics cards (STR #548)

The configure script didn't propagate the CPPFLAGS environment
variable (STR #549)

The numpad keys didn't work properly on WIN32 (STR #502)

fl_input() and friends now set the input focus to the text field
when the dialog is shown (STR #553)

Fixed background color mixup when drawing Fl_Choice menus (STR
#544)

Fixed MingW makefiles (STR #550)

More VC++ project file tweaking (STR #559)

Fl_PNG_Image didn't use the png_set_trns_to_alpha function when
available (STR #547)

The FL_UNFOCUS event wasn't always sent when switching tabs (STR
#558)


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@3868 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
---
 documentation/Fl_Window.html | 38 +++++++++++++++++++++++---------------
 1 file changed, 23 insertions(+), 15 deletions(-)

(limited to 'documentation/Fl_Window.html')

diff --git a/documentation/Fl_Window.html b/documentation/Fl_Window.html
index 183939527..cb4590cb7 100644
--- a/documentation/Fl_Window.html
+++ b/documentation/Fl_Window.html
@@ -79,25 +79,33 @@ Fl::modal()</TT></A> is zero or equal to the window. <TT>Fl_Window</TT>
 </TD></TR>
 </TABLE>
 </CENTER>
-<H4><A name=Fl_Window.Fl_Window>Fl_Window::Fl_Window(int w, int h, const char *title = 0)</A></H4>
+<H4><A name=Fl_Window.Fl_Window>Fl_Window::Fl_Window(int w, int h, const char *title = 0)<br>
+Fl_Window::Fl_Window(int x, int y, int w, int h, const char *title = 0)</A></H4>
 
-The first form of the constructor should be used for a "top-level" window
-(that is, one that is not inside another window).  It correctly sets
-<tt>visible()</tt> to false and <tt>parent()</tt> to <tt>NULL</tt>.
-By not specifying the position of the window, the window system will pick a
-place to show the window or allow the user to pick a location.  If you want to
-force a position you should call <tt>position(x,y)</tt> or <tt>hotspot()</tt>
-before calling <tt>show()</tt>.
+<p>Creates a new window. If <a
+href='Fl_Group.html#Fl_Group.current'><tt>Fl_Group::current()</tt></a>
+is not <tt>NULL</tt>, the window is created as a subwindow of
+the parent window.</p>
 
-<P><TT>Fl_Widget::box()</TT> is set to <TT>FL_FLAT_BOX</TT>.  If you
-plan to completely fill the window with children widgets you should
-change this to <TT>FL_NO_BOX</TT>. If you turn the window border off
-you may want to change this to <TT>FL_UP_BOX</TT>. </P>
+<p>The first form of the constructor creates a top-level window
+and tells the window manager to position the window. The second
+form of the constructor either creates a subwindow or a
+top-level window at the specified location, subject to window
+manager configuration. If you do not specify the position of the
+window, the window manager will pick a place to show the window
+or allow the user to pick a location. Use <tt>position(x,y)</tt>
+or <tt>hotspot()</tt> before calling <tt>show()</tt> to force a
+position on the screen.</p>
 
-<h4>Fl_Window::Fl_Window(int x, int y, int w, int h, const char *title = 0)</H4>
+<p>Top-level windows initially have <tt>visible()</tt> set to 0
+and <tt>parent()</tt> set to <tt>NULL</tt>. Subwindows initially
+have <tt>visible()</tt> set to 1 and <tt>parent()</tt> set to
+the parent window pointer.</p>
 
-<P>The second form of the constructor is for creating child windows.  It
-leaves <tt>visible()</tt> set to true.
+<P><TT>Fl_Widget::box()</TT> defaults to <TT>FL_FLAT_BOX</TT>. If you
+plan to completely fill the window with children widgets you should
+change this to <TT>FL_NO_BOX</TT>. If you turn the window border off
+you may want to change this to <TT>FL_UP_BOX</TT>.</P>
 
 <H4><A name=Fl_Window.~Fl_Window>virtual Fl_Window::~Fl_Window()</A></H4>
  The destructor <I>also deletes all the children</I>. This allows a
-- 
cgit v1.2.3