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.
31
32 Notes
33 -----
34
35 Notes on desktop application/environment support:
36
37 KDE Supports file and URL opening using kfmclient, where the openURL
38 command opens the resource and the exec command runs the
39 resource.
40
41 GNOME Supports file and URL opening using gnome-open.
42
43 XFCE Supports file and URL opening using exo-open.
44
45 ROX-Filer Supports file opening using "rox <filename>" but not URL
46 opening.
47
48 New in desktop 0.3.1 (Changes since desktop 0.3)
49 ------------------------------------------------
50
51 * Improved docstrings.
52 * Fixed support for examining the root window.
53
54 New in desktop 0.3 (Changes since desktop 0.2.4)
55 ------------------------------------------------
56
57 * Made desktop a package.
58 * Added support for graphical dialogue boxes through programs such as
59 kdialog, zenity and Xdialog.
60 * Added support for inspecting desktop windows (currently only for X11).
61
62 New in desktop 0.2.4 (Changes since desktop 0.2.3)
63 --------------------------------------------------
64
65 * Added XFCE support (with advice from Miki Tebeka).
66 * Added Ubuntu Feisty (7.04) package support.
67
68 New in desktop 0.2.3 (Changes since desktop 0.2.2)
69 --------------------------------------------------
70
71 * Added Python 2.3 support (using popen2 instead of subprocess).
72
73 New in desktop 0.2.2 (Changes since desktop 0.2.1)
74 --------------------------------------------------
75
76 * Changed the licence to LGPL.
77
78 New in desktop 0.2.1 (Changes since desktop 0.2)
79 ------------------------------------------------
80
81 * Added Debian/Ubuntu package support.
82
83 New in desktop 0.2 (Changes since desktop 0.1)
84 ----------------------------------------------
85
86 * Added support for waiting for launcher processes.
87 * Added a tests directory.
88
89 Release Procedures
90 ------------------
91
92 Update the desktop __version__ attribute.
93 Change the version number and package filename/directory in the documentation.
94 Update the release notes (see above).
95 Update the package information.
96 Check the release information in the PKG-INFO file.
97 Check the setup.py file.
98 Tag, export.
99 Archive, upload.
100 Update PyPI entry.
101
102 Making Packages
103 ---------------
104
105 To make Debian-based packages:
106
107 1. Create new package directories under packages if necessary.
108 2. Make a symbolic link in the distribution's root directory to keep the
109 Debian tools happy:
110
111 ln -s packages/ubuntu-hoary/python2.4-desktop/debian/
112
113 3. Run the package builder:
114
115 dpkg-buildpackage -rfakeroot
116
117 4. Locate and tidy up the packages in the parent directory of the
118 distribution's root directory.