doc/docbook/GuideMainWindowMenus.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <section id="GuideMainWindowMenus">
   3   <title id="titleGuideMainWindowMenus">Menus</title>
   4   <para>This section describes the functions of each item on the menu bar in the Geeqie main window.</para>
   5   <para />
   6   <section id="FileMenu">
   7     <title>File Menu</title>
   8     <variablelist>
   9       <varlistentry>
  10         <term>
  11           <menuchoice>
  12             <shortcut>
  13               <keycombo>
  14                 <keycap>Ctrl</keycap>
  15                 <keycap>N</keycap>
  16               </keycombo>
  17             </shortcut>
  18             <guimenu>New window</guimenu>
  19           </menuchoice>
  20         </term>
  21         <listitem>
  22           <para>Opens a new main window, with the initial path set to the current folder.</para>
  23         </listitem>
  24       </varlistentry>
  25       <varlistentry>
  26         <term>
  27           <menuchoice>
  28             <shortcut>
  29               <keycombo>
  30                 <keycap>C</keycap>
  31               </keycombo>
  32             </shortcut>
  33             <guimenu>New collection</guimenu>
  34           </menuchoice>
  35         </term>
  36         <listitem>
  37           <para>Opens a new collection window, the new collection will be empty.</para>
  38         </listitem>
  39       </varlistentry>
  40       <varlistentry>
  41         <term>
  42           <menuchoice>
  43             <shortcut>
  44               <keycombo>
  45                 <keycap>O</keycap>
  46               </keycombo>
  47             </shortcut>
  48             <guimenu>Open collection</guimenu>
  49           </menuchoice>
  50         </term>
  51         <listitem>
  52           <para>Displays a dialog to open a collection stored on disk, the selected collection will then appear in a new window.</para>
  53         </listitem>
  54       </varlistentry>
  55       <varlistentry>
  56         <term>
  57           <guimenu>Open recent</guimenu>
  58         </term>
  59         <listitem>
  60           <para>
  61             This menu item lists the recently active collections, selecting an item from the list will open that collection in a new window. The most recent item will appear at the top of the list. Maximum number of entries can be modified through
  62             <link linkend="Behaviour">Open recent list maximum size</link>
  63             option.
  64           </para>
  65         </listitem>
  66       </varlistentry>
  67       <varlistentry>
  68         <term>
  69           <menuchoice>
  70             <shortcut>
  71               <keycombo>
  72                 <keycap>F3</keycap>
  73               </keycombo>
  74             </shortcut>
  75             <guimenu>Search…</guimenu>
  76           </menuchoice>
  77         </term>
  78         <listitem>
  79           <para>Opens a new Search window.</para>
  80         </listitem>
  81       </varlistentry>
  82       <varlistentry>
  83         <term>
  84           <menuchoice>
  85             <shortcut>
  86               <keycombo>
  87                 <keycap>D</keycap>
  88               </keycombo>
  89             </shortcut>
  90             <guimenu>Find duplicates...</guimenu>
  91           </menuchoice>
  92         </term>
  93         <listitem>
  94           <para>Opens a new Find Duplicates window.</para>
  95         </listitem>
  96       </varlistentry>
  97       <varlistentry>
  98         <term>
  99           <menuchoice>
 100             <shortcut>
 101               <keycombo>
 102                 <keycap>Shift</keycap>
 103                 <keycap>P</keycap>
 104               </keycombo>
 105             </shortcut>
 106             <guimenu>Print..</guimenu>
 107           </menuchoice>
 108         </term>
 109         <listitem>
 110           <para>Opens a print dialog.</para>
 111         </listitem>
 112       </varlistentry>
 113       <varlistentry>
 114         <term>
 115           <menuchoice>
 116             <shortcut>
 117               <keycombo>
 118                 <keycap>Ctrl</keycap>
 119                 <keycap>F</keycap>
 120               </keycombo>
 121             </shortcut>
 122             <guimenu>New folder…</guimenu>
 123           </menuchoice>
 124         </term>
 125         <listitem>
 126           <para>Creates a new folder in the current path.</para>
 127         </listitem>
 128       </varlistentry>
 129       <varlistentry>
 130         <term>
 131           <menuchoice>
 132             <shortcut>
 133               <keycombo>
 134                 <keycap>Ctrl</keycap>
 135                 <keycap>C</keycap>
 136               </keycombo>
 137             </shortcut>
 138             <guimenu>Copy…</guimenu>
 139           </menuchoice>
 140         </term>
 141         <listitem>
 142           <para>Opens a dialog to select a destination to copy the currently selected files.</para>
 143         </listitem>
 144       </varlistentry>
 145       <varlistentry>
 146         <term>
 147           <menuchoice>
 148             <shortcut>
 149               <keycombo>
 150                 <keycap>Ctrl</keycap>
 151                 <keycap>M</keycap>
 152               </keycombo>
 153             </shortcut>
 154             <guimenu>Move…</guimenu>
 155           </menuchoice>
 156         </term>
 157         <listitem>
 158           <para>Opens a dialog to select a destination to move currently selected files.</para>
 159         </listitem>
 160       </varlistentry>
 161       <varlistentry>
 162         <term>
 163           <menuchoice>
 164             <shortcut>
 165               <keycombo>
 166                 <keycap>Ctrl</keycap>
 167                 <keycap>R</keycap>
 168               </keycombo>
 169             </shortcut>
 170             <guimenu>Rename…</guimenu>
 171           </menuchoice>
 172         </term>
 173         <listitem>
 174           <para>Renames the current file selection.</para>
 175         </listitem>
 176       </varlistentry>
 177       <varlistentry>
 178         <term>
 179           <guimenu>Open With...</guimenu>
 180         </term>
 181         <listitem>
 182           <para>Calls the standard GTK application chooser for a single file.</para>
 183         </listitem>
 184       </varlistentry>
 185       <varlistentry>
 186         <term>
 187           <menuchoice>
 188             <shortcut>
 189               <keycombo>
 190                 <keycap>Ctrl</keycap>
 191                 <keycap>D</keycap>
 192               </keycombo>
 193             </shortcut>
 194             <guimenu>Delete…</guimenu>
 195           </menuchoice>
 196         </term>
 197         <listitem>
 198           <para>Deletes the current file selection.</para>
 199         </listitem>
 200       </varlistentry>
 201       <varlistentry>
 202         <term>
 203           <guimenu>Symlink</guimenu>
 204         </term>
 205         <listitem>
 206           <para>
 207             Creates a symbolic link. This is implemented via a
 208             <link linkend="GuideImageManagementPlugins">plugin</link>
 209             .
 210           </para>
 211         </listitem>
 212       </varlistentry>
 213       <varlistentry>
 214         <term>
 215           <menuchoice>
 216             <shortcut>
 217               <keycombo>
 218                 <keycap>Ctrl</keycap>
 219                 <keycap>W</keycap>
 220               </keycombo>
 221             </shortcut>
 222             <guimenu>Close window</guimenu>
 223           </menuchoice>
 224         </term>
 225         <listitem>
 226           <para>Closes the window containing the menu, if the window is the last main window Geeqie will quit.</para>
 227         </listitem>
 228       </varlistentry>
 229       <varlistentry>
 230         <term>
 231           <menuchoice>
 232             <shortcut>
 233               <keycombo>
 234                 <keycap>Ctrl</keycap>
 235                 <keycap>Q</keycap>
 236               </keycombo>
 237             </shortcut>
 238             <guimenu>Quit</guimenu>
 239           </menuchoice>
 240         </term>
 241         <listitem>
 242           <para>Quits the Geeqie application, if collections or image metadata have been changed but not saved, the user will be prompted for confirmation.</para>
 243         </listitem>
 244       </varlistentry>
 245     </variablelist>
 246     <para />
 247   </section>
 248   <section id="Gomenu">
 249     <title>Go menu</title>
 250     <para>The Page commands are for files which contain multiple images e.g. .tiff files</para>
 251     <variablelist>
 252       <varlistentry>
 253         <term>
 254           <menuchoice>
 255             <shortcut>
 256               <keycombo>
 257                 <keycap>Home</keycap>
 258               </keycombo>
 259             </shortcut>
 260             <guimenu>First Image</guimenu>
 261           </menuchoice>
 262         </term>
 263         <listitem>
 264           <para>Goes to the first image.</para>
 265         </listitem>
 266       </varlistentry>
 267       <varlistentry>
 268         <term>
 269           <menuchoice>
 270             <shortcut>
 271               <keycombo>
 272                 <keycap>Backspace</keycap>
 273               </keycombo>
 274             </shortcut>
 275             <guimenu>Previous Image</guimenu>
 276           </menuchoice>
 277         </term>
 278         <listitem>
 279           <para>Goes to the previous image.</para>
 280         </listitem>
 281       </varlistentry>
 282       <varlistentry>
 283         <term>
 284           <menuchoice>
 285             <shortcut>
 286               <keycombo>
 287                 <keycap>Space</keycap>
 288               </keycombo>
 289             </shortcut>
 290             <guimenu>Next Image</guimenu>
 291           </menuchoice>
 292         </term>
 293         <listitem>
 294           <para>Goes to the next image</para>
 295         </listitem>
 296       </varlistentry>
 297       <varlistentry>
 298         <term>
 299           <menuchoice>
 300             <shortcut>
 301               <keycombo>
 302                 <keycap>End</keycap>
 303               </keycombo>
 304             </shortcut>
 305             <guimenu>Last Image</guimenu>
 306           </menuchoice>
 307         </term>
 308         <listitem>
 309           <para>Goes to the last image</para>
 310         </listitem>
 311       </varlistentry>
 312       <varlistentry>
 313         <term>
 314           <menuchoice>
 315             <guimenu>Image Back</guimenu>
 316           </menuchoice>
 317         </term>
 318         <listitem>
 319           <para>Each image you view is appended to a chain. You may traverse forwards and backwards through this chain using this and the following key. Move to the previous image in the chain.</para>
 320         </listitem>
 321       </varlistentry>
 322       <varlistentry>
 323         <term>
 324           <menuchoice>
 325             <guimenu>Image Forward</guimenu>
 326           </menuchoice>
 327         </term>
 328         <listitem>
 329           <para>Move to the next image in the chain.</para>
 330         </listitem>
 331       </varlistentry>
 332       <varlistentry>
 333         <term>
 334           <menuchoice>
 335             <guimenu>Back</guimenu>
 336           </menuchoice>
 337         </term>
 338         <listitem>
 339           <para>Back Goes to the previous folder</para>
 340         </listitem>
 341       </varlistentry>
 342       <varlistentry>
 343         <term>
 344           <menuchoice>
 345             <shortcut>
 346               <keycombo>
 347                 <keycap>Home</keycap>
 348               </keycombo>
 349             </shortcut>
 350             <guimenu>Home</guimenu>
 351           </menuchoice>
 352         </term>
 353         <listitem>
 354           <para>
 355             Goes to the the Home folder as defined in
 356             <link linkend="GuideOptionsLayout" endterm="titleGuideOptionsLayout" />
 357           </para>
 358         </listitem>
 359       </varlistentry>
 360       <varlistentry>
 361         <term>
 362           <menuchoice>
 363             <shortcut>
 364               <keycombo>
 365                 <keycap>Ctrl</keycap>
 366                 <keycap>Home</keycap>
 367               </keycombo>
 368             </shortcut>
 369             <guimenu>First Page</guimenu>
 370           </menuchoice>
 371         </term>
 372         <listitem>
 373           <para>Goes to the first page.</para>
 374         </listitem>
 375       </varlistentry>
 376       <varlistentry>
 377         <term>
 378           <menuchoice>
 379             <shortcut>
 380               <keycombo>
 381                 <keycap>Ctrl</keycap>
 382                 <keycap>End</keycap>
 383               </keycombo>
 384             </shortcut>
 385             <guimenu>Last Page</guimenu>
 386           </menuchoice>
 387         </term>
 388         <listitem>
 389           <para>Goes to the last page.</para>
 390         </listitem>
 391       </varlistentry>
 392       <varlistentry>
 393         <term>
 394           <menuchoice>
 395             <shortcut>
 396               <keycombo>
 397                 <keycap>Ctrl</keycap>
 398                 <keycap>PageUp</keycap>
 399               </keycombo>
 400             </shortcut>
 401             <guimenu>Previous Page</guimenu>
 402           </menuchoice>
 403         </term>
 404         <listitem>
 405           <para>Goes to the previous page.</para>
 406         </listitem>
 407       </varlistentry>
 408       <varlistentry>
 409         <term>
 410           <menuchoice>
 411             <shortcut>
 412               <keycombo>
 413                 <keycap>Ctrl</keycap>
 414                 <keycap>PageDown</keycap>
 415               </keycombo>
 416             </shortcut>
 417             <guimenu>Next Page</guimenu>
 418           </menuchoice>
 419         </term>
 420         <listitem>
 421           <para>Goes to the next page.</para>
 422         </listitem>
 423       </varlistentry>
 424     </variablelist>
 425     <para />
 426   </section>
 427   <section id="Selectmenu">
 428     <title>Select menu</title>
 429     <variablelist>
 430       <varlistentry>
 431         <term>
 432           <menuchoice>
 433             <shortcut>
 434               <keycombo>
 435                 <keycap>Ctrl</keycap>
 436                 <keycap>A</keycap>
 437               </keycombo>
 438             </shortcut>
 439             <guimenu>Select all</guimenu>
 440           </menuchoice>
 441         </term>
 442         <listitem>
 443           <para>Selects all files in the current list</para>
 444         </listitem>
 445       </varlistentry>
 446       <varlistentry>
 447         <term>
 448           <menuchoice>
 449             <shortcut>
 450               <keycombo>
 451                 <keycap>Ctrl</keycap>
 452                 <keycap>Shift</keycap>
 453                 <keycap>A</keycap>
 454               </keycombo>
 455             </shortcut>
 456             <guimenu>Select none</guimenu>
 457           </menuchoice>
 458         </term>
 459         <listitem>
 460           <para>Deselects all files</para>
 461         </listitem>
 462       </varlistentry>
 463       <varlistentry>
 464         <term>
 465           <menuchoice>
 466             <shortcut>
 467               <keycombo>
 468                 <keycap>Ctrl</keycap>
 469                 <keycap>Shift</keycap>
 470                 <keycap>I</keycap>
 471               </keycombo>
 472             </shortcut>
 473             <guimenu>Invert selection</guimenu>
 474           </menuchoice>
 475         </term>
 476         <listitem>
 477           <para>Inverts current selection</para>
 478         </listitem>
 479       </varlistentry>
 480       <varlistentry>
 481         <term>
 482           <menuchoice>
 483             <shortcut>
 484               <keycombo>
 485                 <keycap>Alt</keycap>
 486                 <keycap>R</keycap>
 487               </keycombo>
 488             </shortcut>
 489             <guimenu>Rectangular selection</guimenu>
 490           </menuchoice>
 491         </term>
 492         <listitem>
 493           <para>Toggles rectangular selection mode for icons</para>
 494         </listitem>
 495       </varlistentry>
 496       <varlistentry>
 497         <term>
 498           <menuchoice>
 499             <guimenu>Copy to clipboard</guimenu>
 500           </menuchoice>
 501         </term>
 502         <listitem>
 503           <para>
 504             Copy selected item-path(s) to clipboard
 505             <footnote id='ref1'>
 506               The clipboard used is selected
 507               <link linkend="Behaviour">here.</link>
 508             </footnote>
 509             . Each data item copied will be enclosed in quotes.
 510           </para>
 511         </listitem>
 512       </varlistentry>
 513       <varlistentry>
 514         <term>
 515           <menuchoice>
 516             <guimenu>Copy to clipboard (unquoted)</guimenu>
 517           </menuchoice>
 518         </term>
 519         <listitem>
 520           <para>Copy selected item-path(s) to clipboard. The data will not be enclosed in quotes.</para>
 521         </listitem>
 522       </varlistentry>
 523       <varlistentry>
 524         <term>
 525           <menuchoice>
 526             <shortcut>
 527               <keycombo>
 528                 <keycap>Ctrl</keycap>
 529                 <keycap>X</keycap>
 530               </keycombo>
 531             </shortcut>
 532             <guimenu>Cut to clipboard</guimenu>
 533           </menuchoice>
 534         </term>
 535         <listitem>
 536           <para>Perform a standard control-X operation.</para>
 537         </listitem>
 538       </varlistentry>
 539       <varlistentry>
 540         <term>
 541           <menuchoice>
 542             <shortcut>
 543               <keycombo>
 544                 <keycap>M</keycap>
 545               </keycombo>
 546             </shortcut>
 547             <guimenu>Show marks</guimenu>
 548           </menuchoice>
 549         </term>
 550         <listitem>
 551           <para>Displays marks in the file list</para>
 552         </listitem>
 553       </varlistentry>
 554       <varlistentry>
 555         <term>
 556           <menuchoice>
 557             <guimenu>Clear marks</guimenu>
 558           </menuchoice>
 559         </term>
 560         <listitem>
 561           <para>Clear all marks for all images</para>
 562           <warning>
 563             <para>Marks that are linked to keywords will also be cleared. This may result in a metadata write operation being triggered.</para>
 564           </warning>
 565         </listitem>
 566       </varlistentry>
 567       <varlistentry>
 568         <term>
 569           <menuchoice>
 570             <guimenu>Mark n</guimenu>
 571           </menuchoice>
 572         </term>
 573         <listitem>
 574           <para>Opens submenu for manipulating mark n</para>
 575         </listitem>
 576       </varlistentry>
 577       <varlistentry>
 578         <term>
 579           <menuchoice>
 580             <shortcut>
 581               <keycombo>
 582                 <keycap>n</keycap>
 583               </keycombo>
 584             </shortcut>
 585             <guimenu>Mark n</guimenu>
 586             <guimenuitem>Toggle Mark n</guimenuitem>
 587           </menuchoice>
 588         </term>
 589         <listitem>
 590           <para>Set or unset mark n on selected files</para>
 591         </listitem>
 592       </varlistentry>
 593       <varlistentry>
 594         <term>
 595           <menuchoice>
 596             <guimenu>Mark n</guimenu>
 597             <guimenuitem>Set mark n</guimenuitem>
 598           </menuchoice>
 599         </term>
 600         <listitem>
 601           <para>Set mark n on selected files</para>
 602         </listitem>
 603       </varlistentry>
 604       <varlistentry>
 605         <term>
 606           <menuchoice>
 607             <guimenu>Mark n</guimenu>
 608             <guimenuitem>Reset mark n</guimenuitem>
 609           </menuchoice>
 610         </term>
 611         <listitem>
 612           <para>Unset mark n on selected files</para>
 613         </listitem>
 614       </varlistentry>
 615       <varlistentry>
 616         <term>
 617           <menuchoice>
 618             <shortcut>
 619               <keycombo>
 620                 <keycap>Ctrl</keycap>
 621                 <keycap>n</keycap>
 622               </keycombo>
 623             </shortcut>
 624             <guimenu>Mark n</guimenu>
 625             <guimenuitem>Select mark n</guimenuitem>
 626           </menuchoice>
 627         </term>
 628         <listitem>
 629           <para>Selects all files having mark n set</para>
 630         </listitem>
 631       </varlistentry>
 632       <varlistentry>
 633         <term>
 634           <menuchoice>
 635             <guimenu>Mark n</guimenu>
 636             <guimenuitem>Add mark n</guimenuitem>
 637           </menuchoice>
 638         </term>
 639         <listitem>
 640           <para>Adds files having mark n set to selection</para>
 641         </listitem>
 642       </varlistentry>
 643       <varlistentry>
 644         <term>
 645           <menuchoice>
 646             <guimenu>Mark n</guimenu>
 647             <guimenuitem>Intersection with mark n</guimenuitem>
 648           </menuchoice>
 649         </term>
 650         <listitem>
 651           <para>Intersects current selection and mark n</para>
 652         </listitem>
 653       </varlistentry>
 654       <varlistentry>
 655         <term>
 656           <menuchoice>
 657             <guimenu>Mark n</guimenu>
 658             <guimenuitem>Unselect mark n</guimenuitem>
 659           </menuchoice>
 660         </term>
 661         <listitem>
 662           <para>Removes files having mark n set from current selection</para>
 663         </listitem>
 664       </varlistentry>
 665       <varlistentry>
 666         <term>
 667           <menuchoice>
 668             <guimenu>Mark n</guimenu>
 669             <guimenuitem>Filter mark n</guimenuitem>
 670           </menuchoice>
 671         </term>
 672         <listitem>
 673           <para>Shows only the images that have mark n set.</para>
 674         </listitem>
 675       </varlistentry>
 676     </variablelist>
 677     <para />
 678   </section>
 679   <section id="Editmenu">
 680     <title>Edit menu</title>
 681     <variablelist>
 682       <varlistentry>
 683         <term>
 684           <menuchoice>
 685             <guimenu>Orientation</guimenu>
 686           </menuchoice>
 687         </term>
 688         <listitem>
 689           <para>Adjust image orientation</para>
 690         </listitem>
 691       </varlistentry>
 692       <varlistentry>
 693         <term>
 694           <menuchoice>
 695             <shortcut>
 696               <keycombo>
 697                 <keycap>]</keycap>
 698               </keycombo>
 699             </shortcut>
 700             <guimenu>Orientation</guimenu>
 701             <guimenuitem>Rotate clockwise</guimenuitem>
 702           </menuchoice>
 703         </term>
 704         <listitem>
 705           <para>Rotates the current image clockwise 90 degrees, does not modify the file on disk.</para>
 706         </listitem>
 707       </varlistentry>
 708       <varlistentry>
 709         <term>
 710           <menuchoice>
 711             <shortcut>
 712               <keycombo>
 713                 <keycap>[</keycap>
 714               </keycombo>
 715             </shortcut>
 716             <guimenu>Orientation</guimenu>
 717             <guimenuitem>Rotate counterclockwise</guimenuitem>
 718           </menuchoice>
 719         </term>
 720         <listitem>
 721           <para>Rotates the current image counterclockwise 90 degrees, does not modify the file on disk.</para>
 722         </listitem>
 723       </varlistentry>
 724       <varlistentry>
 725         <term>
 726           <menuchoice>
 727             <shortcut>
 728               <keycombo>
 729                 <keycap>Shift</keycap>
 730                 <keycap>R</keycap>
 731               </keycombo>
 732             </shortcut>
 733             <guimenu>Orientation</guimenu>
 734             <guimenuitem>Rotate 180</guimenuitem>
 735           </menuchoice>
 736         </term>
 737         <listitem>
 738           <para>Rotates the current image 180 degrees, does not modify the file on disk.</para>
 739         </listitem>
 740       </varlistentry>
 741       <varlistentry>
 742         <term>
 743           <menuchoice>
 744             <shortcut>
 745               <keycombo>
 746                 <keycap>Shift</keycap>
 747                 <keycap>M</keycap>
 748               </keycombo>
 749             </shortcut>
 750             <guimenu>Orientation</guimenu>
 751             <guimenuitem>Mirror</guimenuitem>
 752           </menuchoice>
 753         </term>
 754         <listitem>
 755           <para>Swaps the left and right sides of the image so that the result is similar to that of looking at the image in a mirror, does not modify the file on disk.</para>
 756         </listitem>
 757       </varlistentry>
 758       <varlistentry>
 759         <term>
 760           <menuchoice>
 761             <shortcut>
 762               <keycombo>
 763                 <keycap>Shift</keycap>
 764                 <keycap>F</keycap>
 765               </keycombo>
 766             </shortcut>
 767             <guimenu>Orientation</guimenu>
 768             <guimenuitem>Flip</guimenuitem>
 769           </menuchoice>
 770         </term>
 771         <listitem>
 772           <para>Swaps the top and bottom sides of the image, does not modify the file on disk.</para>
 773           <warning>
 774             <para>
 775               The above orientation commands - Rotate, Mirror and Flip - do not change the image on disk. The changes will be lost when Geeqie closes. Refer to the
 776               <link linkend="MetadataMiscellaneous">Metadata tab of the Preferences Dialog</link>
 777               if you wish these changes to be written to metadata.
 778             </para>
 779             <para>
 780               Refer also to the
 781               <link linkend="HowdotheExifauto-rotationcommandswork">FAQ</link>
 782               .
 783             </para>
 784           </warning>
 785         </listitem>
 786       </varlistentry>
 787       <varlistentry>
 788         <term>
 789           <menuchoice>
 790             <shortcut>
 791               <keycombo>
 792                 <keycap>Shift</keycap>
 793                 <keycap>O</keycap>
 794               </keycombo>
 795             </shortcut>
 796             <guimenu>Orientation</guimenu>
 797             <guimenuitem>Original state</guimenuitem>
 798           </menuchoice>
 799         </term>
 800         <listitem>
 801           <para>Removes all temporary effects applied through the above commands, reverting the image according to its Exif Orientation tag.</para>
 802         </listitem>
 803       </varlistentry>
 804       <varlistentry>
 805         <term>
 806           <guilabel>Auto rotate image using EXIF information</guilabel>
 807         </term>
 808         <listitem>
 809           <para>
 810             Auto rotates images based on metadata stored in images that have Exif data. Refer also to the
 811             <link linkend="HowdotheExifauto-rotationcommandswork">FAQ</link>
 812             .
 813           </para>
 814         </listitem>
 815       </varlistentry>
 816       <varlistentry>
 817         <term>
 818           <menuchoice>
 819             <guimenu>Orientation</guimenu>
 820             <guimenuitem>Apply the orientation to image content</guimenuitem>
 821           </menuchoice>
 822         </term>
 823         <listitem>
 824           <para>This command affects only jpeg, tiff and png files. The image file on disk is rotated to the orientation as specified by its Exif Orientation tag.</para>
 825           <warning>
 826             <para>
 827               The file rotate.desktop, using external commands exiftran, exiv2 and mogrify, is used to implement this command. Refer to
 828               <link linkend="GuideImageManagementPlugins">Plugins section</link>
 829               for details.
 830             </para>
 831           </warning>
 832         </listitem>
 833       </varlistentry>
 834       <varlistentry>
 835         <term>
 836           <menuchoice>
 837             <shortcut>
 838               <keycombo>
 839                 <keycap>[</keycap>
 840               </keycombo>
 841             </shortcut>
 842             <guimenu>Orientation</guimenu>
 843             <guimenuitem>Rotate counterclockwise</guimenuitem>
 844           </menuchoice>
 845         </term>
 846         <listitem>
 847           <para>Rotates the current image counterclockwise 90 degrees, does not modify the file on disk.</para>
 848         </listitem>
 849       </varlistentry>
 850       <varlistentry>
 851         <term>
 852           <menuchoice>
 853             <shortcut>
 854               <keycombo>
 855                 <keycap>Shift</keycap>
 856                 <keycap>R</keycap>
 857               </keycombo>
 858             </shortcut>
 859             <guimenu>Orientation</guimenu>
 860             <guimenuitem>Rotate 180</guimenuitem>
 861           </menuchoice>
 862         </term>
 863         <listitem>
 864           <para>Rotates the current image 180 degrees, does not modify the file on disk.</para>
 865         </listitem>
 866       </varlistentry>
 867       <varlistentry>
 868         <term>
 869           <menuchoice>
 870             <guimenu>Orientation</guimenu>
 871             <guimenuitem>Write orientation to file</guimenuitem>
 872           </menuchoice>
 873         </term>
 874         <listitem>
 875           <para>
 876             Saves the current image orientation to the disk file. This operation can only be carried out on jpeg, tiff and png files. Jpeg rotations are lossless.
 877             <note>
 878               The Preferences/Metadata option "Write altered image orientation to the metadata" must be off.
 879               <para />
 880               Exiftran and mogrify must be installed.
 881             </note>
 882           </para>
 883         </listitem>
 884       </varlistentry>
 885       <varlistentry>
 886         <term>
 887           <menuchoice>
 888             <guimenu>Orientation</guimenu>
 889             <guimenuitem>Write orientation to file (preserve timestamp)</guimenuitem>
 890           </menuchoice>
 891         </term>
 892         <listitem>
 893           <para>As above, but the file date and time are preserved.</para>
 894         </listitem>
 895       </varlistentry>
 896       <varlistentry>
 897         <term>
 898           <menuchoice>
 899             <guimenu>Rating</guimenu>
 900           </menuchoice>
 901         </term>
 902         <listitem>
 903           <para>Set a Rating value for each image.</para>
 904         </listitem>
 905       </varlistentry>
 906       <varlistentry>
 907         <term>
 908           <menuchoice>
 909             <shortcut>
 910               <keycombo>
 911                 <keycap>Alt+Keypad+n</keycap>
 912               </keycombo>
 913             </shortcut>
 914             <guimenu>Rating</guimenu>
 915             <guimenuitem>n</guimenuitem>
 916           </menuchoice>
 917         </term>
 918         <listitem>
 919           <para>"n" is in the range 0 to 5. Sets the Rating value for the image.</para>
 920         </listitem>
 921       </varlistentry>
 922       <varlistentry>
 923         <term>
 924           <menuchoice>
 925             <shortcut>
 926               <keycombo>
 927                 <keycap>Alt+Keypad+Minus</keycap>
 928               </keycombo>
 929             </shortcut>
 930             <guimenu>Rating</guimenu>
 931             <guimenuitem>-1</guimenuitem>
 932           </menuchoice>
 933         </term>
 934         <listitem>
 935           <para>Sets the Rating value to -1 for the image.</para>
 936         </listitem>
 937       </varlistentry>
 938       <varlistentry>
 939         <term>
 940           <menuchoice>
 941             <shortcut>
 942               <keycombo>
 943                 <keycap>Ctrl</keycap>
 944                 <keycap>S</keycap>
 945               </keycombo>
 946             </shortcut>
 947             <guimenu>Save metadata</guimenu>
 948           </menuchoice>
 949         </term>
 950         <listitem>
 951           <para>Saves queued metadata changes. Autosave can be configured too.</para>
 952         </listitem>
 953       </varlistentry>
 954     </variablelist>
 955     <variablelist>
 956       <varlistentry>
 957         <term>
 958           <menuchoice>
 959             <shortcut>
 960               <keycombo>
 961                 <keycap>Ctrl</keycap>
 962                 <keycap>O</keycap>
 963               </keycombo>
 964             </shortcut>
 965             <guimenu>Preferences</guimenu>
 966           </menuchoice>
 967         </term>
 968         <listitem>
 969           <para>
 970             Opens the
 971             <link linkend="GuideOptionsMain">Preferences Dialog</link>
 972             for changing of global preferences.
 973           </para>
 974         </listitem>
 975       </varlistentry>
 976       <varlistentry>
 977         <term>
 978           <menuchoice>
 979             <guimenu>Configure Plugins…</guimenu>
 980           </menuchoice>
 981         </term>
 982         <listitem>
 983           <para>
 984             Opens the
 985             <link linkend="GuideImageManagementPlugins">Plugins Dialog</link>
 986             for changing of desktop files.
 987           </para>
 988         </listitem>
 989       </varlistentry>
 990       <varlistentry>
 991         <term>
 992           <menuchoice>
 993             <guimenu>Configure This window…</guimenu>
 994           </menuchoice>
 995         </term>
 996         <listitem>
 997           <para>
 998             Opens the
 999             <link linkend="GuideOptionsWindow">Window Preferences Dialog</link>
1000             for changing of options that can differ for each window.
1001           </para>
1002         </listitem>
1003       </varlistentry>
1004       <varlistentry>
1005         <term>
1006           <menuchoice>
1007             <guimenu>Cache maintenance</guimenu>
1008           </menuchoice>
1009         </term>
1010         <listitem>
1011           <para>
1012             Opens a dialog with utilities for thumbnail and keyword
1013             <link linkend="GuideReferenceManagement" endterm="titleGuideReferenceManagement" />
1014             .
1015           </para>
1016         </listitem>
1017       </varlistentry>
1018       <varlistentry>
1019         <term>
1020           <menuchoice>
1021             <guimenu>Set as wallpaper</guimenu>
1022           </menuchoice>
1023         </term>
1024         <listitem>
1025           <para>
1026             Renders the current image to the root window (desktop). The resulting image will be tiled to fit the root window if zoom is not set to
1027             <emphasis role="i">Fit to window</emphasis>
1028             ; when zoom is set to
1029             <emphasis role="i">Fit to window</emphasis>
1030             , the image will be scaled to fill the root window.
1031           </para>
1032         </listitem>
1033       </varlistentry>
1034     </variablelist>
1035     <para />
1036   </section>
1037   <section id="Pluginsmenu">
1038     <title>Plugins menu</title>
1039     <variablelist>
1040       <varlistentry>
1041         <term>
1042           <menuchoice>
1043             <guimenu>Plugins</guimenu>
1044           </menuchoice>
1045         </term>
1046         <listitem>
1047           <para>
1048             This menu contains the plugins (desktop files) that were found on the system. See the
1049             <link linkend="GuideImageManagementPlugins">Plugins section</link>
1050             for details.
1051           </para>
1052         </listitem>
1053       </varlistentry>
1054     </variablelist>
1055   </section>
1056   <section id="Viewmenu">
1057     <title>View menu</title>
1058     <variablelist>
1059       <varlistentry>
1060         <term>
1061           <menuchoice>
1062             <shortcut>
1063               <keycombo>
1064                 <keycap>Ctrl</keycap>
1065                 <keycap>V</keycap>
1066               </keycombo>
1067             </shortcut>
1068             <guimenu>View in new window</guimenu>
1069           </menuchoice>
1070         </term>
1071         <listitem>
1072           <para>Opens selected image in its own window</para>
1073         </listitem>
1074       </varlistentry>
1075       <varlistentry>
1076         <term>
1077           <menuchoice>
1078             <shortcut>
1079               <keycombo>
1080                 <keycap>Ctrl</keycap>
1081                 <keycap>J</keycap>
1082               </keycombo>
1083             </shortcut>
1084             <guimenu>Pan view</guimenu>
1085           </menuchoice>
1086         </term>
1087         <listitem>
1088           <para>Opens current folder in Pan view window</para>
1089         </listitem>
1090       </varlistentry>
1091       <varlistentry>
1092         <term>
1093           <menuchoice>
1094             <shortcut>
1095               <keycombo>
1096                 <keycap>Ctrl</keycap>
1097                 <keycap>E</keycap>
1098               </keycombo>
1099             </shortcut>
1100             <guimenu>Exif data</guimenu>
1101           </menuchoice>
1102         </term>
1103         <listitem>
1104           <para>Toggles display of the Exif sidebar.</para>
1105         </listitem>
1106       </varlistentry>
1107       <varlistentry>
1108         <term>
1109           <menuchoice>
1110             <shortcut>
1111               <keycombo>
1112                 <keycap>Meta</keycap>
1113                 <keycap>L</keycap>
1114               </keycombo>
1115             </shortcut>
1116             <guimenu>Files and Folders</guimenu>
1117             <guimenu>Folder List</guimenu>
1118           </menuchoice>
1119         </term>
1120         <listitem>
1121           <para>Set the folder view mode to list.</para>
1122         </listitem>
1123       </varlistentry>
1124       <varlistentry>
1125         <term>
1126           <menuchoice>
1127             <shortcut>
1128               <keycombo>
1129                 <keycap>Ctrl</keycap>
1130                 <keycap>T</keycap>
1131               </keycombo>
1132             </shortcut>
1133             <guimenu>Files and Folders</guimenu>
1134             <guimenuitem>Folder Tree</guimenuitem>
1135           </menuchoice>
1136         </term>
1137         <listitem>
1138           <para>Set the folder view mode to tree.</para>
1139         </listitem>
1140       </varlistentry>
1141       <varlistentry>
1142         <term>
1143           <menuchoice>
1144             <shortcut>
1145               <keycombo>
1146                 <keycap>Ctrl</keycap>
1147                 <keycap>L</keycap>
1148               </keycombo>
1149             </shortcut>
1150             <guimenu>Files and Folders</guimenu>
1151             <guimenuitem>Image List</guimenuitem>
1152           </menuchoice>
1153         </term>
1154         <listitem>
1155           <para>Changes the file list to display files in list format.</para>
1156         </listitem>
1157       </varlistentry>
1158       <varlistentry>
1159         <term>
1160           <menuchoice>
1161             <shortcut>
1162               <keycombo>
1163                 <keycap>Ctrl</keycap>
1164                 <keycap>I</keycap>
1165               </keycombo>
1166             </shortcut>
1167             <guimenu>Files and Folders</guimenu>
1168             <guimenuitem>Icons</guimenuitem>
1169           </menuchoice>
1170         </term>
1171         <listitem>
1172           <para>Changes the file list to display files as icons.</para>
1173         </listitem>
1174       </varlistentry>
1175       <varlistentry>
1176         <term>
1177           <menuchoice>
1178             <guimenu>Files and Folders</guimenu>
1179             <guimenuitem>Show Thumbnails</guimenuitem>
1180           </menuchoice>
1181         </term>
1182         <listitem>
1183           <para>Toggles the display of image thumbnails in the file list, this item is not available when the file list is in icon view mode. A check appears next to this item when thumbnails are enabled.</para>
1184         </listitem>
1185       </varlistentry>
1186       <varlistentry>
1187         <term>
1188           <menuchoice>
1189             <shortcut>
1190               <keycombo>
1191                 <keycap>L</keycap>
1192               </keycombo>
1193             </shortcut>
1194             <guimenu>Files and Folders</guimenu>
1195             <guimenuitem>Float file list</guimenuitem>
1196           </menuchoice>
1197         </term>
1198         <listitem>
1199           <para>
1200             Splits the 3-pane main window into two parts:
1201             <itemizedlist>
1202               <listitem>File pane and Folder pane, along with menu and status bar</listitem>
1203               <listitem>Image pane and its associated sidebar and sort manager (if displayed)</listitem>
1204             </itemizedlist>
1205           </para>
1206         </listitem>
1207       </varlistentry>
1208       <varlistentry>
1209         <term>
1210           <menuchoice>
1211             <shortcut>
1212               <keycombo>
1213                 <keycap>Ctrl</keycap>
1214                 <keycap>H</keycap>
1215               </keycombo>
1216             </shortcut>
1217             <guimenu>Files and Folders</guimenu>
1218             <guimenuitem>Hide file list</guimenuitem>
1219           </menuchoice>
1220         </term>
1221         <listitem>
1222           <para>
1223             Hides the File and Folder panes, along with menu and status bar.
1224             <code>Right-click</code>
1225             on the Image pane provides a menu item to redisplay these items.
1226           </para>
1227         </listitem>
1228       </varlistentry>
1229     </variablelist>
1230     <variablelist>
1231       <varlistentry>
1232         <term>
1233           <menuchoice>
1234             <guimenu>Zoom</guimenu>
1235           </menuchoice>
1236         </term>
1237         <listitem>
1238           <para />
1239         </listitem>
1240       </varlistentry>
1241       <varlistentry>
1242         <term>
1243           <menuchoice>
1244             <guimenu>Zoom</guimenu>
1245             <guimenuitem>Connected zoom</guimenuitem>
1246           </menuchoice>
1247         </term>
1248         <listitem>
1249           <para>
1250             Actions in this menu are identical to those in
1251             <emphasis role="bold">Zoom</emphasis>
1252             menu, but apply to all images displayed in split view.
1253           </para>
1254         </listitem>
1255       </varlistentry>
1256       <varlistentry>
1257         <term>
1258           <menuchoice>
1259             <guimenu>Zoom</guimenu>
1260             <guimenuitem>Zoom in</guimenuitem>
1261           </menuchoice>
1262         </term>
1263         <listitem>
1264           <para>Increases the zoom by one increment, resulting in a larger image.</para>
1265         </listitem>
1266       </varlistentry>
1267       <varlistentry>
1268         <term>
1269           <menuchoice>
1270             <guimenu>Zoom</guimenu>
1271             <guimenuitem>Zoom out</guimenuitem>
1272           </menuchoice>
1273         </term>
1274         <listitem>
1275           <para>Decreases the zoom by one increment, resulting in a smaller image.</para>
1276         </listitem>
1277       </varlistentry>
1278       <varlistentry>
1279         <term>
1280           <menuchoice>
1281             <guimenu>Zoom</guimenu>
1282             <guimenuitem>Zoom to fit</guimenuitem>
1283           </menuchoice>
1284         </term>
1285         <listitem>
1286           <para>
1287             Automatically adjusts the zoom so that the image will fit within the display pane. The effect on images with an original size smaller than the display pane can be changed with the
1288             <emphasis>Allow enlargement of image for zoom to fit</emphasis>
1289             option located on the
1290             <link linkend="GuideOptionsImage">Image tab</link>
1291             of the preferences dialog.
1292           </para>
1293         </listitem>
1294       </varlistentry>
1295       <varlistentry>
1296         <term>
1297           <menuchoice>
1298             <guimenu>Zoom</guimenu>
1299             <guimenuitem>Fit Horizontally</guimenuitem>
1300           </menuchoice>
1301         </term>
1302         <listitem>
1303           <para>Adjusts the zoom so image height fit within the display pane.</para>
1304         </listitem>
1305       </varlistentry>
1306       <varlistentry>
1307         <term>
1308           <menuchoice>
1309             <guimenu>Zoom</guimenu>
1310             <guimenuitem>Fit Vertically</guimenuitem>
1311           </menuchoice>
1312         </term>
1313         <listitem>
1314           <para>Adjusts the zoom so image width fit within the display pane.</para>
1315         </listitem>
1316       </varlistentry>
1317       <varlistentry>
1318         <term>
1319           <menuchoice>
1320             <code>
1321               <guibutton>
1322                 <guiicon>
1323                   <inlinegraphic fileref="document-new.png" />
1324                 </guiicon>
1325                 New
1326               </guibutton>
1327             </code>
1328             <shortcut>
1329               <keycombo>
1330                 <keycap>Z</keycap>
1331               </keycombo>
1332             </shortcut>
1333             <guimenu>Zoom</guimenu>
1334             <guimenuitem>Zoom n:m</guimenuitem>
1335           </menuchoice>
1336         </term>
1337         <listitem>
1338           <para>Set zoom to the n:m value. 1:1 is the original size of the image. When n is greater than m, zoom in occurs else zoom out occurs.</para>
1339         </listitem>
1340       </varlistentry>
1341     </variablelist>
1342     <variablelist>
1343       <varlistentry>
1344         <term>
1345           <menuchoice>
1346             <shortcut>
1347               <keycombo>
1348                 <keycap>Z</keycap>
1349               </keycombo>
1350             </shortcut>
1351             <guimenu>Zoom</guimenu>
1352             <guimenuitem>Zoom n:m</guimenuitem>
1353           </menuchoice>
1354           <guimenu>Split</guimenu>
1355         </term>
1356         <listitem>
1357           <para />
1358         </listitem>
1359       </varlistentry>
1360       <varlistentry>
1361         <term>
1362           <menuchoice>
1363             <guimenu>Split</guimenu>
1364             <guimenuitem>Horizontal</guimenuitem>
1365           </menuchoice>
1366         </term>
1367         <listitem>
1368           <para>Splits main image view in two horizontal panes.</para>
1369         </listitem>
1370       </varlistentry>
1371       <varlistentry>
1372         <term>
1373           <menuchoice>
1374             <shortcut>
1375               <keycombo>
1376                 <keycap>U</keycap>
1377               </keycombo>
1378             </shortcut>
1379             <guimenu>Split</guimenu>
1380             <guimenuitem>Vertical</guimenuitem>
1381           </menuchoice>
1382         </term>
1383         <listitem>
1384           <para>Splits main image view in two vertical panes.</para>
1385         </listitem>
1386       </varlistentry>
1387       <varlistentry>
1388         <term>
1389           <menuchoice>
1390             <guimenu>Split</guimenu>
1391             <guimenuitem>Triple</guimenuitem>
1392           </menuchoice>
1393         </term>
1394         <listitem>
1395           <para>Splits main image view in three horizontal panes.</para>
1396         </listitem>
1397       </varlistentry>
1398       <varlistentry>
1399         <term>
1400           <menuchoice>
1401             <guimenu>Split</guimenu>
1402             <guimenuitem>Quad</guimenuitem>
1403           </menuchoice>
1404         </term>
1405         <listitem>
1406           <para>Splits main image view in four panes.</para>
1407         </listitem>
1408       </varlistentry>
1409       <varlistentry>
1410         <term>
1411           <menuchoice>
1412             <shortcut>
1413               <keycombo>
1414                 <keycap>Y</keycap>
1415               </keycombo>
1416             </shortcut>
1417             <guimenu>Split</guimenu>
1418             <guimenuitem>Single</guimenuitem>
1419           </menuchoice>
1420         </term>
1421         <listitem>
1422           <para>Reverts to normal view mode (one image).</para>
1423         </listitem>
1424       </varlistentry>
1425     </variablelist>
1426     <variablelist />
1427     <variablelist>
1428       <varlistentry>
1429         <term>
1430           <menuchoice>
1431             <guimenu>Image Overlay</guimenu>
1432             <guimenu>Image Overlay</guimenu>
1433           </menuchoice>
1434         </term>
1435         <listitem>
1436           <para>Displays Image Overlay information box (OSD), use twice to add histogram to it.</para>
1437         </listitem>
1438       </varlistentry>
1439       <varlistentry>
1440         <term>
1441           <menuchoice>
1442             <guimenu>Image Overlay</guimenu>
1443             <guimenu>Histogram channels</guimenu>
1444           </menuchoice>
1445         </term>
1446         <listitem>
1447           <para>Switches channels displayed in the histogram (red, green, blue, RGB, value, maximum value).</para>
1448         </listitem>
1449       </varlistentry>
1450       <varlistentry>
1451         <term>
1452           <menuchoice>
1453             <guimenu>Image Overlay</guimenu>
1454             <guimenu>Histogram log mode</guimenu>
1455           </menuchoice>
1456         </term>
1457         <listitem>
1458           <para>Toggles between linear and logarithmical histogram.</para>
1459         </listitem>
1460       </varlistentry>
1461       <varlistentry>
1462         <term>
1463           <guimenu>Full screen</guimenu>
1464         </term>
1465         <listitem>
1466           <para>Toggles the full screen window display.</para>
1467         </listitem>
1468       </varlistentry>
1469       <varlistentry>
1470         <term>
1471           <menuchoice>
1472             <shortcut>
1473               <keycombo>
1474                 <keycap>Shift</keycap>
1475                 <keycap>E</keycap>
1476               </keycombo>
1477             </shortcut>
1478             <guimenu>Over/Under Exposure</guimenu>
1479           </menuchoice>
1480         </term>
1481         <listitem>
1482           <para>
1483             Toggles highlighting of pixels that are either over or under exposed. This function operates on the displayed pixels. If a raw file is being displayed, the embedded jpeg data is being used. If the image is zoomed, the zoom type affects the results. Two-pass rendering also has some influence.
1484             <para />
1485             If a pixel has any channel at zero or full-scale, the pixel is displayed in red.
1486           </para>
1487         </listitem>
1488       </varlistentry>
1489       <varlistentry>
1490         <term>
1491           <guimenu>Keywords</guimenu>
1492         </term>
1493         <listitem>
1494           <para>Toggles display of the Keywords sidebar.</para>
1495         </listitem>
1496       </varlistentry>
1497       <varlistentry>
1498         <term>
1499           <guimenu>Sort manager</guimenu>
1500         </term>
1501         <listitem>
1502           <para>Toggles display of the Sort Manager sidebar.</para>
1503         </listitem>
1504       </varlistentry>
1505       <varlistentry>
1506         <term>
1507           <menuchoice>
1508             <shortcut>
1509               <keycombo>
1510                 <keycap>`</keycap>
1511               </keycombo>
1512             </shortcut>
1513             <guimenu>Hide Bars and Files</guimenu>
1514           </menuchoice>
1515         </term>
1516         <listitem>
1517           <para>This item is intended to be used by its shortcut key. When pressed, the info sidebar, sort manager, file list, menu and status bars will be hidden (if displayed). Pressing the shortcut key again will revert the display to its previous layout.</para>
1518         </listitem>
1519       </varlistentry>
1520       <varlistentry>
1521         <term>
1522           <menuchoice>
1523             <shortcut>
1524               <keycombo>
1525                 <keycap>Control</keycap>
1526                 <keycap>`</keycap>
1527               </keycombo>
1528             </shortcut>
1529             <guimenu>Hide Selectable Bars</guimenu>
1530           </menuchoice>
1531         </term>
1532         <listitem>
1533           <para>This item is intended to be used by its shortcut key. When pressed, bars selected in Preferences/General will be hidden. Pressing shortcut key again will revert the display to its previous layout.</para>
1534         </listitem>
1535       </varlistentry>
1536       <varlistentry>
1537         <term>
1538           <guimenu>Toggle slideshow</guimenu>
1539         </term>
1540         <listitem>
1541           <para>Begins or ends a slide show, the slide show status is displayed in the status bar.</para>
1542         </listitem>
1543       </varlistentry>
1544       <varlistentry>
1545         <term>
1546           <guimenu>Pause slideshow</guimenu>
1547         </term>
1548         <listitem>
1549           <para>Pauses a slide show, the slide show status is displayed in the status bar.</para>
1550         </listitem>
1551       </varlistentry>
1552       <varlistentry>
1553         <term>
1554           <guimenu>Faster</guimenu>
1555         </term>
1556         <listitem>
1557           <para>Decreases slide show interval in units of 0.5 seconds.</para>
1558         </listitem>
1559       </varlistentry>
1560       <varlistentry>
1561         <term>
1562           <guimenu>Slower</guimenu>
1563         </term>
1564         <listitem>
1565           <para>Increases slide show interval in units of 0.5 seconds.</para>
1566         </listitem>
1567       </varlistentry>
1568       <varlistentry>
1569         <term>
1570           <guimenu>Refresh</guimenu>
1571         </term>
1572         <listitem>
1573           <para>Updates the contents of the folder and file lists to match what is currently on disk, the current image will also be reread from disk.</para>
1574         </listitem>
1575       </varlistentry>
1576     </variablelist>
1577     <para />
1578   </section>
1579   <section id="Windowmenu">
1580     <title>Windows menu</title>
1581     <para>This menu permits you to define several different window layouts that can be recalled at any time.</para>
1582     <variablelist>
1583       <varlistentry>
1584         <term>
1585           <menuchoice>
1586             <shortcut>
1587               <keycombo>
1588                 <keycap>Ctrl</keycap>
1589                 <keycap>N</keycap>
1590               </keycombo>
1591             </shortcut>
1592             <guimenu>New window</guimenu>
1593             <guimenuitem>default</guimenuitem>
1594           </menuchoice>
1595         </term>
1596         <listitem>
1597           <para>Opens a new window with the default layout. The window is given a name in the form "lw&lt;n&gt;".</para>
1598         </listitem>
1599       </varlistentry>
1600       <varlistentry>
1601         <term>
1602           <menuchoice>
1603             <guimenu>New window</guimenu>
1604             <guimenuitem>from current</guimenuitem>
1605           </menuchoice>
1606         </term>
1607         <listitem>
1608           <para>Opens a new window with the layout of the window that has focus.  The window is given a name in the form "lw&lt;n&gt;".</para>
1609         </listitem>
1610       </varlistentry>
1611       <varlistentry>
1612         <term>
1613           <menuchoice>
1614             <guimenu>Rename window</guimenu>
1615           </menuchoice>
1616         </term>
1617         <listitem>
1618           <para>If a window is given a name that does not begin with the characters "lw", the layout will be saved and be available for loading at a later time..</para>
1619         </listitem>
1620       </varlistentry>
1621       <varlistentry>
1622         <term>
1623           <menuchoice>
1624             <guimenu>Delete window</guimenu>
1625           </menuchoice>
1626         </term>
1627         <listitem>
1628           <para>Delete a saved window layout from the list.</para>
1629         </listitem>
1630       </varlistentry>
1631       <varlistentry>
1632         <term>
1633           <menuchoice>
1634             <guimenu>Close window</guimenu>
1635           </menuchoice>
1636         </term>
1637         <listitem>
1638           <para>Close the window. If the window is the "main" window, close all windows.</para>
1639         </listitem>
1640       </varlistentry>
1641     </variablelist>
1642   </section>
1643   <section id="Helpmenu">
1644     <title>Help menu</title>
1645     <variablelist>
1646       <varlistentry>
1647         <term>
1648           <menuchoice>
1649             <shortcut>
1650               <keycombo>
1651                 <keycap>F1</keycap>
1652               </keycombo>
1653             </shortcut>
1654             <guimenu>Contents</guimenu>
1655           </menuchoice>
1656         </term>
1657         <listitem>
1658           <para>Opens the Geeqie user manual in a new browser window.</para>
1659         </listitem>
1660       </varlistentry>
1661       <varlistentry>
1662         <term>
1663           <menuchoice>
1664             <shortcut>
1665               <keycombo>
1666                 <keycap>/</keycap>
1667               </keycombo>
1668             </shortcut>
1669             <guimenu>Search and Run Commands</guimenu>
1670           </menuchoice>
1671         </term>
1672         <listitem>
1673           <para>
1674             Opens a text box in which you may type characters to find a command. The characters you type will be matched to the first characters of any word in all the commands in Geeqie - both built-in commands and plugins - and matching actions will be displayed in a pop-up. You may scroll to any of the matching commands and press
1675             <code>Enter</code>
1676             to execute the command. Pressing
1677             <code>Enter</code>
1678             without selecting from the list will execute the first action in the list. Press
1679             <code>Esc</code>
1680             to close the box.
1681           </para>
1682         </listitem>
1683       </varlistentry>
1684       <varlistentry>
1685         <term>
1686           <menuchoice>
1687             <guimenu>On-line help search</guimenu>
1688           </menuchoice>
1689         </term>
1690         <listitem>
1691           <para>
1692             Use a web browser to search Geeqie's on-line help files. The search engine used is defined in
1693             <link linkend="OnLineHelpSearch">Preferences General</link>
1694             .
1695           </para>
1696         </listitem>
1697       </varlistentry>
1698       <varlistentry>
1699         <term>
1700           <menuchoice>
1701             <guimenu>Keyboard shortcuts</guimenu>
1702           </menuchoice>
1703         </term>
1704         <listitem>
1705           <para>Displays a window listing the default keyboard shortcuts.</para>
1706         </listitem>
1707       </varlistentry>
1708       <varlistentry>
1709         <term>
1710           <menuchoice>
1711             <guimenu>Keyboard Map</guimenu>
1712           </menuchoice>
1713         </term>
1714         <listitem>
1715           <para>Displays an image showing the currently allocated keyboard shortcuts.</para>
1716         </listitem>
1717       </varlistentry>
1718       <varlistentry>
1719         <term>
1720           <menuchoice>
1721             <guimenu>Release notes</guimenu>
1722           </menuchoice>
1723         </term>
1724         <listitem>
1725           <para>Displays a window containing the release notes for the version of Geeqie in use.</para>
1726         </listitem>
1727       </varlistentry>
1728       <varlistentry>
1729         <term>
1730           <menuchoice>
1731             <guimenu>About</guimenu>
1732           </menuchoice>
1733         </term>
1734         <listitem>
1735           <para>Opens a window containing the Geeqie version, credits, website, and email contact information.</para>
1736         </listitem>
1737       </varlistentry>
1738       <varlistentry>
1739         <term>
1740           <menuchoice>
1741             <guimenu>Log window</guimenu>
1742           </menuchoice>
1743         </term>
1744         <listitem>
1745           <para>Opens the log window, mostly used for debugging purposes.</para>
1746         </listitem>
1747       </varlistentry>
1748     </variablelist>
1749     <para />
1750   </section>
1751   <section id="Tearoffmenus">
1752     <title>Tear off menus</title>
1753     <para>Menus can be permanently displayed by selecting the dotted line item at the top of each menu category. A tear off menu will behave the same as an ordinary window. To close a tear off menu, select the dotted line item at the top of the menu.</para>
1754     <para />
1755   </section>
1756   <section id="Keyboardshortcuts">
1757     <title>Keyboard shortcuts</title>
1758     <para>
1759       The keyboard sequence associated to each menu entry is listed within the main window menu bar. For reference, the complete list of default keyboard shortcuts can be found in section
1760       <link linkend="GuideReferenceKeyboardShortcuts">Keyboard Shortcuts</link>
1761       .
1762     </para>
1763     <para />
1764   </section>
1765   <section id="Changingthemainwindowmenubarkeyboardshortcuts">
1766     <title>Changing the main window menu bar keyboard shortcuts</title>
1767     <para>
1768       The section
1769       <link linkend="GuideOptionsKeyboard" endterm="titleGuideOptionsKeyboard" />
1770       describes how to modify the keyboard shortcuts used in the main menu.
1771     </para>
1772   </section>
1773 </section>