--- Begin Message ---
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 address@hidden
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'
--- End Message ---
--- Begin Message ---
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 <address@hidden>
> Cc: address@hidden, address@hidden
>
> > 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.
--- End Message ---