[Python-checkins] CVS: python/dist/src/Doc/lib libos.tex,1.48,1.49

[Fred L. Drake]

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

Modified Files:
	libos.tex 
Log Message:

os.startfile() documentation, based on text from Tim Peters.


Index: libos.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libos.tex,v
retrieving revision 1.48
retrieving revision 1.49
diff -C2 -r1.48 -r1.49
*** libos.tex	2000/09/28 20:27:51	1.48
--- libos.tex	2000/09/29 04:15:19	1.49
***************
*** 941,944 ****
--- 941,962 ----
  \end{datadesc}
  
+ \begin{funcdesc}{startfile}{path}
+ Start a file with its associated application.  This acts like
+ double-clicking the file in Windows Explorer, or giving the file name
+ as an argument to the DOS \program{start} command: the file is opened
+ with whatever application (if any) its extension is associated.
+ 
+ \function{startfile()} returns as soon as the associated application
+ is launched.  There is no option to wait for the application to close,
+ and no way to retrieve the application's exit status.  The \var{path}
+ parameter is relative to the current directory.  If you want to use an
+ absolute path, make sure the first character is not a slash
+ (\character{/}); the underlying Win32 \cfunction{ShellExecute()}
+ function doesn't work it is.  Use the \function{os.path.normpath()}
+ function to ensure that the path is properly encoded for Win32.
+ Availability: Windows.
+ \versionadded{2.0}
+ \end{funcdesc}
+ 
  \begin{funcdesc}{system}{command}
  Execute the command (a string) in a subshell.  This is implemented by