From af976c3779d3e8ac8ceb75e5193d3e0af242e5ad Mon Sep 17 00:00:00 2001 From: Dave Davenport Date: Tue, 19 Jul 2022 15:44:29 +0200 Subject: [XCB] Add a flag to enable work around for #611. In issue #611 there is a workaround implemented for an issue within xserver: https://bugs.freedesktop.org/show_bug.cgi?id=104323#c1, https://gitlab.freedesktop.org/xorg/xserver/-/issues/300. With a latest update in xkeyboard-config this workaround breaks rofi, see #1642 and https://gitlab.freedesktop.org/xkeyboard-config/xkeyboard-config/-/issues/341. This commits disabled this work-around (can be re-enabled with -xserver-i300-workaround flag). Hopefully this restores correct rofi functionality. issue: #611 #1642 --- config/config.c | 5 +- doc/rofi-debugging.5 | 139 +++++++------ doc/rofi-dmenu.5 | 117 ++++++----- doc/rofi-keys.5 | 339 ++++++++++++++++---------------- doc/rofi-script.5 | 53 +++-- doc/rofi-sensible-terminal.1 | 21 +- doc/rofi-theme-selector.1 | 25 ++- doc/rofi-theme.5 | 340 +++++++++++++++++--------------- doc/rofi.1 | 452 +++++++++++++++++++++++-------------------- doc/rofi.1.markdown | 6 + include/settings.h | 3 + source/xcb.c | 16 +- source/xrmoptions.c | 6 + 13 files changed, 792 insertions(+), 730 deletions(-) diff --git a/config/config.c b/config/config.c index c1610453..632869d2 100644 --- a/config/config.c +++ b/config/config.c @@ -155,4 +155,7 @@ Settings config = { /** fallback icon */ .application_fallback_icon = NULL, /** refilter limit */ - .refilter_timeout_limit = 8192}; + .refilter_timeout_limit = 8192, + /** workaround for broken xserver (#300 on xserver, #611) */ + .xserver_i300_workaround = FALSE, +}; diff --git a/doc/rofi-debugging.5 b/doc/rofi-debugging.5 index dc0eb01b..01a64932 100644 --- a/doc/rofi-debugging.5 +++ b/doc/rofi-debugging.5 @@ -1,4 +1,3 @@ -.nh .TH ROFI DEBUGGING 5 rofi debugging .SH NAME .PP @@ -6,16 +5,16 @@ Debugging rofi. .PP When reporting an issue with rofi crashing, or misbehaving. It helps to do some small test -to help pin-point the problem. +to help pin\-point the problem. .PP -First try disabling your custom configuration: \fB\fC-no-config\fR +First try disabling your custom configuration: \fB\fC\-no\-config\fR .PP This disables the parsing of the configuration files. This runs rofi in \fIstock\fP mode. .PP -If you run custom C plugins, you can disable the plugins using: \fB\fC-no-plugins\fR +If you run custom C plugins, you can disable the plugins using: \fB\fC\-no\-plugins\fR .SH Get the relevant information for an issue .PP @@ -25,19 +24,19 @@ Please pastebin the output of the following commands: .RS .nf -rofi -help -rofi -dump-config -rofi -dump-theme +rofi \-help +rofi \-dump\-config +rofi \-dump\-theme .fi .RE .PP -\fB\fCrofi -help\fR provides us with the configuration files parsed, the exact version, monitor layout +\fB\fCrofi \-help\fR provides us with the configuration files parsed, the exact version, monitor layout and more useful information. .PP -The \fB\fCrofi -dump-config\fR and \fB\fCrofi -dump-theme\fR output gives us \fB\fCrofi\fR +The \fB\fCrofi \-dump\-config\fR and \fB\fCrofi \-dump\-theme\fR output gives us \fB\fCrofi\fR interpretation of your configuration and theme. .PP @@ -51,7 +50,7 @@ To get a timing trace, enable the \fBTimings\fP debug domain. .RS .nf -G_MESSAGES_DEBUG=Timings rofi -show drun +G\_MESSAGES\_DEBUG=Timings rofi \-show drun .fi .RE @@ -67,56 +66,56 @@ Example trace: .RS .nf -(process:14942): Timings-DEBUG: 13:47:39.335: 0.000000 (0.000000): Started -(process:14942): Timings-DEBUG: 13:47:39.335: 0.000126 (0.000126): ../source/rofi.c:main:786 -(process:14942): Timings-DEBUG: 13:47:39.335: 0.000163 (0.000037): ../source/rofi.c:main:819 -(process:14942): Timings-DEBUG: 13:47:39.336: 0.000219 (0.000056): ../source/rofi.c:main:826 Setup Locale -(process:14942): Timings-DEBUG: 13:47:39.337: 0.001235 (0.001016): ../source/rofi.c:main:828 Collect MODI -(process:14942): Timings-DEBUG: 13:47:39.337: 0.001264 (0.000029): ../source/rofi.c:main:830 Setup MODI -(process:14942): Timings-DEBUG: 13:47:39.337: 0.001283 (0.000019): ../source/rofi.c:main:834 Setup mainloop -(process:14942): Timings-DEBUG: 13:47:39.337: 0.001369 (0.000086): ../source/rofi.c:main:837 NK Bindings -(process:14942): Timings-DEBUG: 13:47:39.337: 0.001512 (0.000143): ../source/xcb.c:display_setup:1177 Open Display -(process:14942): Timings-DEBUG: 13:47:39.337: 0.001829 (0.000317): ../source/xcb.c:display_setup:1192 Setup XCB -(process:14942): Timings-DEBUG: 13:47:39.346: 0.010650 (0.008821): ../source/rofi.c:main:844 Setup Display -(process:14942): Timings-DEBUG: 13:47:39.346: 0.010715 (0.000065): ../source/rofi.c:main:848 Setup abe -(process:14942): Timings-DEBUG: 13:47:39.350: 0.015101 (0.004386): ../source/rofi.c:main:883 Load cmd config -(process:14942): Timings-DEBUG: 13:47:39.351: 0.015275 (0.000174): ../source/rofi.c:main:907 Setup Modi -(process:14942): Timings-DEBUG: 13:47:39.351: 0.015291 (0.000016): ../source/view.c:rofi_view_workers_initialize:1922 Setup Threadpool, start -(process:14942): Timings-DEBUG: 13:47:39.351: 0.015349 (0.000058): ../source/view.c:rofi_view_workers_initialize:1945 Setup Threadpool, done -(process:14942): Timings-DEBUG: 13:47:39.367: 0.032018 (0.016669): ../source/rofi.c:main:1000 Setup late Display -(process:14942): Timings-DEBUG: 13:47:39.367: 0.032080 (0.000062): ../source/rofi.c:main:1003 Theme setup -(process:14942): Timings-DEBUG: 13:47:39.367: 0.032109 (0.000029): ../source/rofi.c:startup:668 Startup -(process:14942): Timings-DEBUG: 13:47:39.367: 0.032121 (0.000012): ../source/rofi.c:startup:677 Grab keyboard -(process:14942): Timings-DEBUG: 13:47:39.368: 0.032214 (0.000093): ../source/view.c:__create_window:701 xcb create window -(process:14942): Timings-DEBUG: 13:47:39.368: 0.032235 (0.000021): ../source/view.c:__create_window:705 xcb create gc -(process:14942): Timings-DEBUG: 13:47:39.368: 0.033136 (0.000901): ../source/view.c:__create_window:714 create cairo surface -(process:14942): Timings-DEBUG: 13:47:39.369: 0.033286 (0.000150): ../source/view.c:__create_window:723 pango cairo font setup -(process:14942): Timings-DEBUG: 13:47:39.369: 0.033351 (0.000065): ../source/view.c:__create_window:761 configure font -(process:14942): Timings-DEBUG: 13:47:39.381: 0.045896 (0.012545): ../source/view.c:__create_window:769 textbox setup -(process:14942): Timings-DEBUG: 13:47:39.381: 0.045944 (0.000048): ../source/view.c:__create_window:781 setup window attributes -(process:14942): Timings-DEBUG: 13:47:39.381: 0.045955 (0.000011): ../source/view.c:__create_window:791 setup window fullscreen -(process:14942): Timings-DEBUG: 13:47:39.381: 0.045966 (0.000011): ../source/view.c:__create_window:797 setup window name and class -(process:14942): Timings-DEBUG: 13:47:39.381: 0.045974 (0.000008): ../source/view.c:__create_window:808 setup startup notification -(process:14942): Timings-DEBUG: 13:47:39.381: 0.045981 (0.000007): ../source/view.c:__create_window:810 done -(process:14942): Timings-DEBUG: 13:47:39.381: 0.045992 (0.000011): ../source/rofi.c:startup:679 Create Window -(process:14942): Timings-DEBUG: 13:47:39.381: 0.045999 (0.000007): ../source/rofi.c:startup:681 Parse ABE -(process:14942): Timings-DEBUG: 13:47:39.381: 0.046113 (0.000114): ../source/rofi.c:startup:684 Config sanity check -(process:14942): Timings-DEBUG: 13:47:39.384: 0.048229 (0.002116): ../source/dialogs/run.c:get_apps:216 start -(process:14942): Timings-DEBUG: 13:47:39.390: 0.054626 (0.006397): ../source/dialogs/run.c:get_apps:336 stop -(process:14942): Timings-DEBUG: 13:47:39.390: 0.054781 (0.000155): ../source/dialogs/drun.c:get_apps:634 Get Desktop apps (start) -(process:14942): Timings-DEBUG: 13:47:39.391: 0.055264 (0.000483): ../source/dialogs/drun.c:get_apps:641 Get Desktop apps (user dir) -(process:14942): Timings-DEBUG: 13:47:39.418: 0.082884 (0.027620): ../source/dialogs/drun.c:get_apps:659 Get Desktop apps (system dirs) -(process:14942): Timings-DEBUG: 13:47:39.418: 0.082944 (0.000060): ../source/dialogs/drun.c:get_apps_history:597 Start drun history -(process:14942): Timings-DEBUG: 13:47:39.418: 0.082977 (0.000033): ../source/dialogs/drun.c:get_apps_history:617 Stop drun history -(process:14942): Timings-DEBUG: 13:47:39.419: 0.083638 (0.000661): ../source/dialogs/drun.c:get_apps:664 Sorting done. -(process:14942): Timings-DEBUG: 13:47:39.419: 0.083685 (0.000047): ../source/view.c:rofi_view_create:1759 -(process:14942): Timings-DEBUG: 13:47:39.419: 0.083700 (0.000015): ../source/view.c:rofi_view_create:1783 Startup notification -(process:14942): Timings-DEBUG: 13:47:39.419: 0.083711 (0.000011): ../source/view.c:rofi_view_create:1786 Get active monitor -(process:14942): Timings-DEBUG: 13:47:39.420: 0.084693 (0.000982): ../source/view.c:rofi_view_refilter:1028 Filter start -(process:14942): Timings-DEBUG: 13:47:39.421: 0.085992 (0.001299): ../source/view.c:rofi_view_refilter:1132 Filter done -(process:14942): Timings-DEBUG: 13:47:39.421: 0.086090 (0.000098): ../source/view.c:rofi_view_update:982 -(process:14942): Timings-DEBUG: 13:47:39.421: 0.086123 (0.000033): ../source/view.c:rofi_view_update:1002 Background -(process:14942): Timings-DEBUG: 13:47:39.428: 0.092864 (0.006741): ../source/view.c:rofi_view_update:1008 widgets +(process:14942): Timings\-DEBUG: 13:47:39.335: 0.000000 (0.000000): Started +(process:14942): Timings\-DEBUG: 13:47:39.335: 0.000126 (0.000126): ../source/rofi.c:main:786 +(process:14942): Timings\-DEBUG: 13:47:39.335: 0.000163 (0.000037): ../source/rofi.c:main:819 +(process:14942): Timings\-DEBUG: 13:47:39.336: 0.000219 (0.000056): ../source/rofi.c:main:826 Setup Locale +(process:14942): Timings\-DEBUG: 13:47:39.337: 0.001235 (0.001016): ../source/rofi.c:main:828 Collect MODI +(process:14942): Timings\-DEBUG: 13:47:39.337: 0.001264 (0.000029): ../source/rofi.c:main:830 Setup MODI +(process:14942): Timings\-DEBUG: 13:47:39.337: 0.001283 (0.000019): ../source/rofi.c:main:834 Setup mainloop +(process:14942): Timings\-DEBUG: 13:47:39.337: 0.001369 (0.000086): ../source/rofi.c:main:837 NK Bindings +(process:14942): Timings\-DEBUG: 13:47:39.337: 0.001512 (0.000143): ../source/xcb.c:display\_setup:1177 Open Display +(process:14942): Timings\-DEBUG: 13:47:39.337: 0.001829 (0.000317): ../source/xcb.c:display\_setup:1192 Setup XCB +(process:14942): Timings\-DEBUG: 13:47:39.346: 0.010650 (0.008821): ../source/rofi.c:main:844 Setup Display +(process:14942): Timings\-DEBUG: 13:47:39.346: 0.010715 (0.000065): ../source/rofi.c:main:848 Setup abe +(process:14942): Timings\-DEBUG: 13:47:39.350: 0.015101 (0.004386): ../source/rofi.c:main:883 Load cmd config +(process:14942): Timings\-DEBUG: 13:47:39.351: 0.015275 (0.000174): ../source/rofi.c:main:907 Setup Modi +(process:14942): Timings\-DEBUG: 13:47:39.351: 0.015291 (0.000016): ../source/view.c:rofi\_view\_workers\_initialize:1922 Setup Threadpool, start +(process:14942): Timings\-DEBUG: 13:47:39.351: 0.015349 (0.000058): ../source/view.c:rofi\_view\_workers\_initialize:1945 Setup Threadpool, done +(process:14942): Timings\-DEBUG: 13:47:39.367: 0.032018 (0.016669): ../source/rofi.c:main:1000 Setup late Display +(process:14942): Timings\-DEBUG: 13:47:39.367: 0.032080 (0.000062): ../source/rofi.c:main:1003 Theme setup +(process:14942): Timings\-DEBUG: 13:47:39.367: 0.032109 (0.000029): ../source/rofi.c:startup:668 Startup +(process:14942): Timings\-DEBUG: 13:47:39.367: 0.032121 (0.000012): ../source/rofi.c:startup:677 Grab keyboard +(process:14942): Timings\-DEBUG: 13:47:39.368: 0.032214 (0.000093): ../source/view.c:\_\_create\_window:701 xcb create window +(process:14942): Timings\-DEBUG: 13:47:39.368: 0.032235 (0.000021): ../source/view.c:\_\_create\_window:705 xcb create gc +(process:14942): Timings\-DEBUG: 13:47:39.368: 0.033136 (0.000901): ../source/view.c:\_\_create\_window:714 create cairo surface +(process:14942): Timings\-DEBUG: 13:47:39.369: 0.033286 (0.000150): ../source/view.c:\_\_create\_window:723 pango cairo font setup +(process:14942): Timings\-DEBUG: 13:47:39.369: 0.033351 (0.000065): ../source/view.c:\_\_create\_window:761 configure font +(process:14942): Timings\-DEBUG: 13:47:39.381: 0.045896 (0.012545): ../source/view.c:\_\_create\_window:769 textbox setup +(process:14942): Timings\-DEBUG: 13:47:39.381: 0.045944 (0.000048): ../source/view.c:\_\_create\_window:781 setup window attributes +(process:14942): Timings\-DEBUG: 13:47:39.381: 0.045955 (0.000011): ../source/view.c:\_\_create\_window:791 setup window fullscreen +(process:14942): Timings\-DEBUG: 13:47:39.381: 0.045966 (0.000011): ../source/view.c:\_\_create\_window:797 setup window name and class +(process:14942): Timings\-DEBUG: 13:47:39.381: 0.045974 (0.000008): ../source/view.c:\_\_create\_window:808 setup startup notification +(process:14942): Timings\-DEBUG: 13:47:39.381: 0.045981 (0.000007): ../source/view.c:\_\_create\_window:810 done +(process:14942): Timings\-DEBUG: 13:47:39.381: 0.045992 (0.000011): ../source/rofi.c:startup:679 Create Window +(process:14942): Timings\-DEBUG: 13:47:39.381: 0.045999 (0.000007): ../source/rofi.c:startup:681 Parse ABE +(process:14942): Timings\-DEBUG: 13:47:39.381: 0.046113 (0.000114): ../source/rofi.c:startup:684 Config sanity check +(process:14942): Timings\-DEBUG: 13:47:39.384: 0.048229 (0.002116): ../source/dialogs/run.c:get\_apps:216 start +(process:14942): Timings\-DEBUG: 13:47:39.390: 0.054626 (0.006397): ../source/dialogs/run.c:get\_apps:336 stop +(process:14942): Timings\-DEBUG: 13:47:39.390: 0.054781 (0.000155): ../source/dialogs/drun.c:get\_apps:634 Get Desktop apps (start) +(process:14942): Timings\-DEBUG: 13:47:39.391: 0.055264 (0.000483): ../source/dialogs/drun.c:get\_apps:641 Get Desktop apps (user dir) +(process:14942): Timings\-DEBUG: 13:47:39.418: 0.082884 (0.027620): ../source/dialogs/drun.c:get\_apps:659 Get Desktop apps (system dirs) +(process:14942): Timings\-DEBUG: 13:47:39.418: 0.082944 (0.000060): ../source/dialogs/drun.c:get\_apps\_history:597 Start drun history +(process:14942): Timings\-DEBUG: 13:47:39.418: 0.082977 (0.000033): ../source/dialogs/drun.c:get\_apps\_history:617 Stop drun history +(process:14942): Timings\-DEBUG: 13:47:39.419: 0.083638 (0.000661): ../source/dialogs/drun.c:get\_apps:664 Sorting done. +(process:14942): Timings\-DEBUG: 13:47:39.419: 0.083685 (0.000047): ../source/view.c:rofi\_view\_create:1759 +(process:14942): Timings\-DEBUG: 13:47:39.419: 0.083700 (0.000015): ../source/view.c:rofi\_view\_create:1783 Startup notification +(process:14942): Timings\-DEBUG: 13:47:39.419: 0.083711 (0.000011): ../source/view.c:rofi\_view\_create:1786 Get active monitor +(process:14942): Timings\-DEBUG: 13:47:39.420: 0.084693 (0.000982): ../source/view.c:rofi\_view\_refilter:1028 Filter start +(process:14942): Timings\-DEBUG: 13:47:39.421: 0.085992 (0.001299): ../source/view.c:rofi\_view\_refilter:1132 Filter done +(process:14942): Timings\-DEBUG: 13:47:39.421: 0.086090 (0.000098): ../source/view.c:rofi\_view\_update:982 +(process:14942): Timings\-DEBUG: 13:47:39.421: 0.086123 (0.000033): ../source/view.c:rofi\_view\_update:1002 Background +(process:14942): Timings\-DEBUG: 13:47:39.428: 0.092864 (0.006741): ../source/view.c:rofi\_view\_update:1008 widgets .fi .RE @@ -124,7 +123,7 @@ Example trace: .SH Debug domains .PP To further debug the plugin, you can get a trace with (lots of) debug information. This debug output can be enabled for -multiple parts in rofi using the glib debug framework. Debug domains can be enabled by setting the G_MESSAGES_DEBUG +multiple parts in rofi using the glib debug framework. Debug domains can be enabled by setting the G\_MESSAGES\_DEBUG environment variable. At the time of creation of this page, the following debug domains exist: .RS @@ -173,16 +172,16 @@ Helpers.IconFetcher: Information about icon lookup. For full list see \fB\fCman rofi\fR\&. .PP -Example: \fB\fCG_MESSAGES_DEBUG=Dialogs.DRun rofi -show drun\fR To get specific output from the Desktop file run dialog. +Example: \fB\fCG\_MESSAGES\_DEBUG=Dialogs.DRun rofi \-show drun\fR To get specific output from the Desktop file run dialog. .PP -To redirect the debug output to a file (\fB\fC~/rofi.log\fR) add: +To redirect the debug output to a file (\fB\fC\~/rofi.log\fR) add: .PP .RS .nf -rofi -show drun -log ~/rofi.log +rofi \-show drun \-log \~/rofi.log .fi .RE @@ -199,7 +198,7 @@ First make sure you compile \fBrofi\fP with debug symbols: .RS .nf -make CFLAGS="-O0 -g3" clean rofi +make CFLAGS="\-O0 \-g3" clean rofi .fi .RE @@ -207,7 +206,7 @@ make CFLAGS="-O0 -g3" clean rofi .PP Getting a backtrace using GDB is not very handy. Because if rofi get stuck, it grabs keyboard and mouse. So if it crashes in GDB you are stuck. -The best way to go is to enable core file. (ulimit -c unlimited in bash) then make rofi crash. You +The best way to go is to enable core file. (ulimit \-c unlimited in bash) then make rofi crash. You can then load the core in GDB. .PP @@ -235,16 +234,16 @@ thread apply all bt The output trace is useful when reporting crashes. .PP -Some distribution have \fB\fCsystemd-coredump\fR, this way you can easily get a backtrace via \fB\fCcoredumpctl\fR\&. +Some distribution have \fB\fCsystemd\-coredump\fR, this way you can easily get a backtrace via \fB\fCcoredumpctl\fR\&. .SH SEE ALSO .PP -\fBrofi-sensible-terminal(1)\fP, \fBdmenu(1)\fP, \fBrofi-debugging(5)\fP, \fBrofi-theme(5)\fP, \fBrofi-script(5)\fP, \fBrofi-keys(5)\fP,\fBrofi-theme-selector(1)\fP +\fBrofi\-sensible\-terminal(1)\fP, \fBdmenu(1)\fP, \fBrofi\-debugging(5)\fP, \fBrofi\-theme(5)\fP, \fBrofi\-script(5)\fP, \fBrofi\-keys(5)\fP,\fBrofi\-theme\-selector(1)\fP .SH AUTHOR .RS .IP \(bu 2 -Qball Cow qball@blame.services -\[la]mailto:qball@blame.services\[ra] +Qball Cow +\[la]qball@blame.services\[ra] .RE diff --git a/doc/rofi-dmenu.5 b/doc/rofi-dmenu.5 index 89699be1..931c2e70 100644 --- a/doc/rofi-dmenu.5 +++ b/doc/rofi-dmenu.5 @@ -1,8 +1,7 @@ -.nh -.TH ROFI-DMENU 5 rofi-dmenu +.TH ROFI\-DMENU 5 rofi\-dmenu .SH NAME .PP -\fBrofi dmenu mode\fP - Rofi dmenu emulation +\fBrofi dmenu mode\fP \- Rofi dmenu emulation .SH DESCRIPTION .PP @@ -15,8 +14,8 @@ The website for \fB\fCdmenu\fR can be found here .PP \fBrofi\fP does not aim to be 100% compatible with \fB\fCdmenu\fR\&. There are simply too many flavors of \fB\fCdmenu\fR\&. -The idea is that the basic usage command-line flags are obeyed, theme-related flags are not. -Besides, \fBrofi\fP offers some extended features (like multi-select, highlighting, message bar, extra key bindings). +The idea is that the basic usage command\-line flags are obeyed, theme\-related flags are not. +Besides, \fBrofi\fP offers some extended features (like multi\-select, highlighting, message bar, extra key bindings). .SH BASIC CONCEPT .PP @@ -29,27 +28,27 @@ By default separation of rows is done on new lines, making it easy to pipe the o .SH USAGE .PP -By launching \fBrofi\fP with the \fB\fC-dmenu\fR flag it will go into dmenu emulation mode. +By launching \fBrofi\fP with the \fB\fC\-dmenu\fR flag it will go into dmenu emulation mode. .PP .RS .nf -ls | rofi -dmenu +ls | rofi \-dmenu .fi .RE -.SS DMENU DROP-IN REPLACEMENT +.SS DMENU DROP\-IN REPLACEMENT .PP If \fB\fCargv[0]\fR (calling command) is dmenu, \fBrofi\fP will start in dmenu mode. -This way, it can be used as a drop-in replacement for dmenu. Just copy or symlink \fBrofi\fP to dmenu in \fB\fC$PATH\fR\&. +This way, it can be used as a drop\-in replacement for dmenu. Just copy or symlink \fBrofi\fP to dmenu in \fB\fC$PATH\fR\&. .PP .RS .nf -ln -s /usr/bin/rofi /usr/bin/dmenu +ln \-s /usr/bin/rofi /usr/bin/dmenu .fi .RE @@ -57,15 +56,15 @@ ln -s /usr/bin/rofi /usr/bin/dmenu .SS DMENU VS SCRIPT MODE .PP Script mode is used to extend \fBrofi\fP, dmenu mode is used to extend a script. -The two do share much of the same input format. Please see the \fBrofi-script(5)\fP manpage for more information. +The two do share much of the same input format. Please see the \fBrofi\-script(5)\fP manpage for more information. .SS DMENU SPECIFIC COMMANDLINE FLAGS .PP -A lot of these options can also be modified by the script using special input. See the \fBrofi-script(5)\fP manpage +A lot of these options can also be modified by the script using special input. See the \fBrofi\-script(5)\fP manpage for more information about this syntax. .PP -\fB\fC-sep\fR \fIseparator\fP +\fB\fC\-sep\fR \fIseparator\fP .PP Separator for \fB\fCdmenu\fR\&. Example: To show a list of 'a' to 'e' with '|' as a separator: @@ -74,13 +73,13 @@ Separator for \fB\fCdmenu\fR\&. Example: To show a list of 'a' to 'e' with '|' a .RS .nf -echo "a|b|c|d|e" | rofi -sep '|' -dmenu +echo "a|b|c|d|e" | rofi \-sep '|' \-dmenu .fi .RE .PP -\fB\fC-p\fR \fIprompt\fP +\fB\fC\-p\fR \fIprompt\fP .PP Specify the prompt to show in \fB\fCdmenu\fR mode. For example, select 'monkey', a,b,c,d, or e. @@ -89,7 +88,7 @@ Specify the prompt to show in \fB\fCdmenu\fR mode. For example, select 'monkey', .RS .nf -echo "a|b|c|d|e" | rofi -sep '|' -dmenu -p "monkey" +echo "a|b|c|d|e" | rofi \-sep '|' \-dmenu \-p "monkey" .fi .RE @@ -98,7 +97,7 @@ echo "a|b|c|d|e" | rofi -sep '|' -dmenu -p "monkey" Default: \fIdmenu\fP .PP -\fB\fC-l\fR \fInumber of lines to show\fP +\fB\fC\-l\fR \fInumber of lines to show\fP .PP Maximum number of lines the menu may show before scrolling. @@ -107,7 +106,7 @@ Maximum number of lines the menu may show before scrolling. .RS .nf -rofi -dmenu -l 25 +rofi \-dmenu \-l 25 .fi .RE @@ -116,39 +115,39 @@ rofi -dmenu -l 25 Default: \fI15\fP .PP -\fB\fC-i\fR +\fB\fC\-i\fR .PP -Makes \fB\fCdmenu\fR searches case-insensitive +Makes \fB\fCdmenu\fR searches case\-insensitive .PP -\fB\fC-a\fR \fIX\fP +\fB\fC\-a\fR \fIX\fP .PP -Active row, mark \fIX\fP as active. Where \fIX\fP is a comma-separated list of python(1)-style indices and ranges, e.g. indices start at 0, -1 refers to the last row with -2 preceding it, ranges are left-open and right-close, and so on. You can specify: +Active row, mark \fIX\fP as active. Where \fIX\fP is a comma\-separated list of python(1)\-style indices and ranges, e.g. indices start at 0, \-1 refers to the last row with \-2 preceding it, ranges are left\-open and right\-close, and so on. You can specify: .RS .IP \(bu 2 A single row: '5' .IP \(bu 2 -A range of (last 3) rows: '-3:' +A range of (last 3) rows: '\-3:' .IP \(bu 2 -4 rows starting from row 7: '7:11' (or in legacy notation: '7-10') +4 rows starting from row 7: '7:11' (or in legacy notation: '7\-10') .IP \(bu 2 -A set of rows: '2,0,-9' +A set of rows: '2,0,\-9' .IP \(bu 2 -Or any combination: '5,-3:,7:11,2,0,-9' +Or any combination: '5,\-3:,7:11,2,0,\-9' .RE .PP -\fB\fC-u\fR \fIX\fP +\fB\fC\-u\fR \fIX\fP .PP -Urgent row, mark \fIX\fP as urgent. See \fB\fC-a\fR option for details. +Urgent row, mark \fIX\fP as urgent. See \fB\fC\-a\fR option for details. .PP -\fB\fC-only-match\fR +\fB\fC\-only\-match\fR .PP Only return a selected item, do not allow custom entry. @@ -156,14 +155,14 @@ This mode always returns an entry. It will not return if no matching entry is selected. .PP -\fB\fC-no-custom\fR +\fB\fC\-no\-custom\fR .PP Only return a selected item, do not allow custom entry. This mode returns directly when no entries given. .PP -\fB\fC-format\fR \fIformat\fP +\fB\fC\-format\fR \fIformat\fP .PP Allows the output of dmenu to be customized (N is the total number of input entries): @@ -172,9 +171,9 @@ Allows the output of dmenu to be customized (N is the total number of input entr .IP \(bu 2 \&'s' selected string .IP \(bu 2 -\&'i' index (0 - (N-1)) +\&'i' index (0 \-\& (N\-\&1)) .IP \(bu 2 -\&'d' index (1 - N) +\&'d' index (1 \-\& N) .IP \(bu 2 \&'q' quote string .IP \(bu 2 @@ -190,13 +189,13 @@ Allows the output of dmenu to be customized (N is the total number of input entr Default: 's' .PP -\fB\fC-select\fR \fIstring\fP +\fB\fC\-select\fR \fIstring\fP .PP Select first line that matches the given string .PP -\fB\fC-mesg\fR \fIstring\fP +\fB\fC\-mesg\fR \fIstring\fP .PP Add a message line below the filter entry box. Supports Pango markup. @@ -204,27 +203,27 @@ For more information on supported markup, see here \[la]https://docs.gtk.org/Pango/pango_markup.html\[ra] .PP -\fB\fC-dump\fR +\fB\fC\-dump\fR .PP Dump the filtered list to stdout and quit. This can be used to get the list as \fBrofi\fP would filter it. -Use together with \fB\fC-filter\fR command. +Use together with \fB\fC\-filter\fR command. .PP -\fB\fC-input\fR \fIfile\fP +\fB\fC\-input\fR \fIfile\fP .PP Reads from \fIfile\fP instead of stdin. .PP -\fB\fC-password\fR +\fB\fC\-password\fR .PP Hide the input text. This should not be considered secure! .PP -\fB\fC-markup-rows\fR +\fB\fC\-markup\-rows\fR .PP Tell \fBrofi\fP that DMenu input is Pango markup encoded, and should be rendered. @@ -232,47 +231,47 @@ See here \[la]https://developer.gnome.org/pygtk/stable/pango-markup-language.html\[ra] for details about Pango markup. .PP -\fB\fC-multi-select\fR +\fB\fC\-multi\-select\fR .PP Allow multiple lines to be selected. Adds a small selection indicator to the left of each entry. .PP -\fB\fC-sync\fR +\fB\fC\-sync\fR .PP Force \fBrofi\fP mode to first read all data from stdin before showing the selection window. This is original dmenu behavior. .PP Note: the default asynchronous mode will also be automatically disabled if used with conflicting options, -such as \fB\fC-dump\fR, \fB\fC-only-match\fR or \fB\fC-auto-select\fR\&. +such as \fB\fC\-dump\fR, \fB\fC\-only\-match\fR or \fB\fC\-auto\-select\fR\&. .PP -\fB\fC-window-title\fR \fItitle\fP +\fB\fC\-window\-title\fR \fItitle\fP .PP -Set name used for the window title. Will be shown as Rofi - \fItitle\fP +Set name used for the window title. Will be shown as Rofi \- \fItitle\fP .PP -\fB\fC-w\fR \fIwindowid\fP +\fB\fC\-w\fR \fIwindowid\fP .PP Position \fBrofi\fP over the window with the given X11 window ID. .PP -\fB\fC-keep-right\fR +\fB\fC\-keep\-right\fR .PP Set ellipsize mode to start. So, the end of the string is visible. .PP -\fB\fC-display-columns\fR +\fB\fC\-display\-columns\fR .PP A comma seperated list of columns to show. .PP -\fB\fC-display-column-separator\fR +\fB\fC\-display\-column\-separator\fR .PP The column separator. This is a regex. @@ -287,30 +286,30 @@ The column separator. This is a regex. .IP \(bu 2 \fB1\fP: User cancelled the selection. .IP \(bu 2 -\fB10-28\fP: Row accepted by custom keybinding. +\fB10\-28\fP: Row accepted by custom keybinding. .RE .SH SEE ALSO .PP -rofi(1), rofi-sensible-terminal(1), dmenu(1), rofi-theme(5), rofi-script(5), rofi-theme-selector(1), ascii(7) +rofi(1), rofi\-sensible\-terminal(1), dmenu(1), rofi\-theme(5), rofi\-script(5), rofi\-theme\-selector(1), ascii(7) .SH AUTHOR .PP -Qball Cow qball@gmpclient.org -\[la]mailto:qball@gmpclient.org\[ra] +Qball Cow +\[la]qball@gmpclient.org\[ra] .PP -Rasmus Steinke rasi@xssn.at -\[la]mailto:rasi@xssn.at\[ra] +Rasmus Steinke +\[la]rasi@xssn.at\[ra] .PP -Morgane Glidic sardemff7+rofi@sardemff7.net -\[la]mailto:sardemff7+rofi@sardemff7.net\[ra] +Morgane Glidic +\[la]sardemff7+rofi@sardemff7.net\[ra] .PP -Original code based on work by: Sean Pringle sean.pringle@gmail.com -\[la]mailto:sean.pringle@gmail.com\[ra] +Original code based on work by: Sean Pringle +\[la]sean.pringle@gmail.com\[ra] .PP For a full list of authors, check the AUTHORS file. diff --git a/doc/rofi-keys.5 b/doc/rofi-keys.5 index 8a20e17c..ee0cb1df 100644 --- a/doc/rofi-keys.5 +++ b/doc/rofi-keys.5 @@ -1,8 +1,7 @@ -.nh -.TH ROFI-KEYS 5 rofi-keys +.TH ROFI\-KEYS 5 rofi\-keys .SH NAME .PP -\fBrofi keys\fP - Rofi Key and Mouse bindings +\fBrofi keys\fP \- Rofi Key and Mouse bindings .SH DESCRIPTION .PP @@ -10,13 +9,13 @@ .SH Setting binding .PP -Bindings can be done on the commandline (-{bindingname}): +Bindings can be done on the commandline (\-{bindingname}): .PP .RS .nf -rofi -show run -kb-accept-entry 'Control+Shift+space' +rofi \-show run \-kb\-accept\-entry 'Control+Shift+space' .fi .RE @@ -29,7 +28,7 @@ or via the configuration file: .nf configuration { - kb-accept-entry: "Control+Shift+space"; + kb\-accept\-entry: "Control+Shift+space"; } .fi @@ -43,7 +42,7 @@ The key can be set by its name (see above) or its keycode: .nf configuration { - kb-accept-entry: "Control+Shift+[65]"; + kb\-accept\-entry: "Control+Shift+[65]"; } .fi @@ -60,7 +59,7 @@ Multiple keys can be specified for an action as a comma separated list: .nf configuration { - kb-accept-entry: "Control+Shift+space,Return"; + kb\-accept\-entry: "Control+Shift+space,Return"; } .fi @@ -75,566 +74,566 @@ prepend the binding with \fB\fC!\fR: .nf configuration { - kb-accept-entry: "!Control+Shift+space,Return"; + kb\-accept\-entry: "!Control+Shift+space,Return"; } .fi .RE .SH Keyboard Bindings -.SS \fBkb-primary-paste\fP: +.SS \fBkb\-primary\-paste\fP: .PP Paste primary selection .PP -\fBDefault\fP: Control+V,Shift+Insert +\fBDefault\fP: Control+V,Shift+Insert -.SS \fBkb-secondary-paste\fP +.SS \fBkb\-secondary\-paste\fP .PP Paste clipboard .PP -\fBDefault\fP: Control+v,Insert +\fBDefault\fP: Control+v,Insert -.SS \fBkb-clear-line\fP +.SS \fBkb\-clear\-line\fP .PP Clear input line .PP -\fBDefault\fP: Control+w +\fBDefault\fP: Control+w -.SS \fBkb-move-front\fP +.SS \fBkb\-move\-front\fP .PP Beginning of line .PP -\fBDefault\fP: Control+a +\fBDefault\fP: Control+a -.SS \fBkb-move-end\fP +.SS \fBkb\-move\-end\fP .PP End of line .PP -\fBDefault\fP: Control+e +\fBDefault\fP: Control+e -.SS \fBkb-move-word-back\fP +.SS \fBkb\-move\-word\-back\fP .PP Move back one word .PP -\fBDefault\fP: Alt+b,Control+Left +\fBDefault\fP: Alt+b,Control+Left -.SS \fBkb-move-word-forward\fP +.SS \fBkb\-move\-word\-forward\fP .PP Move forward one word .PP -\fBDefault\fP: Alt+f,Control+Right +\fBDefault\fP: Alt+f,Control+Right -.SS \fBkb-move-char-back\fP +.SS \fBkb\-move\-char\-back\fP .PP Move back one char .PP -\fBDefault\fP: Left,Control+b +\fBDefault\fP: Left,Control+b -.SS \fBkb-move-char-forward\fP +.SS \fBkb\-move\-char\-forward\fP .PP Move forward one char .PP -\fBDefault\fP: Right,Control+f +\fBDefault\fP: Right,Control+f -.SS \fBkb-remove-word-back\fP +.SS \fBkb\-remove\-word\-back\fP .PP Delete previous word .PP -\fBDefault\fP: Control+Alt+h,Control+BackSpace +\fBDefault\fP: Control+Alt+h,Control+BackSpace -.SS \fBkb-remove-word-forward\fP +.SS \fBkb\-remove\-word\-forward\fP .PP Delete next word .PP -\fBDefault\fP: Control+Alt+d +\fBDefault\fP: Control+Alt+d -.SS \fBkb-remove-char-forward\fP +.SS \fBkb\-remove\-char\-forward\fP .PP Delete next char .PP -\fBDefault\fP: Delete,Control+d +\fBDefault\fP: Delete,Control+d -.SS \fBkb-remove-char-back\fP +.SS \fBkb\-remove\-char\-back\fP .PP Delete previous char .PP -\fBDefault\fP: BackSpace,Shift+BackSpace,Control+h +\fBDefault\fP: BackSpace,Shift+BackSpace,Control+h -.SS \fBkb-remove-to-eol\fP +.SS \fBkb\-remove\-to\-eol\fP .PP Delete till the end of line .PP -\fBDefault\fP: Control+k +\fBDefault\fP: Control+k -.SS \fBkb-remove-to-sol\fP +.SS \fBkb\-remove\-to\-sol\fP .PP Delete till the start of line .PP -\fBDefault\fP: Control+u +\fBDefault\fP: Control+u -.SS \fBkb-accept-entry\fP +.SS \fBkb\-accept\-entry\fP .PP Accept entry .PP -\fBDefault\fP: Control+j,Control+m,Return,KP_Enter +\fBDefault\fP: Control+j,Control+m,Return,KP\_Enter -.SS \fBkb-accept-custom\fP +.SS \fBkb\-accept\-custom\fP .PP Use entered text as command (in ssh/run modes) .PP -\fBDefault\fP: Control+Return +\fBDefault\fP: Control+Return -.SS \fBkb-accept-custom-alt\fP +.SS \fBkb\-accept\-custom\-alt\fP .PP Use entered text as command (in ssh/run modes) .PP -\fBDefault\fP: Control+Shift+Return +\fBDefault\fP: Control+Shift+Return -.SS \fBkb-accept-alt\fP +.SS \fBkb\-accept\-alt\fP .PP Use alternate accept command. .PP -\fBDefault\fP: Shift+Return +\fBDefault\fP: Shift+Return -.SS \fBkb-delete-entry\fP +.SS \fBkb\-delete\-entry\fP .PP Delete entry from history .PP -\fBDefault\fP: Shift+Delete +\fBDefault\fP: Shift+Delete -.SS \fBkb-mode-next\fP +.SS \fBkb\-mode\-next\fP .PP Switch to the next mode. .PP -\fBDefault\fP: Shift+Right,Control+Tab +\fBDefault\fP: Shift+Right,Control+Tab -.SS \fBkb-mode-previous\fP +.SS \fBkb\-mode\-previous\fP .PP Switch to the previous mode. .PP -\fBDefault\fP: Shift+Left,Control+ISO_Left_Tab +\fBDefault\fP: Shift+Left,Control+ISO\_Left\_Tab -.SS \fBkb-mode-complete\fP +.SS \fBkb\-mode\-complete\fP .PP Start completion for mode. .PP -\fBDefault\fP: Control+l +\fBDefault\fP: Control+l -.SS \fBkb-row-left\fP +.SS \fBkb\-row\-left\fP .PP Go to the previous column .PP -\fBDefault\fP: Control+Page_Up +\fBDefault\fP: Control+Page\_Up -.SS \fBkb-row-right\fP +.SS \fBkb\-row\-right\fP .PP Go to the next column .PP -\fBDefault\fP: Control+Page_Down +\fBDefault\fP: Control+Page\_Down -.SS \fBkb-row-up\fP +.SS \fBkb\-row\-up\fP .PP Select previous entry .PP -\fBDefault\fP: Up,Control+p +\fBDefault\fP: Up,Control+p -.SS \fBkb-row-down\fP +.SS \fBkb\-row\-down\fP .PP Select next entry .PP -\fBDefault\fP: Down,Control+n +\fBDefault\fP: Down,Control+n -.SS \fBkb-row-tab\fP +.SS \fBkb\-row\-tab\fP .PP Go to next row, if one left, accept it, if no left next mode. .PP -\fBDefault\fP: +\fBDefault\fP: -.SS \fBkb-element-next\fP +.SS \fBkb\-element\-next\fP .PP Go to next row. .PP -\fBDefault\fP: Tab +\fBDefault\fP: Tab -.SS \fBkb-element-prev\fP +.SS \fBkb\-element\-prev\fP .PP Go to previous row. .PP -\fBDefault\fP: ISO_Left_Tab +\fBDefault\fP: ISO\_Left\_Tab -.SS \fBkb-page-prev\fP +.SS \fBkb\-page\-prev\fP .PP Go to the previous page .PP -\fBDefault\fP: Page_Up +\fBDefault\fP: Page\_Up -.SS \fBkb-page-next\fP +.SS \fBkb\-page\-next\fP .PP Go to the next page .PP -\fBDefault\fP: Page_Down +\fBDefault\fP: Page\_Down -.SS \fBkb-row-first\fP +.SS \fBkb\-row\-first\fP .PP Go to the first entry .PP -\fBDefault\fP: Home,KP_Home +\fBDefault\fP: Home,KP\_Home -.SS \fBkb-row-last\fP +.SS \fBkb\-row\-last\fP .PP Go to the last entry .PP -\fBDefault\fP: End,KP_End +\fBDefault\fP: End,KP\_End -.SS \fBkb-row-select\fP +.SS \fBkb\-row\-select\fP .PP Set selected item as input text .PP -\fBDefault\fP: Control+space +\fBDefault\fP: Control+space -.SS \fBkb-screenshot\fP +.SS \fBkb\-screenshot\fP .PP Take a screenshot of the rofi window .PP -\fBDefault\fP: Alt+S +\fBDefault\fP: Alt+S -.SS \fBkb-ellipsize\fP +.SS \fBkb\-ellipsize\fP .PP Toggle between ellipsize modes for displayed data .PP -\fBDefault\fP: Alt+period +\fBDefault\fP: Alt+period -.SS \fBkb-toggle-case-sensitivity\fP +.SS \fBkb\-toggle\-case\-sensitivity\fP .PP Toggle case sensitivity .PP -\fBDefault\fP: grave,dead_grave +\fBDefault\fP: grave,dead\_grave -.SS \fBkb-toggle-sort\fP +.SS \fBkb\-toggle\-sort\fP .PP Toggle sort .PP -\fBDefault\fP: Alt+grave +\fBDefault\fP: Alt+grave -.SS \fBkb-cancel\fP +.SS \fBkb\-cancel\fP .PP Quit rofi .PP -\fBDefault\fP: Escape,Control+g,Control+bracketleft +\fBDefault\fP: Escape,Control+g,Control+bracketleft -.SS \fBkb-custom-1\fP +.SS \fBkb\-custom\-1\fP .PP Custom keybinding 1 .PP -\fBDefault\fP: Alt+1 +\fBDefault\fP: Alt+1 -.SS \fBkb-custom-2\fP +.SS \fBkb\-custom\-2\fP .PP Custom keybinding 2 .PP -\fBDefault\fP: Alt+2 +\fBDefault\fP: Alt+2 -.SS \fBkb-custom-3\fP +.SS \fBkb\-custom\-3\fP .PP Custom keybinding 3 .PP -\fBDefault\fP: Alt+3 +\fBDefault\fP: Alt+3 -.SS \fBkb-custom-4\fP +.SS \fBkb\-custom\-4\fP .PP Custom keybinding 4 .PP -\fBDefault\fP: Alt+4 +\fBDefault\fP: Alt+4 -.SS \fBkb-custom-5\fP +.SS \fBkb\-custom\-5\fP .PP Custom Keybinding 5 .PP -\fBDefault\fP: Alt+5 +\fBDefault\fP: Alt+5 -.SS \fBkb-custom-6\fP +.SS \fBkb\-custom\-6\fP .PP Custom keybinding 6 .PP -\fBDefault\fP: Alt+6 +\fBDefault\fP: Alt+6 -.SS \fBkb-custom-7\fP +.SS \fBkb\-custom\-7\fP .PP Custom Keybinding 7 .PP -\fBDefault\fP: Alt+7 +\fBDefault\fP: Alt+7 -.SS \fBkb-custom-8\fP +.SS \fBkb\-custom\-8\fP .PP Custom keybinding 8 .PP -\fBDefault\fP: Alt+8 +\fBDefault\fP: Alt+8 -.SS \fBkb-custom-9\fP +.SS \fBkb\-custom\-9\fP .PP Custom keybinding 9 .PP -\fBDefault\fP: Alt+9 +\fBDefault\fP: Alt+9 -.SS \fBkb-custom-10\fP +.SS \fBkb\-custom\-10\fP .PP Custom keybinding 10 .PP -\fBDefault\fP: Alt+0 +\fBDefault\fP: Alt+0 -.SS \fBkb-custom-11\fP +.SS \fBkb\-custom\-11\fP .PP Custom keybinding 11 .PP -\fBDefault\fP: Alt+exclam +\fBDefault\fP: Alt+exclam -.SS \fBkb-custom-12\fP +.SS \fBkb\-custom\-12\fP .PP Custom keybinding 12 .PP -\fBDefault\fP: Alt+at +\fBDefault\fP: Alt+at -.SS \fBkb-custom-13\fP +.SS \fBkb\-custom\-13\fP .PP Custom keybinding 13 .PP -\fBDefault\fP: Alt+numbersign +\fBDefault\fP: Alt+numbersign -.SS \fBkb-custom-14\fP +.SS \fBkb\-custom\-14\fP .PP Custom keybinding 14 .PP -\fBDefault\fP: Alt+dollar +\fBDefault\fP: Alt+dollar -.SS \fBkb-custom-15\fP +.SS \fBkb\-custom\-15\fP .PP Custom keybinding 15 .PP -\fBDefault\fP: Alt+percent +\fBDefault\fP: Alt+percent -.SS \fBkb-custom-16\fP +.SS \fBkb\-custom\-16\fP .PP Custom keybinding 16 .PP -\fBDefault\fP: Alt+dead_circumflex +\fBDefault\fP: Alt+dead\_circumflex -.SS \fBkb-custom-17\fP +.SS \fBkb\-custom\-17\fP .PP Custom keybinding 17 .PP -\fBDefault\fP: Alt+ampersand +\fBDefault\fP: Alt+ampersand -.SS \fBkb-custom-18\fP +.SS \fBkb\-custom\-18\fP .PP Custom keybinding 18 .PP -\fBDefault\fP: Alt+asterisk +\fBDefault\fP: Alt+asterisk -.SS \fBkb-custom-19\fP +.SS \fBkb\-custom\-19\fP .PP Custom Keybinding 19 .PP -\fBDefault\fP: Alt+parenleft +\fBDefault\fP: Alt+parenleft -.SS \fBkb-select-1\fP +.SS \fBkb\-select\-1\fP .PP Select row 1 .PP -\fBDefault\fP: Super+1 +\fBDefault\fP: Super+1 -.SS \fBkb-select-2\fP +.SS \fBkb\-select\-2\fP .PP Select row 2 .PP -\fBDefault\fP: Super+2 +\fBDefault\fP: Super+2 -.SS \fBkb-select-3\fP +.SS \fBkb\-select\-3\fP .PP Select row 3 .PP -\fBDefault\fP: Super+3 +\fBDefault\fP: Super+3 -.SS \fBkb-select-4\fP +.SS \fBkb\-select\-4\fP .PP Select row 4 .PP -\fBDefault\fP: Super+4 +\fBDefault\fP: Super+4 -.SS \fBkb-select-5\fP +.SS \fBkb\-select\-5\fP .PP Select row 5 .PP -\fBDefault\fP: Super+5 +\fBDefault\fP: Super+5 -.SS \fBkb-select-6\fP +.SS \fBkb\-select\-6\fP .PP Select row 6 .PP -\fBDefault\fP: Super+6 +\fBDefault\fP: Super+6 -.SS \fBkb-select-7\fP +.SS \fBkb\-select\-7\fP .PP Select row 7 .PP -\fBDefault\fP: Super+7 +\fBDefault\fP: Super+7 -.SS \fBkb-select-8\fP +.SS \fBkb\-select\-8\fP .PP Select row 8 .PP -\fBDefault\fP: Super+8 +\fBDefault\fP: Super+8 -.SS \fBkb-select-9\fP +.SS \fBkb\-select\-9\fP .PP Select row 9 .PP -\fBDefault\fP: Super+9 +\fBDefault\fP: Super+9 -.SS \fBkb-select-10\fP +.SS \fBkb\-select\-10\fP .PP Select row 10 .PP -\fBDefault\fP: Super+0 +\fBDefault\fP: Super+0 .SH Mouse Bindings -.SS \fBml-row-left\fP +.SS \fBml\-row\-left\fP .PP Go to the previous column .PP -\fBDefault\fP: ScrollLeft +\fBDefault\fP: ScrollLeft -.SS \fBml-row-right\fP +.SS \fBml\-row\-right\fP .PP Go to the next column .PP -\fBDefault\fP: ScrollRight +\fBDefault\fP: ScrollRight -.SS \fBml-row-up\fP +.SS \fBml\-row\-up\fP .PP Select previous entry .PP -\fBDefault\fP: ScrollUp +\fBDefault\fP: ScrollUp -.SS \fBml-row-down\fP +.SS \fBml\-row\-down\fP .PP Select next entry .PP -\fBDefault\fP: ScrollDown +\fBDefault\fP: ScrollDown -.SS \fBme-select-entry\fP +.SS \fBme\-select\-entry\fP .PP Select hovered row .PP -\fBDefault\fP: MousePrimary +\fBDefault\fP: MousePrimary -.SS \fBme-accept-entry\fP +.SS \fBme\-accept\-entry\fP .PP Accept hovered row .PP -\fBDefault\fP: MouseDPrimary +\fBDefault\fP: MouseDPrimary -.SS \fBme-accept-custom\fP +.SS \fBme\-accept\-custom\fP .PP Accept hovered row with custom action .PP -\fBDefault\fP: Control+MouseDPrimary +\fBDefault\fP: Control+MouseDPrimary .SH SEE ALSO .PP -rofi(1), rofi-sensible-terminal(1), rofi-theme(5), rofi-script(5) +rofi(1), rofi\-sensible\-terminal(1), rofi\-theme(5), rofi\-script(5) .SH AUTHOR .PP -Qball Cow qball@gmpclient.org -\[la]mailto:qball@gmpclient.org\[ra] +Qball Cow +\[la]qball@gmpclient.org\[ra] .PP -Rasmus Steinke rasi@xssn.at -\[la]mailto:rasi@xssn.at\[ra] +Rasmus Steinke +\[la]rasi@xssn.at\[ra] .PP -Morgane Glidic sardemff7+rofi@sardemff7.net -\[la]mailto:sardemff7+rofi@sardemff7.net\[ra] +Morgane Glidic +\[la]sardemff7+rofi@sardemff7.net\[ra] .PP -Original code based on work by: Sean Pringle sean.pringle@gmail.com -\[la]mailto:sean.pringle@gmail.com\[ra] +Original code based on work by: Sean Pringle +\[la]sean.pringle@gmail.com\[ra] .PP For a full list of authors, check the AUTHORS file. diff --git a/doc/rofi-script.5 b/doc/rofi-script.5 index 689f4155..28fb7864 100644 --- a/doc/rofi-script.5 +++ b/doc/rofi-script.5 @@ -1,8 +1,7 @@ -.nh -.TH ROFI-SCRIPT 5 rofi-script +.TH ROFI\-SCRIPT 5 rofi\-script .SH NAME .PP -\fBrofi script mode\fP - Rofi format for scriptable mode. +\fBrofi script mode\fP \- Rofi format for scriptable mode. .SH DESCRIPTION .PP @@ -20,7 +19,7 @@ For example: .RS .nf -rofi -show fb -modes "fb:file_browser.sh" +rofi \-show fb \-modes "fb:file\_browser.sh" .fi .RE @@ -62,7 +61,7 @@ This shows two entries, reload and quit. When the quit entry is selected, rofi c .PP Rofi sets the following environment variable when executing the script: -.SS \fB\fCROFI_RETV\fR +.SS \fB\fCROFI\_RETV\fR .PP An integer number with the current state: @@ -74,15 +73,15 @@ An integer number with the current state: .IP \(bu 2 \fB2\fP: Selected a custom entry. .IP \(bu 2 -\fB10-28\fP: Custom keybinding 1-19 ( need to be explicitly enabled by script ). +\fB10\-28\fP: Custom keybinding 1\-19 ( need to be explicitly enabled by script ). .RE -.SS \fB\fCROFI_INFO\fR +.SS \fB\fCROFI\_INFO\fR .PP Environment get set when selected entry get set with the property value of the 'info' row option, if set. -.SS \fB\fCROFI_DATA\fR +.SS \fB\fCROFI\_DATA\fR .PP Environment get set when script sets \fB\fCdata\fR option in header. @@ -98,7 +97,7 @@ For example to set the prompt: .RS .nf - echo -en "\\0prompt\\x1fChange prompt\\n" + echo \-en "\\0prompt\\x1fChange prompt\\n" .fi .RE @@ -112,7 +111,7 @@ The following extra options exists: .IP \(bu 2 \fBmessage\fP: Update the message text. .IP \(bu 2 -\fBmarkup-rows\fP: If 'true' renders markup in the row. +\fBmarkup\-rows\fP: If 'true' renders markup in the row. .IP \(bu 2 \fBurgent\fP: Mark rows as urgent. (for syntax see the urgent option in dmenu mode) .IP \(bu 2 @@ -120,13 +119,13 @@ The following extra options exists: .IP \(bu 2 \fBdelim\fP: Set the delimiter for for next rows. Default is '\\n' and this option should finish with this. Only call this on first call of script, it is remembered for consecutive calls. .IP \(bu 2 -\fBno-custom\fP: If set to 'true'; only accept listed entries, ignore custom input. +\fBno\-custom\fP: If set to 'true'; only accept listed entries, ignore custom input. .IP \(bu 2 -\fBuse-hot-keys\fP: If set to true, it enabled the Custom keybindings for script. Warning this breaks the normal rofi flow. +\fBuse\-hot\-keys\fP: If set to true, it enabled the Custom keybindings for script. Warning this breaks the normal rofi flow. .IP \(bu 2 -\fBkeep-selection\fP: If set, the selection is not moved to the first entry, but the current position is maintained. +\fBkeep\-selection\fP: If set, the selection is not moved to the first entry, but the current position is maintained. .IP \(bu 2 -\fBdata\fP: Passed data to the next execution of the script via \fBROFI_DATA\fP\&. +\fBdata\fP: Passed data to the next execution of the script via \fBROFI\_DATA\fP\&. .IP \(bu 2 \fBtheme\fP: Small theme snippet to f.e. change the background color of a widget. @@ -144,7 +143,7 @@ For example: .RS .nf - echo -en "aap\\0icon\\x1ffolder\\n" + echo \-en "aap\\0icon\\x1ffolder\\n" .fi .RE @@ -160,7 +159,7 @@ The following options are supported: .IP \(bu 2 \fBnonselectable\fP: If true the row cannot activated. .IP \(bu 2 -\fBinfo\fP: Info that, on selection, gets placed in the \fB\fCROFI_INFO\fR environment variable. This entry does not get searched. +\fBinfo\fP: Info that, on selection, gets placed in the \fB\fCROFI\_INFO\fR environment variable. This entry does not get searched. .RE @@ -171,7 +170,7 @@ multiple entries can be passed using the \fB\fC\\x1f\fR separator. .RS .nf - echo -en "aap\\0icon\\x1ffolder\\x1finfo\\x1ftest\\n" + echo \-en "aap\\0icon\\x1ffolder\\x1finfo\\x1ftest\\n" .fi .RE @@ -188,7 +187,7 @@ In bash the best way to do this is using \fB\fCcoproc\fR\&. .RS .nf - coproc ( myApp > /dev/null 2>&1 ) + coproc ( myApp > /dev/null 2>\&1 ) .fi .RE @@ -200,24 +199,24 @@ See issue #1201 on github. .SH SEE ALSO .PP -rofi(1), rofi-sensible-terminal(1), dmenu(1), rofi-theme(5), rofi-theme-selector(1) +rofi(1), rofi\-sensible\-terminal(1), dmenu(1), rofi\-theme(5), rofi\-theme\-selector(1) .SH AUTHOR .PP -Qball Cow qball@gmpclient.org -\[la]mailto:qball@gmpclient.org\[ra] +Qball Cow +\[la]qball@gmpclient.org\[ra] .PP -Rasmus Steinke rasi@xssn.at -\[la]mailto:rasi@xssn.at\[ra] +Rasmus Steinke +\[la]rasi@xssn.at\[ra] .PP -Morgane Glidic sardemff7+rofi@sardemff7.net -\[la]mailto:sardemff7+rofi@sardemff7.net\[ra] +Morgane Glidic +\[la]sardemff7+rofi@sardemff7.net\[ra] .PP -Original code based on work by: Sean Pringle sean.pringle@gmail.com -\[la]mailto:sean.pringle@gmail.com\[ra] +Original code based on work by: Sean Pringle +\[la]sean.pringle@gmail.com\[ra] .PP For a full list of authors, check the AUTHORS file. diff --git a/doc/rofi-sensible-terminal.1 b/doc/rofi-sensible-terminal.1 index 86634e19..30d4a15d 100644 --- a/doc/rofi-sensible-terminal.1 +++ b/doc/rofi-sensible-terminal.1 @@ -1,18 +1,17 @@ -.nh -.TH rofi-sensible-terminal 1 rofi-sensible-terminal +.TH rofi\-sensible\-terminal 1 rofi\-sensible\-terminal .SH NAME .PP -\fBrofi-sensible-terminal\fP - launches $TERMINAL with fallbacks +\fBrofi\-sensible\-terminal\fP \- launches $TERMINAL with fallbacks .SH SYNOPSIS .PP -rofi-sensible-terminal [arguments] +rofi\-sensible\-terminal [arguments] .SH DESCRIPTION .PP -rofi-sensible-terminal is invoked in the rofi default config to start a terminal. This -wrapper script is necessary since there is no distribution-independent terminal launcher -(but for example Debian has x-terminal-emulator). Distribution packagers are responsible for +rofi\-sensible\-terminal is invoked in the rofi default config to start a terminal. This +wrapper script is necessary since there is no distribution\-independent terminal launcher +(but for example Debian has x\-terminal\-emulator). Distribution packagers are responsible for shipping this script in a way which is appropriate for the distribution. .PP @@ -20,9 +19,9 @@ It tries to start one of the following (in that order): .RS .IP \(bu 2 -\fB\fC$TERMINAL\fR (this is a non-standard variable) +\fB\fC$TERMINAL\fR (this is a non\-standard variable) .IP \(bu 2 -x-terminal-emulator +x\-terminal\-emulator .IP \(bu 2 urxvt .IP \(bu 2 @@ -44,9 +43,9 @@ xterm .IP \(bu 2 roxterm .IP \(bu 2 -xfce4-terminal.wrapper +xfce4\-terminal.wrapper .IP \(bu 2 -mate-terminal +mate\-terminal .IP \(bu 2 lxterminal .IP \(bu 2 diff --git a/doc/rofi-theme-selector.1 b/doc/rofi-theme-selector.1 index 96df43df..de076ff4 100644 --- a/doc/rofi-theme-selector.1 +++ b/doc/rofi-theme-selector.1 @@ -1,39 +1,38 @@ -.nh -.TH rofi-theme-selector 1 rofi-theme-selector +.TH rofi\-theme\-selector 1 rofi\-theme\-selector .SH NAME .PP -\fBrofi-theme-selector\fP - Preview and apply themes for \fBrofi\fP +\fBrofi\-theme\-selector\fP \- Preview and apply themes for \fBrofi\fP .SH DESCRIPTION .PP -\fBrofi-theme-selector\fP is a bash/rofi script to preview and apply themes for \fBrofi\fP\&. +\fBrofi\-theme\-selector\fP is a bash/rofi script to preview and apply themes for \fBrofi\fP\&. It's part of any installation of \fBrofi\fP\&. .SH USAGE -.SS Running rofi-theme-selector +.SS Running rofi\-theme\-selector .PP -\fBrofi-theme-selector\fP shows a list of all available themes in a \fBrofi\fP window. +\fBrofi\-theme\-selector\fP shows a list of all available themes in a \fBrofi\fP window. It lets you preview each theme with the Enter key and apply the theme to your \fBrofi\fP configuration file with Alt+a. .SH Theme directories .PP -\fBrofi-theme-selector\fP searches the following directories for themes: +\fBrofi\-theme\-selector\fP searches the following directories for themes: .RS .IP \(bu 2 ${PREFIX}/share/rofi/themes .IP \(bu 2 -$XDG_CONFIG_HOME/rofi/themes +$XDG\_CONFIG\_HOME/rofi/themes .IP \(bu 2 -$XDG_DATA_HOME/share/rofi/themes +$XDG\_DATA\_HOME/share/rofi/themes .RE .PP -${PREFIX} reflects the install location of rofi. In most cases this will be "/usr". -$XDG_CONFIG_HOME is normally unset. Default path is "$HOME/.config". -$XDG_DATA_HOME is normally unset. Default path is "$HOME/.local/share". +${PREFIX} reflects the install location of rofi. In most cases this will be "/usr".
+$XDG\_CONFIG\_HOME is normally unset. Default path is "$HOME/.config".
+$XDG\_DATA\_HOME is normally unset. Default path is "$HOME/.local/share". .SH SEE ALSO .PP @@ -41,5 +40,5 @@ rofi(1) .SH AUTHORS .PP -Qball Cow qball@gmpclient.org +Qball Cow qball@gmpclient.org
Rasmus Steinke rasi@xssn.at diff --git a/doc/rofi-theme.5 b/doc/rofi-theme.5 index 57ffaedb..e5f0ffa6 100644 --- a/doc/rofi-theme.5 +++ b/doc/rofi-theme.5 @@ -1,8 +1,7 @@ -.nh -.TH ROFI-THEME 5 rofi-theme +.TH ROFI\-THEME 5 rofi\-theme .SH NAME .PP -\fBrofi-theme\fP - Rofi theme format files +\fBrofi\-theme\fP \- Rofi theme format files .SH GETTING STARTED WITH THEMING .PP @@ -11,7 +10,7 @@ The easiest way to get started theming rofi is by modifying your existing theme. .PP Themes can be modified/tweaked by adding theming elements to the end of the .br -config file. The default location of this file is \fB\fC~/.config/rofi/config.rasi\fR, +config file. The default location of this file is \fB\fC\~/.config/rofi/config.rasi\fR, if the file does not exists, you can create it. .PP @@ -23,10 +22,10 @@ A basic config: .nf configuration { modes: [ combi ]; - combi-modes: [ window, drun, run ]; + combi\-modes: [ window, drun, run ]; } -@theme "gruvbox-light" +@theme "gruvbox\-light" /* Insert theme modifications after this */ @@ -79,7 +78,7 @@ increase the size. First we start by modifying the \fB\fCelement\fR widget: element { orientation: horizontal; - children: [ element-text, element-icon ]; + children: [ element\-text, element\-icon ]; spacing: 5px; } @@ -106,19 +105,19 @@ Resulting in the following packing: .PP The \fB\fCelement\fR (container) widget hold each entry in the \fB\fClistview\fR, we add the -two pre-defined children in the order we want to show. We also specify the +two pre\-defined children in the order we want to show. We also specify the packing direction (\fB\fCorientation\fR) and the spacing between the children (\fB\fCspacing\fR). We specify the space between the two children in absolute pixels (\fB\fCpx\fR). .PP -To increase the icon-size, we need to modify the \fB\fCelement-icon\fR widget. +To increase the icon\-size, we need to modify the \fB\fCelement\-icon\fR widget. .PP .RS .nf -element-icon { +element\-icon { size: 2.5em; } @@ -146,23 +145,23 @@ In this example we specify the size in the em \[la]https://www.w3.org/Style/LieBos3e/em\[ra] unit. .PP -Now lets change the text color of both the \fB\fCentry\fR and the \fB\fCelement-text\fR widget to red and background to blue. +Now lets change the text color of both the \fB\fCentry\fR and the \fB\fCelement\-text\fR widget to red and background to blue. .PP .RS .nf -entry, element-text { - text-color: red; - background-color: rgb(0,0,255); +entry, element\-text { + text\-color: red; + background\-color: rgb(0,0,255); } .fi .RE .PP -Here we use two different methods of writing down the color, for \fB\fCtext-color\fR -we used a named color, for \fB\fCbackground-color\fR we specify it in \fB\fCrgb\fR\&. +Here we use two different methods of writing down the color, for \fB\fCtext\-color\fR +we used a named color, for \fB\fCbackground\-color\fR we specify it in \fB\fCrgb\fR\&. We also specify the property for multiple widgets by passing a comma separated list of widget names. @@ -173,8 +172,8 @@ If you want to center the text relative to the icon, we can set this: .RS .nf -element-icon { - vertical-align: 0.5; +element\-icon { + vertical\-align: 0.5; } .fi @@ -188,7 +187,7 @@ element-icon { │ element │ │ ┌─────────────────────────────────────────────┐ ┌─────────────────┐ │ │ │ │ │ element │ │ -│ │element-text │ │ ─ │ │ +│ │element\-text │ │ ─ │ │ │ │ │ │ icon │ │ │ └─────────────────────────────────────────────┘ └─────────────────┘ │ └─────────────────────────────────────────────────────────────────────┘ @@ -203,7 +202,7 @@ If you want to see the complete theme, including the modification you can run: .RS .nf -rofi -dump-theme +rofi \-dump\-theme .fi .RE @@ -241,7 +240,7 @@ To see the default theme, run the following command: .RS .nf -rofi -no-config -dump-theme +rofi \-no\-config \-dump\-theme .fi .RE @@ -251,12 +250,12 @@ rofi -no-config -dump-theme The need for a new theme format was motivated by the fact that the way rofi handled widgets has changed. From a very static drawing of lines and text to a nice structured form of packing widgets. This change made it possible to provide a more flexible theme framework. The old theme format and config file are not flexible enough to expose these options in a -user-friendly way. Therefore, a new file format has been created, replacing the old one. +user\-friendly way. Therefore, a new file format has been created, replacing the old one. .SH FORMAT SPECIFICATION .SH Encoding .PP -The encoding of the file is UTF-8. Both unix (\fB\fC\\n\fR) and windows (\fB\fC\\r\\n\fR) newlines format are supported. But unix is +The encoding of the file is UTF\-8. Both unix (\fB\fC\\n\fR) and windows (\fB\fC\\r\\n\fR) newlines format are supported. But unix is preferred. .SH Comments @@ -338,7 +337,7 @@ abbreviation for \fBr\fPofi \fBa\fPdvanced \fBs\fPtyle \fBi\fPnformation. .SH Basic Structure .PP Each element has a section with defined properties. Global properties can be defined in section \fB\fC* { }\fR\&. -Sub-section names begin with an optional hash symbol \fB\fC#\fR\&. +Sub\-section names begin with an optional hash symbol \fB\fC#\fR\&. .PP It is advised to define the \fIglobal properties section\fP on top of the file to @@ -387,7 +386,7 @@ A theme can have multiple element theme sections. .PP The element path can consist of multiple names separated by whitespace or dots. -Each element may contain any number of letters, numbers and \fB\fC-\fR\&'s. +Each element may contain any number of letters, numbers and \fB\fC\-\fR\&'s. The first element in the element path can optionally start with a \fB\fC#\fR (for historic reasons). Multiple elements can be specified by a \fB\fC,\fR\&. @@ -399,10 +398,10 @@ This is a valid element name: .nf element normal.normal { - background-color: blue; + background\-color: blue; } button { - background-color: blue; + background\-color: blue; } .fi @@ -416,7 +415,7 @@ And is identical to: .nf element normal normal, button { - background-color: blue; + background\-color: blue; } .fi @@ -483,7 +482,7 @@ Both fields are mandatory for a property. .PP The \fB\fCidentifier\fR names the specified property. Identifiers can consist of any -combination of numbers, letters and '-'. It must not contain any whitespace. +combination of numbers, letters and '\-'. It must not contain any whitespace. The structure of the \fB\fCvalue\fR defines the type of the property. The current parser does not define or enforce a certain type of a particular \fB\fCidentifier\fR\&. When used, values with the wrong type that cannot be converted are ignored. @@ -559,7 +558,7 @@ font: "Awasome 12"; .RE .PP -The string must be valid UTF-8, special characters can be escaped: +The string must be valid UTF\-8, special characters can be escaped: .PP .RS @@ -578,7 +577,7 @@ The following special characters can be escaped: \fB\fC\\b\fR, \fB\fC\\f\fR, \fB .SH Integer .RS .IP \(bu 2 -Format: \fB\fC[-+]?[:digit:]+\fR +Format: \fB\fC[\-+]?[:digit:]+\fR .RE @@ -600,7 +599,7 @@ lines: 12; .SH Real .RS .IP \(bu 2 -Format: \fB\fC[-+]?[:digit:]+(\\.[:digit:]+)?\fR +Format: \fB\fC[\-+]?[:digit:]+(\\.[:digit:]+)?\fR .RE @@ -620,7 +619,7 @@ real: 3.4; .RE .PP -The following is not valid: \fB\fC\&.3\fR, \fB\fC3.\fR or scientific notation: \fB\fC3.4e-3\fR\&. +The following is not valid: \fB\fC\&.3\fR, \fB\fC3.\fR or scientific notation: \fB\fC3.4e\-3\fR\&. .SH Boolean .RS @@ -630,7 +629,7 @@ Format: \fB\fC(true|false)\fR .RE .PP -Boolean value is either \fB\fCtrue\fR or \fB\fCfalse\fR\&. This is case-sensitive. +Boolean value is either \fB\fCtrue\fR or \fB\fCfalse\fR\&. This is case\-\&sensitive. .PP For example: @@ -646,7 +645,7 @@ dynamic: false; .SH Image .PP -\fBrofi\fP support a limited set of background-image formats. +\fBrofi\fP support a limited set of background\-image formats. .RS .IP \(bu 2 @@ -655,12 +654,12 @@ Format: url("path to image"); Format: url("path to image", scale); where scale is: none, both, width, height .IP \(bu 2 -Format: linear-gradient(stop color,stop1, color, stop2 color, ...); +Format: linear\-gradient(stop color,stop1, color, stop2 color, ...); .IP \(bu 2 -Format: linear-gradient(to direction, stop color,stop1, color, stop2 color, ...); +Format: linear\-gradient(to direction, stop color,stop1, color, stop2 color, ...); where direction is: top,left,right,bottom. .IP \(bu 2 -Format: linear-gradient(angle, stop color,stop1, color, stop2 color, ...); +Format: linear\-gradient(angle, stop color,stop1, color, stop2 color, ...); Angle in deg,rad,grad (as used in color). .RE @@ -692,27 +691,31 @@ Format: \fB\fChwb[a]( {ANGLE}, {PERCENTAGE}, {PERCENTAGE} [, {PERCENTAGE}])\fR .IP \(bu 2 Format: \fB\fCcmyk( {PERCENTAGE}, {PERCENTAGE}, {PERCENTAGE}, {PERCENTAGE} [, {PERCENTAGE} ])\fR .IP \(bu 2 -Format: \fB\fC{named-color} [ / {PERCENTAGE} ]\fR +Format: \fB\fC{named\-color} [ / {PERCENTAGE} ]\fR .RE .PP -The white-space format proposed in CSS4 is also supported. +The white\-space format proposed in CSS4 is also supported. .PP The different values are: .RS .IP \(bu 2 -\fB\fC{HEX}\fR is a hexadecimal number ('0-9a-f' case insensitive). +\fB\fC{HEX}\fR is a hexadecimal number ('0\-9a\-f' case insensitive). .IP \(bu 2 -\fB\fC{INTEGER}\fR value can be between 0 and 255 or 0-100 when representing percentage. +\fB\fC{INTEGER}\fR value can be between 0 and 255 or 0\-100 when representing percentage. .IP \(bu 2 \fB\fC{ANGLE}\fR is the angle on the color wheel, can be in \fB\fCdeg\fR, \fB\fCrad\fR, \fB\fCgrad\fR or \fB\fCturn\fR\&. When no unit is specified, degrees is assumed. .IP \(bu 2 -\fB\fC{PERCENTAGE}\fR can be between 0-1.0, or 0%-100% +\fB\fC{PERCENTAGE}\fR can be between 0\-1.0, or 0%\-100% .IP \(bu 2 -\fB\fC{named-color}\fR is one of the following colors:AliceBlue, AntiqueWhite, Aqua, Aquamarine, Azure, Beige, Bisque, Black, BlanchedAlmond, Blue, BlueViolet, Brown, + +.PP +\fB\fC{named\-color}\fR is one of the following colors: +.PP +AliceBlue, AntiqueWhite, Aqua, Aquamarine, Azure, Beige, Bisque, Black, BlanchedAlmond, Blue, BlueViolet, Brown, BurlyWood, CadetBlue, Chartreuse, Chocolate, Coral, CornflowerBlue, Cornsilk, Crimson, Cyan, DarkBlue, DarkCyan, DarkGoldenRod, DarkGray, DarkGrey, DarkGreen, DarkKhaki, DarkMagenta, DarkOliveGreen, DarkOrange, DarkOrchid, DarkRed, DarkSalmon, DarkSeaGreen, DarkSlateBlue, DarkSlateGray, DarkSlateGrey, DarkTurquoise, DarkViolet, DeepPink, DeepSkyBlue, @@ -736,9 +739,9 @@ For example: .RS .nf -background-color: #FF0000; -border-color: rgba(0,0,1, 0.5); -text-color: SeaGreen; +background\-color: #FF0000; +border\-color: rgba(0,0,1, 0.5); +text\-color: SeaGreen; .fi .RE @@ -750,8 +753,8 @@ or .RS .nf -background-color: transparent; -text-color: Black; +background\-color: transparent; +text\-color: Black; .fi .RE @@ -839,7 +842,7 @@ For example: .RE .PP -On a full-HD (1920x1080) monitor, it defines a padding of 192 pixels on the left +On a full\-HD (1920x1080) monitor, it defines a padding of 192 pixels on the left and right side and 108 pixels on the top and bottom. .SS Calculating sizes @@ -850,7 +853,7 @@ Rofi supports some maths in calculating sizes. For this it uses the CSS syntax: .RS .nf -width: calc( 100% - 37px ); +width: calc( 100% \- 37px ); .fi .RE @@ -871,7 +874,7 @@ It supports the following operations: .IP \(bu 2 \fB\fC+\fR : Add .IP \(bu 2 -\fB\fC-\fR : Subtract +\fB\fC\-\fR : Subtract .IP \(bu 2 \fB\fC/\fR : Divide .IP \(bu 2 @@ -919,9 +922,9 @@ The different number of fields in the formats are parsed like: .IP \(bu 2 1 field: \fB\fCall\fR .IP \(bu 2 -2 fields: \fB\fCtop&bottom\fR \fB\fCleft&right\fR +2 fields: \fB\fCtop\&bottom\fR \fB\fCleft\&right\fR .IP \(bu 2 -3 fields: \fB\fCtop\fR, \fB\fCleft&right\fR, \fB\fCbottom\fR +3 fields: \fB\fCtop\fR, \fB\fCleft\&right\fR, \fB\fCbottom\fR .IP \(bu 2 4 fields: \fB\fCtop\fR, \fB\fCright\fR, \fB\fCbottom\fR, \fB\fCleft\fR @@ -959,7 +962,6 @@ style property. .PP When no unit is specified, pixels are assumed. - .RE .SH Position @@ -1097,7 +1099,7 @@ Format: \fB\fC[ keyword, keyword ]\fR .RE .PP -A list starts with a '[' and ends with a ']'. The entries in the list are comma-separated. +A list starts with a '[' and ends with a ']'. The entries in the list are comma\-separated. The \fB\fCkeyword\fR in the list refers to an widget name. .SH List of values @@ -1108,7 +1110,7 @@ Format: \fB\fC[ value, value, ... ]\fR .RE .PP -An list starts with a '[' and ends with a ']'. The entries in the list are comma-separated. +An list starts with a '[' and ends with a ']'. The entries in the list are comma\-separated. .SH Environment variable .RS @@ -1119,14 +1121,14 @@ Format: \fB\fC${:alnum:}\fR .PP This will parse the environment variable as the property value. (that then can be any of the above types). -The environment variable should be an alphanumeric string without white-space. +The environment variable should be an alphanumeric string without white\-space. .PP .RS .nf * { - background-color: ${BG}; + background\-color: ${BG}; } .fi @@ -1140,7 +1142,7 @@ Format: \fB\fCenv(ENVIRONMENT, default)\fR .PP This will parse the environment variable as the property value. (that then can be any of the above types). -The environment variable should be an alphanumeric string without white-space. +The environment variable should be an alphanumeric string without white\-space. If the environment value is not found, the default value is used. .PP @@ -1172,7 +1174,7 @@ Inherits the property from its parent widget. .nf mainbox { - border-color: inherit; + border\-color: inherit; } .fi @@ -1224,6 +1226,7 @@ The current