[Python-checkins] CVS: python/dist/src/Doc/mac libscrap.tex,NONE,1.1 toolbox.tex,1.5,1.6

2002年3月07日 19:15:52 -0800

Update of /cvsroot/python/python/dist/src/Doc/mac
In directory usw-pr-cvs1:/tmp/cvs-serv20972
Modified Files:
	toolbox.tex 
Added Files:
	libscrap.tex 
Log Message:
I started writing more documentation on the Scrap module at one point, but
it is difficult to do without a Mac box to try things out on. This expands
on what was there only a little bit; hopefully someone with a Mac can work
on this as well!
--- NEW FILE: libscrap.tex ---
\section{\module{Carbon.Scrap} --- Scrap Manager}
\declaremodule{standard}{Carbon.Scrap}
 \platform{Mac}
\modulesynopsis{The Scrap Manager provides basic services for
 implementing cut \&\ paste and clipboard operations.}
This module is only fully available on MacOS9 and earlier under
classic PPC MacPython. Very limited functionality is available under
Carbon MacPython.
The Scrap\index{Scrap Manager} Manager supports the simplest form of
cut \&\ paste operations on the Macintosh. It can be use for both
inter- and intra-application clipboard operations.
The \module{Scrap} module provides low-level access to the functions
of the Scrap Manager. It contains the following functions:
\begin{funcdesc}{InfoScrap}{}
 Return current information about the scrap. The information is
 encoded as a tuple containing the fields \code{(\var{size},
 \var{handle}, \var{count}, \var{state}, \var{path})}.
 \begin{tableii}{l|l}{var}{Field}{Meaning}
 \lineii{size}{Size of the scrap in bytes.}
 \lineii{handle}{Resource object representing the scrap.}
 \lineii{count}{Serial number of the scrap contents.}
 \lineii{state}{Integer; positive if in memory, \code{0} if on
 disk, negative if uninitialized.}
 \lineii{path}{Filename of the scrap when stored on disk.}
 \end{tableii}
\end{funcdesc}
\begin{seealso}
 \seetitle[http://developer.apple.com/techpubs/mac/MoreToolbox/MoreToolbox-109.html]
 {Scrap Manager}{Apple's documentation for the Scrap Manager
 gives a lot of useful information about using the Scrap
 Manager in applications.}
\end{seealso}
Index: toolbox.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/mac/toolbox.tex,v
retrieving revision 1.5
retrieving revision 1.6
diff -C2 -d -r1.5 -r1.6
*** toolbox.tex	17 Jan 2002 04:51:55 -0000	1.5
--- toolbox.tex	8 Mar 2002 03:15:49 -0000	1.6
***************
*** 134,152 ****

! \section{\module{Carbon.Scrap} --- Scrap Manager}
! \declaremodule{standard}{Carbon.Scrap}
! \platform{Mac}
! \modulesynopsis{The Scrap Manager provides basic services for
! implementing cut \&\ paste and clipboard operations.}
! 
! This module is only fully available on MacOS9 and earlier under classic PPC
! MacPython. Very limited functionality is available under Carbon MacPython.
! 
! \begin{seealso}
! \seetitle[http://developer.apple.com/techpubs/mac/MoreToolbox/MoreToolbox-109.html]{Scrap
! Manager}{Apple's documentation for the Scrap Manager gives
! a lot of useful information about using the Scrap Manager
! in applications.}
! \end{seealso}

--- 134,138 ----

! \input{libscrap}