[Python-checkins] python/dist/src/Mac/OSXResources/app/Resources/English.lproj/Documentation community.html,NONE,1.1 finder.html,1.1,1.2 gui.html,1.1,1.2 index.html,1.3,1.4 intro.html,1.1,1.2 packman.html,1.2,1.3 scripting.html,1.3,1.4 shell.html,1.1,1.2
jackjansen@users.sourceforge.net
jackjansen@users.sourceforge.net
Wed, 18 Jun 2003 15:10:29 -0700
Update of /cvsroot/python/python/dist/src/Mac/OSXResources/app/Resources/English.lproj/Documentation
In directory sc8-pr-cvs1:/tmp/cvs-serv11756
Modified Files:
finder.html gui.html index.html intro.html packman.html
scripting.html shell.html
Added Files:
community.html
Log Message:
- Added a "community" section.
- Cleaned up the HTML.
--- NEW FILE: community.html ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>What is MacPython?</title>
<meta name="generator" content="BBEdit 6.5.3">
<link rel="SHORTCUT ICON" href="pythonsmall.gif">
<META NAME="AppleIcon" CONTENT="pythonsmall.gif">
</head>
<body>
<table>
<tr>
<td>
<img src="python.gif" width="128" height="128" align="top" alt="">
</td>
<td>
<h1>MacPython Community</h1>
</td>
</tr>
</table>
<hr>
<h2>Web Sites</h2>
<p>The MacPython homepage, <a href="http://www.cwi.nl/~jack/macpython.html">
www.cwi.nl/~jack/macpython.html</a>
is where you can find installers, documents, links to useful packages and more.
And, of course,
<a href="http://www.python.org">www.python.org</a> has a much larger collection
of material on Python that is not Mac-specific.</p>
<h2>News groups and Mailing lists</h2>
<p>There are a lot of mailing lists on Python. Some of the more interesting
ones are:</p>
<ul>
<li><a href="mailto:python-help@python.org">python-help@python.org</a> where
you can send questions for individual support. Please check the websites mentioned
above first, though!</li>
<li>The <a href="news:comp.lang.python">comp.lang.python</a> newsgroup for general
discussion. Also available as a
<a href="http://www.python.org/mailman/listinfo/python-list">mailing list</a>.</li>
<li>The <a href="news:comp.lang.python.announce">comp.lang.python.announce</a>
newsgroup for announcements. Low-volume and moderated. Also available as a
<a href="http://www.python.org/mailman/listinfo/python-announce-list">mailing list</a>.</li>
<li>Last but not least, the <a href="http://www.python.org/sigs/pythonmac-sig/">pythonmac-sig</a>
mailing list is specifically for MacPython. Discussions on the implementation of new
features, but beginners questions are welcome too.</li>
</ul>
<p>In addition there are Python <a href="http://www.python.org/sigs/">Special Interest Group</a>
mailing lists on a wide variety of topics such as image processing, numerical algorithms
and more.</p>
<h2>More</h2>
<p>An index of conferences, Wiki's, bookshops and more can be found at the
<a href="http://www.python.org/psa/">Community</a> section of the Python website.</p>
</body>
</html>
Index: finder.html
===================================================================
RCS file: /cvsroot/python/python/dist/src/Mac/OSXResources/app/Resources/English.lproj/Documentation/finder.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** finder.html 11 Mar 2003 22:59:16 -0000 1.1
--- finder.html 18 Jun 2003 22:10:27 -0000 1.2
***************
*** 1 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>Python and the Finder</title>
<meta name="generator" content="BBEdit 6.5.3">
<link rel="SHORTCUT ICON" href="pythonsmall.gif">
<META NAME="AppleIcon" CONTENT="pythonsmall.gif">
</head>
<body>
<h1>Running Python scripts from the Finder</h1>
<table>
<tr>
<td>
<img src="python.gif" width="128" height="128" align="top">
</td>
<td>
<p>The application PythonLauncher will start a Python interpreter
when you drop a Python source file onto it, any file with a <tt>.py</tt>
or <tt>.pyw</tt> extension. If you set PythonLauncher as the default
application to open a file
(<a href="help:search=Changing%20the%20application%20that%20opens%20a%20file bookID=Mac%20Help">
tell me more</a>) this also works when you double click a Python script.</p>
<p>PythonLauncher has preferences per filetype for selecting
the interpreter to use, and how to launch it: in a Terminal window
or not, etc. Holding the Option key while launching your script will
bring up a window that allows changing these settings for a single
run. </p>
</td>
</tr>
</table>
<hr>
</body>
</html>
\ No newline at end of file
--- 1 ----
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>Python and the Finder</title>
<meta name="generator" content="BBEdit 6.5.3">
<link rel="SHORTCUT ICON" href="pythonsmall.gif">
<META NAME="AppleIcon" CONTENT="pythonsmall.gif">
</head>
<body>
<h1>Running Python scripts from the Finder</h1>
<table>
<tr>
<td>
<img src="python.gif" width="128" height="128" align="top" alt="">
</td>
<td>
<p>The application PythonLauncher will start a Python interpreter
when you drop a Python source file onto it, any file with a <tt>.py</tt>
or <tt>.pyw</tt> extension. If you set PythonLauncher as the default
application to open a file
(<a href="help:search=Changing%20the%20application%20that%20opens%20a%20file bookID=Mac%20Help">
tell me more</a>) this also works when you double click a Python script.</p>
<p>PythonLauncher has preferences per filetype for selecting
the interpreter to use, and how to launch it: in a Terminal window
or not, etc. Holding the Option key while launching your script will
bring up a window that allows changing these settings for a single
run. </p>
</td>
</tr>
</table>
<hr>
</body>
</html>
\ No newline at end of file
Index: gui.html
===================================================================
RCS file: /cvsroot/python/python/dist/src/Mac/OSXResources/app/Resources/English.lproj/Documentation/gui.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** gui.html 31 Mar 2003 15:10:41 -0000 1.1
--- gui.html 18 Jun 2003 22:10:27 -0000 1.2
***************
*** 22,31 ****
documentation</a> and the Human Interface Toolbox section of
<a href="help:openbook=Carbon">Apple's Carbon Documentation</a>.
! This solution is compatible with MacPython-OS9.
!
<li> The <tt>W</tt> framework is built on top of this, and easier to use.
The MacPython IDE uses W. Some documentation is available on
<a href="http://www.nevada.edu/~cwebster/Python/index.html">Corran Webster's website</a>.
! Compatible with MacPython-OS9.
</ul>
--- 22,30 ----
documentation</a> and the Human Interface Toolbox section of
<a href="help:openbook=Carbon">Apple's Carbon Documentation</a>.
! This solution is compatible with MacPython-OS9.</li>
<li> The <tt>W</tt> framework is built on top of this, and easier to use.
The MacPython IDE uses W. Some documentation is available on
<a href="http://www.nevada.edu/~cwebster/Python/index.html">Corran Webster's website</a>.
! Compatible with MacPython-OS9.</li>
</ul>
***************
*** 39,47 ****
bidirectional bridge between Python and Objectve-C, similar to Apple's Java
bridge. Probably the best choice for Mac OS X-only applications, but at the
! time of this writing PyObjC is still in beta.
<li> <a href="http://wxpython.sourceforge.net/">wxPython</a> gives Python programs
access to the wxWindows GUI toolkit. Many people consider this
! the best open source cross-platform GUI solution available today.
<li> Tkinter is the oldest cross-platform GUI toolkit for Python, bridging Python
--- 38,46 ----
bidirectional bridge between Python and Objectve-C, similar to Apple's Java
bridge. Probably the best choice for Mac OS X-only applications, but at the
! time of this writing PyObjC is still in beta.</li>
<li> <a href="http://wxpython.sourceforge.net/">wxPython</a> gives Python programs
access to the wxWindows GUI toolkit. Many people consider this
! the best open source cross-platform GUI solution available today.</li>
<li> Tkinter is the oldest cross-platform GUI toolkit for Python, bridging Python
***************
*** 49,53 ****
Documented in the Library section, Tkinter subsection of the
<a href="doc/index.html">Python Language and runtime documentation</a>. Tkinter
! is not available for MacPython-OS9.
</ul>
--- 48,52 ----
Documented in the Library section, Tkinter subsection of the
<a href="doc/index.html">Python Language and runtime documentation</a>. Tkinter
! is not available for MacPython-OS9.</li>
</ul>
Index: index.html
===================================================================
RCS file: /cvsroot/python/python/dist/src/Mac/OSXResources/app/Resources/English.lproj/Documentation/index.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** index.html 31 Mar 2003 15:10:44 -0000 1.3
--- index.html 18 Jun 2003 22:10:27 -0000 1.4
***************
*** 16,20 ****
<tr>
<td>
! <img src="python.gif" width="128" height="128" align="top">
</td>
<td>
--- 16,20 ----
<tr>
<td>
! <img src="python.gif" width="128" height="128" align="top" alt="">
</td>
<td>
***************
*** 31,38 ****
--- 31,43 ----
</li>
<li><a href="shell.html">Running Python scripts from the Unix Shell</a>
+ </li>
<li><a href="gui.html">Creating a User Interface with MacPython</a>
+ </li>
<li><a href="scripting.html">Controlling other Applications from MacPython</a>
+ </li>
<li><a href="packman.html">Installing additional functionality with the
Package Manager</a>
+ </li>
+ <li><a href="community.html">MacPython community</a>
</li>
</ul>
Index: intro.html
===================================================================
RCS file: /cvsroot/python/python/dist/src/Mac/OSXResources/app/Resources/English.lproj/Documentation/intro.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** intro.html 11 Mar 2003 22:59:16 -0000 1.1
--- intro.html 18 Jun 2003 22:10:27 -0000 1.2
***************
*** 14,22 ****
<tr>
<td>
! <img src="python.gif" width="128" height="128" align="top">
</td>
<td>
<p>Python is a programming language. MacPython is a package containing
! that programming language plus Mac-specific tools and extensions.<p>
</td>
--- 14,22 ----
<tr>
<td>
! <img src="python.gif" width="128" height="128" align="top" alt="">
</td>
<td>
<p>Python is a programming language. MacPython is a package containing
! that programming language plus Mac-specific tools and extensions.</p>
</td>
***************
*** 36,40 ****
the language and a
<a href="http://python.org/doc/essays/comparisons.html">comparison</a> of Python
! to other languages.</a> Or read the (rather longwinded) Python
Tutorial in the <a href="doc/index.html">Python Language and runtime documentation</a>.</p>
--- 36,40 ----
the language and a
<a href="http://python.org/doc/essays/comparisons.html">comparison</a> of Python
! to other languages. Or read the (rather longwinded) Python
Tutorial in the <a href="doc/index.html">Python Language and runtime documentation</a>.</p>
Index: packman.html
===================================================================
RCS file: /cvsroot/python/python/dist/src/Mac/OSXResources/app/Resources/English.lproj/Documentation/packman.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** packman.html 16 Apr 2003 12:39:03 -0000 1.2
--- packman.html 18 Jun 2003 22:10:27 -0000 1.3
***************
*** 14,18 ****
<tr>
<td>
! <img src="PackageManager.gif" width="128" height="128" align="top">
</td>
<td>
--- 14,18 ----
<tr>
<td>
! <img src="PackageManager.gif" width="128" height="128" align="top" alt="">
</td>
<td>
***************
*** 36,40 ****
<p>PackageManager is available as a separate application and also
! as a function of the IDE, through the <tt>File->Package Manager</tt> menu
entry. </p>
--- 36,40 ----
<p>PackageManager is available as a separate application and also
! as a function of the IDE, through the <tt>File->Package Manager</tt> menu
entry. </p>
***************
*** 45,49 ****
could be that there is no database (yet?) for your version of Mac OS X.
In the standalone Package Manager you can open an alternative database
! with the <tt>File->Open URL...</tt> command, but you should realize that
you are now on untested ground. </p>
--- 45,49 ----
could be that there is no database (yet?) for your version of Mac OS X.
In the standalone Package Manager you can open an alternative database
! with the <tt>File->Open URL...</tt> command, but you should realize that
you are now on untested ground. </p>
Index: scripting.html
===================================================================
RCS file: /cvsroot/python/python/dist/src/Mac/OSXResources/app/Resources/English.lproj/Documentation/scripting.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** scripting.html 13 Jun 2003 14:32:49 -0000 1.3
--- scripting.html 18 Jun 2003 22:10:27 -0000 1.4
***************
*** 18,40 ****
Python:</p>
! <blockquote><tt><pre>
import Finder
f = Finder.Finder()
print f.get(f.window(1).name)
! </pre></tt></blockquote>
<p>is identical to the following piece of AppleScript:</p>
! <blockquote><tt><pre>
tell application "Finder"
get name of window 1
end tell
! </pre></tt></blockquote>
<p>To send AppleEvents to an application you must first create the Python
modules interfacing to the terminology of the application (what
<tt>Script Editor</tt> calls the "Dictionary"). Use the IDE menu command
! <tt>File->Generate OSA Suite...</tt> for this. For more control run</p>
<blockquote><tt>
--- 18,40 ----
Python:</p>
! <blockquote><pre><tt>
import Finder
f = Finder.Finder()
print f.get(f.window(1).name)
! </tt></pre></blockquote>
<p>is identical to the following piece of AppleScript:</p>
! <blockquote><pre><tt>
tell application "Finder"
get name of window 1
end tell
! </tt></pre></blockquote>
<p>To send AppleEvents to an application you must first create the Python
modules interfacing to the terminology of the application (what
<tt>Script Editor</tt> calls the "Dictionary"). Use the IDE menu command
! <tt>File->Generate OSA Suite...</tt> for this. For more control run</p>
<blockquote><tt>
Index: shell.html
===================================================================
RCS file: /cvsroot/python/python/dist/src/Mac/OSXResources/app/Resources/English.lproj/Documentation/shell.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** shell.html 11 Mar 2003 22:59:16 -0000 1.1
--- shell.html 18 Jun 2003 22:10:27 -0000 1.2
***************
*** 14,18 ****
<tr>
<td>
! <img src="python.gif" width="128" height="128" align="top">
</td>
<td>
--- 14,18 ----
<tr>
<td>
! <img src="python.gif" width="128" height="128" align="top" alt="">
</td>
<td>
***************
*** 27,31 ****
<br>
<tt>setenv PATH /usr/local/bin:$PATH</tt>
!
<p>If you use <tt>bash</tt> or <tt>zsh</tt>
--- 27,31 ----
<br>
<tt>setenv PATH /usr/local/bin:$PATH</tt>
! </p>
<p>If you use <tt>bash</tt> or <tt>zsh</tt>
***************
*** 34,37 ****
--- 34,38 ----
<br>
<tt>export PATH=/usr/local/bin:$PATH</tt>
+ </p>
<h2>GUI scripts</h2>