Chapters on Mac Toolbox modules and other undocumented modules, ready to

be filled in with real information.  Contributed by Chris Barker
<cbarker@jps.net>.
This commit is contained in:
Fred Drake 2000-10-14 05:08:34 +00:00
parent 1bd905e901
commit 4d0d621b66
2 changed files with 245 additions and 0 deletions

126
Doc/mac/toolbox.tex Normal file
View File

@ -0,0 +1,126 @@
\chapter{MacOS Toolbox Modules \label{toolbox}}
There are a set of modules that provide interfaces to various MacOS
toolboxes. If applicable the module will define a number of Python
objects for the various structures declared by the toolbox, and
operations will be implemented as methods of the object. Other
operations will be implemented as functions in the module. Not all
operations possible in C will also be possible in Python (callbacks
are often a problem), and parameters will occasionally be different in
Python (input and output buffers, especially). All methods and
functions have a \member{__doc__} string describing their arguments
and return values, and for additional description you are referred to
\citetitle[http://developer.apple.com/techpubs/macos8/mac8.html]{Inside
Macintosh} or similar works.
\strong{Warning!} These modules are not yet documented. If you
wish to contribute documentation of any of these modules, please get
in touch with \email{python-docs@python.org}.
\localmoduletable
%\section{Argument Handling for Toolbox Modules}
\section{\module{AE} --- Apple Events}
\declaremodule{standard}{AE}
\platform{Mac}
\modulesynopsis{Interface to the Apple Events toolbox}
\section{\module{Cm} --- Component Manager}
\declaremodule{standard}{Cm}
\platform{Cm}
\modulesynopsis{Interface to the Component Manager}
\section{\module{Ctl} --- Control Manager}
\declaremodule{standard}{Ctl}
\platform{Mac}
\modulesynopsis{Interface to the Control Manager}
\section{\module{Dlg} --- Dialog Manager}
\declaremodule{standard}{Dlg}
\platform{Mac}
\modulesynopsis{Interface to the Dialog Manager}
\section{\module{Evt} --- Event Manager}
\declaremodule{standard}{Evt}
\platform{Mac}
\modulesynopsis{Interface to the Event Manager}
\section{\module{Fm} --- Font Manager}
\declaremodule{standard}{Fm}
\platform{Mac}
\modulesynopsis{Interface to the Font Manager}
\section{\module{List} --- List Manager}
\declaremodule{standard}{List}
\platform{Mac}
\modulesynopsis{Interface to the List Manager}
\section{\module{Menu} --- Menu Manager}
\declaremodule{standard}{Menu}
\platform{Mac}
\modulesynopsis{Interface to the Menu Manager}
\section{\module{Qd} --- QuickDraw}
\declaremodule{builtin}{Qd}
\platform{Mac}
\modulesynopsis{Interface to the QuickDraw toolbox}
\section{\module{Qt} --- QuickTime}
\declaremodule{standard}{Qt}
\platform{Mac}
\modulesynopsis{Interface to the QuickTime toolbox}
\section{\module{Res} --- Resource Manager and Handles}
\declaremodule{standard}{Res}
\platform{Mac}
\modulesynopsis{Interface to the Resource Manager and Handles}
\section{\module{Scrap} --- Scrap Manager}
\declaremodule{standard}{Scrap}
\platform{Mac}
\modulesynopsis{Interface to the Scrap Manager}
\section{\module{Snd} --- Sound Manager}
\declaremodule{standard}{Snd}
\platform{Mac}
\modulesynopsis{Interface to the Sound Manager }
\section{\module{TE} --- TextEdit}
\declaremodule{standard}{TE}
\platform{Mac}
\modulesynopsis{Interface to TextEdit}
\section{\module{waste} --- non-Apple \program{TextEdit} replacement}
\declaremodule{standard}{waste}
\platform{Mac}
\modulesynopsis{Interface to the ``WorldScript-Aware Styled Text Engine.''}
\begin{seealso}
\seetitle[http://www.merzwaren.com/waste/]{About WASTE}{Information
about the WASTE widget and library, including
documentation and downloads.}
\end{seealso}
\section{\module{Win} --- Window Manager}
\declaremodule{standard}{Win}
\platform{Mac}
\modulesynopsis{Interface to the Window Manager}

119
Doc/mac/undoc.tex Normal file
View File

@ -0,0 +1,119 @@
\chapter{Undocumented Modules \label{undocumented-modules}}
The modules in this chapter are poorly documented (if at all). If you
wish to contribute documentation of any of these modules, please get in
touch with \email{python-docs@python.org}.
\localmoduletable
\section{\module{buildtools} --- Helper module for BuildApplet and Friends}
\declaremodule{standard}{buildtools}
\platform{Mac}
\modulesynopsis{Helper module for BuildApple, BuildApplication and macfreeze}
\section{\module{py_resource} --- }
\declaremodule[pyresource]{standard}{py_resource}
\platform{Mac}
\modulesynopsis{}
\section{\module{cfmfile} --- Code Fragment Resource module}
\declaremodule{standard}{cfmfile}
\platform{Mac}
\modulesynopsis{Code Fragment Resource module}
\module{cfmfile} is a module that understands Code Fragments and the
accompanying ``cfrg'' resources. It can parse them and merge them, and is
used by BuildApplication to combine all plugin modules to a single
executable.
\section{\module{macerrors} --- MacOS Errors}
\declaremodule{standard}{macerrors}
\platform{Mac}
\modulesynopsis{Constant definitions for many MacOS error codes}
\module{macerrors} cotains constant definitions for many MacOS error codes.
\section{\module{macfsn} --- NavServices calls}
\declaremodule{standard}{macfsn}
\platform{Mac}
\modulesynopsis{NavServices versions of StandardFile calls}
\module{macfsn} contains wrapper functions that have the same API as the macfs
StandardFile calls, but are implemented with Navigation Services. Importing it
will replace the methods in macfs with these, if Navigation Services is
available on your machine.
\section{\module{icopen} --- Internet Config replacement for \method{open()}}
\declaremodule{standard}{icopen}
\platform{Mac}
\modulesynopsis{Internet Config replacement for \method{open()}}
Importing \module{icopen} will replace the builtin \method{open()}
with a version that uses Internet Config to set file type and creator
for new files.
\section{\module{mactty} --- }
\declaremodule{standard}{mactty}
\platform{Mac}
\modulesynopsis{}
\section{\module{nsremote} --- Wrapper around Netscape OSA modules}
\declaremodule{standard}{nsremote}
\platform{Mac}
\modulesynopsis{Wrapper around Netscape OSA modules}
\module{nsremote} is a wrapper around the Netscape OSA modules that
allows you to easily send your browser to a given URL.
\section{\module{PixMapWrapper} --- Wrapper for PixMap objects}
\declaremodule{standard}{PixMapWrapper}
\platform{Mac}
\modulesynopsis{Wrapper for PixMap objects}
\module{PixMapWrapper} wraps a PixMap object with a Python object that
allows access to the fields by name. It also has methods to convert
to and from \module{PIL} images.
\section{\module{preferences} --- }
\declaremodule{standard}{preferences}
\platform{Mac}
\modulesynopsis{}
\section{\module{pythonprefs} --- }
\declaremodule{standard}{pythonprefs}
\platform{Mac}
\modulesynopsis{}
\section{\module{quietconsole} --- non-visible stdout output}
\declaremodule{standard}{quietconsole}
\platform{Mac}
\modulesynopsis{buffered, non-visible stdout output}
\module{quietconsole} allows you to keep stdio output in a buffer
without displaying it (or without displaying the stdout window
altogether, if set with \program{EditPythonPrefs}) until you try to read from
stdin or disable the buffering, at which point all the saved output is
sent to the window. Good for GUI programs that do want to display their
output at a crash.
\section{\module{W} --- Widgets built on \module{FrameWork}}
\declaremodule{standard}{W}
\platform{Mac}
\modulesynopsis{Widgets for the Mac, built on top of \module{FrameWork}}
The \module{W} widgets are used extensively in the \program{IDE}.