From 9b1026886b86809055286413bdc4023df0b5896b Mon Sep 17 00:00:00 2001 From: "FeRD (Frank Dana)" Date: Sun, 14 May 2023 09:18:48 +0000 Subject: docs/input-handling: Don't leave reader hanging Strangely, the document's last sentence ended with a colon, giving the impression there's missing text that should follow. There is not. Even more strange, it's _always_ ended with a colon, ever since the file was converted from XML (in commit 10cd539104af54f5d1d1e49618f5aa9d8ac42074). BUT, the XML file it was converted _from_ ended that same sentence with a period! I have no idea where the colon came from. --- docs/reference/gtk/input-handling.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/reference/gtk/input-handling.md b/docs/reference/gtk/input-handling.md index 59983f092d..df92aa281a 100644 --- a/docs/reference/gtk/input-handling.md +++ b/docs/reference/gtk/input-handling.md @@ -208,4 +208,4 @@ sequence, so setting the state on one does transfer the state to the others. They also are mutually exclusive, within a widget where may be only one gesture group claiming a given sequence. If another gesture group claims later that same sequence, the -first group will deny the sequence: +first group will deny the sequence. -- cgit v1.2.1 From 59acec21d471de35cb04c88aa327941d92dfc306 Mon Sep 17 00:00:00 2001 From: "FeRD (Frank Dana)" Date: Sun, 14 May 2023 16:20:33 -0400 Subject: docs/input-handling: A few more wrappings - Format a few missed keypresses/combos using - Switch to semantic newlines for those (paragraphs, bullet points) --- docs/reference/gtk/input-handling.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) (limited to 'docs') diff --git a/docs/reference/gtk/input-handling.md b/docs/reference/gtk/input-handling.md index df92aa281a..0e724935dc 100644 --- a/docs/reference/gtk/input-handling.md +++ b/docs/reference/gtk/input-handling.md @@ -121,15 +121,17 @@ GTK has traditionally supported different kinds of shortcuts: - Accelerators are any other shortcuts that can be activated regardless of where the focus is, and typically trigger global actions, such as - Ctrl-Q to quit an application. -- Mnemonics are usually triggered using Alt as a modifier for a letter. + Ctrl+Q to quit an application. +- Mnemonics are usually triggered using Alt + as a modifier for a letter. They are used in places where a label is associated with a control, and are indicated by underlining the letter in the label. As a special case, inside menus (i.e. inside `GtkPopoverMenu`), mnemonics can be triggered without the modifier. -- Key bindings are specific to individual widgets, such as Ctrl-C or - Ctrl-V in an entry copy to or paste from the clipboard. They are only - triggered when the widget has focus. +- Key bindings are specific to individual widgets, + such as Ctrl+C or Ctrl+V + in an entry copy to or paste from the clipboard. + They are only triggered when the widget has focus. GTK handles accelerators and mnemonics in a global scope, during the capture phase, and key bindings locally, during the target phase. -- cgit v1.2.1 From 8b4e7a638c8e5fc1d6c6fcedf9bf903a2432fc1e Mon Sep 17 00:00:00 2001 From: "FeRD (Frank Dana)" Date: Sun, 14 May 2023 16:23:41 -0400 Subject: =?UTF-8?q?docs/input:=20=E2=90=A3=20=3D>=20Space?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Switch to semantic newlines, where adding caused wrapped text to grow wider than 80 characters on some lines. --- docs/reference/gtk/input-handling.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) (limited to 'docs') diff --git a/docs/reference/gtk/input-handling.md b/docs/reference/gtk/input-handling.md index 0e724935dc..45b4c41416 100644 --- a/docs/reference/gtk/input-handling.md +++ b/docs/reference/gtk/input-handling.md @@ -103,14 +103,15 @@ fields, but e.g. buttons can take the focus too. Input widgets can be given the focus by clicking on them, but focus can also be moved around with certain key events (this is known as -“keyboard navigation”). GTK reserves the Tab key to move the focus -to the next location, and Shift+Tab to move it back to the previous -one. In addition many containers allow “directional navigation” with -the arrow keys. - -Many widgets can be “activated” to trigger and action. E.g., you can -activate a button or switch by clicking on them, but you can also -activate them with the keyboard, by using the Enter or ␣ keys. +“keyboard navigation”). +GTK reserves the Tab key to move the focus to the next location, +and Shift+Tab to move it back to the previous one. +In addition many containers allow “directional navigation” with the arrow keys. + +Many widgets can be “activated” to trigger and action. +E.g., you can activate a button or switch by clicking on them, +but you can also activate them with the keyboard, +by using the Enter or Space keys. Apart from keyboard navigation, activation and directly typing into entries or text views, GTK widgets can use key events for activating -- cgit v1.2.1 From c01be6cac74ee4e3f8a916b2c562578b4b38647f Mon Sep 17 00:00:00 2001 From: "FeRD (Frank Dana)" Date: Sun, 14 May 2023 17:01:38 -0400 Subject: doc/actions: Fix end-of-file : The actions document ended with a : where there used to be a period, seemingly a bug in the conversion from XML. Replace that : with a period, and remove another spurious : inserted during the conversion. --- docs/reference/gtk/actions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs') diff --git a/docs/reference/gtk/actions.md b/docs/reference/gtk/actions.md index 2482c5c0b9..40057644bf 100644 --- a/docs/reference/gtk/actions.md +++ b/docs/reference/gtk/actions.md @@ -220,6 +220,6 @@ clipboard.cut, clipboard.copy, clipboard.paste selection.delete, selection.select-all : Selection operations on entries, text view and labels -color.select, color.customize: +color.select, color.customize : Operate on colors in a `GtkColorChooserWidget`. These actions are - unusual in that they have the non-trivial parameter type (dddd): + unusual in that they have the non-trivial parameter type (dddd). -- cgit v1.2.1