Rewrite to use test_support's fine fcmp instead -- I didn't know that
[python/dscho.git] / Doc / mac / toolbox.tex
blob9f48566a24bf2a37aa3f679cf25ace468e8540c7
1 \chapter{MacOS Toolbox Modules \label{toolbox}}
3 There are a set of modules that provide interfaces to various MacOS
4 toolboxes. If applicable the module will define a number of Python
5 objects for the various structures declared by the toolbox, and
6 operations will be implemented as methods of the object. Other
7 operations will be implemented as functions in the module. Not all
8 operations possible in C will also be possible in Python (callbacks
9 are often a problem), and parameters will occasionally be different in
10 Python (input and output buffers, especially). All methods and
11 functions have a \member{__doc__} string describing their arguments
12 and return values, and for additional description you are referred to
13 \citetitle[http://developer.apple.com/techpubs/macos8/mac8.html]{Inside
14 Macintosh} or similar works.
17 \strong{Warning!} These modules are not yet documented. If you
18 wish to contribute documentation of any of these modules, please get
19 in touch with \email{python-docs@python.org}.
21 \localmoduletable
24 %\section{Argument Handling for Toolbox Modules}
27 \section{\module{AE} --- Apple Events}
28 \declaremodule{standard}{AE}
29 \platform{Mac}
30 \modulesynopsis{Interface to the Apple Events toolbox}
33 \section{\module{Cm} --- Component Manager}
34 \declaremodule{standard}{Cm}
35 \platform{Mac}
36 \modulesynopsis{Interface to the Component Manager}
39 \section{\module{Ctl} --- Control Manager}
40 \declaremodule{standard}{Ctl}
41 \platform{Mac}
42 \modulesynopsis{Interface to the Control Manager}
45 \section{\module{Dlg} --- Dialog Manager}
46 \declaremodule{standard}{Dlg}
47 \platform{Mac}
48 \modulesynopsis{Interface to the Dialog Manager}
51 \section{\module{Evt} --- Event Manager}
52 \declaremodule{standard}{Evt}
53 \platform{Mac}
54 \modulesynopsis{Interface to the Event Manager}
57 \section{\module{Fm} --- Font Manager}
58 \declaremodule{standard}{Fm}
59 \platform{Mac}
60 \modulesynopsis{Interface to the Font Manager}
63 \section{\module{List} --- List Manager}
64 \declaremodule{standard}{List}
65 \platform{Mac}
66 \modulesynopsis{Interface to the List Manager}
69 \section{\module{Menu} --- Menu Manager}
70 \declaremodule{standard}{Menu}
71 \platform{Mac}
72 \modulesynopsis{Interface to the Menu Manager}
75 \section{\module{Qd} --- QuickDraw}
76 \declaremodule{builtin}{Qd}
77 \platform{Mac}
78 \modulesynopsis{Interface to the QuickDraw toolbox}
81 \section{\module{Qt} --- QuickTime}
82 \declaremodule{standard}{Qt}
83 \platform{Mac}
84 \modulesynopsis{Interface to the QuickTime toolbox}
87 \section{\module{Res} --- Resource Manager and Handles}
88 \declaremodule{standard}{Res}
89 \platform{Mac}
90 \modulesynopsis{Interface to the Resource Manager and Handles}
93 \section{\module{Scrap} --- Scrap Manager}
94 \declaremodule{standard}{Scrap}
95 \platform{Mac}
96 \modulesynopsis{The Scrap Manager provides basic services for
97 implementing cut \&\ paste and clipboard operations.}
99 \begin{seealso}
100 \seetitle[http://developer.apple.com/techpubs/mac/MoreToolbox/MoreToolbox-109.html]{Scrap
101 Manager}{Apple's documentation for the Scrap Manager gives
102 a lot of useful information about using the Scrap Manager
103 in applications.}
104 \end{seealso}
107 \section{\module{Snd} --- Sound Manager}
108 \declaremodule{standard}{Snd}
109 \platform{Mac}
110 \modulesynopsis{Interface to the Sound Manager }
113 \section{\module{TE} --- TextEdit}
114 \declaremodule{standard}{TE}
115 \platform{Mac}
116 \modulesynopsis{Interface to TextEdit}
119 \section{\module{waste} --- non-Apple \program{TextEdit} replacement}
120 \declaremodule{standard}{waste}
121 \platform{Mac}
122 \modulesynopsis{Interface to the ``WorldScript-Aware Styled Text Engine.''}
124 \begin{seealso}
125 \seetitle[http://www.merzwaren.com/waste/]{About WASTE}{Information
126 about the WASTE widget and library, including
127 documentation and downloads.}
128 \end{seealso}
131 \section{\module{Win} --- Window Manager}
132 \declaremodule{standard}{Win}
133 \platform{Mac}
134 \modulesynopsis{Interface to the Window Manager}