<?xml version="1.0" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<title>Standards, Environments and Macros</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:root@localhost" />
</head>
<body id="_podtop_">
<table border="0" width="100%" cellspacing="0" cellpadding="3">
<tr><td class="_podblock_" style="background-color: #cccccc; color: #000" valign="middle">
<big><strong><span class="_podblock_"> Standards, Environments and Macros</span></strong></big>
</td></tr>
</table>
<a href="#_podtop_"><h1 id="NAME">NAME</h1></a>
<pre><code> icewm-toolbar - icewm toolbar configuration file</code></pre>
<a href="#_podtop_"><h1 id="SYNOPSIS">SYNOPSIS</h1></a>
<dl>
<dt id="ICEWM_PRIVCFG-toolbar"><i>$ICEWM_PRIVCFG/toolbar</i></dt>
<dd>
</dd>
<dt id="XDG_CONFIG_HOME-icewm-toolbar"><i>$XDG_CONFIG_HOME/icewm/toolbar</i></dt>
<dd>
</dd>
<dt id="HOME-.icewm-toolbar"><i>$HOME/.icewm/toolbar</i></dt>
<dd>
</dd>
<dt id="etc-icewm-toolbar"><i>/etc/icewm/toolbar</i></dt>
<dd>
</dd>
<dt id="usr-share-icewm-toolbar"><i>/usr/share/icewm/toolbar</i></dt>
<dd>
</dd>
</dl>
<a href="#_podtop_"><h1 id="DESCRIPTION">DESCRIPTION</h1></a>
<p>The <i>toolbar</i> file is responsible for configuring quick launch application icons that are placed on the <a href="icewm.1.html">icewm(1)</a> panel. The file is used to place programs as buttons on the <a href="icewm.1.html">icewm(1)</a> pane</p>
<p>Contains names of quick to launch applications with icons for the task bar. Each non-empty non-comment line starts with the keyword <b>prog</b>. After one or more spaces follows a name, which is displayed in a tool tip whenever the mouse cursor hovers over the toolbar icon. This name may be a double quoted string. Then follows the bare name of the icon to use without extensions. This icon will be shown in the toolbar. The last component is a shell command line which will be executed whenever the user presses the icon in the toolbar. For example, the following line in toolbar will create a button with tool tip <code>Mozilla Firefox</code> with the <i>firefox</i> icon which launches <a href="https://manned.org/firefox.1">firefox(1)</a> when clicked:</p>
<pre><code> prog "Mozilla Firefox" firefox /usr/bin/firefox --private-window</code></pre>
<a href="#_podtop_"><h1 id="FORMAT">FORMAT</h1></a>
<p>The format of the file contains one of the following line syntax:</p>
<ul>
<p><b>prog</b> <b>"</b><i>title</i><b>"</b> <i>icon</i> <i>program</i> <i>options</i></p>
</ul>
<p>Where,</p>
<dl>
<dt id="prog"><b>prog</b></dt>
<dd>
<p>The literal string <b>prog</b>.</p>
</dd>
<dt id="title"><b>"</b><i>title</i><b>"</b></dt>
<dd>
<p>The title of the toolbar item, which will appear as a tool-tip for the program button, enclosed in double quotes (<code>"</code>).</p>
</dd>
<dt id="icon"><i>icon</i></dt>
<dd>
<p>The icon to display on the toolbar button. May be specified as a single dash (<code>-</code>) when no icon is provided. When no icon is provided, the <i>title</i> text will be displayed on the button in place of the icon.</p>
</dd>
<dt id="program"><i>program</i></dt>
<dd>
<p>The executable program (full path or executable name) to run when the button is pressed.</p>
</dd>
<dt id="options"><i>options</i></dt>
<dd>
<p>Options and arguments that are passed to <i>program</i>.</p>
</dd>
</dl>
<p>Lines beginning with a hash (<code>#</code>) are comment lines. Comment lines and blank lines are ignored.</p>
<a href="#_podtop_"><h1 id="EXAMPLES">EXAMPLES</h1></a>
<p>Following is an example that places a number of toolbar buttons on the <a href="icewm.1.html">icewm(1)</a> panel:</p>
<pre><code> prog "File Manager" file-manager.png pcmanfm
prog "Web Browser" web-browser.png /usr/lib/firefox/firefox
prog "Terminal" terminal.png roxterm
prog "Graphical Editor" text-editor.png gvim -f
prog "Calculator" accessories-calculator.png calculator
prog "Run Command" gtk-execute.png xde-run
prog "Network" gtk-network.png pcmanfm ~/Network
prog "Logout" system-log-out.png xde-logout</code></pre>
<a href="#_podtop_"><h1 id="FILES">FILES</h1></a>
<p>Locations for the <i>toolbar</i> file are as follows:</p>
<dl>
<dt id="ICEWM_PRIVCFG-toolbar1"><i>$ICEWM_PRIVCFG/toolbar</i></dt>
<dd>
</dd>
<dt id="XDG_CONFIG_HOME-icewm-toolbar1"><i>$XDG_CONFIG_HOME/icewm/toolbar</i></dt>
<dd>
</dd>
<dt id="HOME-.icewm-toolbar1"><i>$HOME/.icewm/toolbar</i></dt>
<dd>
</dd>
<dt id="etc-icewm-toolbar1"><i>/etc/icewm/toolbar</i></dt>
<dd>
</dd>
<dt id="usr-share-icewm-toolbar1"><i>/usr/share/icewm/toolbar</i></dt>
<dd>
</dd>
</dl>
<a href="#_podtop_"><h1 id="SEE-ALSO">SEE ALSO</h1></a>
<p><a href="icewm.1.html">icewm(1)</a>, <a href="icewm-programs.5.html">icewm-programs(5)</a>, <a href="icewm-menu.5.html">icewm-menu(5)</a>, <a href="icewm-menu-fdo.1.html">icewm-menu-fdo(1)</a>.</p>
<a href="#_podtop_"><h1 id="AUTHOR">AUTHOR</h1></a>
<p>Brian Bidulock <a href="mailto:bidulock@openss7.org">mailto:bidulock@openss7.org</a>.</p>
<a href="#_podtop_"><h1 id="LICENSE">LICENSE</h1></a>
<p><b>IceWM</b> is licensed under the GNU Library General Public License. See the <i>COPYING</i> file in the distribution.</p>
<table border="0" width="100%" cellspacing="0" cellpadding="3">
<tr><td class="_podblock_" style="background-color: #cccccc; color: #000" valign="middle">
<big><strong><span class="_podblock_"> Standards, Environments and Macros</span></strong></big>
</td></tr>
</table>
</body>
</html>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-release
>
by-pkgid
>
402607c61c3b7824dac91e3798227f4a
>
files
>
51
