aboutsummaryrefslogtreecommitdiffstats
path: root/src/xselect.c
diff options
context:
space:
mode:
authorEli Zaretskii2018-09-08 12:20:55 +0300
committerEli Zaretskii2018-09-08 12:20:55 +0300
commite48968561728d6c1d9e4e8753cd7eafa08e37ac7 (patch)
tree7956545062a40da92c5ed73469879f7c28af9279 /src/xselect.c
parentf9a72b83abc0f8de85840269b59c228b55496dd4 (diff)
downloademacs-e48968561728d6c1d9e4e8753cd7eafa08e37ac7.tar.gz
emacs-e48968561728d6c1d9e4e8753cd7eafa08e37ac7.zip
Fix documentation for conversion to bignums
* src/xselect.c (selection_data_to_lisp_data): * src/w32fns.c (Fw32_read_registry): * src/process.c (Fprocess_id): * src/font.c (Ffont_variation_glyphs, Finternal_char_font): * src/fns.c (Fsafe_length): * src/editfns.c (Fuser_uid, Fuser_real_uid, Fgroup_gid) (Fgroup_real_gid, Femacs_pid): * src/dired.c (Ffile_attributes): * src/charset.c (Fencode_char): Update commentary and doc strings for recent changes that produce bignums where previously cons cells of integers were produced.
Diffstat (limited to 'src/xselect.c')
-rw-r--r--src/xselect.c15
1 files changed, 4 insertions, 11 deletions
diff --git a/src/xselect.c b/src/xselect.c
index 53e788523cc..a87784fb4b1 100644
--- a/src/xselect.c
+++ b/src/xselect.c
@@ -1536,17 +1536,10 @@ x_get_window_property_as_lisp_data (struct x_display_info *dpyinfo,
1536 ATOM 32 > 1 Vector of Symbols 1536 ATOM 32 > 1 Vector of Symbols
1537 * 16 1 Integer 1537 * 16 1 Integer
1538 * 16 > 1 Vector of Integers 1538 * 16 > 1 Vector of Integers
1539 * 32 1 if <=16 bits: Integer 1539 * 32 1 if small enough: fixnum
1540 if > 16 bits: Cons of top16, bot16 1540 otherwise: bignum
1541 * 32 > 1 Vector of the above 1541 * 32 > 1 Vector of the above
1542 1542
1543 When converting a Lisp number to C, it is assumed to be of format 16 if
1544 it is an integer, and of format 32 if it is a cons of two integers.
1545
1546 When converting a vector of numbers from Lisp to C, it is assumed to be
1547 of format 16 if every element in the vector is an integer, and is assumed
1548 to be of format 32 if any element is a cons of two integers.
1549
1550 When converting an object to C, it may be of the form (SYMBOL . <data>) 1543 When converting an object to C, it may be of the form (SYMBOL . <data>)
1551 where SYMBOL is what we should claim that the type is. Format and 1544 where SYMBOL is what we should claim that the type is. Format and
1552 representation are as above. 1545 representation are as above.
@@ -1611,8 +1604,8 @@ selection_data_to_lisp_data (struct x_display_info *dpyinfo,
1611 } 1604 }
1612 1605
1613 /* Convert a single 16-bit number or a small 32-bit number to a Lisp_Int. 1606 /* Convert a single 16-bit number or a small 32-bit number to a Lisp_Int.
1614 If the number is 32 bits and won't fit in a Lisp_Int, 1607 If the number is 32 bits and won't fit in a Lisp_Int, convert it
1615 convert it to a cons of integers, 16 bits in each half. 1608 to a bignum.
1616 1609
1617 INTEGER is a signed type, CARDINAL is unsigned. 1610 INTEGER is a signed type, CARDINAL is unsigned.
1618 Assume any other types are unsigned as well. 1611 Assume any other types are unsigned as well.