bug#2608: 23.0.90; `w32-use-visible-system-carat' should be a defcustom

bug#2608: 23.0.90; `w32-use-visible-system-carat' should be a defcustom

[Drew Adams]

A visually impaired new Emacs user just asked a question about this
variable on help-emacs-windows@gnu.org. I had never heard of this
variable. I see now that it is a defvar, even though it seems to be
documented as a user "flag". Seems like it should be a defcustom.
 

In GNU Emacs 23.0.90.1 (i386-mingw-nt5.1.2600)
 of 2009-02-01 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4)'
 

bug#2608: 23.0.90; `w32-use-visible-system-carat' should be a defcustom

[Jason Rumney]

Drew Adams wrote:
> A visually impaired new Emacs user just asked a question about this
> variable on help-emacs-windows@gnu.org. I had never heard of this
> variable. I see now that it is a defvar, even though it seems to be
> documented as a user "flag". Seems like it should be a defcustom.
>   

It was originally intended as a user option, but code was added to 
automatically set it according to whether screen reading software is in 
use. So it should just do the right thing. Documentation probably needs 
updating to reflect that, and the fact that it is only useful for screen 
reading software, as the user seems to have gotten the idea that it 
might help them even though they don't use such software - in fact Emacs 
drawn cursors are far more useful, as they can be configured to be more 
or less visible as the user requires.

bug#2608: 23.0.90; `w32-use-visible-system-carat' should be a defcustom

[Drew Adams]

> From: Jason Rumney Sent: Tuesday, March 10, 2009 7:50 AM
> > A visually impaired new Emacs user just asked a question about this
> > variable on help-emacs-windows@gnu.org. I had never heard of this
> > variable. I see now that it is a defvar, even though it seems to be
> > documented as a user "flag". Seems like it should be a defcustom.
> >   
> 
> It was originally intended as a user option, but code was added to 
> automatically set it according to whether screen reading 
> software is in use. So it should just do the right thing.
> Documentation probably needs updating to reflect that, and the
> fact that it is only useful for screen reading software, as the
> user seems to have gotten the idea that it might help them even
> though they don't use such software - in fact Emacs 
> drawn cursors are far more useful, as they can be configured 
> to be more or less visible as the user requires.

I see. Yes, I think clarifying this in the doc would help. And perhaps add a
link to a manual section about customizing the cursor, for people such as the OP
who don't use screenreaders.

Beyond this bug fix, perhaps it would be useful to add a top-level Emacs-manual
section about Accessibility (aka help for the disabled) with links to pertinent
sections of the manual that might be of special help.

CC'ing the OP.

Thx - Drew.

bug#2608: 23.0.90; `w32-use-visible-system-carat' should be a defcustom

[Drew Adams]

> > From: Jason Rumney Sent: Tuesday, March 10, 2009 7:50 AM
> > > A visually impaired new Emacs user just asked a question 
> > > about this variable on help-emacs-windows@gnu.org. I had
> > > never heard of this variable. I see now that it is a
> > > defvar, even though it seems to be
> > > documented as a user "flag". Seems like it should be a defcustom.
> > >   
> > 
> > It was originally intended as a user option, but code was added to 
> > automatically set it according to whether screen reading 
> > software is in use. So it should just do the right thing.
> > Documentation probably needs updating to reflect that, and the
> > fact that it is only useful for screen reading software, as the
> > user seems to have gotten the idea that it might help them even
> > though they don't use such software - in fact Emacs 
> > drawn cursors are far more useful, as they can be configured 
> > to be more or less visible as the user requires.
> 
> I see. Yes, I think clarifying this in the doc would help. 
> And perhaps add a
> link to a manual section about customizing the cursor, for 
> people such as the OP
> who don't use screenreaders.
> 
> Beyond this bug fix, perhaps it would be useful to add a 
> top-level Emacs-manual
> section about Accessibility (aka help for the disabled) with 
> links to pertinent
> sections of the manual that might be of special help.
> 
> CC'ing the OP.

I don't see this as fixed in 23.0.94.1. I'm looking at both the doc string and
the Emacs manual section about this variable.

bug#2608: marked as done (23.0.90; `w32-use-visible-system-carat' should be a defcustom)

[Emacs bug Tracking System]

[-- Attachment #1: Type: text/plain, Size: 906 bytes --]


Your message dated Wed, 11 Mar 2009 21:20:27 +0800
with message-id <49B7BA9B.4030209@gnu.org>
and subject line Re: 23.0.90; `w32-use-visible-system-carat' should be a defcustom
has caused the Emacs bug report #2608,
regarding 23.0.90; `w32-use-visible-system-carat' should be a defcustom
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@emacsbugs.donarmstrong.com
immediately.)


-- 
2608: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=2608
Emacs Bug Tracking System
Contact owner@emacsbugs.donarmstrong.com with problems

[-- Attachment #2: Type: message/rfc822, Size: 3183 bytes --]

From: "Drew Adams" <drew.adams@oracle.com>
To: <emacs-pretest-bug@gnu.org>
Subject: 23.0.90; `w32-use-visible-system-carat' should be a defcustom
Date: Sun, 8 Mar 2009 23:55:42 -0700
Message-ID: <005f01c9a084$114a0280$0200a8c0@us.oracle.com>

A visually impaired new Emacs user just asked a question about this
variable on help-emacs-windows@gnu.org. I had never heard of this
variable. I see now that it is a defvar, even though it seems to be
documented as a user "flag". Seems like it should be a defcustom.
 

In GNU Emacs 23.0.90.1 (i386-mingw-nt5.1.2600)
 of 2009-02-01 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4)'
 




[-- Attachment #3: Type: message/rfc822, Size: 2535 bytes --]

From: Jason Rumney <jasonr@gnu.org>
To: 2608-done@emacsbugs.donarmstrong.com
Subject: Re: 23.0.90; `w32-use-visible-system-carat' should be a defcustom
Date: Wed, 11 Mar 2009 21:20:27 +0800
Message-ID: <49B7BA9B.4030209@gnu.org>

The documentation for this has been updated.

bug#2608: marked as done (23.0.90; `w32-use-visible-system-carat' should be a defcustom)

[Emacs bug Tracking System]

[-- Attachment #1: Type: text/plain, Size: 915 bytes --]


Your message dated Mon, 25 May 2009 09:10:47 +0800
with message-id <4A19F017.2090104@gnu.org>
and subject line Re: bug#2608: 23.0.90;`w32-use-visible-system-carat' should be a defcustom
has caused the Emacs bug report #2608,
regarding 23.0.90; `w32-use-visible-system-carat' should be a defcustom
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@emacsbugs.donarmstrong.com
immediately.)


-- 
2608: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=2608
Emacs Bug Tracking System
Contact owner@emacsbugs.donarmstrong.com with problems

[-- Attachment #2: Type: message/rfc822, Size: 3183 bytes --]

From: "Drew Adams" <drew.adams@oracle.com>
To: <emacs-pretest-bug@gnu.org>
Subject: 23.0.90; `w32-use-visible-system-carat' should be a defcustom
Date: Sun, 8 Mar 2009 23:55:42 -0700
Message-ID: <005f01c9a084$114a0280$0200a8c0@us.oracle.com>

A visually impaired new Emacs user just asked a question about this
variable on help-emacs-windows@gnu.org. I had never heard of this
variable. I see now that it is a defvar, even though it seems to be
documented as a user "flag". Seems like it should be a defcustom.
 

In GNU Emacs 23.0.90.1 (i386-mingw-nt5.1.2600)
 of 2009-02-01 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4)'
 




[-- Attachment #3: Type: message/rfc822, Size: 3195 bytes --]

From: Jason Rumney <jasonr@gnu.org>
To: Drew Adams <drew.adams@oracle.com>
Cc: 2608-done@emacsbugs.donarmstrong.com
Subject: Re: bug#2608: 23.0.90;`w32-use-visible-system-carat' should be a defcustom
Date: Mon, 25 May 2009 09:10:47 +0800
Message-ID: <4A19F017.2090104@gnu.org>

Drew Adams wrote:
> I don't see this as fixed in 23.0.94.1. I'm looking at both the doc string and
> the Emacs manual section about this variable.
>   

Drew, can you please stop reopening bugs because the solution is not 
EXACTLY what you want.

At least explain what it is that is missing so we can have a clue what 
it is you are not happy with.