[POS-commit] CVS: Kiwi/doc howto.tex,1.12,1.13

[Christian Reis]

Update of /cvs/Kiwi/doc
In directory anthem:/tmp/cvs-serv10150

Modified Files:
	howto.tex 
Log Message:
Update focus_topmost_widget -> focus_topmost, problem pointed out by
Andreas (again).


Index: howto.tex
===================================================================
RCS file: /cvs/Kiwi/doc/howto.tex,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- howto.tex	4 Nov 2002 14:35:43 -0000	1.12
+++ howto.tex	17 Feb 2003 11:31:24 -0000	1.13
@@ -880,10 +880,13 @@
 If you are using a subclassed View, I would recommend doing this at the
 end of your View's constructor; otherwise, call it directly before
 running \code{show\_and\_loop()}. 
-\item Call \code{view.focus\_topmost\_widget()}. For most forms, it
-makes sense to focus the form widget most to the top and left when
-starting up the application; you can use this convenience function to
-accomplish that.
+% If it's a bad idea, should we document it?
+% \item Call \code{view.focus\_toplevel()}. This causes the toplevel
+% widget to be focused, which is usually a {\bf bad} idea because it is
+% normally a window or container.
+\item Call \code{view.focus\_topmost()}. For most forms, it makes sense
+to focus the form widget most to the top and left when starting up the
+application; you can use this convenience function to accomplish that.
 \end{itemize}
 
 When using UI composition, remember that the slave view will lose its