[OpenSPARC-T2-SAM] / sam-t2 / devtools / v8plus / lib / python2.4 / site-packages / Pmw / Pmw_1_2 / doc / starting.html


    <html>
    <head>
    <meta name="description" content="Pmw - a toolkit for building high-level compound widgets in Python">
    <meta name="content" content="python, megawidget, mega widget, compound widget, gui, tkinter">
    <title>Getting started with Pmw</title>
    </head>

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

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

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

</p>

</dd>
<dt> <h2>Requirements</h2></dt><dd>
<p>
Pmw.1.2 requires the _tkinter and Tkinter modules.  It works
with python versions 1.5.2 and greater (tested up to 2.2.1) and Tk
versions 8.0 and greater (tested up to 8.3.2).

</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, stripchart, tabset and
vector commands will be available.  BLT versions 2.4i and greater are
supported (tested up to 2.4u).  You can find BLT at
<a href="http://www.tcltk.com/blt/">http://www.tcltk.com/blt/</a>.

</p>

</dd>
<dt> <h2>Distribution and installation</h2></dt><dd>
<p>
Releases of the Pmw distribution are available via http from
<code>http://download.sourceforge.net/pmw/</code>.  This release is available
as <a href="http://download.sourceforge.net/pmw/Pmw.1.2.tar.gz">
<code>Pmw.1.2.tar.gz</code></a>, released on 5 August 2003. 
This is a compressed tar file.  Under Linux, Unix, etc, you will need to
unpack it using <code>tar</code> and you may also need to use
<code>gzip</code> or <code>gunzip</code> to uncompress it.
Under Microsoft Windows, you will need a program such as WinZip (<a
href="http://www.winzip.com">http://www.winzip.com</a>) that can
unpack the gzipped tar files.  You may need to change the suffix of
the file to <strong>.tgz</strong> for WinZip to recognise it.

</p>

<p>

This will unpack into a directory named Pmw.  You now need to put this
directory somewhere python can find it, preferably in one of the
standard places, such as in the <code>site-packages</code> directory
(eg: <code>/usr/lib/python2.2/site-packages/Pmw</code>) or the
<code>sys.prefix</code> directory (eg: <code>C:\Program
Files\Python\Pmw</code> or <code>/usr/lib/python2.2</code>).

</p>

<p>

For example, under Unix, assuming you have placed the tar file in the
<code>/tmp</code> directory, you can simply run the following
commands:

</p>

<dl>
<dd>
<pre>
cd /usr/lib/python2.2/site-packages
gunzip /tmp/Pmw.1.2.tar.gz (or gzip -d /tmp/Pmw.1.2.tar.gz)
tar xvf /tmp/Pmw.1.2.tar
</pre>
</dd>
</dl>

<p>

If you do not have write permission for these standard directories,
place the Pmw
directory somewhere on your <code>PYTHONPATH</code> or
<code>sys.path</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>

<p>

If you need assistance in installing BLT under Unix, please contact me
(<a href="mailto:gregm@iname.com"><i>gregm@iname.com</i></a>) and I
will try to help.  For other operating systems, such as Microsoft or
Macintosh, you should try asking the python newsgroup.  If anyone can
give me a description of how to install BLT under other operating
systems please contribute it and I will place it here.

</p>

</dd>
<dt> <h2>Documentation</h2></dt><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://pmw.sourceforge.net/">official Pmw home page</a>.

</p>

<p>
An excellent tutorial and reference covering the Pmw interface to the
powerful Blt graph widget, "<a
href="http://www.ifi.uio.no/~hpl/Pmw.Blt/doc/">A User's Guide to
Commit	Line	Data
920dae64 AT	1
	2	<html>
	3	<head>
	4	<meta name="description" content="Pmw - a toolkit for building high-level compound widgets in Python">
	5	<meta name="content" content="python, megawidget, mega widget, compound widget, gui, tkinter">
	6	<title>Getting started with Pmw</title>
	7	</head>
	8
	9	<body bgcolor="#ffffff" text="#000000" link="#0000ee"
	10	vlink="551a8b" alink="ff0000">
	11
	12	<h1 ALIGN="CENTER">Getting started with Pmw</h1>
	13
	14	<center><P ALIGN="CENTER">
	15	<IMG SRC = blue_line.gif ALT = "" WIDTH=320 HEIGHT=5>
	16	</p></center>
	17
	18	<dl>
	19	<dt> <h2>Introduction</h2></dt><dd>
	20	<p>
	21	This document describes how to fetch and install Pmw, and how to run
	22	the demonstrations and tests.
	23
	24	</p>
	25
	26	</dd>
	27	<dt> <h2>Requirements</h2></dt><dd>
	28	<p>
	29	Pmw.1.2 requires the _tkinter and Tkinter modules. It works
	30	with python versions 1.5.2 and greater (tested up to 2.2.1) and Tk
	31	versions 8.0 and greater (tested up to 8.3.2).
	32
	33	</p>
	34
	35	<p>
	36	If the BLT extension to Tk is present, Pmw will use the BLT busy
	37	command during modal dialogs to display a clock cursor. Also, the
	38	Pmw.Blt interface to the BLT busy, graph, stripchart, tabset and
	39	vector commands will be available. BLT versions 2.4i and greater are
	40	supported (tested up to 2.4u). You can find BLT at
	41	<a href="http://www.tcltk.com/blt/">http://www.tcltk.com/blt/</a>.
	42
	43	</p>
	44
	45	</dd>
	46	<dt> <h2>Distribution and installation</h2></dt><dd>
	47	<p>
	48	Releases of the Pmw distribution are available via http from
	49	<code>http://download.sourceforge.net/pmw/</code>. This release is available
	50	as <a href="http://download.sourceforge.net/pmw/Pmw.1.2.tar.gz">
	51	<code>Pmw.1.2.tar.gz</code></a>, released on 5 August 2003.
	52	This is a compressed tar file. Under Linux, Unix, etc, you will need to
	53	unpack it using <code>tar</code> and you may also need to use
	54	<code>gzip</code> or <code>gunzip</code> to uncompress it.
	55	Under Microsoft Windows, you will need a program such as WinZip (<a
	56	href="http://www.winzip.com">http://www.winzip.com</a>) that can
	57	unpack the gzipped tar files. You may need to change the suffix of
	58	the file to <strong>.tgz</strong> for WinZip to recognise it.
	59
	60	</p>
	61
	62	<p>
	63
	64	This will unpack into a directory named Pmw. You now need to put this
65	directory somewhere python can find it, preferably in one of the
66	standard places, such as in the <code>site-packages</code> directory
67	(eg: <code>/usr/lib/python2.2/site-packages/Pmw</code>) or the
68	<code>sys.prefix</code> directory (eg: <code>C:\Program
69	Files\Python\Pmw</code> or <code>/usr/lib/python2.2</code>).
70
71	</p>
72
73	<p>
74
75	For example, under Unix, assuming you have placed the tar file in the
76	<code>/tmp</code> directory, you can simply run the following
77	commands:
78
79	</p>
80
81	<dl>
82	<dd>
83	<pre>
84	cd /usr/lib/python2.2/site-packages
85	gunzip /tmp/Pmw.1.2.tar.gz (or gzip -d /tmp/Pmw.1.2.tar.gz)
86	tar xvf /tmp/Pmw.1.2.tar
87	</pre>
88	</dd>
89	</dl>
90
91	<p>
92
93	If you do not have write permission for these standard directories,
94	place the Pmw
95	directory somewhere on your <code>PYTHONPATH</code> or
96	<code>sys.path</code>. If this is not possible, place the Pmw
97	directory somewhere else and add the parent directory to your
98	<code>PYTHONPATH</code> or <code>sys.path</code>.
99
100	</p>
101
102	<p>
103
104	If you have previously installed Pmw version 0.6 or later, then the
105	new version can share the same <code>Pmw</code> directory as the
106	previous versions. You will need to perform the <code>tar</code>
107	extraction in the directory containing (that is, the parent directory
108	of) the existing <code>Pmw</code> directory. By default, your
109	applications will use the most recent version of Pmw. If required,
110	the function <code>Pmw.setversion()</code> can be used to specify a
111	version to be used. See the reference manual for details. If you are
112	no longer using the older versions, you can safely remove the
113	corresponding subdirectories from the <code>Pmw</code> directory.
114
115	</p>
116
117	<p>
118
119	If you need assistance in installing BLT under Unix, please contact me
120	(<a href="mailto:gregm@iname.com"><i>gregm@iname.com</i></a>) and I
121	will try to help. For other operating systems, such as Microsoft or
122	Macintosh, you should try asking the python newsgroup. If anyone can
123	give me a description of how to install BLT under other operating
124	systems please contribute it and I will place it here.
125
126	</p>
127
128	</dd>
129	<dt> <h2>Documentation</h2></dt><dd>
130	<p>
131	The <code>doc</code> directory for each Pmw version contains all the
132	documentation for that version of Pmw. See the local <a
133	href="index.html">home page</a> for a complete list of documents. The
134	files in this directory are also available from the <a
135	href="http://pmw.sourceforge.net/">official Pmw home page</a>.
136
137	</p>
138
139	<p>
140	An excellent tutorial and reference covering the Pmw interface to the
141	powerful Blt graph widget, "<a
142	href="http://www.ifi.uio.no/~hpl/Pmw.Blt/doc/">A User's Guide to
143