From c2601e08e1f1f7ac328cfa1b803c3a85632627ae Mon Sep 17 00:00:00 2001 From: Dave Davenport Date: Tue, 8 Jun 2021 22:58:27 +0200 Subject: [PATCH] [Doc] Update manpage with extra notice about passing theme options on cmd --- doc/rofi.1 | 11 ++++++++++- doc/rofi.1.markdown | 10 +++++++++- 2 files changed, 19 insertions(+), 2 deletions(-) diff --git a/doc/rofi.1 b/doc/rofi.1 index c7002c02..51d11988 100644 --- a/doc/rofi.1 +++ b/doc/rofi.1 @@ -561,7 +561,15 @@ Default: '\-' .fi .RE -.SS Layout +.SS Layout and Themeing +.PP +\fBIMPORTANT\fP + In newer \fBrofi\fP releases all the themeing options are moved into the new theme format. The are no longer normal + \fBrofi\fP options that can be passed directly on the commandline (there are to many). + Small snippets can be passed on the commandline: \fB\fCrofi \-theme\-str 'window {width: 50%;}'\fR to override a single + setting. The are merged into the current theme. + They can also be appened at the end of the \fBrofi\fP config file to override parts of the theme. + .PP Most of the following options are \fBdeprecated\fP and should not be used. Please use the new theme format to customize \fBrofi\fP\&. More information about the new format can be found in the \fBrofi\-theme(5)\fP manpage. @@ -703,6 +711,7 @@ rofi \-theme\-str '#window { fullscreen: true; }' .PP This option can be specified multiple times. +This is now the method to tweak the theme via the commandline. .PP \fB\fC\-dpi\fR \fInumber\fP diff --git a/doc/rofi.1.markdown b/doc/rofi.1.markdown index 3523e346..3e18334c 100644 --- a/doc/rofi.1.markdown +++ b/doc/rofi.1.markdown @@ -320,7 +320,14 @@ Set to '\x0' to disable. Default: '-' -### Layout +### Layout and Themeing + +**IMPORTANT** + In newer **rofi** releases all the themeing options are moved into the new theme format. The are no longer normal + **rofi** options that can be passed directly on the commandline (there are to many). + Small snippets can be passed on the commandline: `rofi -theme-str 'window {width: 50%;}'` to override a single + setting. The are merged into the current theme. + They can also be appened at the end of the **rofi** config file to override parts of the theme. Most of the following options are **deprecated** and should not be used. Please use the new theme format to customize **rofi**. More information about the new format can be found in the **rofi-theme(5)** manpage. @@ -400,6 +407,7 @@ For example: rofi -theme-str '#window { fullscreen: true; }' This option can be specified multiple times. +This is now the method to tweak the theme via the commandline. `-dpi` *number*