[gnome-devel-docs] HIG - consolidate standard shortcut lists
- From: Allan Day <allanday src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gnome-devel-docs] HIG - consolidate standard shortcut lists
- Date: Mon, 29 Sep 2014 14:36:21 +0000 (UTC)
commit 45b876e9228d5b360a6bc6d686d738769e9b5574
Author: Allan Day <allanpday gmail com>
Date: Mon Sep 29 15:34:53 2014 +0100
HIG - consolidate standard shortcut lists
Having two lists of keyboard shortcuts resulted in a lot of
overhead. Consolidate all the material into one list, and split
out the details of standard menus into the menu bars page.
hig/C/keyboard-input.page | 376 ++++++++++++++++++-----
hig/C/menu-bars.page | 766 ++-------------------------------------------
2 files changed, 334 insertions(+), 808 deletions(-)
---
diff --git a/hig/C/keyboard-input.page b/hig/C/keyboard-input.page
index e9c044c..d458103 100644
--- a/hig/C/keyboard-input.page
+++ b/hig/C/keyboard-input.page
@@ -225,18 +225,22 @@ Do not assign system-level shortcut keys. These use the Super key (sometimes kno
</section>
-<section id="standard-shortcut-keys">
-<title>Standard shortcut keys</title>
+<section id="application-shortcuts">
+<title>Standard application shortcuts</title>
+
+<p>This section details common application keyboard shortcuts. With the exception of applicaiton shortcuts,
these shortcuts only need to be followed when the corresponding action is included in your application.
Standard shortcuts can be assigned to other actions if the standard action is not available.</p>
-<p>If your application uses any of the standard functions listed in the following tables, use the
recommended standard keyboard shortcut for that function.</p>
+<p>This section also provides guidance on standard menu items in a <link xref="menu-bars">menu bar</link>,
should one be used.</p>
<section id="application">
-<title>Standard application shortcuts</title>
+<title>Application</title>
+
+<p>Standard application keyboard shortcuts and menu items. These application shortcuts should not be
reassigned to other actions, even when the corresponding action is not provided by your application.</p>
<table>
<thead>
<tr>
-<td><p>Function</p></td>
+<td><p>Label</p></td>
<td><p>Shortcut</p></td>
<td><p>Description</p></td>
</tr>
@@ -245,25 +249,32 @@ Do not assign system-level shortcut keys. These use the Super key (sometimes kno
<tr>
<td><p><gui>Help</gui></p></td>
<td><p><key>F1</key></p></td>
-<td><p>Show the help content pages for the current application</p></td>
+<td><p>Opens the default help browser on the contents page for the application.</p></td>
+</tr>
+<tr>
+<td><p><gui>About</gui></p></td>
+<td><p>None</p></td>
+<td><p>Opens the About dialog for the application. Use the standard GNOME 3 dialog for this.</p></td>
</tr>
<tr>
<td><p><gui>Quit</gui></p></td>
<td><p><keyseq><key>Ctrl</key><key>Q</key></keyseq></p></td>
-<td><p>Quit the application</p></td>
+<td><p>Closes the application, including all application windows.</p></td>
</tr>
</tbody>
</table>
</section>
-<section id="content">
-<title>Standard content shortcuts</title>
+<section id="file">
+<title>File</title>
+
+<p>Standard file keyboard shortcuts and menu items.</p>
<table>
<thead>
<tr>
-<td><p>Function</p></td>
+<td><p>Label</p></td>
<td><p>Shortcut</p></td>
<td><p>Description</p></td>
</tr>
@@ -272,27 +283,83 @@ Do not assign system-level shortcut keys. These use the Super key (sometimes kno
<tr>
<td><p><gui>New</gui></p></td>
<td><p><keyseq><key>Ctrl</key><key>N</key></keyseq></p></td>
-<td><p>Create a new document</p></td>
+<td><p>Creates a new content item, often (but not always) in a new primary window or tab. If your
application can create a number of different types of document, you can make the <gui>New</gui> item a
submenu, containing a menu item for each type. Label these items <gui>New</gui> document type, make the first
entry in the submenu the most commonly used document type, and give it the
<keyseq><key>Ctrl</key><key>N</key></keyseq> shortcut.</p></td>
</tr>
<tr>
-<td><p><gui>Open</gui></p></td>
+<td><p><gui>Open…</gui></p></td>
<td><p><keyseq><key>Ctrl</key><key>O</key></keyseq></p></td>
-<td><p>Open a document</p></td>
+<td><p>Opens an existing content item, often by presenting the user with a standard <gui>Open File</gui>
dialog. If the chosen file is already open in the application, raise that window instead of opening a new
one.</p></td>
</tr>
<tr>
<td><p><gui>Save</gui></p></td>
<td><p><keyseq><key>Ctrl</key><key>S</key></keyseq></p></td>
-<td><p>Save the current document</p></td>
+<td><p>Saves the current content item. If the document already has a filename associated with it, save the
document immediately without any further interaction from the user. If there are any additional options
involved in saving a file, prompt for these first time the document is saved, but subsequently use the same
values each time until the user changes them. If the document has no current filename or is read-only,
selecting this item should be the same as selecting <gui>Save As</gui>.</p></td>
</tr>
<tr>
-<td><p><gui>Print</gui></p></td>
+<td><p><gui>Save As…</gui></p></td>
+<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>S</key></keyseq></p></td>
+<td><p>Saves the content item with a new filename. Present the user with the standard <gui>Save As</gui>
dialog, and save the file with the chosen file name.</p></td>
+</tr>
+<tr>
+<td><p><gui>Save a Copy…</gui></p></td>
+<td><p>None</p></td>
+<td><p>Prompts the user to enter a filename, with which a copy of the document is then saved. Do not alter
either the view or the filename of the original document. All subsequent changes are still made to the
original document until the user specifies otherwise, for example by choosing the <gui>Save As</gui>
command.</p>
+<p>Like the <gui>Save As</gui> dialog, the <gui>Save a Copy</gui> dialog may present different ways to save
the data. For example, an image may be saved in a native format or as a PNG.</p></td>
+</tr>
+<tr>
+<td><p><gui>Revert</gui></p></td>
+<td><p>None</p></td>
+<td><p>Reverts the document to the last saved state. Present the user with a warning that all changes will
be lost, and offer the option of cancelling before reloading the file.</p></td>
+</tr>
+<tr>
+<td><p><gui>Save Version</gui></p></td>
+<td><p>None</p></td>
+<td><p>An alternative to the <gui>Save a Copy</gui> command. Only use this item in conjunction with the
<gui>Restore Version</gui> command.</p></td>
+</tr>
+<tr>
+<td><p><gui>Restore Version…</gui></p></td>
+<td><p>None</p></td>
+<td><p>Prompts the user for a version of the current document to be restored. Present the user with with a
warning that all changes will be lost, and offer the option of cancelling before restoring the version. Only
use this item in conjunction with the <gui>Save Version</gui> command.</p></td>
+</tr>
+<tr>
+<td><p><gui>Versions…</gui></p></td>
+<td><p>None</p></td>
+<td><p>An alternative to the <gui>Save Version</gui> and <gui>Restore Version</gui> commands. Use this when
more utilities, such as a diff, are available.</p></td>
+</tr>
+<tr>
+<td><p>Label</p></td>
+<td><p>Shortcut</p></td>
+<td><p>Description</p></td>
+</tr>
+<tr>
+<td><p><gui>Page Setup</gui></p></td>
+<td><p>None</p></td>
+<td><p>Allows the user to control print-related settings. Present the user with a dialog allowing the user
to set such options as portrait or landscape format, margins, and so on.</p></td>
+</tr>
+<tr>
+<td><p><gui>Print Preview</gui></p></td>
+<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Ctrl</key><key>P</key></keyseq></p></td>
+<td><p>Shows the user what the printed document will look like. Present a new window containing an accurate
representation of the appearance of the document as it would be printed.</p></td>
+</tr>
+<tr>
+<td><p><gui>Print…</gui></p></td>
<td><p><keyseq><key>Ctrl</key><key>P</key></keyseq></p></td>
-<td><p>Print the current document</p></td>
+<td><p>Prints the current document. Present the user with a dialog allowing them to set options like the
page range to be printed, the printer to be used, and so on. The dialog must contain a button labelled
<gui>Print</gui> that starts printing and closes the dialog.</p></td>
+</tr>
+<tr>
+<td><p><gui>Send To…</gui></p></td>
+<td><p><keyseq><key>Ctrl</key><key>M</key></keyseq></p></td>
+<td><p>Provides the user a means to attach or send the current document as an email or email attachment,
depending on its format. You may provide more than one <gui>Send</gui> item depending on which options are
available. If there are more than two such items, move them into a submenu. For example, if only <gui>Send by
Email</gui> and <gui>Send by Bluetooth</gui> are available, leave them on the top-level menu If there is a
third option, such as <gui>Send by FTP</gui>, place all the options in a Send submenu.</p></td>
+</tr>
+<tr>
+<td><p><gui>Properties…</gui></p></td>
+<td><p><keyseq><key>Alt</key><key>Return</key></keyseq></p></td>
+<td><p>Opens the document’s <gui>Properties</gui> window. This may contain editable information, such as the
document author’s name, or read-only information, such as the number of words in the document, or a
combination of both. The <keyseq><key>Alt</key><key>Return</key></keyseq> shortcut should not be provided
where <key>Return</key> is most frequently used to insert a new line.</p></td>
</tr>
<tr>
<td><p><gui>Close</gui></p></td>
<td><p><keyseq><key>Ctrl</key><key>W</key></keyseq></p></td>
-<td><p>Close the current document</p></td>
+<td><p>Closes the current content item or tab. If there are unsaved changes, present the user with a
confirmation alert giving the option to save changes, discard them, or cancel the action without closing or
saving the document.</p></td>
</tr>
</tbody>
</table>
@@ -300,26 +367,58 @@ Do not assign system-level shortcut keys. These use the Super key (sometimes kno
</section>
<section id="edit">
-<title>Standard edit shortcuts</title>
+<title>Edit</title>
+
+<p>Standard edit keyboard shortcuts and menu items.</p>
<table>
<thead>
<tr>
-<td><p>Function</p></td>
+<td><p>Label</p></td>
<td><p>Shortcut</p></td>
<td><p>Description</p></td>
</tr>
</thead>
<tbody>
<tr>
-<td><p><gui>Undo</gui></p></td>
+<td><p><gui>Undo <em>action</em></gui></p></td>
<td><p><keyseq><key>Ctrl</key><key>Z</key></keyseq></p></td>
-<td><p>Undo the last operation</p></td>
+<td><p>Reverts the effect of the previous action.</p></td>
</tr>
<tr>
-<td><p><gui>Redo</gui></p></td>
+<td><p><gui>Redo <em>action</em></gui></p></td>
<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Z</key></keyseq></p></td>
-<td><p>Redo the last operation</p></td>
+<td><p>Performs the next action in the undo history list, after the user has moved backwards through the
list with the <gui>Undo</gui> command.</p></td>
+</tr>
+<tr>
+<td><p><gui>Cut</gui></p></td>
+<td><p><keyseq><key>Ctrl</key><key>X</key></keyseq></p></td>
+<td><p>Removes the selected content and places it onto the clipboard. Visually, remove the content from the
document in the same manner as <gui>Delete</gui>.</p></td>
+</tr>
+<tr>
+<td><p><gui>Copy</gui></p></td>
+<td><p><keyseq><key>Ctrl</key><key>C</key></keyseq></p></td>
+<td><p>Copies the selected content onto the clipboard.</p></td>
+</tr>
+<tr>
+<td><p><gui>Paste</gui></p></td>
+<td><p><keyseq><key>Ctrl</key><key>V</key></keyseq></p></td>
+<td><p>Inserts the contents of the clipboard into the content item. When editing text, if there is no
current selection, use the caret as the insertion point. If there is a current selection, replace it with the
clipboard contents.</p></td>
+</tr>
+<tr>
+<td><p><gui>Paste Special…</gui></p></td>
+<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>V</key></keyseq></p></td>
+<td><p>Inserts a non-default representation of the clipboard contents. Open a dialog presenting a list of
the available formats from which the user can select. For example, if the clipboard contains a PNG file
copied from a file manager, the image may be embedded in the document, or a link to the file inserted so that
changes to the image on disk are always reflected in the document.</p></td>
+</tr>
+<tr>
+<td><p><gui>Duplicate</gui></p></td>
+<td><p><keyseq><key>Ctrl</key><key>U</key></keyseq></p></td>
+<td><p>Creates a duplicate copy of the selected object.</p></td>
+</tr>
+<tr>
+<td><p><gui>Delete</gui></p></td>
+<td><p><key>Delete</key></p></td>
+<td><p>Removes the selected content without placing it on the clipboard.</p></td>
</tr>
<tr>
<td><p><gui>Select All</gui></p></td>
@@ -329,72 +428,176 @@ Do not assign system-level shortcut keys. These use the Super key (sometimes kno
<tr>
<td><p><gui>Deselect All</gui></p></td>
<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>A</key></keyseq></p></td>
-<td><p>Deselects all content in the current document.</p></td>
+<td><p>Deselects all content in the current document. Only provide this item in situations when no other
method of undoing selection is possible or apparent to the user. For example, in complex graphics
applications where selection and deselection is not usually possible simply by using the cursor keys. Note:
Do not provide <gui>Deselect All</gui> in text entry fields, as
<keyseq><key>Shift</key><key>Ctrl</key><key>hex</key></keyseq> digit is used to enter unicode characters so
its shortcut will not work.</p></td>
+</tr>
+<tr>
+<td><p><gui>Find…</gui></p></td>
+<td><p><keyseq><key>Ctrl</key><key>F</key></keyseq></p></td>
+<td><p>Displays a user interface for allowing the user to search for specific content in the current content
item or page.</p></td>
+</tr>
+<tr>
+<td><p><gui>Find Next</gui></p></td>
+<td><p><keyseq><key>Ctrl</key><key>G</key></keyseq></p></td>
+<td><p>Selects the next instance of the last Find term in the current document.</p></td>
+</tr>
+<tr>
+<td><p><gui>Find Previous</gui></p></td>
+<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>G</key></keyseq></p></td>
+<td><p>Selects the previous instance of the last <gui>Find</gui> term in the current document.</p></td>
+</tr>
+<tr>
+<td><p><gui>Replace…</gui></p></td>
+<td><p><keyseq><key>Ctrl</key><key>H</key></keyseq></p></td>
+<td><p>Displays a user interface allowing the user to find specific content and replace each
occurrence.</p></td>
</tr>
-
</tbody>
</table>
-<p>If your application requires both <guiseq><gui>Edit</gui><gui>Find</gui></guiseq> and
<guiseq><gui>Edit</gui><gui>Search</gui></guiseq> menu items, use
<keyseq><key>Shift</key><key>Ctrl</key><key>F</key></keyseq> as the shortcut for <gui>Search</gui>.</p>
-
</section>
<section id="view">
-<title>Standard view shortcuts</title>
+<title>View</title>
+
+<p>View keyboard shortcuts and menu items.</p>
<table>
<thead>
<tr>
-<td><p>Function</p></td>
+<td><p>Label</p></td>
<td><p>Shortcut</p></td>
<td><p>Description</p></td>
</tr>
</thead>
<tbody>
<tr>
+<td><p><gui>Icons</gui></p></td>
+<td><p>None</p></td>
+<td><p>Shows content as a grid of icons. This is a radio button menu item.</p></td>
+</tr>
+<tr>
+<td><p><gui>List</gui></p></td>
+<td><p>None</p></td>
+<td><p>Shows content as a list. This is a radio button menu item.</p></td>
+</tr>
+<tr>
+<td><p><gui>Sort By…</gui></p></td>
+<td><p>None</p></td>
+<td><p>Specifies the criteria by which content should be sorted. Can open a preference dialog, popover, or
sub-menu.</p></td>
+</tr>
+<tr>
+<td><p><gui>Filter…</gui></p></td>
+<td><p>None</p></td>
+<td><p>Allows content to be filtered, by opening a popover, drop down, or dialog.</p></td>
+</tr>
+<tr>
<td><p><gui>Zoom In</gui></p></td>
<td><p><keyseq><key>Ctrl</key><key>+</key></keyseq></p></td>
-<td><p>Zoom in on the document</p></td>
+<td><p>Zooms in, making content appear larger.</p></td>
</tr>
<tr>
<td><p><gui>Zoom Out</gui></p></td>
<td><p><keyseq><key>Ctrl</key><key>-</key></keyseq></p></td>
-<td><p>Zoom out of the document</p></td>
+<td><p>Zooms out, making content appear smaller.</p></td>
</tr>
<tr>
<td><p><gui>Normal Size</gui></p></td>
<td><p><keyseq><key>Ctrl</key><key>0</key></keyseq></p></td>
-<td><p>Restore the zoom level to the normal size (generally 100%)</p></td>
+<td><p>Resets the zoom level back to the default value.</p></td>
+</tr>
+<tr>
+<td><p><gui>Best Fit</gui></p></td>
+<td><p>None</p></td>
+<td><p>Makes the document fill the window.</p></td>
</tr>
<tr>
<td><p><gui>Reload</gui></p></td>
<td><p><keyseq><key>Ctrl</key><key>R</key></keyseq></p></td>
-<td><p>Reload the current document, updating content from the source if necessary</p></td>
+<td><p>Redraws the current view of the document, checking the data source for changes first. For example,
checks the web server for updates to the page before redrawing it.</p></td>
+</tr>
+</tbody>
+</table>
+
+</section>
+
+<section id="format">
+<title>Format</title>
+
+<p>Standard format keyboard shortcuts and menu items.</p>
+
+<table>
+<thead>
+<tr>
+<td><p>Label</p></td>
+<td><p>Shortcut</p></td>
+<td><p>Description</p></td>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><p><gui>Style…</gui></p></td>
+<td><p>None</p></td>
+<td><p>Sets the style attributes of the selected text or objects either individually or to a named,
predefined style.</p></td>
+</tr>
+<tr>
+<td><p><gui>Font…</gui></p></td>
+<td><p>None</p></td>
+<td><p>Sets the font properties of the selected text or objects.</p></td>
+</tr>
+<tr>
+<td><p><gui>Paragraph…</gui></p></td>
+<td><p>None</p></td>
+<td><p>Sets the properties of the selected paragraph.</p></td>
+</tr>
+<tr>
+<td><p><gui>Bold</gui></p></td>
+<td><p><keyseq><key>Ctrl</key><key>B</key></keyseq></p></td>
+<td><p>Toggles the boldness of the current text selection. If some of the selection is currently bold and
some is not, this command should bolden the selected text.</p></td>
+</tr>
+<tr>
+<td><p><gui>Italic</gui></p></td>
+<td><p><keyseq><key>Ctrl</key><key>I</key></keyseq></p></td>
+<td><p>Toggles the italicisation of the current text selection on or off. If some of the selection is
currently italicized and some is not, this command should italicise the selected text.</p></td>
+</tr>
+<tr>
+<td><p><gui>Underline</gui></p></td>
+<td><p><keyseq><key>Ctrl</key><key>U</key></keyseq></p></td>
+<td><p>Toggles underlining of the current text selection. If some of the selection is currently underlined
and some is not, this command should underline the selected text.
+</p></td>
+</tr>
+<tr>
+<td><p><gui>Cells…</gui></p></td>
+<td><p>None</p></td>
+<td><p>Sets the properties of the selected table cells.</p></td>
+</tr>
+<tr>
+<td><p><gui>List…</gui></p></td>
+<td><p>None</p></td>
+<td><p>Sets the properties of the selected list, or turns the selected paragraphs into a list if they are
not already formatted as such.</p></td>
</tr>
<tr>
-<td><p><gui>Properties</gui></p></td>
-<td><p><keyseq><key>Alt</key><key>Enter</key></keyseq></p></td>
-<td><p>Display the selected object’s properties window.</p></td>
+<td><p><gui>Layer…</gui></p></td>
+<td><p>None</p></td>
+<td><p>Sets the properties of all or selected layers of a multi-layered document.</p></td>
</tr>
<tr>
-<td><p><gui>Sidebar</gui></p></td>
-<td><p><key>F9</key></p></td>
-<td><p>Toggle the visibility of a sidebar, if there is one that can be toggled.</p></td>
+<td><p><gui>Page…</gui></p></td>
+<td><p>None</p></td>
+<td><p>Sets the properties of all or selected pages of the document.</p></td>
</tr>
</tbody>
</table>
-<p>If your application requires both <guiseq><gui>View</gui><gui>Reload</gui></guiseq> and
<guiseq><gui>View</gui><gui>Refresh</gui></guiseq> menu items, use
<keyseq><key>Shift</key><key>Ctrl</key><key>R</key></keyseq> as the shortcut for <gui>Reload</gui>.</p>
-
</section>
<section id="bookmarks">
-<title>Standard bookmark shortcuts</title>
+<title>Bookmarks</title>
+
+<p>Standard bookmark keyboard shortcuts and menu items.</p>
<table>
<thead>
<tr>
-<td><p>Function</p></td>
+<td><p>Label</p></td>
<td><p>Shortcut</p></td>
<td><p>Description</p></td>
</tr>
@@ -403,27 +606,32 @@ Do not assign system-level shortcut keys. These use the Super key (sometimes kno
<tr>
<td><p><gui>Add Bookmark</gui></p></td>
<td><p><keyseq><key>Ctrl</key><key>D</key></keyseq></p></td>
-<td><p>Add a bookmark for the current location</p></td>
+<td><p>Adds a bookmark for the current location. Do not pop up a dialog asking for a title or location for
the bookmark, instead choose sensible defaults (such as the document’s title or filename as the bookmark
name) and allow the user to change them later using the <gui>Edit Bookmarks</gui> feature.</p></td>
</tr>
<tr>
-<td><p><gui>Edit Bookmarks…</gui></p></td>
+<td><p><gui>Edit Bookmarks</gui></p></td>
<td><p><keyseq><key>Ctrl</key><key>B</key></keyseq></p></td>
-<td><p>Open a window in which the user can edit and organize saved bookmarks</p></td>
+<td><p>Allows the user to edit their bookmarks.</p></td>
+</tr>
+<tr>
+<td><p>Bookmark List</p></td>
+<td><p>None</p></td>
+<td><p>Displays the user’s bookmarks.</p></td>
</tr>
</tbody>
</table>
-<p>If your application requires both <guiseq><gui>Format</gui><gui>Bold</gui></guiseq> and
<guiseq><gui>Bookmarks</gui><gui>Edit Bookmarks…</gui></guiseq> menu items, use
<keyseq><key>Shift</key><key>Ctrl</key><key>D</key></keyseq> as the shortcut for <gui>Edit
Bookmarks</gui>.</p>
-
</section>
-<section id="navigation">
-<title>Standard navigation shortcut keys</title>
+<section id="go">
+<title>Go</title>
+
+<p>Standard navigation keyboard shortcuts and <gui>Go</gui> menu items.</p>
<table>
<thead>
<tr>
-<td><p>Function</p></td>
+<td><p>Label</p></td>
<td><p>Shortcut</p></td>
<td><p>Description</p></td>
</tr>
@@ -432,65 +640,91 @@ Do not assign system-level shortcut keys. These use the Super key (sometimes kno
<tr>
<td><p><gui>Back</gui></p></td>
<td><p><keyseq><key>Alt</key><key>Left</key></keyseq></p></td>
-<td><p>Go to the previous location in the navigation chain</p></td>
+<td><p>Navigates to the previous location.</p></td>
</tr>
<tr>
-<td><p><gui>Next</gui></p></td>
+<td><p><gui>Forward</gui></p></td>
<td><p><keyseq><key>Alt</key><key>Right</key></keyseq></p></td>
-<td><p>Go to the next location in the navigation chain</p></td>
+<td><p>Navigates to the next location in the navigation history.</p></td>
</tr>
<tr>
<td><p><gui>Up</gui></p></td>
<td><p><keyseq><key>Alt</key><key>Up</key></keyseq></p></td>
-<td><p>Go up one level in the navigation hierarchy</p></td>
+<td><p>Navigates to the parent content item, document, page or section.</p></td>
</tr>
<tr>
-<td><p><gui>Home</gui></p></td>
+<td><p><gui>Up</gui></p></td>
<td><p><keyseq><key>Alt</key><key>Home</key></keyseq></p></td>
-<td><p>Go to the starting point</p></td>
+<td><p>Navigates to a starting page defined by the user or the application.</p></td>
</tr>
<tr>
<td><p><gui>Location…</gui></p></td>
<td><p><keyseq><key>Ctrl</key><key>L</key></keyseq></p></td>
-<td><p>Present or focus an entry field into which the user can type a new address or location</p></td>
+<td><p>Allows the user to specify a URI to navigate to.</p></td>
+</tr>
+<tr>
+<td><p><gui>Previous Page</gui></p></td>
+<td><p><key>PageUp</key></p></td>
+<td><p>Navigates to the previous page in the document.</p></td>
+</tr>
+<tr>
+<td><p><gui>Next Page</gui></p></td>
+<td><p><key>PageDown</key></p></td>
+<td><p>Navigates to the next page in the document.</p></td>
+</tr>
+<tr>
+<td><p><gui>Go to Page…</gui></p></td>
+<td><p>None</p></td>
+<td><p>Allows the user to specify a page number to be navigated to. Text-based applications may also include
a <gui>Go to Line…</gui> menu item, which allows the user to jump to a specified line number.</p></td>
+</tr>
+<tr>
+<td><p><gui>First Page</gui></p></td>
+<td><p><keyseq><key>Ctrl</key><key>Home</key></keyseq></p></td>
+<td><p>Navigates to the first page in the document.</p></td>
+</tr>
+<tr>
+<td><p><gui>Last Page</gui></p></td>
+<td><p><keyseq><key>Ctrl</key><key>End</key></keyseq></p></td>
+<td><p>Navigates to the last page in the document.</p></td>
</tr>
</tbody>
</table>
</section>
-<section id="format">
-<title>Standard format shortcut keys</title>
+<section id="windows">
+<title>Windows</title>
+
+<p>Standard <gui>Windows</gui> menu items.</p>
<table>
<thead>
<tr>
-<td><p>Function</p></td>
+<td><p>Label</p></td>
<td><p>Shortcut</p></td>
<td><p>Description</p></td>
</tr>
</thead>
<tbody>
<tr>
-<td><p><gui>Bold</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>B</key></keyseq></p></td>
-<td><p>Make selected text bold/regular</p></td>
+<td><p><gui>Save All</gui></p></td>
+<td><p>None</p></td>
+<td><p>Saves all open documents. If any documents have no current filename, prompt for a filename for each
one in turn using the standard <gui>Save</gui> dialog.</p></td>
</tr>
<tr>
-<td><p><gui>Underline</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>U</key></keyseq></p></td>
-<td><p>Underline/remove underline from selected text</p></td>
+<td><p><gui>Close All</gui></p></td>
+<td><p>None</p></td>
+<td><p>Closes all open documents. If there are any unsaved changes in any documents, post a confirmation
alert for each one in turn.</p></td>
</tr>
<tr>
-<td><p><gui>Italic</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>I</key></keyseq></p></td>
-<td><p>Make selected text italic/regular</p></td>
+<td><p>List of windows</p></td>
+<td><p>None</p></td>
+<td><p>Each menu item raises the corresponding window to the top of the window stack.</p></td>
</tr>
</tbody>
</table>
</section>
-
</section>
</page>
diff --git a/hig/C/menu-bars.page b/hig/C/menu-bars.page
index f77f504..f566820 100644
--- a/hig/C/menu-bars.page
+++ b/hig/C/menu-bars.page
@@ -37,772 +37,64 @@
</section>
-<section id="general-guidelines">
-<title>General guidelines</title>
-
-<list>
-<item><p>The menubar is normally visible at all times and is always accessible from the keyboard, so make
all the commands available in your application available on the menubar. (This guideline is unique to menu
bars - other menus should not seek to reproduce functionality that is made available by other
controls).</p></item>
-<item><p>Treat <link xref="application-menus">application menus</link> as part of the menu bar - it is not
necessary to reproduce items from the application menu in other menus.</p></item>
-<item><p>Do not disable menu titles. Allow the user to explore the menu, even though there might be no
available items on it at that time.</p></item>
-<item><p>Menu titles on a menubar are single words with their first letter capitalized. Do not use spaces in
menu titles, as this makes them easily-mistaken for two separate menu titles. Do not use compound words (such
as <gui>WindowOptions</gui>) or hyphens (such as <gui>Window-Options</gui>) to circumvent this
guideline.</p></item>
-<item><p>Do not provide a mechanism for hiding the menubar, as this may be activated accidentally. Some
users will not be able to figure out how to get the menu bar back in this case.</p></item>
-</list>
-
-</section>
-
<section id="standard-menus">
<title>Standard menus</title>
-<p>This section details the most common menus and menu items in a menu bar.</p>
-
-<section id="file">
-<title>File</title>
-
-<p>The <gui>File</gui> menu contains commands that operate on the current document. It is the left-most item
in the menubar because of its importance and frequency of use, and because it is a relevant menu in many
applications. Historically, because most applications already had this menu, and because the distinction
between closing documents and closing windows became blurred over time, the <gui>File</gui> menu has also
become the standard location for <gui>Quit</gui>.</p>
-
-<p>The items on the <gui>File</gui> menu are generally ordered by locality, closest first. That is, items to
save or load from file, followed by printing, followed by sending to a remote user. Try to maintain this
ordering if you have to add new items to the menu.</p>
-
-<p>If your application does not operate on documents, name this item for the type of object it displays. For
example, many games should have a <gui>Game</gui> instead of a <gui>File</gui> menu. However, place the
<gui>Quit</gui> menu item last on this menu nonetheless.</p>
-
-<section id="creation-and-opening-menu-items">
-<title>Creation and opening operation menu items</title>
-
-<table>
-<thead>
-<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><p><gui>New</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>N</key></keyseq></p></td>
-<td><p>Creates a new document. Open a new primary window, with the title <gui>Document name</gui>,
containing a blank document. How this window is displayed, eg: as a tab or a separate window, is up to the
window manager.</p>
-<p>If your application can create a number of different types of document, you can make the <gui>New</gui>
item a submenu, containing a menu item for each type. Label these items <gui>New</gui> document type, make
the first entry in the submenu the most commonly used document type, and give it the
<keyseq><key>Ctrl</key><key>N</key></keyseq> shortcut.</p>
-<p>Note: A blank document will not necessarily be completely blank. For example, a document created from a
template may already contain some data.</p></td>
-</tr>
-<tr>
-<td><p><gui>Open…</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>O</key></keyseq></p></td>
-<td><p>Opens an existing document in a new window. Present the user with a standard <gui>Open File</gui>
dialog from which they can choose an existing file. If the chosen file is already open in the application,
raise that window instead of opening a new one.</p></td>
-</tr>
-</tbody>
-</table>
-
-</section>
-
-<section id="saved-state-operations">
-<title>Saved state operation menu items</title>
-
-<table>
-<thead>
-<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><p><gui>Save</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>S</key></keyseq></p></td>
-<td><p>Saves the document with its current filename. If the document already has a filename associated with
it, save the document immediately without any further interaction from the user. If there are any additional
options involved in saving a file (eg. DOS or UNIX-style line endings in a text file), prompt for these first
time the document is saved, but subsequently use the same values each time until the user changes them. If
the document has no current filename or is read-only, selecting this item should be the same as selecting
<gui>Save As</gui>.</p></td>
-</tr>
-<tr>
-<td><p><gui>Save As…</gui></p></td>
-<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>S</key></keyseq></p></td>
-<td><p>Saves the document with a new filename. Present the user with the standard <gui>Save As</gui> dialog,
and save the file with the chosen file name.</p></td>
-</tr>
-<tr>
-<td><p><gui>Save a Copy…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Prompts the user to enter a filename, with which a copy of the document is then saved. Do not alter
either the view or the filename of the original document. All subsequent changes are still made to the
original document until the user specifies otherwise, for example by choosing the <gui>Save As</gui>
command.</p>
-<p>Like the <gui>Save As</gui> dialog, the <gui>Save a Copy</gui> dialog may present different ways to save
the data. For example, an image may be saved in a native format or as a PNG.</p></td>
-</tr>
-<tr>
-<td><p><gui>Revert</gui></p></td>
-<td><p>None</p></td>
-<td><p>Reverts the document to the last saved state. Present the user with a warning that all changes will
be lost, and offer the option of cancelling before reloading the file.</p></td>
-</tr>
-<tr>
-<td><p><gui>Save Version</gui></p></td>
-<td><p>None</p></td>
-<td><p>An alternative to the <gui>Save a Copy</gui> command. Only use this item in conjunction with the
<gui>Restore Version</gui> command.</p></td>
-</tr>
-<tr>
-<td><p><gui>Restore Version…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Prompts the user for a version of the current document to be restored. Present the user with with a
warning that all changes will be lost, and offer the option of cancelling before restoring the version. Only
use this item in conjunction with the <gui>Save Version</gui> command.</p></td>
-</tr>
-<tr>
-<td><p><gui>Versions…</gui></p></td>
-<td><p>None</p></td>
-<td><p>An alternative to the <gui>Save Version</gui> and <gui>Restore Version</gui> commands. Use this when
more utilities, such as a diff, are available.</p></td>
-</tr>
-</tbody>
-</table>
-
-</section>
-
-<section id="export-operations">
-<title>Export operations menu items</title>
+<p>This section details the most common menus and menu items in a menu bar. For details on the standard
items to include in each of these menus, see <link xref="keyboard-input#application-shortcuts">keyboard
input</link>.</p>
<table>
-<thead>
-<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><p><gui>Page Setup</gui></p></td>
-<td><p>None</p></td>
-<td><p>Allows the user to control print-related settings. Present the user with a dialog allowing the user
to set such options as portrait or landscape format, margins, and so on.</p></td>
-</tr>
<tr>
-<td><p><gui>Print Preview</gui></p></td>
-<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Ctrl</key><key>P</key></keyseq></p></td>
-<td><p>Shows the user what the printed document will look like. Present a new window containing an accurate
representation of the appearance of the document as it would be printed. The libgnomeprintui library provides
a standard <gui>Print Preview</gui> window that you should use if possible.</p></td>
+<td><p><gui>File</gui></p></td>
+<td><p>Commands that operate on the current document or content item as a whole. It is the left-most item in
the menubar because of its importance and frequency of use, and because it is a relevant menu in many
applications.</p>
+<p>If your application does not operate on files, name this menu for the type of object it displays. For
example, a music player could have a <gui>Music</gui> instead of a <gui>File</gui> menu.</p></td>
</tr>
<tr>
-<td><p><gui>Print…</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>P</key></keyseq></p></td>
-<td><p>Prints the current document. Present the user with a dialog allowing them to set options like the
page range to be printed, the printer to be used, and so on. The dialog must contain a button labelled
<gui>Print</gui> that starts printing and closes the dialog. The libgnomeprintui library provides a standard
<gui>Print</gui> dialog that you should use if possible.</p></td>
+<td><p><gui>Edit</gui></p></td>
+<td><p>The <gui>Edit</gui> menu contains items relating to editing the document, such as clipboard handling,
find and replace, and inserting objects.</p></td>
</tr>
<tr>
-<td><p><gui>Send To…</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>M</key></keyseq></p></td>
-<td><p>Provides the user a means to attach or send the current document as an email or email attachment,
depending on its format. You may provide more than one <gui>Send</gui> item depending on which options are
available. If there are more than two such items, move them into a submenu. For example, if only <gui>Send by
Email</gui> and <gui>Send by Fax</gui> are available, leave them on the top-level menu If there is a third
option, such as <gui>Send by FTP</gui>, place all the options in a Send submenu.</p></td>
+<td><p><gui>View</gui></p></td>
+<td><p>Includes items that affect the user’s view, such as of the current document or page, or how items are
presented for browsing. Do not place any items on the <gui>View</gui> menu that affect content items.</p></td>
</tr>
-</tbody>
-</table>
-
-</section>
-
-<section id="file-properties">
-<title>File properties menu items</title>
-
-<table>
-<thead>
<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
+<td><p><gui>Insert</gui></p></td>
+<td><p>Lists the types of objects that can be inserted into the current document, such as images, links or
page breaks. Only provide this menu if you have more than about six types of object that can be inserted,
otherwise place individual items for each type on the <gui>Edit</gui> menu.</p></td>
</tr>
-</thead>
-<tbody>
<tr>
-<td><p><gui>Properties…</gui></p></td>
-<td><p><keyseq><key>Alt</key><key>Return</key></keyseq></p></td>
-<td><p>Opens the document’s <gui>Properties</gui> window. This may contain editable information, such as the
document author’s name, or read-only information, such as the number of words in the document, or a
combination of both. The <keyseq><key>Alt</key><key>Return</key></keyseq> shortcut should not be provided
where <key>Return</key> is most frequently used to insert a new line.</p></td>
+<td><p><gui>Format</gui></p></td>
+<td><p>Includes commands to change the visual appearance of the document. For example, changing the font,
color, or line spacing of a text selection.</p>
+<p>The difference between these commands and those on the <gui>View</gui> menu is that changes made with
<gui>Format</gui> commands are persistent and saved as part of the document.</p>
+<p>Items found on the Format menu are very application-specific.</p></td>
</tr>
-</tbody>
-</table>
-
-</section>
-
-<section id="closing-operations">
-<title>Closing operations menu items</title>
-
-<table>
-<thead>
<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
+<td><p><gui>Bookmarks</gui></p></td>
+<td><p>Provide a Bookmarks menu in any application that allows the user to browse files and folders, help
documents, web pages or any other large information space.</p></td>
</tr>
-</thead>
-<tbody>
<tr>
-<td><p><gui>Close</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>W</key></keyseq></p></td>
-<td><p>Closes the current document. If it has unsaved changes, present the user with a confirmation alert
giving the option to save changes, discard them, or cancel the action without closing or saving the
document.</p>
-<p>If the window you are closing is the last open document in the application, the correct action depends on
your application type:</p>
-<list>
-<item><p>Single document interface: close the application</p></item>
-<item><p>Controlled single document interface: leave only the control window open</p></item>
-<item><p>Multiple document interface: close the current document and create a new blank document</p></item>
-</list>
-</td>
+<td><p><gui>Go</gui></p></td>
+<td><p>A <gui>Go</gui> menu provides commands for quickly navigating around a document or collection of
documents, or an information space such as a directory structure or the web.</p>
+<p>The contents of the menu will vary depending on the type of application.</p></td>
</tr>
<tr>
-<td><p><gui>Quit</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>Q</key></keyseq></p></td>
-<td><p>Closes the application, including all application windows. If there are unsaved changes in any open
documents, present the user with a confirmation alert for each affected document, giving the option to save
the changes, discard them, or cancel. If there are no unsaved changes, close the application immediately
without presenting any further messages or dialogs.</p>
-<p>In particular, non-document based applications, for example a game or a calculator, should save their
state and exit immediately. This state should be restored the next time the application is started.</p></td>
+<td><p><gui>Windows</gui></p></td>
+<td><p>Commands that apply to all of the application’s open windows. You may also label this menu
<gui>Documents</gui>, <gui>Buffers</gui>, or similar according to the type of document handled by your
application.</p>
+<p>The last items on this menu are a numbered list of the application’s primary windows, for example
<gui>1shoppinglist.abw</gui>. Selecting one of these items raises the corresponding window.</p></td>
</tr>
-</tbody>
</table>
</section>
-</section>
-
-<section id="edit">
-<title>Edit</title>
-<p>The <gui>Edit</gui> menu contains items relating to editing both the document (clipboard handling, search
and replace, and inserting special objects) and the user’s preferences. <gui>Preferences</gui> are edited
here rather than on a <gui>Settings</gui> menu, because:</p>
+<section id="general-guidelines">
+<title>General guidelines</title>
<list>
-<item><p>most applications’ preferences windows are accessed via a single menu item, and single-item menus
offer poor usability</p></item>
-<item><p>most applications already contain a suitable Edit menu.</p></item>
+<item><p>The menubar is normally visible at all times and is always accessible from the keyboard, so make
all the commands available in your application available on the menubar. (This guideline is unique to menu
bars - other menus should not seek to reproduce functionality that is made available by other
controls).</p></item>
+<item><p>Treat <link xref="application-menus">application menus</link> as part of the menu bar - it is not
necessary to reproduce items from the application menu in other menus.</p></item>
+<item><p>Do not disable menu titles. Allow the user to explore the menu, even though there might be no
available items on it at that time.</p></item>
+<item><p>Menu titles on a menubar are single words with their first letter capitalized. Do not use spaces in
menu titles, as this makes them easily-mistaken for two separate menu titles. Do not use compound words (such
as <gui>WindowOptions</gui>) or hyphens (such as <gui>Window-Options</gui>) to circumvent this
guideline.</p></item>
+<item><p>Do not provide a mechanism for hiding the menubar, as this may be activated accidentally. Some
users will not be able to figure out how to get the menu bar back in this case.</p></item>
</list>
-<section id="modification-history">
-<title>Modification history menu items</title>
-
-<p>Document-based applications should maintain a history of modifications to a document and the state of the
document between each action. The Undo and Redo commands move backwards and forwards through this history.</p>
-
-<table>
-<thead>
-<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><p><gui>Undo <em>action</em></gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>Z</key></keyseq></p></td>
-<td><p>Undoes the effect of the previous action in the undo history list. Revert the document to its state
before the previous action was performed. If your application supports undo, and the user undoes all changes
since it was last saved, treat the document as unmodified. Note: provide a separate <gui>Undo</gui> and
<gui>Redo</gui> menu item even if your application only supports one level of undo.</p></td>
-</tr>
-<tr>
-<td><p><gui>Redo <em>action</em></gui></p></td>
-<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Z</key></keyseq></p></td>
-<td><p>Performs the next action in the undo history list, after the user has moved backwards through the
list with the <gui>Undo</gui> command. Move the user one step forwards again, restoring the document to the
state it was in after that action was originally performed.</p>
-<p>Note: provide a separate <gui>Undo</gui> and <gui>Redo</gui> menu item even if your application only
supports one level of undo.</p></td>
-</tr>
-</tbody>
-</table>
-
-</section>
-
-<section id="selected-data-manipulation-menu-items">
-<title>Selected data manipulation menu items</title>
-
-<table>
-<thead>
-<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><p><gui>Cut</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>X</key></keyseq></p></td>
-<td><p>Removes the selected content and places it onto the clipboard. Visually, remove the content from the
document in the same manner as <gui>Delete</gui>.</p></td>
-</tr>
-<tr>
-<td><p><gui>Copy</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>C</key></keyseq></p></td>
-<td><p>Copies the selected content onto the clipboard.</p></td>
-</tr>
-<tr>
-<td><p><gui>Paste</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>V</key></keyseq></p></td>
-<td><p>Inserts the contents of the clipboard into the document. If there is no current selection, use the
caret as the insertion point. If there is a current selection, replace it with the clipboard
contents.</p></td>
-</tr>
-<tr>
-<td><p><gui>Paste Special…</gui></p></td>
-<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>V</key></keyseq></p></td>
-<td><p>Inserts a non-default representation of the clipboard contents into the document. Open a dialog
presenting a list of the available formats from which the user can select. For example, if the clipboard
contains a PNG file copied from a file manager, the image may be embedded in the document, or a link to the
file inserted so that changes to the image on disk are always reflected in the document.</p></td>
-</tr>
-<tr>
-<td><p><gui>Duplicate</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>U</key></keyseq></p></td>
-<td><p>Creates a duplicate copy of the selected object. Do not prompt for a name for the duplicate object,
but give it a sensible default (for example, Copy of ShoppingList.abw) and allow the user to change it later.
Place the duplicate copy as near the original as possible without overlapping it, even if this means breaking
the current sort order within the container, so the user sees it immediately.</p></td>
-</tr>
-<tr>
-<td><p><gui>Delete</gui></p></td>
-<td><p><key>Delete</key></p></td>
-<td><p>Removes the selected content without placing it on the clipboard.</p></td>
-</tr>
-<tr>
-<td><p><gui>Select All</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>A</key></keyseq></p></td>
-<td><p>Selects all content in the current document.</p></td>
-</tr>
-<tr>
-<td><p><gui>Deselect All</gui></p></td>
-<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>A</key></keyseq></p></td>
-<td><p>Deselects all content in the current document. Only provide this item in situations when no other
method of undoing selection is possible or apparent to the user. For example, in complex graphics
applications where selection and deselection is not usually possible simply by using the cursor keys. Note:
Do not provide <gui>Deselect All</gui> in text entry fields, as
<keyseq><key>Shift</key><key>Ctrl</key><key>hex</key></keyseq> digit is used to enter unicode characters so
its shortcut will not work.</p></td>
-</tr>
-</tbody>
-</table>
-
-</section>
-
-<section id="searching-and-replacing">
-<title>Searching and replacing menu items</title>
-
-<table>
-<thead>
-<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><p><gui>Find…</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>F</key></keyseq></p></td>
-<td><p>Opens a window or dialog allowing the user to search for specific content in the current document.
Highlight each match in-place. If the command allows the user to search for content in places other than the
current document, for example other open documents, other documents on disk, or a remote network location,
label this item <gui>Search</gui> instead of <gui>Find</gui>.</p></td>
-</tr>
-<tr>
-<td><p><gui>Find Next</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>G</key></keyseq></p></td>
-<td><p>Selects the next instance of the last Find term in the current document.</p></td>
-</tr>
-<tr>
-<td><p><gui>Find Previous</gui></p></td>
-<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>G</key></keyseq></p></td>
-<td><p>Selects the previous instance of the last <gui>Find</gui> term in the current document.</p></td>
-</tr>
-<tr>
-<td><p><gui>Replace…</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>H</key></keyseq></p></td>
-<td><p>Opens a window or dialog allowing the user to search for specific content in the current document,
and replace each occurrence with new content.</p></td>
-</tr>
-</tbody>
-</table>
-
-</section>
-
-<section id="inserting-special-objects">
-<title>Inserting special objects</title>
-
-<p>Where applicable, provide items on the <gui>Edit</gui> menu that insert special objects such as images,
links, GUI controls or the current date and time.</p>
-
-<p>If you have up to three types of object that can be inserted, add them as individual items to this menu,
for example <gui>Insert Image</gui>, or <gui>Insert External Link</gui>. If you have between three and six
types, place them on an <guiseq><gui>Edit</gui><gui>Insert</gui></guiseq> submenu. If you have more than six,
add a separate <gui>Insert</gui> menu to the menubar.</p>
-
-</section>
-
-</section>
-
-<section id="view">
-<title>View</title>
-
-<p>The <gui>View</gui> menu contains only items that affect the user’s view of the current document. Do not
place any items on the <gui>View</gui> menu that affect the content of the current document. (Exception:
<guiseq><gui>View</gui><gui>Reload</gui></guiseq> may change the current contents if, for example, the
document is a webpage that has been recently updated on the server).</p>
-
-<table>
-<thead>
-<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><p><gui>Icons</gui></p></td>
-<td><p>None</p></td>
-<td><p>Shows the contents of the selected container as rows and columns of large icons, each with its name
underneath. This is a radio button menu item.</p></td>
-</tr>
-<tr>
-<td><p><gui>List</gui></p></td>
-<td><p>None</p></td>
-<td><p>Shows the contents of the selected container as a list of small icons, possibly in multiple columns,
each with its name on its right-hand side. This is a radio button menu item.</p></td>
-</tr>
-<tr>
-<td><p><gui>Details</gui></p></td>
-<td><p>None</p></td>
-<td><p>Shows the contents of the selected container as single column of small icons, each with its name on
its right-hand side. Additional columns give extra information about the object each icon represents, for
example the size and modification date of files in a file manager. This is a radio button menu item.</p>
-<p>If your application has no need for both <gui>List</gui> and <gui>Details</gui> modes, use the List item
for whichever of the two modes you support.</p></td>
-</tr>
-<tr>
-<td><p><gui>Sort By…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Sorts the contents of a container by user-specified criteria. Open a dialog allowing the user to
choose from pre-defined sort keys (for example, Name, Size, or Modification Date in a file manager), or to
specify their own if applicable.</p></td>
-</tr>
-<tr>
-<td><p><gui>Filter…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Hides objects that are not of interest to the user. Open a dialog allowing the user to choose from a
list of types of object they want to display, or to enter their own criteria (for example, a regular
expression matched against a particular property of the objects).</p></td>
-</tr>
-<tr>
-<td><p><gui>Zoom In</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>+</key></keyseq></p></td>
-<td><p>Zooms into the document. Make the center of the new view the same as the center of the previous
view.</p></td>
-</tr>
-<tr>
-<td><p><gui>Zoom Out</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>-</key></keyseq></p></td>
-<td><p>Zooms out of the document. Make the center of the new view the same as the center of the previous
view.</p></td>
-</tr>
-<tr>
-<td><p><gui>Normal Size</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>0</key></keyseq></p></td>
-<td><p>Resets the zoom level back to the default value, normally 100%. Make the center of the new view the
same as the center of the previous view.</p></td>
-</tr>
-<tr>
-<td><p><gui>Best Fit</gui></p></td>
-<td><p>None</p></td>
-<td><p>Makes the document fill the window. Show the document, or the current page of the document, at as
high a zoom level as will fit in the window whilst allowing the whole document or page to be visible without
scrolling.</p></td>
-</tr>
-<tr>
-<td><p><gui>Refresh</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>R</key></keyseq></p></td>
-<td><p>Redraws the current view of the document from local storage. For example, in a web browser
application, this would redraw the page from the browser page cache.</p></td>
-</tr>
-<tr>
-<td><p><gui>Reload</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>R</key></keyseq></p></td>
-<td><p>Redraws the current view of the document, checking the data source for changes first. For example,
checks the web server for updates to the page before redrawing it. If your application requires both
<gui>Reload</gui> and <gui>Refresh</gui>, use <keyseq><key>Shift</key><key>Ctrl</key><key>R</key></keyseq> as
the shortcut for <gui>Reload</gui>.</p></td>
-</tr>
-</tbody>
-</table>
-
-</section>
-
-<section id="insert">
-<title>Insert</title>
-
-<p>The <gui>Insert</gui> menu lists the type of special objects that can be inserted into the document at
the current caret position, for example images, links, page breaks or GUI objects. Only provide this menu if
you have more than about six types of object that can be inserted, otherwise place individual items for each
type on the <gui>Edit</gui> menu.</p>
-
-<p>The types of object will vary between applications, but the table below shows some common types that may
be applicable.</p>
-
-<table>
-<thead>
-<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><p><gui>Page Break</gui></p></td>
-<td><p>None</p></td>
-<td><p>Inserts a page break at the caret position. Show the page break visually, for example as a dotted
line across the page, unless the user has specifically requested not to see them.</p></td>
-</tr>
-<tr>
-<td><p><gui>Date and Time…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Inserts the current date and/or time at the caret position. Open a dialog giving a choice of date and
time formats. If applicable, also offer the choice to insert either as plain text, so the specified date and
time will always appear in the document, or as a special field that will updated every time the document is
opened, refreshed or printed.</p></td>
-</tr>
-<tr>
-<td><p><gui>Symbol…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Inserts a special symbol, such as a mathematical symbol or foreign character, at the caret position.
Open a dialog showing all the available symbols as a table, from which the user can choose. The user must be
able to add multiple symbols to the document at one time without having to close and re-open the
dialog.</p></td>
-</tr>
-<tr>
-<td><p><gui>Sheet…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Adds a new sheet to the current workbook. Do not prompt for a name, but choose a sensible default
(such as <gui>Sheet-2</gui>) and allow the user to change it later.</p></td>
-</tr>
-<tr>
-<td><p><gui>Rows…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Adds new rows to a table in which one or more rows or cells are currently selected. Open a dialog
asking whether to insert rows above or below the current selection, and for any other required information.
Copy the row format from the last or first row of the current selection respectively, unless the user
specifies otherwise.</p></td>
-</tr>
-<tr>
-<td><p><gui>Columns…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Adds new columns to a table in which one or more columns or cells are currently selected. Open a
dialog asking whether to insert columns to the left or right of the current selection, and for any other
required information. Copy the column format from the right- or left-most column of the current selection
respectively, unless the user specifies otherwise.</p></td>
-</tr>
-<tr>
-<td><p><gui>Image…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Inserts an image into the document from a file. Present a standard Open File dialog filtered on
acceptable file types, from which the user can choose an image file to insert.</p></td>
-</tr>
-<tr>
-<td><p><gui>Graph…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Inserts a graph into the document. Open a dialog or assistant that allows the user to build (or open
from a file) a graph of their choice, using the current selection as an indication of which values, axis
labels and data labels to use.</p></td>
-</tr>
-<tr>
-<td><p><gui>From File…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Inserts an object from any acceptable file type, for example plain text, formatted text, or an image.
Present a standard Open File dialog filtered on acceptable file types, from which the user can choose a file
to insert</p></td>
-</tr>
-<tr>
-<td><p><gui>External Link…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Inserts a link to an object stored in a different file, or on a remote system. The object is not
embedded in or saved with the document, only a link to it. Open a dialog in which the user can type or choose
the name of the object, for example a filename or a webpage URL. Show the link in the document in as
informative way as possible. For example, show a link to an image as a thumbnail of that image, unless the
user specifies otherwise.</p></td>
-</tr>
-</tbody>
-</table>
-
-</section>
-
-<section id="format">
-<title>Format</title>
-
-<p>A <gui>Format</gui> menu contains commands to change the visual appearance of the document. For example,
changing the font, color, or line spacing of a text selection.</p>
-
-<p>The difference between these commands and those on the <gui>View</gui> menu is that changes made with
Format commands are persistent and saved as part of the document, for example as HTML or RTF tags.</p>
-
-<p>Items found on the Format menu will be very application-specific, but some common items are listed in the
table below.</p>
-
-<table>
-<thead>
-<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><p><gui>Style…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Sets the style attributes of the selected text or objects either individually or to a named,
predefined style. Open a dialog allowing the user to set attributes such as bold, italic, size and spacing
individually, and to create their own named styles where applicable.</p></td>
-</tr>
-<tr>
-<td><p><gui>Font…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Sets the font properties of the selected text or objects. Open a dialog allowing the user to choose
font, size, style, color, or whatever other attributes are applicable.</p></td>
-</tr>
-<tr>
-<td><p><gui>Paragraph…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Sets the properties of the selected paragraph. Open a dialog allowing the user to choose style, line
spacing, tabulation, or whatever other attributes are applicable.</p></td>
-</tr>
-<tr>
-<td><p><gui>Bold</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>B</key></keyseq></p></td>
-<td><p>Toggles the boldness of the current text selection on or off. If some of the selection is currently
bold and some is not, this command should bolden the selected text.</p></td>
-</tr>
-<tr>
-<td><p><gui>Italic</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>I</key></keyseq></p></td>
-<td><p>Toggles the italicisation of the current text selection on or off. If some of the selection is
currently italicized and some is not, this command should italicise the selected text.</p></td>
-</tr>
-<tr>
-<td><p><gui>Underline</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>U</key></keyseq></p></td>
-<td><p>Toggles underlining of the current text selection. If some of the selection is currently underlined
and some is not, this command should underline the selected text.
-</p></td>
-</tr>
-<tr>
-<td><p><gui>Cells…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Sets the properties of the selected table cells. Open a dialog allowing the user to choose alignment,
borders, shading, text style, number format, or whatever other attributes are applicable.
-</p></td>
-</tr>
-<tr>
-<td><p><gui>List…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Sets the properties of the selected list, or turns the selected paragraphs into a list if they are
not already formatted as such. Open a dialog allowing the user to choose number or bullet style, spacing,
tabulation, or whatever other attributes are applicable.</p></td>
-</tr>
-<tr>
-<td><p><gui>Layer…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Sets the properties of all or selected layers of a multi-layered document. Open a dialog allowing the
user to choose name, size, visibility, opacity, z-ordering, or whatever other attributes are
applicable.</p></td>
-</tr>
-<tr>
-<td><p><gui>Page…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Sets the properties of all or selected pages of the document. Open a dialog allowing the user to
choose paper size, orientation, columns, margins, or whatever other attributes are applicable.</p></td>
-</tr>
-</tbody>
-</table>
-
-</section>
-
-<section id="bookmarks">
-<title>Bookmarks</title>
-
-<p>Provide a Bookmarks menu in any application that allows the user to browse files and folders, help
documents, web pages or any other large information space.</p>
-
-<table>
-<thead>
-<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><p><gui>Add Bookmark</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>D</key></keyseq></p></td>
-<td><p>Adds a bookmark for the current document to the default bookmark list. Do not pop up a dialog asking
for a title or location for the bookmark, instead choose sensible defaults (such as the document’s title or
filename as the bookmark name) and allow the user to change them later using the <gui>Edit Bookmarks</gui>
feature.</p></td>
-</tr>
-<tr>
-<td><p><gui>Edit Bookmarks</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>B</key></keyseq></p></td>
-<td><p>Allows the user to edit the application’s bookmark list. Open a window in which the user can arrange
bookmarks into a hierarchy, move, copy, and delete bookmarks, and change their properties.</p></td>
-</tr>
-<tr>
-<td><p>Bookmark List</p></td>
-<td><p>None</p></td>
-<td><p>The user’s current list of bookmarks for the application.</p></td>
-</tr>
-</tbody>
-</table>
-
-</section>
-
-<section id="go">
-<title>Go</title>
-
-<p>A <gui>Go</gui> menu provides commands for quickly navigating around a document or collection of
documents, or an information space such as a directory structure or the web.</p>
-
-<p>The contents of the menu will vary depending on the type of application. Different standard menus are
presented here for browser-based and document-based applications , but your application may require a
combination of both.</p>
-
-<section id="go-browser">
-<title>Go menu items for a browser application</title>
-
-<table>
-<thead>
-<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><p><gui>Back</gui></p></td>
-<td><p><keyseq><key>Alt</key><key>Left</key></keyseq></p></td>
-<td><p>Navigates to the previous document in the browser’s history list.</p></td>
-</tr>
-<tr>
-<td><p><gui>Forward</gui></p></td>
-<td><p><keyseq><key>Alt</key><key>Right</key></keyseq></p></td>
-<td><p>Navigates to the next document in the browser’s history list.</p></td>
-</tr>
-<tr>
-<td><p><gui>Up</gui></p></td>
-<td><p><keyseq><key>Alt</key><key>Up</key></keyseq></p></td>
-<td><p>Navigates to the current document’s (or folder’s) parent document (or folder). For a document
browser, such as an online help viewer, this usually means navigating to the enclosing sub-section, section,
chapter or contents page.</p></td>
-</tr>
-<tr>
-<td><p><gui>Up</gui></p></td>
-<td><p><keyseq><key>Alt</key><key>Home</key></keyseq></p></td>
-<td><p>Navigates to a starting page defined by the user or the application.</p></td>
-</tr>
-<tr>
-<td><p><gui>Location…</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>L</key></keyseq></p></td>
-<td><p>Navigates to a user-specified URI. Open a dialog into which the user can type a suitable URI, or
select one from a list where applicable (for example, a file selection dialog for applications that can
handle file:// URIs).</p></td>
-</tr>
-</tbody>
-</table>
-
-</section>
-
-<section id="go-document">
-<title>Go menu items for a document-based application</title>
-
-<table>
-<thead>
-<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><p><gui>Previous Page</gui></p></td>
-<td><p><key>PageUp</key></p></td>
-<td><p>Navigates to the previous page in the document.</p></td>
-</tr>
-<tr>
-<td><p><gui>Next Page</gui></p></td>
-<td><p><key>PageDown</key></p></td>
-<td><p>Navigates to the next page in the document.</p></td>
-</tr>
-<tr>
-<td><p><gui>Go to Page…</gui></p></td>
-<td><p>None</p></td>
-<td><p>Navigates to a user-specified page number. Open a dialog into which the user can type a page number.
Text-based applications may also include a <gui>Go to Line…</gui> menu item, which allows the user to jump to
a specified line number.</p></td>
-</tr>
-<tr>
-<td><p><gui>First Page</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>Home</key></keyseq></p></td>
-<td><p>Navigates to the first page in the document.</p></td>
-</tr>
-<tr>
-<td><p><gui>Last Page</gui></p></td>
-<td><p><keyseq><key>Ctrl</key><key>End</key></keyseq></p></td>
-<td><p>Navigates to the last page in the document.</p></td>
-</tr>
-</tbody>
-</table>
-
-</section>
-
-</section>
-
-<section id="windows">
-<title>Windows</title>
-
-<p>The <gui>Windows</gui> menu contains commands that apply to all of the application’s open windows. Only
use a Windows menu in multiple document interface (MDI) applications.</p>
-
-<note><p>Use of MDI is discouraged, as they have a number of inherent usability problems.</p></note>
-
-<p>You may also label this menu <gui>Documents</gui>, <gui>Buffers</gui>, or similar according to the type
of document handled by your application.</p>
-
-<p>The last items on this menu are a numbered list of the application’s primary windows, for example
<gui>1shoppinglist.abw</gui>. Selecting one of these items raises the corresponding window.</p>
-
-<table>
-<thead>
-<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><p><gui>Save All</gui></p></td>
-<td><p>None</p></td>
-<td><p>Saves all open documents. If any documents have no current filename, prompt for a filename for each
one in turn using the standard <gui>Save</gui> dialog.</p></td>
-</tr>
-<tr>
-<td><p><gui>Close All</gui></p></td>
-<td><p>None</p></td>
-<td><p>Closes all open documents. If there are any unsaved changes in any documents, post a confirmation
alert for each one in turn.</p></td>
-</tr>
-<tr>
-<td><p>List of windows</p></td>
-<td><p>None</p></td>
-<td><p>Each menu item raises the corresponding window to the top of the window stack.</p></td>
-</tr>
-</tbody>
-</table>
-
-</section>
-
-<section id="help">
-<title>Help</title>
-
-<p>The <gui>Help</gui> menu provides access to all online documentation for your application. This includes
both the user guide, and the <gui>About</gui> window which includes a brief description of your application’s
functionality.</p>
-
-<table>
-<thead>
-<tr>
-<td><p>Label</p></td>
-<td><p>Shortcut</p></td>
-<td><p>Description</p></td>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><p><gui>Contents</gui></p></td>
-<td><p><key>F1</key></p></td>
-<td><p>Opens the default help browser on the contents page for the application.</p></td>
-</tr>
-<tr>
-<td><p><gui>About</gui></p></td>
-<td><p>None</p></td>
-<td><p>Opens the About dialog for the application. Use the standard dialog provided by the GNOME libraries,
which contains the name and version number of the application, a short description of the application’s
functionality, author contact details, copyright message and a pointer to the licence under which the
application is made available.</p></td>
-</tr>
-</tbody>
-</table>
-
-</section>
-
</section>
</page>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
