Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 167 insertions, 0 deletions

diff --git a/upstream/fedora-40/man5/icewm-toolbar.5 b/upstream/fedora-40/man5/icewm-toolbar.5
new file mode 100644
index 00000000..f2af59ab
--- /dev/null
+++ b/upstream/fedora-40/man5/icewm-toolbar.5
@@ -0,0 +1,167 @@
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.45)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
+.ie n \{\
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds C`
+.    ds C'
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
+.\" If the F register is >0, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.\"
+.\" Avoid warning from groff about undefined register 'F'.
+.de IX
+..
+.nr rF 0
+.if \n(.g .if rF .nr rF 1
+.if (\n(rF:(\n(.g==0)) \{\
+.    if \nF \{\
+.        de IX
+.        tm Index:\\$1\t\\n%\t"\\$2"
+..
+.        if !\nF==2 \{\
+.            nr % 0
+.            nr F 2
+.        \}
+.    \}
+.\}
+.rr rF
+.\" ========================================================================
+.\"
+.IX Title "ICEWM-TOOLBAR 5"
+.TH ICEWM-TOOLBAR 5 2024-01-24 "icewm\ 3.4.5" "Standards, Environments and Macros"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SS NAME
+.IX Subsection "NAME"
+.Vb 1
+\& icewm\-toolbar \- icewm toolbar configuration file
+.Ve
+.SS SYNOPSIS
+.IX Subsection "SYNOPSIS"
+.Vb 5
+\& $ICEWM_PRIVCFG/toolbar
+\& $XDG_CONFIG_HOME/icewm/toolbar
+\& $HOME/.icewm/toolbar
+\& /etc/icewm/toolbar
+\& /usr/share/icewm/toolbar
+.Ve
+.SS DESCRIPTION
+.IX Subsection "DESCRIPTION"
+The \fItoolbar\fR file is responsible for configuring quick launch
+application icons that are placed on the \fBicewm\fR\|(1) panel.  It
+contains names of quick to launch applications with icons for the task
+bar.  Each non-empty non-comment line starts with the keyword \fBprog\fR.
+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 that 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 \f(CW\*(C`Mozilla Firefox\*(C'\fR
+with the \fIfirefox\fR icon which launches \fBfirefox\fR\|(1) when clicked:
+.PP
+.Vb 1
+\&    prog  "Mozilla Firefox"  firefox  /usr/bin/firefox \-\-private\-window
+.Ve
+.SS FORMAT
+.IX Subsection "FORMAT"
+The format of the file contains one of the following line syntax:
+.Sp
+.RS 4
+\&\fBprog\fR \fB"\fR\fItitle\fR\fB"\fR \fIicon\fR \fIprogram\fR \fIoptions\fR
+.RE
+.PP
+Where,
+.IP \fBprog\fR 4
+.IX Item "prog"
+The literal string \fBprog\fR.
+.IP "\fB""\fR\fItitle\fR\fB""\fR" 4
+.IX Item """title"""
+The title of the toolbar item, which will appear as a tool-tip for the
+program button, enclosed in double quotes (\f(CW\*(C`"\*(C'\fR).
+.IP \fIicon\fR 4
+.IX Item "icon"
+The icon to display on the toolbar button.  May be specified as a single
+dash (\f(CW\*(C`\-\*(C'\fR) when no icon is provided.  When no icon is provided, the
+\&\fItitle\fR text will be displayed on the button in place of the icon.
+.IP \fIprogram\fR 4
+.IX Item "program"
+The executable program (full path or executable name) to run when the
+button is pressed.
+.IP \fIoptions\fR 4
+.IX Item "options"
+Options and arguments that are passed to \fIprogram\fR.
+.PP
+Lines beginning with a hash (\f(CW\*(C`#\*(C'\fR) are comment lines.  Comment lines and
+blank lines are ignored.
+.SS EXAMPLES
+.IX Subsection "EXAMPLES"
+Following is an example that places a number of toolbar buttons on the
+\&\fBicewm\fR\|(1) panel:
+.PP
+.Vb 8
+\&    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
+.Ve
+.SS FILES
+.IX Subsection "FILES"
+Locations for the \fItoolbar\fR file are as follows:
+.PP
+.Vb 5
+\& $ICEWM_PRIVCFG/toolbar
+\& $XDG_CONFIG_HOME/icewm/toolbar
+\& $HOME/.icewm/toolbar
+\& /etc/icewm/toolbar
+\& /usr/share/icewm/toolbar
+.Ve
+.PP
+The locations are searched in the order listed; the first file found is
+read and the remainder ignored.
+.SS "SEE ALSO"
+.IX Subsection "SEE ALSO"
+\&\fBicewm\fR\|(1),
+\&\fBicewm\-programs\fR\|(5),
+\&\fBicewm\-menu\fR\|(5),
+\&\fBicewm\-menu\-fdo\fR\|(1).
+.SS AUTHOR
+.IX Subsection "AUTHOR"
+Brian Bidulock <mailto:bidulock@openss7.org>.
+.SS LICENSE
+.IX Subsection "LICENSE"
+\&\fBIceWM\fR is licensed under the GNU Library General Public License.
+See the \fICOPYING\fR file in the distribution.