More doc fixes for bug#19502 -- make documentation less X-specific.

doc/lispref/frames.texi (Display Feature Testing): Make the description of
 x-server-version and x-server-vendor less X-specific.

 Make doc strings on X and w32 identical.
 src/w32fns.c (Fx_server_version, Fx_server_vendor): Doc fix.
 src/xfns.c (Fx_server_version, Fx_server_vendor): Doc fix.
This commit is contained in:
Eli Zaretskii 2015-01-04 20:30:16 +02:00
parent 143516c73d
commit 5981b4b1c0
5 changed files with 64 additions and 25 deletions

View file

@ -1,3 +1,8 @@
2015-01-04 Eli Zaretskii <eliz@gnu.org>
* frames.texi (Display Feature Testing): Make the description of
x-server-version and x-server-vendor less X-specific. (Bug#19502)
2014-12-24 Glenn Morris <rgm@gnu.org> 2014-12-24 Glenn Morris <rgm@gnu.org>
* control.texi (Pattern matching case statement): * control.texi (Pattern matching case statement):

View file

@ -2645,20 +2645,26 @@ colors).
This function returns the number of color cells the screen supports. This function returns the number of color cells the screen supports.
@end defun @end defun
These functions obtain additional information specifically These functions obtain additional information about the window
about X displays. system in use where Emacs shows the specified @var{display}. (Their
names begin with @code{x-} for historical reasons.)
@defun x-server-version &optional display @defun x-server-version &optional display
This function returns the list of version numbers of the X server This function returns the list of version numbers of the GUI window
running the display. The value is a list of three integers: the major system running on @var{display}, such as the X server on GNU and Unix
and minor version numbers of the X protocol, and the systems. The value is a list of three integers: the major and minor
distributor-specific release number of the X server software itself. version numbers of the protocol, and the distributor-specific release
number of the window system software itself. On GNU and Unix systems,
these are normally the version of the X protocol and the
distributor-specific release number of the X server software. On
MS-Windows, this is the version of the Windows OS.
@end defun @end defun
@defun x-server-vendor &optional display @defun x-server-vendor &optional display
This function returns the ``vendor'' that provided the X server This function returns the ``vendor'' that provided the window system
software (as a string). Really this means whoever distributes the X software (as a string). On GNU and Unix systems this really means
server. whoever distributes the X server. On MS-Windows this is the vendor ID
string of the Windows OS (Microsoft).
When the developers of X labeled software distributors as When the developers of X labeled software distributors as
``vendors'', they showed their false assumption that no system could ``vendors'', they showed their false assumption that no system could

View file

@ -1,5 +1,9 @@
2015-01-04 Eli Zaretskii <eliz@gnu.org> 2015-01-04 Eli Zaretskii <eliz@gnu.org>
* w32fns.c (Fx_server_version, Fx_server_vendor): Doc fix.
* xfns.c (Fx_server_version, Fx_server_vendor): Doc fix.
* emacs.c (syms_of_emacs) <system-configuration>: Doc fix. * emacs.c (syms_of_emacs) <system-configuration>: Doc fix.
(Bug#19502) (Bug#19502)

View file

@ -4842,25 +4842,38 @@ If omitted or nil, that stands for the selected frame's display. */)
} }
DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0, DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
doc: /* Return the "vendor ID" string of the W32 system (Microsoft). doc: /* Return the "vendor ID" string of the GUI software on TERMINAL.
The optional argument DISPLAY specifies which display to ask about.
DISPLAY should be either a frame or a display name (a string). \(Labeling every distributor as a "vendor" embodies the false assumption
that operating systems cannot be developed and distributed noncommercially.)
For GNU and Unix systems, this queries the X server software; for
MS-Windows, this queries the OS.
The optional argument TERMINAL specifies which display to ask about.
TERMINAL should be a terminal object, a frame or a display name (a string).
If omitted or nil, that stands for the selected frame's display. */) If omitted or nil, that stands for the selected frame's display. */)
(Lisp_Object display) (Lisp_Object terminal)
{ {
return build_string ("Microsoft Corp."); return build_string ("Microsoft Corp.");
} }
DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0, DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
doc: /* Return the version numbers of the server of DISPLAY. doc: /* Return the version numbers of the GUI software on TERMINAL.
The value is a list of three integers: the major and minor The value is a list of three integers specifying the version of the GUI
version numbers of the X Protocol in use, and the distributor-specific software in use.
release number. See also the function `x-server-vendor'.
The optional argument DISPLAY specifies which display to ask about. For GNU and Unix system, the first 2 numbers are the version of the X
DISPLAY should be either a frame or a display name (a string). Protocol used on TERMINAL and the 3rd number is the distributor-specific
release number. For MS-Windows, the 3 numbers report the version and
the build number of the OS.
See also the function `x-server-vendor'.
The optional argument TERMINAL specifies which display to ask about.
TERMINAL should be a terminal object, a frame or a display name (a string).
If omitted or nil, that stands for the selected frame's display. */) If omitted or nil, that stands for the selected frame's display. */)
(Lisp_Object display) (Lisp_Object terminal)
{ {
return list3i (w32_major_version, w32_minor_version, w32_build_number); return list3i (w32_major_version, w32_minor_version, w32_build_number);
} }

View file

@ -3535,10 +3535,15 @@ If omitted or nil, that stands for the selected frame's display. */)
} }
DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0, DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
doc: /* Return the "vendor ID" string of the X server of display TERMINAL. doc: /* Return the "vendor ID" string of the GUI software on TERMINAL.
\(Labeling every distributor as a "vendor" embodies the false assumption \(Labeling every distributor as a "vendor" embodies the false assumption
that operating systems cannot be developed and distributed noncommercially.) that operating systems cannot be developed and distributed noncommercially.)
The optional argument TERMINAL specifies which display to ask about. The optional argument TERMINAL specifies which display to ask about.
For GNU and Unix systems, this queries the X server software; for
MS-Windows, this queries the OS.
TERMINAL should be a terminal object, a frame or a display name (a string). TERMINAL should be a terminal object, a frame or a display name (a string).
If omitted or nil, that stands for the selected frame's display. */) If omitted or nil, that stands for the selected frame's display. */)
(Lisp_Object terminal) (Lisp_Object terminal)
@ -3551,10 +3556,16 @@ If omitted or nil, that stands for the selected frame's display. */)
} }
DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0, DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
doc: /* Return the version numbers of the X server of display TERMINAL. doc: /* Return the version numbers of the GUI software on TERMINAL.
The value is a list of three integers: the major and minor The value is a list of three integers specifying the version of the GUI
version numbers of the X Protocol in use, and the distributor-specific release software in use.
number. See also the function `x-server-vendor'.
For GNU and Unix system, the first 2 numbers are the version of the X
Protocol used on TERMINAL and the 3rd number is the distributor-specific
release number. For MS-Windows, the 3 numbers report the version and
the build number of the OS.
See also the function `x-server-vendor'.
The optional argument TERMINAL specifies which display to ask about. The optional argument TERMINAL specifies which display to ask about.
TERMINAL should be a terminal object, a frame or a display name (a string). TERMINAL should be a terminal object, a frame or a display name (a string).