diff options
| author | Dave Davenport <qball@blame.services> | 2023-01-22 12:54:45 +0100 |
|---|---|---|
| committer | Dave Davenport <qball@blame.services> | 2023-01-22 12:54:45 +0100 |
| commit | 004f4ebd984311fac47569a54a3bb5cbe395cd6e (patch) | |
| tree | 9410e361b4ebba8b394cfaf0d49514d579543bff | |
| parent | ebb4459a60e75a25e679dd1c02466d91a662cb76 (diff) | |
[doc] Add conflicting constraint section to manpage.
| -rw-r--r-- | doc/rofi-theme.5 | 16 | ||||
| -rw-r--r-- | doc/rofi-theme.5.markdown | 15 |
2 files changed, 25 insertions, 6 deletions
diff --git a/doc/rofi-theme.5 b/doc/rofi-theme.5 index 62eadb24..98f150b9 100644 --- a/doc/rofi-theme.5 +++ b/doc/rofi-theme.5 @@ -2136,12 +2136,22 @@ It supports the following keys as constraint: .fi .RE +.SH Conflicting constraints +.PP +It is possible to define conflicting constraints in the theme. These conflicts +are not explicitly reported. The most common example is forcing a specific +window size, for example by enabling full-screen mode, having number of lines +set in the listview and having the listview expand to available space. There is +clearly a conflict in these 3 constraints. In this case, listview will not +limit to the number of lines, but tries to fill the available space. It is up +to the theme designer to make sure the theme handles this correctly. + .SH Font Parsing .PP Rofi uses pango -\[la]https://pango.gnome.org/\[ra] for font rendering. The font should be specified in a format that pango -understands. -This normally is the font name followed by the font size. For example: +\[la]https://pango.gnome.org/\[ra] for font rendering. The font should +be specified in a format that pango understands. This normally is the font name +followed by the font size. For example: .PP .RS diff --git a/doc/rofi-theme.5.markdown b/doc/rofi-theme.5.markdown index c1f71c7c..11e52dd3 100644 --- a/doc/rofi-theme.5.markdown +++ b/doc/rofi-theme.5.markdown @@ -1361,12 +1361,21 @@ It supports the following keys as constraint: } ``` +## Conflicting constraints + +It is possible to define conflicting constraints in the theme. These conflicts +are not explicitly reported. The most common example is forcing a specific +window size, for example by enabling full-screen mode, having number of lines +set in the listview and having the listview expand to available space. There is +clearly a conflict in these 3 constraints. In this case, listview will not +limit to the number of lines, but tries to fill the available space. It is up +to the theme designer to make sure the theme handles this correctly. ## Font Parsing -Rofi uses [pango](https://pango.gnome.org/) for font rendering. The font should be specified in a format that pango -understands. -This normally is the font name followed by the font size. For example: +Rofi uses [pango](https://pango.gnome.org/) for font rendering. The font should +be specified in a format that pango understands. This normally is the font name +followed by the font size. For example: ``` mono 18 |