After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 789503 - Code points not explained correctly
Code points not explained correctly
Status: RESOLVED FIXED
Product: gnome-user-docs
Classification: Core
Component: gnome-help
3.26.x
Other Linux
: Normal normal
: ---
Assigned To: Maintainers of Gnome user documentation
Maintainers of Gnome user documentation
Depends on:
Blocks:
 
 
Reported: 2017-10-26 01:47 UTC by Gunnar Hjalmarsson
Modified: 2017-12-24 17:04 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
code point description changed (1.54 KB, patch)
2017-10-26 01:55 UTC, Gunnar Hjalmarsson
none Details | Review
code point description changed 2 (2.25 KB, patch)
2017-11-27 16:17 UTC, Gunnar Hjalmarsson
committed Details | Review

Description Gunnar Hjalmarsson 2017-10-26 01:47:18 UTC
Re: https://help.gnome.org/users/gnome-help/stable/tips-specialchars.html

The section "Code points" says:

"To enter a character by its code point, hold down <Ctrl> and <Shift>, type U followed by the four-character code point, then release <Ctrl> and <Shift>."

That does not work for me on Ubuntu 17.10. I need to release <Ctrl> and <Shift> before typing the code point, so I think the sentence should be changed to something like this:

"To enter a character by its code point, hold down <Ctrl> and <Shift> while typing U, type the four-character code point, then press <Space> or <Enter>."
Comment 1 Gunnar Hjalmarsson 2017-10-26 01:55:25 UTC
Created attachment 362300 [details] [review]
code point description changed
Comment 2 André Klapper 2017-10-26 16:52:55 UTC
> That does not work for me on Ubuntu 17.10.

It does work for me on Fedora 27. (Just tried in Firefox' address bar.) 
So the problem might not be the docs but might be somewhere else? :-/

> "To enter a character by its code point, hold down <Ctrl> and <Shift> while
> typing U, type the four-character code point, then press <Space> or <Enter>."

That would mean that you never release <Ctrl> and <Shift>... :P
Comment 3 Gunnar Hjalmarsson 2017-10-26 17:30:44 UTC
Hmm.. I see now that it works as described if I use the numeric keypad *when NumLock is off*, which isn't very intuitive. To make it work with the numeric keypad with NumLock on, or with the ordinary number keys, I need to release <Ctrl> and <Shift> before I type.

If you see the same behavior, I really think this should be changed. And if you agree, please feel free to suggest a better wording.
Comment 4 André Klapper 2017-10-26 17:55:15 UTC
Cannot test as I don't have a keyboard with a numlock switch. :-/

(And I probably should not have "rejected" the patch as that sounds harsh, sorry - there is definitely something to improve in the docs it seems.)
Comment 5 Gunnar Hjalmarsson 2017-10-26 18:05:24 UTC
No problem. Even without a NumLock switch, you should be able to see it if you use the regular number keys on the keyboard.
Comment 6 Gunnar Hjalmarsson 2017-11-02 04:16:39 UTC
Would be nice if we could achieve a wording which everyone is comfortable with. There may be a reason to improve the proposed patch.

I can mention that in Ubuntu 17.04 we have this wording:

https://help.ubuntu.com/17.04/ubuntu-help/tips-specialchars.html#ctrlshiftu
Comment 7 Gunnar Hjalmarsson 2017-11-26 22:11:17 UTC
Ping? Anybody who can help finalize this change?
Comment 8 Kat 2017-11-27 06:23:41 UTC
Sorry, I can't test it on a numeric keypad either, but I can see how it can be improved.

Rather than saying "hold down Ctrl+Shift while typing U", I would prefer to see it say "press Ctrl+Shift+U, then…" because U+Ctrl+Shift does not work in that order and the phrase is otherwise ambiguous.

Will you provide a revised patch?
Comment 9 Gunnar Hjalmarsson 2017-11-27 16:17:49 UTC
Created attachment 364514 [details] [review]
code point description changed 2

Ok, new patch submitted. I took the opportunity to also replace the reference to the character map with the Characters application.
Comment 10 Petr Kovar 2017-12-19 18:39:00 UTC
Review of attachment 364514 [details] [review]:

Thanks for your patch, pushed as 10201c1498be1e1b4c8534b803c2b0e01bfc265d.
Comment 11 Hannie 2017-12-24 17:04:22 UTC
Comment on attachment 364514 [details] [review]
code point description changed 2

Before I saw this bug, I was going to suggest this:
To enter a character by its code point, hold down <key>Ctrl</key> and <key>Shift</key>, type <key>U</key>, release <key>Ctrl</key> and <key>Shift</key>, then type the four-character code point followed by <key>Enter</key>.
or
  <steps>
    <item><p>Hold down <key>Ctrl</key> and <key>Shift</key>.</p></item>
    <item><p>Type <key>U</key>.</p></item>
    <item><p>Release <key>Ctrl</key> and <key>Shift</key>.</p></item>
    <item><p>Type the four-character code point.</p></item>
    <item><p>Press <key>Enter</key>.</p></item>
  </steps>