mirror of
https://github.com/gryf/window-maker.github.io.git
synced 2025-12-17 19:20:17 +01:00
371 lines
15 KiB
HTML
371 lines
15 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<title>Window Maker: User Guide - Workspace</title>
|
|
<meta charset="utf-8">
|
|
<link rel="stylesheet" href="/style.css" media="screen">
|
|
<meta name="HandheldFriendly" content="True">
|
|
<meta name="MobileOptimized" content="320">
|
|
<meta name="viewport"
|
|
content="width=device-width, minimumscale=1.0, maximum-scale=1.0">
|
|
</head>
|
|
<body>
|
|
<div id="wrapper">
|
|
<header>
|
|
<h1>
|
|
<a href="/">
|
|
<span class="first">Window</span><span class="second">Maker</span>
|
|
</a>
|
|
</h1>
|
|
</header>
|
|
<aside>
|
|
<nav class="menu">
|
|
<ul>
|
|
<li id="dock">
|
|
<a href="#"></a>
|
|
</li>
|
|
<li id="home" title="Home">
|
|
<a href="/">Home</a>
|
|
</li>
|
|
<li id="news" title="News">
|
|
<a href="/news">News</a>
|
|
</li>
|
|
<li id="docs" title="Documentation">
|
|
<a href="/docs">Documentation</a>
|
|
</li>
|
|
<li id="mail" title="Mailing lists">
|
|
<a href="/lists">Mailing</a>
|
|
</li>
|
|
<li id="devel" title="Development">
|
|
<a href="/dev">Development</a>
|
|
</li>
|
|
<li id="screenshots" title="Screenshots">
|
|
<a href="/screenshots">Screenshots</a>
|
|
</li>
|
|
<li id="themes" title="Themes">
|
|
<a href="/themes">Themes</a>
|
|
</li>
|
|
<li id="links" title="Links">
|
|
<a href="/links">Links</a>
|
|
</li>
|
|
</ul>
|
|
</nav>
|
|
</aside>
|
|
<article>
|
|
|
|
<div class="document" id="the-workspace">
|
|
<h1 class="title">The Workspace</h1>
|
|
|
|
<div class="section" id="working-with-menus">
|
|
<h1>Working with Menus</h1>
|
|
<p>Menus provide a list of commands that you can execute.</p>
|
|
<div class="borderless figure">
|
|
<img alt="An Example Menu" src="guide/images/menu.gif">
|
|
</div>
|
|
<p>To execute a command listed in a menu, click in the corresponding item. The
|
|
item will blink telling that the command is going to be executed.</p>
|
|
<p>Grayed commands are disabled and cannot be executed at that moment. If you
|
|
click on them nothing will happen.</p>
|
|
<p>Some menu entries have a little triangular indicator at the right. Selecting
|
|
these entries will open a submenu, with a new list of commands.</p>
|
|
<p>You can use the keyboard to traverse and execute commands in some of the menus.
|
|
First you must hit the key used to open the menu - like F12 for the root menu -
|
|
to enable keyboard traversal of it. Then you can use the Up and Down arrow keys
|
|
to change the current selected item and the Left and Right arrow keys to jump
|
|
between submenus and parent menus. To execute the current selected item press
|
|
Return. To close the menu or stop menu traversal, press Escape. Additionally,
|
|
pressing the first letter for an menu item, will jump the current selection to
|
|
that item.</p>
|
|
<p>You can make frequently used menus "stick" to the workspace by dragging the
|
|
titlebar of the menu. This will make a close button appear in the menu
|
|
titlebar. If you want to close the menu, just click in that button.</p>
|
|
<p>Menus are normally placed on top of other windows and cannot be obscured by
|
|
them. If you want the menus to be able to be obscured by lowering them, double
|
|
click the menu titlebar while holding the Meta key. Repeat this to make the
|
|
menus not obscurable again.</p>
|
|
<div class="section" id="the-root-window-menu">
|
|
<h2>The Root Window Menu</h2>
|
|
<p>The <em>Root Window Menu</em> or <em>Applications Menu</em> has items that allow you to
|
|
quickly launch applications and do some workspace management.</p>
|
|
<p>To open this menu, click on the workspace (root window) with the 3rd mouse
|
|
button or hit the key bound to it (F12 by default).</p>
|
|
<p>The contents of the applications menu can be configured to hold the
|
|
applications installed on your system. To learn how to configure it, read the
|
|
section on application menu configuration.</p>
|
|
</div>
|
|
<div class="section" id="the-window-list-menu">
|
|
<h2>The Window List Menu</h2>
|
|
<p>Clicking in the workspace with the middle mouse button will open a menu listing
|
|
all windows that currently exist, with the workspace in which the window is
|
|
located to its right. The current focused window is marked by a diamond sign
|
|
next to its name. Clicking in an entry in this menu will focus the window,
|
|
raise it, and change to the workspace where it is located.</p>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="working-with-applications">
|
|
<h1>Working with Applications</h1>
|
|
<p>In WindowMaker the instance of a running application is represented by an
|
|
application icon. Do not confuse it with the icons (miniwindows in WindowMaker)
|
|
displayed by other window managers when a window is iconified. Application
|
|
icons and miniwindows can be differentiated in that miniwindows have titlebars,
|
|
application icons do not.</p>
|
|
<p>WindowMaker identifies a group of windows as belonging to a single instance of
|
|
an application through some standard hints that the application sets in its
|
|
windows. Unfortunately, not all applications that exist set these hints,
|
|
preventing some application-specific features from working. These hints are
|
|
<strong>WM.CLASS</strong>, <strong>WM.COMMAND</strong>, and <strong>WM.CLIENT.LEADER</strong> or the group leader in
|
|
<strong>WM.HINTS</strong>.</p>
|
|
<p>Note: The information about applications contained in this section only applies
|
|
to versions of WindowMaker built without the --enable-single-icon compile time
|
|
option. This option is unsupported and behaviour when it's enabled will not be
|
|
covered in this text.</p>
|
|
<div class="section" id="hiding-an-application">
|
|
<h2>Hiding an Application</h2>
|
|
<p>If you want to close and application but intend to use it later you can <em>hide</em>
|
|
it. When you hide an application all windows and miniwindows that belong to
|
|
that application will be removed from the screen and hidden into its
|
|
application icon.</p>
|
|
<p>To hide an application:</p>
|
|
<ul class="simple">
|
|
<li><p>Click the miniaturize button of any of the windows that belong to the
|
|
application while holding the Control key.</p></li>
|
|
</ul>
|
|
<p>OR</p>
|
|
<ul class="simple">
|
|
<li><p>Press the keyboard shortcut assigned to it, which is Meta+h in the default
|
|
configuration.</p></li>
|
|
</ul>
|
|
<p>OR</p>
|
|
<ul class="simple">
|
|
<li><p>User the hide command in the <a class="reference external" href="chap2.html#the-window-commands-menu">window commands menu</a> brought up when the window titlebar
|
|
is clicked with the right mouse button.</p></li>
|
|
</ul>
|
|
<p>OR</p>
|
|
<ul class="simple">
|
|
<li><p>Use the (Un)Hide command in the application icon commands menu brought up
|
|
when the application icon is clicked with the right mouse button.</p></li>
|
|
</ul>
|
|
<p>To unhide an application</p>
|
|
<ul class="simple">
|
|
<li><p>Double click the application icon with the left mouse button.</p></li>
|
|
</ul>
|
|
<p>OR</p>
|
|
<ul class="simple">
|
|
<li><p>Use the (Un)Hide command in the application icon commands menu brought up
|
|
when the application icon is clicked with the right mouse button.</p></li>
|
|
</ul>
|
|
<p>When you unhide an application, all it's windows and miniwindows will brought
|
|
back, and you will be taken to the last workspace in which you worked with that
|
|
application.</p>
|
|
<p><strong>Extra Bindings</strong></p>
|
|
<table>
|
|
<colgroup>
|
|
<col style="width: 49%">
|
|
<col style="width: 51%">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="head"><p>Action</p></th>
|
|
<th class="head"><p>Effect</p></th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><p>Double-click the application icon
|
|
while holding the Meta key</p></td>
|
|
<td><p>Unhide the clicked application,
|
|
and hide all other applications
|
|
that are present in the current
|
|
workspace.</p></td>
|
|
</tr>
|
|
<tr>
|
|
<td><p>Double-click the application icon
|
|
while holding the Shift key</p></td>
|
|
<td><p>Unhide the clicked application in
|
|
the current workspace</p></td>
|
|
</tr>
|
|
<tr>
|
|
<td><p>Double-click the application icon
|
|
with the middle mouse button</p></td>
|
|
<td><p>Unhide the clicked application and
|
|
deminiaturize all its windows.</p></td>
|
|
</tr>
|
|
<tr>
|
|
<td><p>Double-click the window titlebar
|
|
with the right mouse button while
|
|
holding the Meta key.</p></td>
|
|
<td><p>Hide all applications in the
|
|
current workspace except for the
|
|
clicked one.</p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p>There are two other commands in the applications menu related to application
|
|
hiding:</p>
|
|
<dl class="simple">
|
|
<dt>Hide others</dt>
|
|
<dd>
|
|
<p>Hide all applications in the current workspace, except for the currently
|
|
active one.</p>
|
|
</dd>
|
|
<dt>Show All</dt>
|
|
<dd>
|
|
<p>Unhide all applications that were hidden from the current workspace</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<div class="section" id="the-application-icon-menu">
|
|
<h2>The Application Icon Menu</h2>
|
|
<p>A menu with commands that will apply to the application can be brought up by
|
|
clicking the application icon with the right mouse button.</p>
|
|
<p>The commands available in this menu are:</p>
|
|
<dl class="simple">
|
|
<dt>Unhide Here</dt>
|
|
<dd>
|
|
<p>Unhides the application in the current workspace.</p>
|
|
</dd>
|
|
<dt>(Un)Hide</dt>
|
|
<dd>
|
|
<p>Hides the application. Unless the application is already hidden, in which
|
|
case it will unhide the application and take you to its workspace.</p>
|
|
</dd>
|
|
<dt>Set Icon...</dt>
|
|
<dd>
|
|
<p>Opens the icon image selection panel for the application icon.</p>
|
|
</dd>
|
|
<dt>Kill</dt>
|
|
<dd>
|
|
<p>Will kill the application.</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<div class="section" id="the-application-dock">
|
|
<h2>The Application Dock</h2>
|
|
<p>The application dock is a place where you can store frequently used
|
|
applications for easy and fast access. It is located, by default, on the right
|
|
side of the screen.</p>
|
|
<p>You can click the top icon (the one with the GNUstep logo) and drag it downward
|
|
to remove most of the dock from view. You can also drag it sideways to move
|
|
the entire dock from side of the screen to the other.</p>
|
|
<p>A menu similar to the <a class="reference external" href="#the-application-icon-menu">application icon menu</a> is
|
|
brought up when you click a docked icon with the right mouse button.</p>
|
|
<p>To make the dock <em>float</em> over windows (not be coverable by windows), either
|
|
double-click the top dock icon while holding the Meta key, or select the
|
|
"Floating Dock" option in the dock menu.</p>
|
|
<div class="section" id="starting-a-docked-application">
|
|
<h3>Starting a docked application</h3>
|
|
<p>To start an application that is docked, double-click its icon. The icon will be
|
|
briefly highlighted and the application will start.</p>
|
|
<p>While an application is not running an ellipsis is present in the lower
|
|
left-hand corner of the icon. This ellipsis will disappear when the application
|
|
is started and reappear when the application is exited.</p>
|
|
<p>While the application is running the docked icon will behave just like a
|
|
normal, undocked application icon, except for some extra actions specific to
|
|
the dock.</p>
|
|
<p>To start a docked application:</p>
|
|
<ul class="simple">
|
|
<li><p>Double-click the application icon with the left mouse button.</p></li>
|
|
</ul>
|
|
<p>OR</p>
|
|
<ul class="simple">
|
|
<li><p>Use the "Launch" command in the dock menu for the icon. If the application is
|
|
already running it will start another instance.</p></li>
|
|
</ul>
|
|
<p>OR</p>
|
|
<ul class="simple">
|
|
<li><p>Hold the Control key while double-clicking the icon to start another instance
|
|
of the application.</p></li>
|
|
</ul>
|
|
<p>If a new instance of an already running application is started it will get a
|
|
new application icon.</p>
|
|
</div>
|
|
<div class="section" id="customizing-the-dock">
|
|
<h3>Customizing the dock</h3>
|
|
<p>To add new applications to the dock, you can click an application icon and drag
|
|
it onto the dock. When a ghost image of the icon appears you can release the
|
|
mouse button and the icon will be docked.</p>
|
|
<p>To reorder the docked applications, drag an icon to an empty slot and move the
|
|
icons around as you want.</p>
|
|
<p>To remove a docked application, drag it from the dock and release the mouse
|
|
button when the ghost image disappears. To remove the icon of an application
|
|
that is running, hold the Meta key while dragging it.</p>
|
|
</div>
|
|
<div class="section" id="configuring-the-docked-application">
|
|
<h3>Configuring the docked application</h3>
|
|
<p>To change the settings of a docked application, select the "Settings..." item
|
|
in the dock menu for that icon. A settings panel for that icon will appear.</p>
|
|
<div class="borderless figure">
|
|
<img alt="Docked Application Settings Panel" src="guide/images/dockapppanel.gif">
|
|
</div>
|
|
<p>In the <em>Application path and arguments</em> field, the path for the application and
|
|
its arguments can be changed. Note that you can't change the application that
|
|
is represented in the icon or change anything that would cause the application
|
|
name to be changed. For example, if the icon is for <span class="docutils literal">xterm</span> you can't change
|
|
the field's value to <strong>ghostview</strong>; or if the icon is for <span class="docutils literal">xterm <span class="pre">-name</span> vi</span>,
|
|
you can't change it to <span class="docutils literal">xterm <span class="pre">-name</span> pine</span>. Also note that you cannot use
|
|
shell commands, such as output redirectors. (<span class="docutils literal">></span>, <span class="docutils literal">>></span>; etc.)</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="working-with-workspaces">
|
|
<h1>Working with Workspaces</h1>
|
|
<div class="section" id="the-workspaces-menu">
|
|
<h2>The Workspaces Menu</h2>
|
|
<p>The <em>Workspaces Menu</em> allows you to create, switch, destroy and rename
|
|
workspaces.</p>
|
|
<p>It has the following items:</p>
|
|
<dl class="simple">
|
|
<dt>New</dt>
|
|
<dd>
|
|
<p>Creates a new workspace and automatically switches to it</p>
|
|
</dd>
|
|
<dt>Destroy Last</dt>
|
|
<dd>
|
|
<p>Destroys the last workspace unless it is occupied</p>
|
|
</dd>
|
|
<dt>Workspaces</dt>
|
|
<dd>
|
|
<p>Each workspace has a corresponding item in the Workspaces menu. Clicking in
|
|
one of these entries will switch from the current workspace to the selected
|
|
workspace.</p>
|
|
</dd>
|
|
</dl>
|
|
<p>The current active workspace is indicated by a small indicator at the left of
|
|
the workspace item.</p>
|
|
<div class="borderless figure">
|
|
<img alt="Workspace Menu" src="guide/images/wsmenu.gif">
|
|
</div>
|
|
<p>To change the name of a workspace you must first "stick" the menu. Then Control
|
|
click in the item corresponding to the workspace you want to rename. The item
|
|
will turn into a editable text field where you can edit the workspace name. To
|
|
finish editing the workspace name, press Return; to cancel it, press Escape.</p>
|
|
<p>There is a limit of 16 characters on the length of the workspace name.</p>
|
|
<p>An example Workspace menu being edited:</p>
|
|
<div class="borderless figure">
|
|
<img alt="Workspace Menu: Editing a Workspace name" src="guide/images/wsmenued.gif">
|
|
</div>
|
|
</div>
|
|
<div class="section" id="the-workspace-clip">
|
|
<h2>The workspace clip</h2>
|
|
<!-- WTF is that?? -->
|
|
<p>[This section was unavailable in the original, and thus is not here]</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
</article>
|
|
<div id="titlebar">
|
|
<div id="minimize"></div>
|
|
<div id="titlebar-inner">Window Maker: User Guide - Workspace</div>
|
|
<div id="close"></div>
|
|
</div>
|
|
<div id="resizebar">
|
|
<div id="resizel"></div>
|
|
<div id="resizebar-inner">
|
|
</div>
|
|
<div id="resizer"></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|