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