[Emacs-diffs] Changes to emacs/etc/NEWS,v

[Glenn Morris]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Glenn Morris <gm>       08/06/04 07:08:45

Index: NEWS
===================================================================
RCS file: /sources/emacs/emacs/etc/NEWS,v
retrieving revision 1.1751
retrieving revision 1.1752
diff -u -b -r1.1751 -r1.1752
--- NEWS        30 May 2008 02:37:38 -0000      1.1751
+++ NEWS        4 Jun 2008 07:08:45 -0000       1.1752
@@ -121,10 +121,24 @@
 http://standards.freedesktop.org/xembed-spec/xembed-spec-latest.html
 for details about XEmbed.
 
-FIXME
-** There is a new frame parameter, alpha.
-This [does something] on [some kind of system] with [some kind of X
-server] and [some kind of window manager].
+** Controlling the frame opacity
+The opacity of a frame can now be controlled by setting the `alpha'
+frame parameter, on an X Window system with the composite extension.
+
+The alpha parameter should be an integer between 0 (transparent) and
+100 (opaque) or a float number between 0.0 and 1.0.  Optionally, the
+opacity can be set by a cons cell; the first item controls the
+opacity of an active frame, and the second item controls that of
+non-active frames.
+
+ (set-frame-parameter nil 'alpha 80)
+ (set-frame-parameter nil 'alpha 0.8)
+ (set-frame-parameter nil 'alpha '(100 70)) ; (<active> [<inactive>])
+ (set-frame-parameter nil 'alpha nil)
+
+Note that the threshold opacity of a frame is defined by the variable
+`frame-alpha-lower-limit' (default 20), so that the user may not lose
+control of the frame.
 
 ** Emacs comes with a new set of default icons.
 Various resolutions are available as etc/images/icons/hicolor/*/apps/emacs.png.