paulb@11 | 1 | Introduction
|
paulb@11 | 2 | ------------
|
paulb@11 | 3 |
|
paulb@11 | 4 | The desktop module provides desktop environment detection and resource opening
|
paulb@11 | 5 | support for a selection of common and standardised desktop environments. See
|
paulb@20 | 6 | the module docstring for a more extensive introduction. See also the following
|
paulb@20 | 7 | patch registered in the Python SourceForge project:
|
paulb@20 | 8 |
|
paulb@20 | 9 | http://www.python.org/sf?id=1301512
|
paulb@11 | 10 |
|
paulb@11 | 11 | Contact, Copyright and Licence Information
|
paulb@11 | 12 | ------------------------------------------
|
paulb@11 | 13 |
|
paulb@11 | 14 | No Web page has yet been made available for this work, but the author can be
|
paulb@11 | 15 | contacted at the following e-mail address:
|
paulb@11 | 16 |
|
paulb@11 | 17 | paul@boddie.org.uk
|
paulb@11 | 18 |
|
paulb@11 | 19 | Copyright and licence information can be found in the docs directory - see
|
paulb@11 | 20 | docs/COPYING.txt and docs/LICENCE.txt for more information. Whilst I would
|
paulb@11 | 21 | prefer to release my software under the LGPL or GPL, the Python Software
|
paulb@11 | 22 | Foundation insists on other licences, and I have chosen one of those in the
|
paulb@11 | 23 | hope that this module becomes a part of the Python standard library.
|
paulb@11 | 24 |
|
paulb@11 | 25 | Notes
|
paulb@11 | 26 | -----
|
paulb@11 | 27 |
|
paulb@4 | 28 | Notes on desktop application/environment support:
|
paulb@4 | 29 |
|
paulb@4 | 30 | KDE Supports file and URL opening using kfmclient, where the openURL
|
paulb@4 | 31 | command opens the resource and the exec command runs the
|
paulb@4 | 32 | resource.
|
paulb@4 | 33 |
|
paulb@4 | 34 | GNOME Supports file and URL opening using gnome-open.
|
paulb@4 | 35 |
|
paulb@4 | 36 | ROX-Filer Supports file opening using "rox <filename>" but not URL
|
paulb@4 | 37 | opening.
|
paulb@17 | 38 |
|
paulb@20 | 39 | New in desktop 0.2.1 (Changes since desktop 0.2)
|
paulb@20 | 40 | ------------------------------------------------
|
paulb@20 | 41 |
|
paulb@20 | 42 | * Added Debian/Ubuntu package support.
|
paulb@20 | 43 |
|
paulb@17 | 44 | New in desktop 0.2 (Changes since desktop 0.1)
|
paulb@17 | 45 | ----------------------------------------------
|
paulb@17 | 46 |
|
paulb@18 | 47 | * Added support for waiting for launcher processes.
|
paulb@17 | 48 | * Added a tests directory.
|
paulb@20 | 49 |
|
paulb@20 | 50 | Release Procedures
|
paulb@20 | 51 | ------------------
|
paulb@20 | 52 |
|
paulb@20 | 53 | Update the desktop __version__ attribute.
|
paulb@20 | 54 | Change the version number and package filename/directory in the documentation.
|
paulb@20 | 55 | Update the release notes (see above).
|
paulb@20 | 56 | Update the package information.
|
paulb@20 | 57 | Check the release information in the PKG-INFO file.
|
paulb@20 | 58 | Check the setup.py file.
|
paulb@20 | 59 | Tag, export.
|
paulb@20 | 60 | Archive, upload.
|
paulb@20 | 61 | Update PyPI, PythonInfo Wiki, Vaults of Parnassus entries.
|
paulb@20 | 62 |
|
paulb@20 | 63 | Making Packages
|
paulb@20 | 64 | ---------------
|
paulb@20 | 65 |
|
paulb@20 | 66 | To make Debian-based packages:
|
paulb@20 | 67 |
|
paulb@20 | 68 | 1. Create new package directories under packages if necessary.
|
paulb@20 | 69 | 2. Make a symbolic link in the distribution's root directory to keep the
|
paulb@20 | 70 | Debian tools happy:
|
paulb@20 | 71 |
|
paulb@20 | 72 | ln -s packages/ubuntu-hoary/python2.4-desktop/debian/
|
paulb@20 | 73 |
|
paulb@20 | 74 | 3. Run the package builder:
|
paulb@20 | 75 |
|
paulb@20 | 76 | dpkg-buildpackage -rfakeroot
|
paulb@20 | 77 |
|
paulb@20 | 78 | 4. Locate and tidy up the packages in the parent directory of the
|
paulb@20 | 79 | distribution's root directory.
|