Update wmbattery on dockapps webpage.
[whome.git] / guidedtour / dock.html
blobf3e9051464546d3fbd82b814171b4e73d66aebdd
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html><head><title>Window Maker - Dock</title>
8 <link href="title.css" rel="stylesheet" type="text/css">
11 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"></head>
12 <strong> </strong>
13 <h1><strong>
14 <center>DOCK</center>
15 </strong></h1>
17 <h2><strong></strong></h2>
19 <strong></strong>
20 <center><a href="index.html">Back to index</a></center>
22 <ul>
24 <li><a href="dock.html#what" name="what">Application dock</a></li>
25 <li><a href="dock.html#start" name="start">Starting an application</a></li>
26 <li><a href="dock.html#cust" name="cust">Customizing</a></li>
27 <li><a href="dock.html#conf" name="conf">Configuring</a></li>
28 </ul>
30 <h2><a name="what">Application dock</a></h2>
33 <p>The dock is the column of icons located by default on the right
34 side of the screen.</p>
36 <p>Any application can be attached to the dock. To do this, open an
37 application then simply left-click-and-drag the application's icon to
38 the last position on the dock. The dock will "attract" the icon and it
39 will remain on the dock until removed by the user (left-click-and-drag
40 the icon off the dock - it will disappear.) If you have saved your
41 Window Maker session prior to logout (or set Window Maker to autosave
42 your session upon logout) any icons you docked will automatically
43 reappear at your next - and each subsequent - session.<br>
44 </p>
46 <p>The dock has it's own menu for user configuration.<br>
47 </p>
49 <p>The dock can be configured to remain on top of maximized windows. To
50 do this, right-click on any docked icon then select "Keep on top" from
51 the application icon menu. This will keep the entire dock visible
52 (maximized windows will not be allowed to cover the dock). To allow the
53 dock to be covered, uncheck the "Keep on top" item in the application
54 icon menu.<br>
55 </p>
57 <p>The WMDock icon (by default, with the GNUstep logo) can be dragged
58 sideways
59 to switch the
60 the entire dock from one side of the display to the other.<br>
61 </p>
63 <p>Dragging the WMDock icon downward will move the dock off the display
64 with the
65 exception of the WMDock icon itself, which will remain visible. To
66 restore dock visibility, left-click-and-drag the dock back on screen.<br>
67 </p>
69 <h2><a name="start">Starting an application</a></h2>
72 <p>Double-clicking the icon of a docked application starts the
73 application. <br>
74 </p>
76 <p>An application that has not been launched normally has an elipsis
77 (three dots) in the bottom-left-corner of the icon and appears in full
78 color as shown below.&nbsp; <br>
79 </p>
81 <p style="text-align: center;"><img style="width: 62px; height: 62px;" alt="Unlaunched application icon" src="images/iconwithelipsis.png"><br>
82 </p>
84 <p>When the application is running, the elipsis disappears from the
85 bottom-left-corner of the icon and the icon becomes "greyed out,"
86 giving a visual cue that the application is already open. <br>
87 </p>
89 <p style="text-align: center;"><img style="width: 62px; height: 62px;" alt="Launched application icon" src="images/greyedouticon.png"><br>
90 </p>
92 <p>A docked icon that continues to show an elipsis and remains "full
93 color" even after an instance of the
94 application is running indicates that the application's settings have
95 been modified to allow multiple launches from one docked icon. To do
96 this you must open the application and modify the
97 "application specific" settings in the <a href="win.html#menu">"commands
98 menu"</a> of the application to allow
99 "shared application icons."</p>
101 <p>Using the "launch" command in the "application icon menu" for the
102 icon is another way to start an application from the dock.<br>
103 <br>
104 From version 0.80.0 on, the dock can "steal" appicons. This feature has
105 nothing to
106 do with Autoattract Icons. When you start an application from somewhere
107 else
108 than either the clip or the dock (menu or terminal), and the appicon
109 exists in
110 one of them (clip or dock), this appicon doesn't appear at the bottom
111 of your
112 screen. The appicon existing in the clip or the dock "stole" it. As a
113 result, the
114 appicon is the same as the one used to start the application from the
115 clip or
116 the dock. </p>
118 <p> </p>
120 <h2><a name="cust">Customizing</a></h2>
123 <p>Left-clicking and dragging an application icon to the dock adds this
124 application to the dock. Obviously, this means the application is
125 running! <br>
126 </p>
128 <p><span style="font-style: italic;">Miniwindows</span> (windows of
129 minimized applications) cannot be docked. The small titlebar on the
130 miniwindow differentiates it from an application's icon. <br>
131 </p>
133 <p>Dragging an icon off the dock removes the docked application.&nbsp; <br>
134 </p>
136 <p> </p>
138 <h2><a name="conf">Configuring</a></h2>
141 <p>There is a dock menu for each icon. Right-clicking the icon displays
142 the "application icon menu." Select the "Settings..." option to
143 configure the application.&nbsp;</p>
145 <center>
146 <p><a href="images/docks.jpg"><img src="images/docks.jpg" alt="dock"></a></p>
147 </center>
149 <p>The application's <span style="font-style: italic;">path</span> and
150 its arguments, the command for middle-click launch, and the icon
151 employed can
152 be changed in this panel.<br>
153 </p>
155 <p>Shell commands such as redirection cannot be used in the command
156 field. <br>
157 </p>
159 <p>The desired icon must be in one of the directories displayed
160 in the panel while browsing. New directories can be added from the <a href="prefs.html#search">Search path preferences</a><br>
161 </p>
163 <p> A checkbox allows you to start the application when Window Maker is
164 first started. (Note: <span style="font-style: italic;">You want to be
165 careful with this</span>. If you have, for example, your terminal
166 emulator, your file manager, and your browser set to start when Window
167 Maker is started you'll get an open terminal, an open file manager and
168 an open browser <span style="font-style: italic;">every time</span>
169 you start a session! Normally you will only want to start certain
170 dockapps - "regular" applications like a terminal emulator or browser
171 can be started <span style="font-style: italic;">after</span> your
172 session is up and going.)<br>
173 </p>
175 <p>From version 0.62.0 on, a checkbox can be used to prevent accidental
176 removal from the dock. <br>
177 <br>
178 From version 0.70.0 on, a new field has been added for middle-click
179 launch. Entering, for example, "firefox" into a docked
180 application
181 settings panel will launch the Firefox browser.<br>
182 <br>
183 </p>
185 <p> </p>
187 <center><a href="index.html">Back to index</a></center>
189 </body></html>