From: Robin Dunn Date: Fri, 26 Mar 2004 21:25:58 +0000 (+0000) Subject: Removed some old, outdated, unfinished, or unstarted docs and the X-Git-Url: https://git.saurik.com/wxWidgets.git/commitdiff_plain/625a9dc6664ee781cf4c1c2ec2c61d75665a7412 Removed some old, outdated, unfinished, or unstarted docs and the samples that go with them. These can be added back later if somebody wants to work on them again. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@26378 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775 --- diff --git a/wxPython/demo/Main.py b/wxPython/demo/Main.py index 733baf9f53..ddce684930 100644 --- a/wxPython/demo/Main.py +++ b/wxPython/demo/Main.py @@ -212,7 +212,6 @@ _treeList = [ 'FileHistory', 'FontEnumerator', 'Joystick', - 'NewNamespace', 'OGL', 'PrintFramework', 'ShapedWindow', diff --git a/wxPython/demo/NewNamespace.py b/wxPython/demo/NewNamespace.py deleted file mode 100644 index 15c4a752bb..0000000000 --- a/wxPython/demo/NewNamespace.py +++ /dev/null @@ -1,47 +0,0 @@ - -import wx # This module uses the new wx namespace -from wx import html -from Main import opj - -#---------------------------------------------------------------------- - -class TestPanel(wx.Panel): - def __init__(self, parent, log): - self.log = log - wx.Panel.__init__(self, parent, -1) - - hwin = html.HtmlWindow(self, -1) - hwin.LoadFile(opj('data/wxPackage.html')) - - sizer = wx.BoxSizer(wx.VERTICAL) - sizer.Add(hwin, 1, wx.EXPAND) - - self.SetSizer(sizer) - - -#---------------------------------------------------------------------- - -def runTest(frame, nb, log): - win = TestPanel(nb, log) - return win - -#---------------------------------------------------------------------- - - - -overview = """ -

Using the New Namespace

- -This sample isn't really a demo, but rather a place to display the -introductory doc for using the new namespace. - - -""" - - - -if __name__ == '__main__': - import sys,os - import run - run.main(['', os.path.basename(sys.argv[0])] + sys.argv[1:]) - diff --git a/wxPython/demo/data/wxPackage.html b/wxPython/demo/data/wxPackage.html deleted file mode 100644 index 5b2fb06588..0000000000 --- a/wxPython/demo/data/wxPackage.html +++ /dev/null @@ -1,290 +0,0 @@ - - - - - - -The wxPython wx Package - - - - - - -
-

The wxPython wx Package

-

Or, how to survive the new wx namespace changes.

- --- - - - - - - - - - - - -
Author:Patrick K. O'Brien
Contact:pobrien@orbtech.com
Organization:Orbtech
Date:2003-05-08
Revision:1.1.2.4
- -
-

Introduction

-

Big things sometimes come in small packages. This is certainly true -of the new wx package, which is being introduced in wxPython 2.4.1 as -a way to allow the "wx" prefix to be dropped from the names of all -wxPython classes, functions, and constants. This document should -answer all the questions you might have concerning the new wx package. -If not, feel free to contact the author. I hope you like the new wx -package as much as I do.

-
-
-

Why change anything?

-

This change is being made for a couple of reasons. The first reason -is to discourage the use of import *, which is a dangerous -technique that can create name conflicts and bloated namespaces.

-

The second reason is to remove what some perceive to be a "wart." For -example, the following code is rather ugly in that the "wx" prefix on -the wxFrame class name is no longer useful when you're using the wx -module prefix:

-
-from wxPython import wx
-
-class Frame(wx.wxFrame)
-
-

The new wx package allows you to write code like this, instead:

-
-import wx
-
-class Frame(wx.Frame)
-
-

The third reason is that the wxWindows project intends to do the same -thing (implement a new wx namespace and drop the "wx" prefix) and we -want wxPython to lead the way.

-
-
-

What does the new wx package do?

-

As a way of getting to this new syntax as quickly as possible, the -code in this new wx package was created. What it does is alter the -existing wx namespace dynamically. By making the changes on-the-fly -at runtime, we can try out the new syntax before any permanent changes -are made to the underlying class library. The downside of making -these changes at runtime is that there is a slight delay when you -import wx; the upside is that you can start using the new syntax -now.

-
-
-

Will any of this effect my existing code?

-

No. Your existing code will continue to work and be supported for -some time. It will be up to you to decide when to switch to the new -syntax. But all new documentation and code examples will use the new -syntax. So don't wait too long. You wouldn't want anyone calling you -old-fashioned, would you?

-
-
-

How does the new wx package work?

-

It's pretty simple, and pretty clever. The wx directory contains an -__init__.py file, making it a Python package. (In contrast, the -old wxPython.wx module is a module, not a package.) When you import -wx the code in the __init__.py file is executed, and that's -where all the magic takes place. Let's take a look at the code inside -the __init__.py file:

-
-"""wx package
-
-Provides a way to drop the wx prefix from wxPython objects."""
-
-__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
-__cvsid__ = "$Id$"
-__revision__ = "$Revision$"[11:-2]
-
-from wxPython import wx
-
-import types
-
-d_new = globals()
-d_old = wx.__dict__
-
-for old, obj in d_old.items():
-    if type(obj) is types.ModuleType or old.startswith('_'):
-        # Skip modules and private names.
-        continue
-    new = old
-    if old.startswith('EVT_'):
-        # Leave name unmodified; add to the new wx namespace.
-        d_new[new] = obj
-    elif old.startswith('wxEVT_'):
-        # Leave name unmodified; add to the new wx namespace.
-        d_new[new] = obj
-    else:
-        if old.startswith('wx'):
-            # Remove the 'wx' prefix.
-            new = old[2:]
-        # Add to the new wx package namespace.
-        d_new[new] = obj
-
-del d_new
-del d_old
-del new
-del obj
-del old
-del types
-
-del wx
-
-
-

Namespaces in Python are implemented as dictionaries. The dictionary -used to create the wx package's namespace is accessible using the -globals() function. The dictionary used to create the old -wxPython.wx module's namespace is wx.__dict__. Once we have these -two dictionaries, it's a simple matter of iterating through one, -changing the names, adding the renamed object to the other dictionary, -and cleaning up a few local variables and imported modules. Voila!

-
-
-

What about all the other modules, like grid, html, and stc?

-

There's more to wxPython than just the wx namespace. And we've got -those extra modules covered as well. For each of those modules (as -well as the lib package) we've got matching modules in the new wx -package. Let's take a look at a few of them.

-

Here is html.py:

-
-"""Provides a way to drop the wx prefix from wxPython objects."""
-
-__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
-__cvsid__ = "$Id$"
-__revision__ = "$Revision$"[11:-2]
-
-import wx
-from wx import prefix
-
-from wxPython import html
-prefix.rename(d_new=globals(), d_old=html.__dict__)
-del html
-
-del prefix
-del wx
-
-
-

And here is lib/dialogs.py:

-
-"""Provides a way to drop the wx prefix from wxPython objects."""
-
-__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
-__cvsid__ = "$Id$"
-__revision__ = "$Revision$"[11:-2]
-
-import wx
-from wx import prefix
-
-from wxPython.lib import dialogs
-prefix.rename(d_new=globals(), d_old=dialogs.__dict__)
-del dialogs
-
-del prefix
-del wx
-
-
-

As you can see, they both rely on the prefix.rename() function -defined in prefix.py:

-
-"""Renaming utility.
-
-Provides a way to drop the wx prefix from wxPython objects."""
-
-__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
-__cvsid__ = "$Id$"
-__revision__ = "$Revision$"[11:-2]
-
-import types
-
-def rename(d_new, d_old):
-    for old, obj in d_old.items():
-        if type(obj) is types.ModuleType or old.startswith('_'):
-            # Skip modules and private names.
-            continue
-##         mod = d_old['__name__']
-##         if hasattr(obj, '__module__') and not obj.__module__.startswith(mod):
-##             # Skip objects imported from other modules, except those
-##             # related to the current module, such as stc_.
-##             continue
-        new = old
-        if old.startswith('EVT_') or old.startswith('wxEVT_'):
-            # Leave these names unmodified.
-            pass 
-        elif old.startswith('wx'):
-            new = old[2:]
-        if new:
-            d_new[new] = d_old[old]
-
-
-

Again, the technique is very similar to the one used by the wx -package.

-
-
-

How do I use this new wx package?

-

The wx package is automatically created when you install wxPython -version 2.4.1 or higher. So all you have to do is:

-
-import wx
-
-
-
-

What are the issues with converting old code to use the new wx package?

-

Obviously, you need to change your import statements from:

-
-from wxPython import wx
-
-

or:

-
-from wxPython.wx import *
-
-

to:

-
-import wx
-
-

Then you need to refer to wx attributes without a "wx" prefix, such -as:

-
-class MyFrame(wx.Frame):
-
-

In most cases, existing code can be modified with a simple search and -replace.

-

One extra issue you might run into when converting existing code is -that the wx.__version__ attribute is no longer available, since the -new wx namespace doesn't include any private attributes from the old -wxPython.wx namespace. The solution is to use the wx.VERSION_STRING -attribute, which was introduced in wxPython 2.4.1.

-
-
-

Where can I find example programs using the new wx syntax?

-

Example programs are included in the wxPython/samples/wx_examples -directory, and are documented in the wxPythonExamples documentation -file. Also, all the code in the py package uses the new wx syntax. -You can learn more about these in the PyManual.

-
-
- - - - diff --git a/wxPython/distrib/DIRLIST b/wxPython/distrib/DIRLIST index 3ff573dfaa..8f075869ae 100644 --- a/wxPython/distrib/DIRLIST +++ b/wxPython/distrib/DIRLIST @@ -53,9 +53,6 @@ wxPython/samples/pySketch wxPython/samples/pySketch/images wxPython/samples/simple wxPython/samples/StyleEditor -wxPython/samples/wx_examples -wxPython/samples/wx_examples/basic -wxPython/samples/wx_examples/hello wxPython/samples/wxProject wxPython/scripts wxPython/src diff --git a/wxPython/distrib/make_installer.py b/wxPython/distrib/make_installer.py index 3a14fea336..6ebecedcd3 100644 --- a/wxPython/distrib/make_installer.py +++ b/wxPython/distrib/make_installer.py @@ -221,10 +221,6 @@ Source: "samples\StyleEditor\*.txt"; DestDir: "{app}\wx\samples\StyleEdit Source: "samples\StyleEditor\*.py"; DestDir: "{app}\wx\samples\StyleEditor"; Components: samples Source: "samples\StyleEditor\*.cfg"; DestDir: "{app}\wx\samples\StyleEditor"; Components: samples -Source: "samples\wx_examples\basic\*.py"; DestDir: "{app}\wx\samples\wx_examples\basic"; Components: samples -Source: "samples\wx_examples\hello\*.py"; DestDir: "{app}\wx\samples\wx_examples\hello"; Components: samples -Source: "samples\wx_examples\hello\*.jpg"; DestDir: "{app}\wx\samples\wx_examples\hello"; Components: samples - Source: "samples\wxProject\*.txt"; DestDir: "{app}\wx\samples\wxProject"; Components: samples Source: "samples\wxProject\*.py"; DestDir: "{app}\wx\samples\wxProject"; Components: samples @@ -256,12 +252,9 @@ Name: "{group}\Resource Editor"; Filename: "{code:GetPythonDir}\pythonw.ex Name: "{group}\Sample Apps"; Filename: "{app}\wx\samples"; Components: samples Name: "{group}\wxWindows Reference"; Filename: "{app}\wx\docs\wx.chm"; Components: docs -Name: "{group}\wxOGL Reference"; Filename: "{app}\wx\docs\ogl.chm"; Components: docs -Name: "{group}\licence.txt"; Filename: "{app}\wx\docs\licence\licence.txt"; Components: core -Name: "{group}\README.txt"; Filename: "{app}\wx\docs\README.txt"; Components: docs -Name: "{group}\CHANGES.txt"; Filename: "{app}\wx\docs\CHANGES.txt"; Components: docs Name: "{group}\Migration Guide"; Filename: "{app}\wx\docs\MigrationGuide.html"; Components: docs -Name: "{group}\Other wxPython Docs"; Filename: "{app}\wx\docs\wxPythonDocs.html"; Components: docs +Name: "{group}\CHANGES"; Filename: "{app}\wx\docs\CHANGES.html"; Components: docs +Name: "{group}\Other Docs"; Filename: "{app}\wx\docs"; Components: docs ;;------------------------------------------------------------ diff --git a/wxPython/docs/wxPythonDocs.html b/wxPython/docs/wxPythonDocs.html deleted file mode 100644 index 53eb239a9f..0000000000 --- a/wxPython/docs/wxPythonDocs.html +++ /dev/null @@ -1,77 +0,0 @@ - - - - - - -wxPython Documentation - - - - - - -
-

wxPython Documentation

- --- - - - - - - - - - - - -
Author:Patrick K. O'Brien
Contact:pobrien@orbtech.com
Organization:Orbtech
Date:2003-07-02
Revision:1.2
-
-

wxPython Manual

-

The wxPython Manual is a reference to the wxPython toolkit.

-
-
-

wxPython Developer Reference

-

The wxPython source code documentation is for developers, and was -created using the Epydoc tool.

-
-
-

wxPython Tutorial

-

The wxPython Tutorial will help get you started with wxPython.

-
-
-

wxPython Examples

-

The wxPython Examples illustrates example programs using wxPython.

-
-
-

wx Package

-

The wxPython wx Package explains the new prefix-less wx package.

-
-
-

Py Manual

-

The Py Manual documents the Py collection of programs and source -code modules, including:

-
    -
  • PyAlaCarte
  • -
  • PyAlaMode
  • -
  • PyCrust
  • -
  • PyFilling
  • -
  • PyShell
  • -
  • PyWrap
  • -
-
-
-

Py Developer Reference

-

The Py source code documentation is for developers, and was created -using the Epydoc tool.

-
-
- - - - diff --git a/wxPython/docs/wxPythonDocs.txt b/wxPython/docs/wxPythonDocs.txt deleted file mode 100644 index cbc378ecc4..0000000000 --- a/wxPython/docs/wxPythonDocs.txt +++ /dev/null @@ -1,77 +0,0 @@ -======================== - wxPython Documentation -======================== - -:Author: Patrick K. O'Brien -:Contact: pobrien@orbtech.com -:Organization: Orbtech_ -:Date: $Date$ -:Revision: $Revision$ - -.. _Orbtech: http://www.orbtech.com/ - - -wxPython Manual -=============== - -`The wxPython Manual`_ is a reference to the wxPython toolkit. - -.. _The wxPython Manual: wxPythonManual.html - - -wxPython Developer Reference -============================ - -`The wxPython source code documentation`_ is for developers, and was -created using the Epydoc tool. - -.. _The wxPython source code documentation: http://www.orbtech.com/www/wx/epydoc/ - - -wxPython Tutorial -================= - -`The wxPython Tutorial`_ will help get you started with wxPython. - -.. _The wxPython Tutorial: wxPythonTutorial.html - - -wxPython Examples -================= - -`The wxPython Examples`_ illustrates example programs using wxPython. - -.. _The wxPython Examples: wxPythonExamples.html - - -wx Package -========== - -`The wxPython wx Package`_ explains the new prefix-less wx package. - -.. _The wxPython wx Package: wxPackage.html - - -Py Manual -========= - -`The Py Manual`_ documents the Py collection of programs and source -code modules, including: - -* PyAlaCarte -* PyAlaMode -* PyCrust -* PyFilling -* PyShell -* PyWrap - -.. _The Py Manual: PyManual.html - - -Py Developer Reference -====================== - -`The Py source code documentation`_ is for developers, and was created -using the Epydoc tool. - -.. _The Py source code documentation: http://www.orbtech.com/www/wx/epydoc/public/wx.py-module.html diff --git a/wxPython/docs/wxPythonExamples.html b/wxPython/docs/wxPythonExamples.html deleted file mode 100644 index ef24fde165..0000000000 --- a/wxPython/docs/wxPythonExamples.html +++ /dev/null @@ -1,226 +0,0 @@ - - - - - - -Example Programs Using wxPython - - - - - - -
-

Example Programs Using wxPython

-

A survival guide for the post-wx-prefixed world.

- --- - - - - - - - - - - - -
Author:Patrick K. O'Brien
Contact:pobrien@orbtech.com
Organization:Orbtech
Date:2003-07-02
Revision:1.2
- -
-

Introduction

-

This document illustrates example programs using wxPython. All the -examples make use of the new wx package syntax introduced in wxPython -2.4.1, which is a bit different than older examples you might come -across.

-
-
-

Background (with tongue firmly in cheek)

-

If something hits you on the head, don't run around screaming that the -sky is falling. Instead, take a close look and see if it wasn't a -"wx" prefix that hit you. Apparently, they're dropping off wxPython -class names like flies dropping dead in the scorching heat of a -summer's day.

-

Yes, the world is changing, and even our little wxPython world must -change with it. Then again, I'm not fond of pesky summertime flies, -and I'm not too upset that the "wx" prefixes are going to bite the -dust. I think it's for the best. But, being the kind, considerate -person that I am, I decided to write this guide to make the wx -namespace transition easier for everyone, even Chicken Little.

-
-

Note

-

Say what?

-

If you have no idea what I mean by the "wx namespace transition," -consider yourself lucky. You can simply use these examples to -learn wxPython in its current state (beginning with wxPython -version 2.4.1). All you need to know is that previous wxPython -code used a slightly different syntax that some folks (including -me) considered ugly. So we changed it. And that's when the sky -starting falling...

-

If you want more of the technical details, read the wx package -documentation.

-
-

Rather than simply tell you that everything will be okay, I -decided to show you that everything will be okay. To do that, -I've created a bunch of example programs using the new wx package. I -hope you like them.

-
-
-

Basic Program Example

-

It doesn't get much simpler than this. Every wxPython program needs -an application and a frame. To encourage good coding habits, I've -split them into separate modules. They don't do much, but they're a -good starting point.

-

I include a simple App class in the frame module because the PyWrap -"wrapper" utility (pywrap) only works with modules that contain an -application class. So including a simple one in each of your frame -modules allows you to use the PyWrap runtime wrapper and debug your -frames independent of your full application.

-

Here is the module (frame.py) that defines the frame class:

-
-#!/usr/bin/env python
-
-"""Basic frame class, with App for testing."""
-
-__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
-__cvsid__ = "$Id$"
-__revision__ = "$Revision$"[11:-2]
-
-import wx
-
-class Frame(wx.Frame):
-    """Frame class."""
-
-    def __init__(self, parent=None, id=-1, title='Title',
-                 pos=wx.DefaultPosition, size=(400, 200)):
-        """Create a Frame instance."""
-        wx.Frame.__init__(self, parent, id, title, pos, size)
-
-class App(wx.App):
-    """Application class."""
-
-    def OnInit(self):
-        self.frame = Frame()
-        self.frame.Show()
-        self.SetTopWindow(self.frame)
-        return True
-
-def main():
-    app = App()
-    app.MainLoop()
-
-if __name__ == '__main__':
-    main()
-
-
-

And here is the module (app.py) that defines the application class -and imports the frame from frame.py:

-
-#!/usr/bin/env python
-
-"""Basic application class."""
-
-__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
-__cvsid__ = "$Id$"
-__revision__ = "$Revision$"[11:-2]
-
-import wx
-
-from frame import Frame
-
-class App(wx.App):
-    """Application class."""
-
-    def OnInit(self):
-        self.frame = Frame()
-        self.frame.Show()
-        self.SetTopWindow(self.frame)
-        return True
-
-def main():
-    app = App()
-    app.MainLoop()
-
-if __name__ == '__main__':
-    main()
-
-
-
-
-

Hello wxPython Example

-

This program displays an image file (wxPython.jpg) inside a frame -sized to match the graphic.

-
-

screenshots/hello-win98.png

-

Running hello.py on Windows.

-
-
-

screenshots/hello-linux.png

-

Running hello.py on Linux.

-
-
-

screenshots/hello-mac.png

-

Running hello.py on Mac OS X.

-
-

Here is the source code for hello.py:

-
-#!/usr/bin/env python
-
-"""Hello, wxPython! program."""
-
-__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
-__cvsid__ = "$Id$"
-__revision__ = "$Revision$"[11:-2]
-
-import wx
-
-class Frame(wx.Frame):
-    """Frame class that displays an image."""
-
-    def __init__(self, image, parent=None, id=-1,
-                 pos=wx.DefaultPosition, title='Hello, wxPython!'):
-        """Create a Frame instance and display image."""
-        temp = image.ConvertToBitmap()
-        size = temp.GetWidth(), temp.GetHeight()
-        wx.Frame.__init__(self, parent, id, title, pos, size)
-        self.bmp = wx.StaticBitmap(parent=self, id=-1, bitmap=temp)
-
-class App(wx.App):
-    """Application class."""
-
-    def OnInit(self):
-        wx.InitAllImageHandlers()
-        image = wx.Image('wxPython.jpg', wx.BITMAP_TYPE_JPEG)
-        self.frame = Frame(image)
-        self.frame.Show()
-        self.SetTopWindow(self.frame)
-        return True
-
-def main():
-    app = App()
-    app.MainLoop()
-
-if __name__ == '__main__':
-    main()
-
-
-
-
- - - - diff --git a/wxPython/docs/wxPythonExamples.txt b/wxPython/docs/wxPythonExamples.txt deleted file mode 100644 index 80c178a6ae..0000000000 --- a/wxPython/docs/wxPythonExamples.txt +++ /dev/null @@ -1,118 +0,0 @@ -================================= - Example Programs Using wxPython -================================= - --------------------------------------------------- - A survival guide for the post-wx-prefixed world. --------------------------------------------------- - -:Author: Patrick K. O'Brien -:Contact: pobrien@orbtech.com -:Organization: Orbtech_ -:Date: $Date$ -:Revision: $Revision$ - -.. _Orbtech: http://www.orbtech.com/ - -.. contents:: - - -Introduction -============ - -This document illustrates example programs using wxPython. All the -examples make use of the new wx package syntax introduced in wxPython -2.4.1, which is a bit different than older examples you might come -across. - - -Background (with tongue firmly in cheek) -======================================== - -If something hits you on the head, don't run around screaming that the -sky is falling. Instead, take a close look and see if it wasn't a -"wx" prefix that hit you. Apparently, they're dropping off wxPython -class names like flies dropping dead in the scorching heat of a -summer's day. - -Yes, the world is changing, and even our little wxPython world must -change with it. Then again, I'm not fond of pesky summertime flies, -and I'm not too upset that the "wx" prefixes are going to bite the -dust. I think it's for the best. But, being the kind, considerate -person that I am, I decided to write this guide to make the wx -namespace transition easier for everyone, even Chicken Little. - -.. note:: Say what? - - If you have no idea what I mean by the "wx namespace transition," - consider yourself lucky. You can simply use these examples to - learn wxPython in its current state (beginning with wxPython - version 2.4.1). All you need to know is that previous wxPython - code used a slightly different syntax that some folks (including - me) considered ugly. So we changed it. And that's when the sky - starting falling... - - If you want more of the technical details, read the `wx package - documentation`_. - - .. _wx package documentation: wxPackage.html - - -Rather than simply **tell** you that everything will be okay, I -decided to **show** you that everything will be okay. To do that, -I've created a bunch of example programs using the new wx package. I -hope you like them. - - -Basic Program Example -===================== - -It doesn't get much simpler than this. Every wxPython program needs -an application and a frame. To encourage good coding habits, I've -split them into separate modules. They don't do much, but they're a -good starting point. - -I include a simple App class in the frame module because the PyWrap -"wrapper" utility (``pywrap``) only works with modules that contain an -application class. So including a simple one in each of your frame -modules allows you to use the PyWrap runtime wrapper and debug your -frames independent of your full application. - -Here is the module (``frame.py``) that defines the frame class: - -.. include:: ../samples/wx_examples/basic/frame.py - :literal: - -And here is the module (``app.py``) that defines the application class -and imports the frame from ``frame.py``: - -.. include:: ../samples/wx_examples/basic/app.py - :literal: - - -Hello wxPython Example -====================== - -This program displays an image file (``wxPython.jpg``) inside a frame -sized to match the graphic. - -.. figure:: screenshots/hello-win98.png - :scale: 100 - - Running ``hello.py`` on Windows. - -.. figure:: screenshots/hello-linux.png - :scale: 100 - - Running ``hello.py`` on Linux. - -.. figure:: screenshots/hello-mac.png - :scale: 100 - - Running ``hello.py`` on Mac OS X. - -Here is the source code for ``hello.py``: - -.. include:: ../samples/wx_examples/hello/hello.py - :literal: - diff --git a/wxPython/docs/wxPythonTutorial.html b/wxPython/docs/wxPythonTutorial.html deleted file mode 100644 index 3def21c9a0..0000000000 --- a/wxPython/docs/wxPythonTutorial.html +++ /dev/null @@ -1,128 +0,0 @@ - - - - - - -The wxPython Tutorial - - - - - - -
-

The wxPython Tutorial

-

How to get up and running with wxPython

- --- - - - - - - - - - - - - - -
Author:Patrick K. O'Brien
Contact:pobrien@orbtech.com
Organization:Orbtech
Date:2003-07-02
Revision:1.2
License:wxWindows Free Documentation Licence, Version 3
- -
-

Introduction

-

This is a tutorial for the wxPython GUI toolkit. It uses the new wx -package syntax that was introduced in wxPython 2.4.1.

-
-
-

What is wxPython?

-

wxPython is a GUI toolkit for the Python programming language. It -allows Python programmers to create programs with a graphical user -interface for Windows, Linux, and Mac OS X.

-
-
-

License

-

This document adheres to the same license as the other documentation -that comes with wxWindows:

-
-                wxWindows Free Documentation Licence, Version 3
-                ===============================================
-
-  Copyright (c) 1998 Julian Smart, Robert Roebling et al
-
-  Everyone is permitted to copy and distribute verbatim copies
-  of this licence document, but changing it is not allowed.
-   
-                   WXWINDOWS FREE DOCUMENTATION LICENCE
-     TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
-
-  1. Permission is granted to make and distribute verbatim copies of this
-  manual or piece of documentation provided any copyright notice and this
-  permission notice are preserved on all copies.
-
-  2. Permission is granted to process this file or document through a
-  document processing system and, at your option and the option of any third
-  party, print the results, provided a printed document carries a copying
-  permission notice identical to this one.
-
-  3. Permission is granted to copy and distribute modified versions of this
-  manual or piece of documentation under the conditions for verbatim
-  copying, provided also that any sections describing licensing conditions
-  for this manual, such as, in particular, the GNU General Public Licence,
-  the GNU Library General Public Licence, and any wxWindows Licence are
-  included exactly as in the original, and provided that the entire
-  resulting derived work is distributed under the terms of a permission
-  notice identical to this one.
-
-  4. Permission is granted to copy and distribute translations of this
-  manual or piece of documentation into another language, under the above
-  conditions for modified versions, except that sections related to
-  licensing, including this paragraph, may also be included in translations
-  approved by the copyright holders of the respective licence documents in
-  addition to the original English.
-
-                            WARRANTY DISCLAIMER
-
-  5. BECAUSE THIS MANUAL OR PIECE OF DOCUMENTATION IS LICENSED FREE OF CHARGE,
-  THERE IS NO WARRANTY FOR IT, TO THE EXTENT PERMITTED BY APPLICABLE LAW. 
-  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER
-  PARTIES PROVIDE THIS MANUAL OR PIECE OF DOCUMENTATION "AS IS" WITHOUT
-  WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
-  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
-  PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF
-  THE MANUAL OR PIECE OF DOCUMENTATION IS WITH YOU.  SHOULD THE MANUAL OR
-  PIECE OF DOCUMENTATION PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
-  NECESSARY SERVICING, REPAIR OR CORRECTION.
-
-  6. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
-  ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
-  REDISTRIBUTE THE MANUAL OR PIECE OF DOCUMENTATION AS PERMITTED ABOVE, BE
-  LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
-  CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
-  MANUAL OR PIECE OF DOCUMENTATION (INCLUDING BUT NOT LIMITED TO LOSS OF
-  DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
-  PARTIES OR A FAILURE OF A PROGRAM BASED ON THE MANUAL OR PIECE OF
-  DOCUMENTATION TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR
-  OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
-
-
-
-
-
- - - - diff --git a/wxPython/docs/wxPythonTutorial.txt b/wxPython/docs/wxPythonTutorial.txt deleted file mode 100644 index 683aa18790..0000000000 --- a/wxPython/docs/wxPythonTutorial.txt +++ /dev/null @@ -1,43 +0,0 @@ -======================= - The wxPython Tutorial -======================= - ------------------------------------------ - How to get up and running with wxPython ------------------------------------------ - -:Author: Patrick K. O'Brien -:Contact: pobrien@orbtech.com -:Organization: Orbtech_ -:Date: $Date$ -:Revision: $Revision$ -:License: wxWindows Free Documentation Licence, Version 3 - -.. _Orbtech: http://www.orbtech.com/ - -.. contents:: - - -Introduction -============ - -This is a tutorial for the wxPython GUI toolkit. It uses the new wx -package syntax that was introduced in wxPython 2.4.1. - - -What is wxPython? -================= - -wxPython is a GUI toolkit for the Python programming language. It -allows Python programmers to create programs with a graphical user -interface for Windows, Linux, and Mac OS X. - - -License -======= - -This document adheres to the same license as the other documentation -that comes with wxWindows: - -.. include:: ../licence/licendoc.txt - :literal: diff --git a/wxPython/samples/wx_examples/basic/__init__.py b/wxPython/samples/wx_examples/basic/__init__.py deleted file mode 100644 index b929a7db76..0000000000 --- a/wxPython/samples/wx_examples/basic/__init__.py +++ /dev/null @@ -1 +0,0 @@ -# Python package. diff --git a/wxPython/samples/wx_examples/basic/app.py b/wxPython/samples/wx_examples/basic/app.py deleted file mode 100755 index 09013ed834..0000000000 --- a/wxPython/samples/wx_examples/basic/app.py +++ /dev/null @@ -1,27 +0,0 @@ -#!/usr/bin/env python - -"""Basic application class.""" - -__author__ = "Patrick K. O'Brien " -__cvsid__ = "$Id$" -__revision__ = "$Revision$"[11:-2] - -import wx - -from frame import Frame - -class App(wx.App): - """Application class.""" - - def OnInit(self): - self.frame = Frame() - self.frame.Show() - self.SetTopWindow(self.frame) - return True - -def main(): - app = App() - app.MainLoop() - -if __name__ == '__main__': - main() diff --git a/wxPython/samples/wx_examples/basic/frame.py b/wxPython/samples/wx_examples/basic/frame.py deleted file mode 100755 index 3bcecb9f75..0000000000 --- a/wxPython/samples/wx_examples/basic/frame.py +++ /dev/null @@ -1,33 +0,0 @@ -#!/usr/bin/env python - -"""Basic frame class, with App for testing.""" - -__author__ = "Patrick K. O'Brien " -__cvsid__ = "$Id$" -__revision__ = "$Revision$"[11:-2] - -import wx - -class Frame(wx.Frame): - """Frame class.""" - - def __init__(self, parent=None, id=-1, title='Title', - pos=wx.DefaultPosition, size=(400, 200)): - """Create a Frame instance.""" - wx.Frame.__init__(self, parent, id, title, pos, size) - -class App(wx.App): - """Application class.""" - - def OnInit(self): - self.frame = Frame() - self.frame.Show() - self.SetTopWindow(self.frame) - return True - -def main(): - app = App() - app.MainLoop() - -if __name__ == '__main__': - main() diff --git a/wxPython/samples/wx_examples/hello/__init__.py b/wxPython/samples/wx_examples/hello/__init__.py deleted file mode 100644 index b929a7db76..0000000000 --- a/wxPython/samples/wx_examples/hello/__init__.py +++ /dev/null @@ -1 +0,0 @@ -# Python package. diff --git a/wxPython/samples/wx_examples/hello/hello.py b/wxPython/samples/wx_examples/hello/hello.py deleted file mode 100755 index 63a29b5666..0000000000 --- a/wxPython/samples/wx_examples/hello/hello.py +++ /dev/null @@ -1,38 +0,0 @@ -#!/usr/bin/env python - -"""Hello, wxPython! program.""" - -__author__ = "Patrick K. O'Brien " -__cvsid__ = "$Id$" -__revision__ = "$Revision$"[11:-2] - -import wx - -class Frame(wx.Frame): - """Frame class that displays an image.""" - - def __init__(self, image, parent=None, id=-1, - pos=wx.DefaultPosition, title='Hello, wxPython!'): - """Create a Frame instance and display image.""" - temp = image.ConvertToBitmap() - size = temp.GetWidth(), temp.GetHeight() - wx.Frame.__init__(self, parent, id, title, pos, size) - self.bmp = wx.StaticBitmap(parent=self, id=-1, bitmap=temp) - -class App(wx.App): - """Application class.""" - - def OnInit(self): - wx.InitAllImageHandlers() - image = wx.Image('wxPython.jpg', wx.BITMAP_TYPE_JPEG) - self.frame = Frame(image) - self.frame.Show() - self.SetTopWindow(self.frame) - return True - -def main(): - app = App() - app.MainLoop() - -if __name__ == '__main__': - main() diff --git a/wxPython/samples/wx_examples/hello/wxPython.jpg b/wxPython/samples/wx_examples/hello/wxPython.jpg deleted file mode 100644 index 9770d4e9b8..0000000000 Binary files a/wxPython/samples/wx_examples/hello/wxPython.jpg and /dev/null differ