bug#5197: 23.1; (elisp) Character Sets

bug#5197: 23.1; (elisp) Character Sets

[Drew Adams]

emacs -Q
Go to (elisp)Character Sets
 
1. "The character set `unicode' includes all the characters whose
Emacs code points are in the range `0..10FFFF'."
 
The previous sections in the Non-ASCII major section use decimal
notation for characters and character ranges. When a character-range
value is returned from a function and printed by the read-eval-print
loop, it is written in decimal notation.
 
The notation used should be consistent.
 
2. Description of `map-charset-chars':
 
2a. All that is said about argument ARG is this:
"The second argument is the optional argument ARG."
That's useless. It seems not to respect the reader.
 
2b. "optional arguments FROM-CODE and TO-CODE limit that to the range
of characters". These should presumably be FROM and TO, not FROM-CODE
and TO-CODE.

In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600)
 of 2009-07-29 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.4)'
 

bug#5197: 23.1; (elisp) Character Sets

[Drew Adams]

> emacs -Q
> Go to (elisp)Character Sets
>  
> 1. "The character set `unicode' includes all the characters whose
> Emacs code points are in the range `0..10FFFF'."
>  
> The previous sections in the Non-ASCII major section use decimal
> notation for characters and character ranges.

I was mistaken about this part. It seems that sometimes hex is used and
sometimes decimal is used. When a cons (MIN . MAX) range is mentioned, for
instance, decimal notation is used.

> When a character-range
> value is returned from a function and printed by the read-eval-print
> loop, it is written in decimal notation.
>  
> The notation used should be consistent.

Perhaps, for this part of the bug report, the suggestion should be to just
mention explicitly which number base is being used in the current context.

It's pretty obvious if you see `F' that hex is used, but it is not so obvious
when the digits could be either decimal or hex.

bug#5197: 23.1; (elisp) Character Sets

[Chong Yidong]

> 1. "The character set `unicode' includes all the characters whose
> Emacs code points are in the range `0..10FFFF'."

> The previous sections in the Non-ASCII major section use decimal
> notation for characters and character ranges. When a character-range
> value is returned from a function and printed by the read-eval-print
> loop, it is written in decimal notation.

> The notation used should be consistent.

I've changed this to use hex throughout (since that is what Unicode
uses).  Thanks.

> 2. Description of `map-charset-chars':
>
> 2a. All that is said about argument ARG is this:
> "The second argument is the optional argument ARG."
> That's useless. It seems not to respect the reader.

If you read properly, this is referring to the second argument passed to
FUNCTION.  I tweaked it a little to make this clearer.

> 2b. "optional arguments FROM-CODE and TO-CODE limit that to the range
> of characters". These should presumably be FROM and TO, not FROM-CODE
> and TO-CODE.

No, the arguments should be FROM-CODE and TO-CODE.  Thanks.