Changeset 97ee53d for x/wm/icewm.xml
- Timestamp:
- 03/22/2020 08:34:34 AM (4 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- dcee7a56
- Parents:
- 1b70960
- File:
-
- 1 edited
-
x/wm/icewm.xml (modified) (20 diffs)
Legend:
- Unmodified
- Added
- Removed
-
x/wm/icewm.xml
r1b70960 r97ee53d 30 30 <title>Introduction to IceWM</title> 31 31 32 <para><application>IceWM</application> is a window manager with the goals of 33 speed, simplicity, and not getting in the user's way.</para> 32 <para> 33 <application>IceWM</application> is a window manager with the goals of 34 speed, simplicity, and not getting in the user's way. 35 </para> 34 36 35 37 &lfs91_checked; … … 38 40 <itemizedlist spacing="compact"> 39 41 <listitem> 40 <para>Download (HTTP): <ulink url="&icewm-download-http;"/></para> 42 <para> 43 Download (HTTP): <ulink url="&icewm-download-http;"/> 44 </para> 41 45 </listitem> 42 46 <listitem> 43 <para>Download (FTP): <ulink url="&icewm-download-ftp;"/></para> 47 <para> 48 Download (FTP): <ulink url="&icewm-download-ftp;"/> 49 </para> 44 50 </listitem> 45 51 <listitem> 46 <para>Download MD5 sum: &icewm-md5sum;</para> 52 <para> 53 Download MD5 sum: &icewm-md5sum; 54 </para> 47 55 </listitem> 48 56 <listitem> 49 <para>Download size: &icewm-size;</para> 57 <para> 58 Download size: &icewm-size; 59 </para> 50 60 </listitem> 51 61 <listitem> 52 <para>Estimated disk space required: &icewm-buildsize;</para> 62 <para> 63 Estimated disk space required: &icewm-buildsize; 64 </para> 53 65 </listitem> 54 66 <listitem> 55 <para>Estimated build time: &icewm-time;</para> 67 <para> 68 Estimated build time: &icewm-time; 69 </para> 56 70 </listitem> 57 71 </itemizedlist> … … 81 95 <title>Installation of IceWM</title> 82 96 83 <para>Install <application>IceWM</application> by running the following 84 commands:</para> 97 <para> 98 Install <application>IceWM</application> by running the following 99 commands: 100 </para> 85 101 86 102 <screen><userinput>mkdir build && … … 95 111 make</userinput></screen> 96 112 97 <para>This package does not have a working testsuite.</para> 98 99 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 113 <para> 114 This package does not have a working testsuite. 115 </para> 116 117 <para> 118 Now, as the <systemitem class="username">root</systemitem> user: 119 </para> 100 120 <!-- 101 121 <screen role="root"><userinput>cp ../lib/IceWM.jpg lib && … … 136 156 <title>Config Files</title> 137 157 138 <para><filename>~/.icewm/keys</filename>, 158 <para> 159 <filename>~/.icewm/keys</filename>, 139 160 <filename>~/.icewm/menu</filename>, and 140 161 <filename>~/.icewm/preferences</filename>, and … … 144 165 and will be used if you have not copied them to <filename 145 166 class="directory">~/.icewm</filename>. 146 167 </para> 147 168 148 169 … … 172 193 <title>Configuration Information</title> 173 194 174 <para>If <application>IceWM</application> is the only Window Manager you 175 want to use, you can start it with an <filename>.xinitrc</filename> file 176 in your home folder. Be sure to backup your current 177 <filename>.xinitrc</filename> before proceeding.</para> 195 <para> 196 If <application>IceWM</application> is the only Window Manager you 197 want to use, you can start it with an <filename>.xinitrc</filename> file 198 in your home folder. Be sure to backup your current 199 <filename>.xinitrc</filename> before proceeding. 200 </para> 178 201 179 202 <indexterm zone="icewm icewm-config"> … … 183 206 <screen><userinput>echo icewm-session > ~/.xinitrc</userinput></screen> 184 207 185 <para>Now create the <application>IceWM</application> configuration 186 files:</para> 208 <para> 209 Now create the <application>IceWM</application> configuration files: 210 </para> 187 211 188 212 <screen><userinput>mkdir -v ~/.icewm && … … 193 217 cp -v /usr/share/icewm/winoptions ~/.icewm/winoptions</userinput></screen> 194 218 195 <para>You can now edit these files to meet your requirements. In 196 particular, review the <filename>preferences</filename> file. You can use 197 <command>Logout -> Restart-IceWM</command> on the main menu to load your 198 changed preferences, but changes to the background only take effect when 199 <application>IceWM</application> is started.</para> 200 201 <para>At this point you can <emphasis>either</emphasis> modify the 202 traditional menu files to suit your requirements, <emphasis>or</emphasis> 203 use the newer <command>icewm-menu-fdo</command> described later.</para> 204 205 <para>The syntax of the menus is explained in the help files, which you 206 can access by running <command>help</command> from the menu, but some of 207 the detail is out of date and the default selections in the menus (a few 208 old applications on the main menu, everything else on the 209 <command>Programs</command> menu) will benefit from being updated to meet 210 your needs. The following examples are provided to encourage you to 211 think about how you wish to organise your menus. Please note the 212 following:</para> 219 <para> 220 You can now edit these files to meet your requirements. In particular, 221 review the <filename>preferences</filename> file. You can use 222 <command>Logout -> Restart-IceWM</command> on the main menu to load 223 your changed preferences, but changes to the background only take 224 effect when <application>IceWM</application> is started. 225 </para> 226 227 <para> 228 At this point you can <emphasis>either</emphasis> modify the 229 traditional menu files to suit your requirements, 230 <emphasis>or</emphasis> use the newer 231 <command>icewm-menu-fdo</command> described later. 232 </para> 233 234 <para> 235 The syntax of the menus is explained in the help files, which you can 236 access by running <command>help</command> from the menu, but some of 237 the detail is out of date and the default selections in the menus (a 238 few old applications on the main menu, everything else on the 239 <command>Programs</command> menu) will benefit from being updated to 240 meet your needs. The following examples are provided to encourage you 241 to think about how you wish to organise your menus. Please note the 242 following: 243 </para> 213 244 214 245 <itemizedlist> 215 246 <listitem> 216 <para>If a program listed in the menu has not been installed, it will 217 not appear when the menu is displayed. Similarly, if the program 218 exists but the specified icon does not, no icon will be displayed in 219 the menu.</para> 220 </listitem> 221 <listitem> 222 <para>The icons can be either <filename>.xpm</filename> or 223 <filename>.png</filename> files, and there is no need to specify the 224 extension. If the icon is located in the "library" 225 (<filename class="directory">/usr/share/icewm/icons</filename>) there 226 is no need to specifiy the path.</para> 227 </listitem> 228 <listitem> 229 <para>Most programs are in sub-menus, and the main menu will always 230 append entries for <literal>windows, help, settings, logout</literal> 231 at the bottom.</para> </listitem> 232 <listitem> 233 <para>An icon for <application>firefox</application> was copied to 234 the library directory and given a meaningful name. The icon for 235 <application>xine</application> is <filename>xine.xpm</filename> 236 which was installed to a pixmap directory.</para> 237 </listitem> 238 <listitem> 239 <para>The default toolbar is not altered.</para> 247 <para> 248 If a program listed in the menu has not been installed, it will 249 not appear when the menu is displayed. Similarly, if the program 250 exists but the specified icon does not, no icon will be displayed 251 in the menu. 252 </para> 253 </listitem> 254 <listitem> 255 <para> 256 The icons can be either <filename>.xpm</filename> or 257 <filename>.png</filename> files, and there is no need to specify 258 the extension. If the icon is located in the "library" 259 (<filename class="directory">/usr/share/icewm/icons</filename>) 260 there is no need to specifiy the path. 261 </para> 262 </listitem> 263 <listitem> 264 <para> 265 Most programs are in sub-menus, and the main menu will always 266 append entries for 267 <literal>windows, help, settings, logout</literal> 268 at the bottom. 269 </para> 270 </listitem> 271 <listitem> 272 <para> 273 An icon for <application>firefox</application> was copied to 274 the library directory and given a meaningful name. The icon for 275 <application>xine</application> is <filename>xine.xpm</filename> 276 which was installed to a pixmap directory. 277 </para> 278 </listitem> 279 <listitem> 280 <para> 281 The default toolbar is not altered. 282 </para> 240 283 </listitem> 241 284 </itemizedlist> 242 285 243 <para>If you wish to use this traditional method, there are more examples in 286 <para> 287 If you wish to use this traditional method, there are more examples in 244 288 previous releases of this book (e.g. BLFS-7.8). 245 289 </para> 246 290 247 <para><emphasis>Alternatively</emphasis>, you can create a menu which conforms 248 to the FDO Desktop Menu Specifications, where programs can be found because 249 they have a .desktop file in the XDG_DATA_HOME or XDG_DATA_DIR directories. 250 Unlike most windowmanagers, <application>icewm</application> does not search 251 for programs when the menu is invoked, so if you take this route you will 252 need to rerun the following command after installing or removing programs: 291 <para> 292 <emphasis>Alternatively</emphasis>, you can create a menu which 293 conforms to the FDO Desktop Menu Specifications, where programs can be 294 found because they have a .desktop file in the XDG_DATA_HOME or 295 XDG_DATA_DIR directories. Unlike most windowmanagers, 296 <application>icewm</application> does not search for programs when the 297 menu is invoked, so if you take this route you will need to rerun the 298 following command after installing or removing programs: 253 299 </para> 254 300 255 301 <screen><userinput>icewm-menu-fdo >~/.icewm/menu</userinput></screen> 256 302 257 <para>If you wish to put icons on your desktop, you will need to install 258 a program such as <xref linkend="rox-filer"/> which provides a pinboard. 259 If you do that you will no longer be able to access the menu by 260 right-clicking on the desktop, you will have to use the 261 <application>IceWM</application> button. To ensure that the 262 <application>rox</application> pinboard is running, the following 263 commands will put it in the startup file:</para> 303 <para> 304 If you wish to put icons on your desktop, you will need to install a 305 program such as <xref linkend="rox-filer"/> which provides a pinboard. 306 If you do that you will no longer be able to access the menu by 307 right-clicking on the desktop, you will have to use the 308 <application>IceWM</application> button. To ensure that the 309 <application>rox</application> pinboard is running, the following 310 commands will put it in the startup file: 311 </para> 264 312 265 313 <screen role="nodump"><userinput>cat > ~/.icewm/startup << "EOF" … … 269 317 270 318 <tip> 271 <para>There are a number of keyboard shortcuts in 272 <application>IceWM</application>:</para> 273 <itemizedlist> 274 <listitem> 275 <para>Ctrl + Alt + F<replaceable>N</replaceable> : go to 276 <filename>tty<replaceable>N</replaceable></filename>.</para> 277 </listitem> 278 <listitem> 279 <para>Ctrl + Alt + <replaceable>N</replaceable> : go to desktop 280 number <replaceable>N</replaceable></para> 281 </listitem> 282 <listitem> 283 <para>Ctrl + Alt + Space : open a box on the taskbar where you can 284 key in the name of an application and run it.</para> 285 </listitem> 286 </itemizedlist> 319 <para> 320 There are a number of keyboard shortcuts in 321 <application>IceWM</application>: 322 </para> 323 <itemizedlist> 324 <listitem> 325 <para> 326 Ctrl + Alt + F<replaceable>N</replaceable> : go to 327 <filename>tty<replaceable>N</replaceable></filename>. 328 </para> 329 </listitem> 330 <listitem> 331 <para> 332 Ctrl + Alt + <replaceable>N</replaceable> : go to desktop 333 number <replaceable>N</replaceable> 334 </para> 335 </listitem> 336 <listitem> 337 <para> 338 Ctrl + Alt + Space : open a box on the taskbar where you can 339 key in the name of an application and run it. 340 </para> 341 </listitem> 342 </itemizedlist> 287 343 </tip> 288 344 … … 315 371 <term><command>icehelp</command></term> 316 372 <listitem> 317 <para>is used to display the html manual.</para> 373 <para> 374 is used to display the html manual. 375 </para> 318 376 <indexterm zone="icewm icehelp"> 319 377 <primary sortas="b-icehelp">icehelp</primary> … … 325 383 <term><command>icesh</command></term> 326 384 <listitem> 327 <para>is a command-line window manager which can be used in 328 <filename>~/.icewm/startup</filename>.</para> 385 <para> 386 is a command-line window manager which can be used in 387 <filename>~/.icewm/startup</filename>. 388 </para> 329 389 <indexterm zone="icewm icesh"> 330 390 <primary sortas="b-icesh">icesh</primary> … … 336 396 <term><command>icesound</command></term> 337 397 <listitem> 338 <para>plays audio files on GUI events raised by IceWM.</para> 398 <para> 399 plays audio files on GUI events raised by IceWM. 400 </para> 339 401 <indexterm zone="icewm icesound"> 340 402 <primary sortas="b-icesound">icesound</primary> … … 346 408 <term><command>icewm</command></term> 347 409 <listitem> 348 <para>is the window manager.</para> 410 <para> 411 is the window manager. 412 </para> 349 413 <indexterm zone="icewm icewm-prog"> 350 414 <primary sortas="b-icewm">icewm</primary> … … 356 420 <term><command>icewm-menu-fdo</command></term> 357 421 <listitem> 358 <para>can create a file in a format suitable for an IceWM menu, which 359 lists those programs currently installed in a layout conforming to the 360 FDO Desktop Menu Specifications.</para> 422 <para> 423 can create a file in a format suitable for an IceWM menu, which 424 lists those programs currently installed in a layout conforming to 425 the FDO Desktop Menu Specifications. 426 </para> 361 427 <indexterm zone="icewm icewm-menu-fdo"> 362 428 <primary sortas="b-icewm-menu-fdo">icewm-menu-fdo</primary> … … 368 434 <term><command>icewm-session</command></term> 369 435 <listitem> 370 <para>runs icewmbg, icewm, icewmtray, startup, shutdown (i.e. startup 371 and shutdown scripts are run if installed).</para> 436 <para> 437 runs icewmbg, icewm, icewmtray, startup, shutdown (i.e. startup 438 and shutdown scripts are run if installed). 439 </para> 372 440 <indexterm zone="icewm icewm-session"> 373 441 <primary sortas="b-icewm-session">icewm-session</primary> … … 379 447 <term><command>icewm-set-gnomewm</command></term> 380 448 <listitem> 381 <para>is a script to set the <application>GNOME</application>windowmanager to 382 <application>icewm</application> using <application>gconftool</application>. 449 <para> 450 is a script to set the <application>GNOME</application> window 451 manager to <application>icewm</application> using 452 <application>gconftool</application>. 383 453 </para> 384 454 <indexterm zone="icewm icewm-set-gnomewm"> … … 391 461 <term><command>icewmbg</command></term> 392 462 <listitem> 393 <para>is used to set the background, according to the various 394 <literal>DesktopBackground</literal> settings in the preferences.</para> 463 <para> 464 is used to set the background, according to the various 465 <literal>DesktopBackground</literal> settings in the preferences. 466 </para> 395 467 <indexterm zone="icewm icewmbg"> 396 468 <primary sortas="b-icewmbg">icewmbg</primary> … … 402 474 <term><command>icewmhint</command></term> 403 475 <listitem> 404 <para>is used internally.</para> 476 <para> 477 is used internally. 478 </para> 405 479 <indexterm zone="icewm icewmhint"> 406 480 <primary sortas="b-icewmhint">icewmhint</primary> … … 412 486 <term><command>icewmtray</command></term> 413 487 <listitem> 414 <para>provides the tray.</para> 488 <para> 489 provides the tray. 490 </para> 415 491 <indexterm zone="icewm icewmtray"> 416 492 <primary sortas="b-icewmtray">icewmtray</primary>
Note:
See TracChangeset
for help on using the changeset viewer.
