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:
parent
143516c73d
commit
5981b4b1c0
5 changed files with 64 additions and 25 deletions
|
@ -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):
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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)
|
||||||
|
|
||||||
|
|
35
src/w32fns.c
35
src/w32fns.c
|
@ -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);
|
||||||
}
|
}
|
||||||
|
|
21
src/xfns.c
21
src/xfns.c
|
@ -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).
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue