aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEli Zaretskii2015-01-04 20:30:16 +0200
committerEli Zaretskii2015-01-04 20:30:16 +0200
commit5981b4b1c08d308563ecfd4e3ee9f133d47af3b2 (patch)
treedbb614a3ad9cc680cb95ff4e9a0e1aeeb5d3052f
parent143516c73db7e182687f4be98966461ce7f3703f (diff)
downloademacs-5981b4b1c08d308563ecfd4e3ee9f133d47af3b2.tar.gz
emacs-5981b4b1c08d308563ecfd4e3ee9f133d47af3b2.zip
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.
-rw-r--r--doc/lispref/ChangeLog5
-rw-r--r--doc/lispref/frames.texi24
-rw-r--r--src/ChangeLog4
-rw-r--r--src/w32fns.c35
-rw-r--r--src/xfns.c21
5 files changed, 64 insertions, 25 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index c4b80a03575..c898af51686 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
12015-01-04 Eli Zaretskii <eliz@gnu.org>
2
3 * frames.texi (Display Feature Testing): Make the description of
4 x-server-version and x-server-vendor less X-specific. (Bug#19502)
5
12014-12-24 Glenn Morris <rgm@gnu.org> 62014-12-24 Glenn Morris <rgm@gnu.org>
2 7
3 * control.texi (Pattern matching case statement): 8 * control.texi (Pattern matching case statement):
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 2d5922732c6..3c27ab15566 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -2645,20 +2645,26 @@ colors).
2645This function returns the number of color cells the screen supports. 2645This function returns the number of color cells the screen supports.
2646@end defun 2646@end defun
2647 2647
2648 These functions obtain additional information specifically 2648 These functions obtain additional information about the window
2649about X displays. 2649system in use where Emacs shows the specified @var{display}. (Their
2650names begin with @code{x-} for historical reasons.)
2650 2651
2651@defun x-server-version &optional display 2652@defun x-server-version &optional display
2652This function returns the list of version numbers of the X server 2653This function returns the list of version numbers of the GUI window
2653running the display. The value is a list of three integers: the major 2654system running on @var{display}, such as the X server on GNU and Unix
2654and minor version numbers of the X protocol, and the 2655systems. The value is a list of three integers: the major and minor
2655distributor-specific release number of the X server software itself. 2656version numbers of the protocol, and the distributor-specific release
2657number of the window system software itself. On GNU and Unix systems,
2658these are normally the version of the X protocol and the
2659distributor-specific release number of the X server software. On
2660MS-Windows, this is the version of the Windows OS.
2656@end defun 2661@end defun
2657 2662
2658@defun x-server-vendor &optional display 2663@defun x-server-vendor &optional display
2659This function returns the ``vendor'' that provided the X server 2664This function returns the ``vendor'' that provided the window system
2660software (as a string). Really this means whoever distributes the X 2665software (as a string). On GNU and Unix systems this really means
2661server. 2666whoever distributes the X server. On MS-Windows this is the vendor ID
2667string of the Windows OS (Microsoft).
2662 2668
2663When the developers of X labeled software distributors as 2669When the developers of X labeled software distributors as
2664``vendors'', they showed their false assumption that no system could 2670``vendors'', they showed their false assumption that no system could
diff --git a/src/ChangeLog b/src/ChangeLog
index 39acf77e41b..d9dd53ba1df 100644
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,5 +1,9 @@
12015-01-04 Eli Zaretskii <eliz@gnu.org> 12015-01-04 Eli Zaretskii <eliz@gnu.org>
2 2
3 * w32fns.c (Fx_server_version, Fx_server_vendor): Doc fix.
4
5 * xfns.c (Fx_server_version, Fx_server_vendor): Doc fix.
6
3 * emacs.c (syms_of_emacs) <system-configuration>: Doc fix. 7 * emacs.c (syms_of_emacs) <system-configuration>: Doc fix.
4 (Bug#19502) 8 (Bug#19502)
5 9
diff --git a/src/w32fns.c b/src/w32fns.c
index 64e0e6d028a..412e91e045e 100644
--- a/src/w32fns.c
+++ b/src/w32fns.c
@@ -4842,25 +4842,38 @@ If omitted or nil, that stands for the selected frame's display. */)
4842} 4842}
4843 4843
4844DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0, 4844DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
4845 doc: /* Return the "vendor ID" string of the W32 system (Microsoft). 4845 doc: /* Return the "vendor ID" string of the GUI software on TERMINAL.
4846The optional argument DISPLAY specifies which display to ask about. 4846
4847DISPLAY should be either a frame or a display name (a string). 4847\(Labeling every distributor as a "vendor" embodies the false assumption
4848that operating systems cannot be developed and distributed noncommercially.)
4849
4850For GNU and Unix systems, this queries the X server software; for
4851MS-Windows, this queries the OS.
4852
4853The optional argument TERMINAL specifies which display to ask about.
4854TERMINAL should be a terminal object, a frame or a display name (a string).
4848If omitted or nil, that stands for the selected frame's display. */) 4855If omitted or nil, that stands for the selected frame's display. */)
4849 (Lisp_Object display) 4856 (Lisp_Object terminal)
4850{ 4857{
4851 return build_string ("Microsoft Corp."); 4858 return build_string ("Microsoft Corp.");
4852} 4859}
4853 4860
4854DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0, 4861DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
4855 doc: /* Return the version numbers of the server of DISPLAY. 4862 doc: /* Return the version numbers of the GUI software on TERMINAL.
4856The value is a list of three integers: the major and minor 4863The value is a list of three integers specifying the version of the GUI
4857version numbers of the X Protocol in use, and the distributor-specific 4864software in use.
4858release number. See also the function `x-server-vendor'.
4859 4865
4860The optional argument DISPLAY specifies which display to ask about. 4866For GNU and Unix system, the first 2 numbers are the version of the X
4861DISPLAY should be either a frame or a display name (a string). 4867Protocol used on TERMINAL and the 3rd number is the distributor-specific
4868release number. For MS-Windows, the 3 numbers report the version and
4869the build number of the OS.
4870
4871See also the function `x-server-vendor'.
4872
4873The optional argument TERMINAL specifies which display to ask about.
4874TERMINAL should be a terminal object, a frame or a display name (a string).
4862If omitted or nil, that stands for the selected frame's display. */) 4875If omitted or nil, that stands for the selected frame's display. */)
4863 (Lisp_Object display) 4876 (Lisp_Object terminal)
4864{ 4877{
4865 return list3i (w32_major_version, w32_minor_version, w32_build_number); 4878 return list3i (w32_major_version, w32_minor_version, w32_build_number);
4866} 4879}
diff --git a/src/xfns.c b/src/xfns.c
index a9192c8431d..b21228a8697 100644
--- a/src/xfns.c
+++ b/src/xfns.c
@@ -3535,10 +3535,15 @@ If omitted or nil, that stands for the selected frame's display. */)
3535} 3535}
3536 3536
3537DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0, 3537DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
3538 doc: /* Return the "vendor ID" string of the X server of display TERMINAL. 3538 doc: /* Return the "vendor ID" string of the GUI software on TERMINAL.
3539
3539\(Labeling every distributor as a "vendor" embodies the false assumption 3540\(Labeling every distributor as a "vendor" embodies the false assumption
3540that operating systems cannot be developed and distributed noncommercially.) 3541that operating systems cannot be developed and distributed noncommercially.)
3541The optional argument TERMINAL specifies which display to ask about. 3542The optional argument TERMINAL specifies which display to ask about.
3543
3544For GNU and Unix systems, this queries the X server software; for
3545MS-Windows, this queries the OS.
3546
3542TERMINAL should be a terminal object, a frame or a display name (a string). 3547TERMINAL should be a terminal object, a frame or a display name (a string).
3543If omitted or nil, that stands for the selected frame's display. */) 3548If omitted or nil, that stands for the selected frame's display. */)
3544 (Lisp_Object terminal) 3549 (Lisp_Object terminal)
@@ -3551,10 +3556,16 @@ If omitted or nil, that stands for the selected frame's display. */)
3551} 3556}
3552 3557
3553DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0, 3558DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
3554 doc: /* Return the version numbers of the X server of display TERMINAL. 3559 doc: /* Return the version numbers of the GUI software on TERMINAL.
3555The value is a list of three integers: the major and minor 3560The value is a list of three integers specifying the version of the GUI
3556version numbers of the X Protocol in use, and the distributor-specific release 3561software in use.
3557number. See also the function `x-server-vendor'. 3562
3563For GNU and Unix system, the first 2 numbers are the version of the X
3564Protocol used on TERMINAL and the 3rd number is the distributor-specific
3565release number. For MS-Windows, the 3 numbers report the version and
3566the build number of the OS.
3567
3568See also the function `x-server-vendor'.
3558 3569
3559The optional argument TERMINAL specifies which display to ask about. 3570The optional argument TERMINAL specifies which display to ask about.
3560TERMINAL should be a terminal object, a frame or a display name (a string). 3571TERMINAL should be a terminal object, a frame or a display name (a string).