GNU bug report logs - #14801
24.3.50; Document monitor attributes (e.g., `workarea' and `mm-size')

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Drew Adams <drew.adams <at> oracle.com>
Subject: bug#14801: closed (Re: bug#14801: 24.3.50; Document monitor
 attributes (e.g., `workarea' and `mm-size'))
Date: Sat, 06 Jul 2013 02:50:02 +0000

[Message part 1 (text/plain, inline)]

Your bug report

#14801: 24.3.50; Document monitor attributes (e.g., `workarea' and `mm-size')

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 14801 <at> debbugs.gnu.org.

-- 
14801: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=14801
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Glenn Morris <rgm <at> gnu.org>
To: 14801-done <at> debbugs.gnu.org
Subject: Re: bug#14801: 24.3.50;
 Document monitor attributes (e.g., `workarea' and `mm-size')
Date: Fri, 05 Jul 2013 22:49:01 -0400

No need for bug reports about documenting new features that are in
NEWS without +++/--- markup.

[Message part 3 (message/rfc822, inline)]

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 24.3.50; Document monitor attributes (e.g., `workarea' and `mm-size')
Date: Fri, 5 Jul 2013 13:30:53 -0700 (PDT)

Monitor attributes are partially documented in
`C-h f display-monitor-attributes-list'.  They should also be (fully)
documented in the Elisp manual.

Even in the doc string of d-m-a-l, the description is incomplete and
needs to be filled out.

Attribute `workareas' is described only in terms of "the workarea".
There is no explanation of what is meant by "workarea" (which should
presumably be two words, BTW).

Attribute `mm-size' is described only as "the width and height in
millimeters".  It's all very nice to say what the units are, but what is
it that is being measured?  The width & height of what?  If it is the
"work area" (whatever that might be) then say so explicitly.

Beyond all this, what on Earth IS a monitor "attribute"?  Is it supposed
to be the same thing as a frame parameter?  The Elisp manual covers file
attributes and face attributes.  And it mentions terminal attributes (in
passing - there is no explanation or description of them), but it is
silent about monitor attributes.

The doc for this feature or collection of features (?) is hopelessly
incomplete and confused.  One can only make wild guesses as to what is
meant and what this is all about.

In GNU Emacs 24.3.50.1 (i686-pc-mingw32)
 of 2013-07-01 on LEG570
Bzr revision: 113246 lekktu <at> gmail.com-20130701165437-ea20s94hqwp3ttaj
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/usr --enable-checking CFLAGS='-O0 -g3'
 CPPFLAGS='-DGLYPH_DEBUG=1 -I/c/usr/include''

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.