GNU bug report logs - #15109
24.3.50; doc of `x-get-selection, `selection-converter-alist', `xselect-convert-to-*'

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#15109: closed (24.3.50; doc of `x-get-selection,
 `selection-converter-alist', `xselect-convert-to-*')
Date: Tue, 11 Feb 2014 03:37:02 +0000

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

Your message dated Tue, 11 Feb 2014 05:36:03 +0200
with message-id <83eh3atj6k.fsf <at> gnu.org>
and subject line Re: bug#15109: 24.3.50; doc of `x-get-selection, `selection-converter-alist',	`xselect-convert-to-*'
has caused the debbugs.gnu.org bug report #15109,
regarding 24.3.50; doc of `x-get-selection, `selection-converter-alist', `xselect-convert-to-*'
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


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

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

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 24.3.50; doc of `x-get-selection, `selection-converter-alist',
 `xselect-convert-to-*'
Date: Thu, 15 Aug 2013 23:49:11 -0700 (PDT)

1. `x-get-selection': Doc string refers you to
`selection-converter-alist', without which you cannot understand
parameter DATA-TYPE.

2. `selection-converter-alist': There is NO doc string.  Please add one
and please make sure it describes (or links to the doc for) the various
`xselect-convert-to-*' functions that one sees in the value of
`selection-converter-alist'.

3. `xselect-convert-to-*' functions, such as
`xselect-convert-to-filename': There is NO doc string.  Please add one
for each such function.


In GNU Emacs 24.3.50.1 (i686-pc-mingw32)
 of 2013-08-07 on ODIEONE
Bzr revision: 113750 lekktu <at> gmail.com-20130808011911-0jzpc9xuncegg6x9
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/Devel/emacs/binary --enable-checking=yes,glyphs
 CFLAGS=-O0 -g3 LDFLAGS=-Lc:/Devel/emacs/lib
 CPPFLAGS=-Ic:/Devel/emacs/include'

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: larsi <at> gnus.org, drew.adams <at> oracle.com, 15109-done <at> debbugs.gnu.org
Subject: Re: bug#15109: 24.3.50; doc of `x-get-selection,
 `selection-converter-alist',	`xselect-convert-to-*'
Date: Tue, 11 Feb 2014 05:36:03 +0200

> Date: Mon, 10 Feb 2014 13:36:12 -0800 (PST)
> From: Drew Adams <drew.adams <at> oracle.com>
> Cc: larsi <at> gnus.org, 15109 <at> debbugs.gnu.org
> 
> > I see no reason to have selection-converter-alist documented
> > on Windows, since the functionality it encompasses is not available
> > there, and the DATA-TYPE argument to x-get-selection is completely
> > ignored on MS-Windows.
> 
> In that case, why define `selection-converter-alist' at all on
> Windows?  And why not rename it to `x-selection-converter-alist',
> if it is X-specific?

I explained why: because we must have identical doc strings for these
on all platforms, due to limitations of how the DOC file is built and
used.

> On the other hand, although `x-get-selection' has that prefix,
> it _is_ defined and used on Windows.  Likewise, `x-set-selection'.
> Code that makes use of the secondary selection will make use of
> such functions, for instance.
> 
> So maybe they should lose their `x-' prefix (or suitable unprefixed
> synonyms or wrapper functions be provided).
> 
> IOW, things do not seem so cut-and-dried as you describe them.
> In the past we have renamed `x-defined-colors' to `defined-colors' etc.
> Sounds like maybe some more such cleanup is in order.

Could be.  But that's a different issue.  This one is done.

Previous Next

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