Adding upstream version 4.22.0.upstream/4.22.0

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

1 files changed, 141 insertions, 0 deletions

diff --git a/upstream/opensuse-tumbleweed/man1/icewm-menu-xrandr.1 b/upstream/opensuse-tumbleweed/man1/icewm-menu-xrandr.1
new file mode 100644
index 00000000..98fdce2b
--- /dev/null
+++ b/upstream/opensuse-tumbleweed/man1/icewm-menu-xrandr.1
@@ -0,0 +1,141 @@
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
+.\"
+.\" 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-MENU-XRANDR 1"
+.TH ICEWM-MENU-XRANDR 1 2023-12-28 "icewm 3.4.5" "User Commands"
+.\" 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\-menu\-xrandr \- IceWM menu provider for multi\-monitor setup shortcuts
+.Ve
+.SS SYNOPSIS
+.IX Subsection "SYNOPSIS"
+\&\fBicewm-menu-xrandr\fR
+.SS DESCRIPTION
+.IX Subsection "DESCRIPTION"
+\&\fBicewm-menu-xrandr\fR is a helper to manage multi-screen configurations
+in a semi-automated way. It is a regular icewm menu generator that
+detects the available xrandr screens (i.e. connected monitors) and
+creates menu entries that call the xrandr command to setup this
+configuration.
+.PP
+Optionally, the contents of the generated configurations can be accessed
+on-the-fly through a "quick-switch" style menu which pops up upon
+pressing Super-P key binding (or a manually configured key, see
+\&\fBicewm\-keys\fR\|(5) for the configuration of \fBswitchkey\fR directive).
+.PP
+The tool does not examine the exact monitor resolutions, refresh rates
+or screen orientation. For this matters it uses auto selected mode by
+default. However, it is possible to replace the custom option selection
+for each output using \fIxrandr\fR options in a custom configuration file
+(see \fICONFIGURATION\fR below). Also tuning specific options like
+\&\-\-brightness and \-\-gamma is possible there.
+.PP
+The displayed name of the monitors is constructed using the output name
+and the monitor information from its EDID data. Either from its "Display
+Name" field or from the "Unspecified ASCII text" fields (concatenated).
+.SS OPTIONS
+.IX Subsection "OPTIONS"
+.IP \fB\-\-max\fR 4
+.IX Item "--max"
+Obsolete and ineffective option. Used to select the \fIxrandr\fR mode with the
+highest detected refresh rate. However, the maximum rate might cause
+problems, therefore the explicit configuration in the \fIINI file\fR should be
+used now, see \fICONFIGURATION\fR.
+.IP "\fB\-\-auto\-number [ init value ]\fR" 4
+.IX Item "--auto-number [ init value ]"
+Adding a auto-incremented numbered prefix to each display name,
+optionally started at the specified value. This mostly useful for menu
+creation.
+.IP "\fB\-\-xrandr command\fR" 4
+.IX Item "--xrandr command"
+Replacement for \fIxrandr\fR command that should deliver equivalent data
+and accept the same options as \fIxrandr\fR.
+.IP "\fB\-\-activate combo-name\fR" 4
+.IX Item "--activate combo-name"
+A shortcut to run the activation command of the specified combo, just
+like \fIIceWM\fR would run the commmand when selected from the menu or
+quick-switch dialog. The \fIcombo-name\fR parameter needs to match the
+displayed name exactly.
+.SS CONFIGURATION
+.IX Subsection "CONFIGURATION"
+Optionally, a local configuration can specify command line options to
+\&\fIxrandr\fR calls, and further commands to run after mode switching.
+.PP
+Refer to configuration examples (\fIxrandr_menu\fR) in \fIicewm\fR
+documentation or its contrib folder for the syntax and rules of that
+file. It can be placed into \fR\f(CI$HOME\fR\fI/.config/icewm\fR or into
+\&\fI\fR\f(CI$HOME\fR\fI/.icewm\fR or wherever \fI\fR\f(CI$XDG_CONFIG_HOME\fR\fI/.config/icewm\fR might
+resolve to.
+.SS "SEE ALSO"
+.IX Subsection "SEE ALSO"
+\&\fBicewm\fR\|(1),
+\&\fBxrandr\fR\|(1).
+.SS BUGS
+.IX Subsection "BUGS"
+Please report bugs at <https://github.com/bbidulock/icewm/issues>.
+.SS AUTHOR
+.IX Subsection "AUTHOR"
+Eduard Bloch <mailto:edi@gmx.de>.
+.SS LICENSE
+.IX Subsection "LICENSE"
+\&\fBicewm-menu-xrandr\fR is licensed under the Simplified BSD License.
+\&\fBIceWM\fR is licensed under the GNU Library General Public License.
+See the \fICOPYING\fR file in the distribution.