diff options
| author | Eli Zaretskii | 2018-09-08 12:20:55 +0300 |
|---|---|---|
| committer | Eli Zaretskii | 2018-09-08 12:20:55 +0300 |
| commit | e48968561728d6c1d9e4e8753cd7eafa08e37ac7 (patch) | |
| tree | 7956545062a40da92c5ed73469879f7c28af9279 /src/xselect.c | |
| parent | f9a72b83abc0f8de85840269b59c228b55496dd4 (diff) | |
| download | emacs-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.c | 15 |
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. |