File: starting.html

package info (click to toggle)
python-pmw 0.6.2-0.1
  • links: PTS
  • area: main
  • in suites: hamm
  • size: 1,652 kB
  • ctags: 2,716
  • sloc: python: 10,720; makefile: 44; sh: 24
file content (262 lines) | stat: -rw-r--r-- 7,687 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262

    <html>
    <head>
    <title>Getting started with Pmw</title>
    </head>

    <body bgcolor="#ffffff" text="#000000" link="#0000ee"
	vlink="551a8b" alink="ff0000">

    <center><P ALIGN="CENTER">
    <IMG SRC = transdove.gif ALT = "" WIDTH=70 HEIGHT=75>
    <IMG SRC = transdove.gif ALT = "" WIDTH=70 HEIGHT=75>
    <IMG SRC = transdove.gif ALT = "" WIDTH=70 HEIGHT=75>
    </p></center>

    <h1 ALIGN="CENTER">Getting started with Pmw</h1>
    <p>
    
<center><P ALIGN="CENTER">
<IMG SRC = blue_line.gif ALT = "" WIDTH=320 HEIGHT=5>
</p></center>

<dl>
<dt> <h2>Introduction</h2><dd>
<p>
This document describes how to fetch and install Pmw, and how to run
the demonstrations and tests.

</p>

<dt> <h2>Requirements</h2><dd>
<p>
Pmw.0.6.2 requires the _tkinter and Tkinter modules.  It works with
python 1.5 (not 1.4) and Tk 4.2 or 8.0.

</p>

<p>
If the BLT extension to Tk is present, Pmw will use the BLT busy
command during modal dialogs to display a clock cursor.  Also, the
Pmw.Blt interface to the BLT busy, graph and vector commands will
be available.

</p>

<dt> <h2>Distribution and installation</h2><dd>
<p>
Releases of the Pmw distribution are available via ftp from
<code>ftp.dscpl.com.au</code>.  This release is available at <a
href="ftp://ftp.dscpl.com.au/pub/pmw/Pmw.0.6.2.tar.gz">
<code>pub/pmw/Pmw.0.6.2.tar.gz</code></a>, released on 23 February 1998. 
This is a compressed tar file which can be unpacked like this:

<dl>
<dd>
<pre>
gunzip Pmw.0.6.2.tar.gz
tar xvf Pmw.0.6.2.tar
</pre>
</dl>
</p>

<p>

This will unpack into a directory named Pmw.  This directory (or a
symbolic link to it) can be placed in your standard python
<code>site-packages</code> directory, which by default is
<code>/usr/local/lib/python1.5/site-packages</code>.

</p>

<p>

If you do not have access to the <code>site-packages</code> directory,
place the Pmw directory somewhere on your <code>PYTHONPATH</code>.  If
this is not possible, place the Pmw directory somewhere else and add
the parent directory to your <code>PYTHONPATH</code> or
<code>sys.path</code>.

</p>

<p>

If you have previously installed Pmw version 0.6 or later, then the
new version can share the same <code>Pmw</code> directory as the
previous versions.  You will need to perform the <code>tar</code>
extraction in the directory containing (that is, the parent directory
of) the existing <code>Pmw</code> directory.  By default, your
applications will use the most recent version of Pmw.  If required,
the function <code>Pmw.setversion()</code> can be used to specify a
version to be used.  See the reference manual for details.  If you are
no longer using the older versions, you can safely remove the
corresponding subdirectories from the <code>Pmw</code> directory.

</p>

<dt> <h2>Documentation</h2><dd>
<p>
The <code>doc</code> directory for each Pmw version contains all the
documentation for that version of Pmw.  See the local <a
href="index.html">home page</a> for a complete list of documents.  The
files in this directory are also available from the <a
href="http://www.dscpl.com.au/pmw/">official Pmw home page</a>.

</p>

<dt> <h2>Demonstrations and tests</h2><dd>
<p>
  A good way to get an overview of the functionality provided by Pmw
  is to run the demonstrations and tests and look at the demonstration
  code.  To view a comprehensive demonstration of many of the features
  of Pmw run the <code>All.py</code> script, which can be found in the
  <code>demos</code> subdirectory of each version of Pmw.

<p>

  You do not have to install Pmw to run the demonstrations and tests,
  simply change into the appropriate directory and run the file
  <code>All.py</code>.  See <a
  href="demosandtests.html">Demonstrations and tests</a> for more
  information about running the demonstrations and tests and how to
  create your own.

</p>

<a name=contributions></a>
<dt> <h2>Contributions welcome</h2><dd>

<p>
If you create some whiz-bang megawidgets and would like to contribute
them to Pmw, they will be most welcome.  You should be able to get
some idea of the coding style used in Pmw code by reading <a
href="howtobuild.html">How to build Pmw megawidgets</a> and by looking
at the Pmw library code itself in the <code>lib</code> directory of
each Pmw version.

</p>

<p>
If you would like to contribute a megawidget, it would be preferable if it
also came with a simple demonstration and a test script.  See <a
href="demosandtests.html">Demonstrations and tests</a> for information
about how to create new demonstrations and tests.

</p>

<p>
Each megawidget should also have a reference manual describing its
options, components and methods.  The released reference manuals are
automatically generated by merging specially marked-up text with the
output from megawidget query methods, such as
<code>components()</code>, <code>options()</code> and
<code>componentaliases()</code>, and various other introspective
devices.  If you would like to create documentation using this system,
let me (<a href="mailto:gregm@iname.com"><i>gregm@iname.com</i></a>)
know and I will send it to you.

</p>

<dt> <h2>Future plans</h2><dd>

<p>
<ul>
  <li>
    Complete general documentation and manual pages for individual
    megawidgets.

  <li>
    Create more megawidgets, particularly a file browser, a scrolled
    canvas and a tabbed notebook.

</ul>
</p>

<dt> <h2>Bugs</h2><dd>

<ul>
  <li>
    There is a small bug which appears only with Tk8.0 (the bug is not
    apparent with Tk4.2).  If a dialog is activated and pops up
    directly over the cursor and the dialog has a default button, then
    pressing the <strong>Return</strong> key will not invoke the
    default button.  If you move the mouse out of and then back into
    the dialog, pressing the <strong>Return</strong> key will work.

  <li>
    The word <em>color</em> is spelled in the American fashion, while
    the word <em>initialise</em> is spelled in the British.

  <li>
    There are probably one or two more bugs.  I'm sure you will let me
    know.

</ul>

<dt> <h2>Acknowledgements</h2><dd>

<p>
The initial ideas for Pmw were blatantly stolen from the itcl
extensions
<a href="http://www.tcltk.com/itk">[incr Tk]</a>
by Michael McLennan and
<a href="http://www.tcltk.com/iwidgets">[incr Widgets]</a>
by Mark Ulferts.  Several of the megawidgets are direct translations
from the itcl to python.
</p>

<p>
The base classes and most megawidgets were written by Greg McFarlane
and Peter Munnings.  The TimeCounter megawidget was contributed by Joe
VanAndel.  A big thank you to the following people for their bug
reports, fixes, enhancements and suggestions:

Joe Saltiel,
Andreas Kostyrka,
Case Roole,
Michael McLay,
Clemens Hintze,
Magnus Lycka,
Roman Sulzhyk
  and
Guido van Rossum.

Special thanks to Case Roole and Michael McLay for help with getting
Pmw to work with python 1.5 packages and many other nifty features.

My deepest apologies if I have forgotten anyone. Please let me know.

</p>
    
<p>
The Pmw web and ftp site is made available courtesy of
<a href="http://www.dscpl.com.au/">Dumpleton Software Consulting Pty Limited</a>.

</p>
<p>
The current maintainer is Greg McFarlane.  If you have any
comments, enhancements or new contributions, please contact me at
<a href="mailto:gregm@iname.com"><i>gregm@iname.com</i></a>.
</p>

</dl>


    <center><P ALIGN="CENTER">
    <IMG SRC = blue_line.gif ALT = "" WIDTH=320 HEIGHT=5>
    </p></center>
    

    <font size=-1>
    <center><P ALIGN="CENTER">
    <a href="index.html">Home</a>. 
    Pmw 0.6.2
    Maintainer
    <a href="mailto:gregm@iname.com">gregm@iname.com</a>.
    23 Feb 1998
    </p></center>
    </font>

    </body>
    </html>