716254 - TB: A lot(!) of keyboard shortcuts are missing in documentation

Status: RESOLVED FIXED

(Thunderbird :: Help Documentation, defect)

Description

[Thomas D.]

+++ This bug was initially created as a clone of Bug #716222 +++

A lot(!) of keyboard shortcuts are missing from the main Keyboard Shortcuts documentation article (1), current revision (2) at the time of posting this bug:

Caveats!:
- the position in this list does not anticipate the position in the documentation
- the documentation is currently not well-ordered, see bug 714044.
- I am listing shortcuts from a Windows system perspective(!)

*** Composition Window ***
Caveat: Most, but not necessarily all of these shortcuts from composition window should be added to ==Writing Messages== section; for the problem of order, see bug 714044

* File Menu (ok)

* Edit Menu 
Rewrap message text	Ctrl+R
Delete selected text	Del (missing in the Writing Messages Section)
Remove selected attachment(s)	Del

* View Menu
Toggle Contacts Sidebar	F9

* Insert Menu
Insert Link	Ctrl+L

* Format Menu
Apply Text Style "Bold"	Ctrl+B
Apply Text Style "Italics"	Ctrl+I
Apply Text Style "Underline"	Ctrl+U
Apply Text Style "Fixed Width"	Ctrl+T
Discontinue Text Styles	Ctrl+Shift+Y
Discontinue Link	Ctrl+Shift+K (should go together with Insert Link)
Remove Named Anchors	Ctrl+Shift+A (this will change for TB10, see bug 452634)
Increase Indent	Ctrl+]
Decrease Indent	Ctrl+[
Select Table Cell	Ctrl+Click
* Other Table Selection Methods need to be verified, e.g. "Select Table Column" has Ctrl+Drag but it also works without Ctrl, just Drag
Delete Table Cell Contents	Del (may want to bundle with other Del uses)

* Options Menu
Check Spelling	Ctrl+Shift+P

* Tools Menu
Show Main Mail Window	Ctrl+1 (just imagine, and it even works...)

...and:
Move to next main UI element	Ctrl+Tab (for ==Writing Messages== only)

Wow, that's 16(!) missing shortcuts for Composition window only!

*** Main Mail Window ***
Within the current, insufficient structure/order of the document (bug 714044), most, but not necessarily all of these missing shortcuts from main mail window need to go into the ==Message functions== section.

* File Menu
Rename Folder	F2

* Edit Menu
Cut	Ctrl+X (missing in Message functions section, see below)
Paste	Ctrl+V (Message Functions section currently covers message reader and general functions, and there are many places where cutting and pasting works: Quick Filter Bar, Search Bar, Advanced Search, HTML forms in message reader etc.)

* View Menu
View Message Source	Ctrl+U (this is missing from Message Functions, and wrongly listed under Writing Messages)
Toggle Menu Bar (if hidden)	Alt (for Windows only, and starting from tb8, see relnotes)
(In Message Functions section, Zoom Shortcuts Ctrl++/-/0 are listed, but with a wrong caption, they need to have Zoom In, Zoom Out, and Reset Zoom)

* Go Menu
Go to Mail Start Page	Alt+Home

...and:
Bug 686436 - ctrl+tab, ctrl+shift+tab for switching tabs missing from TB keyboard shortcuts documentation

That's another 8 missing shortcuts from Main Mail Window.

*** Address Book ***
Addressbook New Contact	Ctrl+N
Addressbook Quick Filter	Ctrl+F
Addressbook Advanced Search	Ctrl+Shift+F
Addressbook Edit Properties	Ctrl+I

...and 4 missing from Address Book, if we skip obvious duplicates from other sections.

So that's a total of 28(!) missing shortcuts, plus what might be undocumented in the UI, or what I might have overlooked...!

(1) https://support.mozillamessaging.com/en-US/kb/keyboard-shortcuts
(2) https://support.mozillamessaging.com/en-US/kb/keyboard-shortcuts/revision/5396

Comment 1

[Thomas D.]

Next steps (help wanted!):

1) Ideally, find out if any of these shortcuts were introduced after 3.1, so that appropriate version restriction can be set using {for}
2) Check if all of these apply to non-windows systems, too (please report back!)
3) Add missing shortcuts with respective version and OS restrictions via {for}

I can't make any promises whether at all, or how quickly I might work on this.
I would appreciate any help, especially with 1) and 2); I cannot do 2) without help.

Comment 2

[jenzed]

Mac OS X is the same except for: 

- Toggle Contacts Sidebar F9: not on Mac
- Move to next main UI element: what does this do on Windows?
- Rename Folder	F2: not on Mac
- Go to Mail Start Page	Alt+Home: fn+left arrow on Mac laptop keyboard, Home on    regular keyboard         
- Addressbook Quick Filter Ctrl+F: not on Mac (probably a bug, as Addressbook Advanced Search	Ctrl+Shift+F works)

Comment 3

[jenzed]

Linux (Ubuntu) is the same except for:

Addressbook Quick Filter Ctrl+F - not on Ubuntu
Addressbook Advanced Search Ctrl+Shift+F - not on Ubuntu

Comment 4

[jenzed]

(In reply to jenzed from comment #2)

> - Move to next main UI element: what does this do on Windows?

I see know - on Mac Tab moves through the mail composition fields, but not Ctrl+Tab

Comment 5

[jenzed]

(In reply to jenzed from comment #4)
 
> I see know - on Mac Tab moves through the mail composition fields, but not
> Ctrl+Tab

know -> now

Comment 6

[Thomas D.]

(In reply to jenzed from comment #4)
> (In reply to jenzed from comment #2)
> 
> > - Move to next main UI element: what does this do on Windows?
> 
> I see know - on Mac Tab moves through the mail composition fields, but not
> Ctrl+Tab

Jen, on MAC, Message Composition, with focus on "From:Sender":
- What does Control+Tab do? Nothing?
- What does Command+Tab do?
- Or perhaps Command+Option+Tab?
I can't believe MAC doesn't have a fast-track focus cycle?

Comment 7

[Thomas D.]

Jen, can you please clarify the following...?

(In reply to jenzed from comment #2)
> Mac OS X is the same except for: 
> 
> - Toggle Contacts Sidebar F9: not on Mac

Did you try both F9 and fn+F9? Does fn+F9 work?

> - Rename Folder	F2: not on Mac

What about fn+F2?

> - Go to Mail Start Page	Alt+Home (on windows)
> fn+left arrow on Mac laptop keyboard, Home on    regular keyboard

Pls clarify for the "Go to mail start page command" (which will show the thunderbird home page in the message reader):
- on mac laptop, is it *option*+fn+cursorleft or just fn+cursorleft without Option key?
- on mac regular keyboard, is it *option*+home or just home key only?

> - Addressbook Quick Filter Ctrl+F: not on Mac (probably a bug, as

In addressbook, did you try both command+f and control+f?
Does one of them trigger address book quick filter?

> Addressbook Advanced Search	Ctrl+Shift+F works)

For AB advanced search, is it Control+Shift+F or Command+Shift+F or both of them work?

And for Main Mail window advanced search ("search messages" dialogue), which of them works:
Control+Shift+F or Command+Shift+F or both?

Comment 8

[Thomas D.]

After many hours of work, fixed by major landmark revision

https://support.mozillamessaging.com/en-US/kb/keyboard-shortcuts/revision/5658

as documented and discussed in bug 721666.

Comment 9

[jenzed]

(In reply to Thomas D. from comment #7)
> Jen, can you please clarify the following...?
> 
> (In reply to jenzed from comment #2)
> > Mac OS X is the same except for: 
> > 
> > - Toggle Contacts Sidebar F9: not on Mac
> 
> Did you try both F9 and fn+F9? Does fn+F9 work?

Neither works. F9 is used by the O/S to display all windows.

> 
> > - Rename Folder	F2: not on Mac
> 
> What about fn+F2?

Nope.

> 
> > - Go to Mail Start Page	Alt+Home (on windows)
> > fn+left arrow on Mac laptop keyboard, Home on    regular keyboard
> 
> Pls clarify for the "Go to mail start page command" (which will show the
> thunderbird home page in the message reader):
> - on mac laptop, is it *option*+fn+cursorleft or just fn+cursorleft without
> Option key?

*option*+fn+cursorleft displays the welcome page in the message pane but does not move the focus from the current folder / message. fn+cursorleft either moves to the top of the folder pane or the top of the message list pane depending on which is in focus. (fn+cursorright moves to the bottom.

> - on mac regular keyboard, is it *option*+home or just home key only?

option+home displays the welcome page in the message pane but does not move the focus from the current folder / message. I can't find a combo that does the same thing as fn+cursorleft.


> 
> > - Addressbook Quick Filter Ctrl+F: not on Mac (probably a bug, as
> 
> In addressbook, did you try both command+f and control+f?
> Does one of them trigger address book quick filter?

Neither of them moves the cursor to the quick filter field.

> 
> > Addressbook Advanced Search	Ctrl+Shift+F works)
> 
> For AB advanced search, is it Control+Shift+F or Command+Shift+F or both of
> them work?

Command+Shift+F

> 
> And for Main Mail window advanced search ("search messages" dialogue), which
> of them works:
> Control+Shift+F or Command+Shift+F or both?

Command+Shift+F