GNU bug report logs - #2835
23.0.92; Info is missing help for some mac specific variables.

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 2835 in the body.
You can then email your comments to 2835 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> emacsbugs.donarmstrong.com (full text, mbox):

From: David Caldwell <david <at> porkrind.org>
To: emacs-pretest-bug <at> gnu.org
Subject: 23.0.92; Info is missing help for some mac specific variables.
Date: Tue, 31 Mar 2009 15:33:47 -0700

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

The following variables exist but are not documented in the emacs info:

mac-allow-anti-aliasing  mac-command-modifier
mac-control-modifier     mac-function-modifier
mac-option-modifier

They are originally from the carbon port and they used to be documented.
The info section that describes them seems to have been removed,
probably when the nextstep port took over. They are still relevant
should be documented.

-David


In GNU Emacs 23.0.92.1 (i386-apple-darwin9.6.0, NS apple-appkit-949.43)
 of 2009-03-31 on black.local
Windowing system distributor `Apple', version 10.3.949
configured using `configure  '--with-ns''

Important settings:
  value of $LC_ALL: nil
  value of $LC_COLLATE: nil
  value of $LC_CTYPE: nil
  value of $LC_MESSAGES: nil
  value of $LC_MONETARY: nil
  value of $LC_NUMERIC: nil
  value of $LC_TIME: nil
  value of $LANG: nil
  value of $XMODIFIERS: nil
  locale-coding-system: nil
  default-enable-multibyte-characters: t

Major mode: Emacs-Lisp

Minor modes in effect:
  diff-auto-refine-mode: t
  dir-locals-mode: t
  auto-insert-mode: t
  show-paren-mode: t
  delete-selection-mode: t
  tooltip-mode: t
  mouse-wheel-mode: t
  menu-bar-mode: t
  file-name-shadow-mode: t
  global-font-lock-mode: t
  font-lock-mode: t
  global-auto-composition-mode: t
  auto-composition-mode: t
  auto-encryption-mode: t
  auto-compression-mode: t
  column-number-mode: t
  line-number-mode: t
  transient-mark-mode: t

Recent messages:
line-move-visual: Beginning of buffer
Auto-saving...done
Mark set
Auto-saving...done
line-move-visual: Beginning of buffer [2 times]
Auto-saving...done
Sending...done
line-move-visual: End of buffer
line-move-visual: Beginning of buffer
Making completion list...

[signature.asc (application/pgp-signature, attachment)]

Message #10 received at 2835 <at> emacsbugs.donarmstrong.com (full text, mbox):

From: David Caldwell <david <at> porkrind.org>
To: 2835 <at> debbugs.gnu.org
Subject: Re: bug#2835: 23.0.92; Info is missing help for some mac specific
 variables.
Date: Tue, 31 Mar 2009 16:17:35 -0700

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

I was poking around and noticed that the mac-* have been renamed to ns-* 
names. They are still not documented, however. Sorry to cause any confusion 
by refering to their old names.

[Message part 2 (application/pgp-signature, inline)]

Message #15 received at 2835 <at> emacsbugs.donarmstrong.com (full text, mbox):

From: Jason Rumney <jasonr <at> gnu.org>
To: David Caldwell <david <at> porkrind.org>, 2835 <at> debbugs.gnu.org
Subject: Re: bug#2835: 23.0.92;	Info is missing help for some mac specific
 variables.
Date: Wed, 01 Apr 2009 07:55:52 +0800

David Caldwell wrote:
> The following variables exist but are not documented in the emacs info:
>
> mac-allow-anti-aliasing

Other font backends that support anti-aliasing use an :antialias 
property on the font to disable or use a different type of antialiasing 
for that font. There are a lot of extra font properties like this that 
aren't documented either, especially in the xft and w32 font backends.

Message #20 received at 2835 <at> emacsbugs.donarmstrong.com (full text, mbox):

From: YAMAMOTO Mitsuharu <mituharu <at> math.s.chiba-u.ac.jp>
To: Jason Rumney <jasonr <at> gnu.org>, 2835 <at> debbugs.gnu.org
Cc: David Caldwell <david <at> porkrind.org>
Subject: Re: bug#2835: 23.0.92;	Info is missing help for some mac specific variables.
Date: Wed, 01 Apr 2009 10:22:37 +0900

>>>>> On Wed, 01 Apr 2009 07:55:52 +0800, Jason Rumney <jasonr <at> gnu.org> said:

>> The following variables exist but are not documented in the emacs
>> info:
>> 
>> mac-allow-anti-aliasing

Confusingly, this is not a variable that controls anti-aliasing, but
it changes a font rendering engine so it uses lighter anti-aliasing.
This facility seems to be deprecated as of Mac OS X 10.5, so I'd
suggest removing this variable together with the corresponding NS
variable, ns-use-qd-smoothing.

> Other font backends that support anti-aliasing use an :antialias
> property on the font to disable or use a different type of
> antialiasing for that font. There are a lot of extra font properties
> like this that aren't documented either, especially in the xft and
> w32 font backends.

Still this applies to another NS variable, ns-antialias-text.

				     YAMAMOTO Mitsuharu
				mituharu <at> math.s.chiba-u.ac.jp

Message #25 received at 2835 <at> emacsbugs.donarmstrong.com (full text, mbox):

From: YAMAMOTO Mitsuharu <mituharu <at> math.s.chiba-u.ac.jp>
To: 2835 <at> debbugs.gnu.org
Cc: Jason Rumney <jasonr <at> gnu.org>, David Caldwell <david <at> porkrind.org>
Subject: Re: bug#2835: 23.0.92;	Info is missing help for some mac specific variables.
Date: Wed, 01 Apr 2009 11:02:11 +0900

>>>>> On Wed, 01 Apr 2009 10:22:37 +0900, YAMAMOTO Mitsuharu <mituharu <at> math.s.chiba-u.ac.jp> said:

>>> The following variables exist but are not documented in the emacs
>>> info:
>>> 
>>> mac-allow-anti-aliasing

> Confusingly, this is not a variable that controls anti-aliasing, but
> it changes a font rendering engine so it uses lighter anti-aliasing.

Sorry, this description itself seems to be confusing.  I meant, "if
the variable is set to non-nil, it selects another font rendering
engine whose rendering results in lighter anti-aliasing."

				     YAMAMOTO Mitsuharu
				mituharu <at> math.s.chiba-u.ac.jp

Message #34 received at 2835 <at> emacsbugs.donarmstrong.com (full text, mbox):

From: Adrian Robert <adrian.b.robert <at> gmail.com>
To: 2835 <at> debbugs.gnu.org
Subject: Re: Info is missing help for some mac specific variables
Date: Sun, 31 May 2009 22:49:44 +0700

The mac-xxx variables are there for legacy support.  They are  
documented if you do Ctrl-h v, but I'm not sure it's appropriate to  
document them in the info manual.

Also, mac-allow-anti-aliasing appears to be an alias for ns-antialias- 
text, which does switch on/off antialiasing.

ns-use-qd-smoothing controls the use of the QuickDraw engine, which  
was also a kind of legacy support for those transitioning from Carbon  
emacs, which at one time used QuickDraw rendering exclusively.  Since  
that changed long ago it is indeed probably best to remove this now  
-- the results don't really look good enough to justify it  
independently.

Would be good to standardize antialiasing control -- if all other  
backends use :antialias, NS should probably change to use it too, and  
then it should be documented globally.

Message #39 received at 2835 <at> debbugs.gnu.org (full text, mbox):

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: Adrian Robert <adrian.b.robert <at> gmail.com>
Cc: 2835 <at> debbugs.gnu.org
Subject: Re: Info is missing help for some mac specific variables
Date: Mon, 11 Jul 2011 16:05:09 +0200

Adrian Robert <adrian.b.robert <at> gmail.com> writes:

> The mac-xxx variables are there for legacy support.  They are
> documented if you do Ctrl-h v, but I'm not sure it's appropriate to
> document them in the info manual.

I agree, so I'm closing this bug report.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Previous Next

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