[Python-checkins] CVS: python/dist/src/Doc/mac libframework.tex,1.8,1.9

[Fred L. Drake]

Update of /cvsroot/python/python/dist/src/Doc/mac
In directory slayer.i.sourceforge.net:/tmp/cvs-serv18892

Modified Files:
	libframework.tex 
Log Message:

Chris Barker <cbarker@jps.net>:
Added summary of the strengths and weaknesses of the FrameWork module
and fixed some typos.


Index: libframework.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/mac/libframework.tex,v
retrieving revision 1.8
retrieving revision 1.9
diff -C2 -r1.8 -r1.9
*** libframework.tex	1999/03/02 16:36:31	1.8
--- libframework.tex	2000/10/14 04:53:31	1.9
***************
*** 19,24 ****
  documentation describes only the most important functionality, and not
  in the most logical manner at that. Examine the source or the examples
! for more details.
  
  The \module{FrameWork} module defines the following functions:
  
--- 19,37 ----
  documentation describes only the most important functionality, and not
  in the most logical manner at that. Examine the source or the examples
! for more details.  The following are some comments posted on the
! MacPython newsgroup about the strengths and limitations of
! \module{FrameWork}:
! 
! \begin{quotation}
! The strong point of \module{FrameWork} is that it allows you to break
! into the control-flow at many different places. \refmodule{W}, for
! instance, uses a different way to enable/disable menus and that plugs
! right in leaving the rest intact.  The weak points of
! \module{FrameWork} are that it has no abstract command interface (but
! that shouldn't be difficult), that it's dialog support is minimal and
! that it's control/toolbar support is non-existent.
! \end{quotation}
  
+ 
  The \module{FrameWork} module defines the following functions:
  
***************
*** 43,53 ****
  
  \begin{funcdesc}{MenuItem}{menu, title\optional{, shortcut, callback}}
! Create a menu item object. The arguments are the menu to crate the
! item it, the item title string and optionally the keyboard shortcut
  and a callback routine. The callback is called with the arguments
  menu-id, item number within menu (1-based), current front window and
  the event record.
  
! In stead of a callable object the callback can also be a string. In
  this case menu selection causes the lookup of a method in the topmost
  window and the application. The method name is the callback string
--- 56,66 ----
  
  \begin{funcdesc}{MenuItem}{menu, title\optional{, shortcut, callback}}
! Create a menu item object. The arguments are the menu to create, the
! item item title string and optionally the keyboard shortcut
  and a callback routine. The callback is called with the arguments
  menu-id, item number within menu (1-based), current front window and
  the event record.
  
! Instead of a callable object the callback can also be a string. In
  this case menu selection causes the lookup of a method in the topmost
  window and the application. The method name is the callback string
***************
*** 80,85 ****
  tuple suitable for creation of a window of given width and height. The
  window will be staggered with respect to previous windows, and an
! attempt is made to keep the whole window on-screen. The window will
! however always be exact the size given, so parts may be offscreen.
  \end{funcdesc}
  
--- 93,98 ----
  tuple suitable for creation of a window of given width and height. The
  window will be staggered with respect to previous windows, and an
! attempt is made to keep the whole window on-screen. However, the window will
! however always be the exact size given, so parts may be offscreen.
  \end{funcdesc}
  
***************
*** 267,271 ****
  \begin{methoddesc}[ScrolledWindow]{do_activate}{onoff, event}
  Takes care of dimming/highlighting scrollbars when a window becomes
! frontmost vv. If you override this method call this one at the end of
  your method.
  \end{methoddesc}
--- 280,284 ----
  \begin{methoddesc}[ScrolledWindow]{do_activate}{onoff, event}
  Takes care of dimming/highlighting scrollbars when a window becomes
! frontmost. If you override this method, call this one at the end of
  your method.
  \end{methoddesc}