From 1324bb0edd04d43a1284abad3426e5a789306706 Mon Sep 17 00:00:00 2001 From: Dave Davenport Date: Mon, 25 Sep 2017 22:28:47 +0200 Subject: [PATCH] Small tweaks to release note --- releasenotes/1.4.0/release-1.4.0.markdown | 132 +++++++++++++--------- 1 file changed, 80 insertions(+), 52 deletions(-) diff --git a/releasenotes/1.4.0/release-1.4.0.markdown b/releasenotes/1.4.0/release-1.4.0.markdown index 672d6a44..a67fd63d 100644 --- a/releasenotes/1.4.0/release-1.4.0.markdown +++ b/releasenotes/1.4.0/release-1.4.0.markdown @@ -1,42 +1,52 @@ # V1.4.0: I reject your truth and trumpstitute my own -> This release contains some major changes. One of them being a new theme engine. The migration from older versions to -> this version might not go flawless. +> This release contains some major changes. One of them being a new theme +> engine. The migration from older versions to this version might not go +> flawless. -With more then 750 commits since the last version, this is one of the biggest releases so far. -In this version we used the groundwork laid in v1.3.0 and went completely nuts with it. Hopefully this release should -satisfy the die-hard desktop [ricers](https://www.reddit.com/r/unixporn/) with a brand new theme engine. -Lot of different colors, border, multiple fonts everything is now possible. +With more then 750 commits since the last version, this is one of the biggest +releases so far. In this version we used the groundwork laid in v1.3.0 and went +completely nuts with it. Hopefully this release should satisfy the die-hard +desktop [ricers](https://www.reddit.com/r/unixporn/) with a brand new theme +engine. Lot of different colors, border, multiple fonts everything is now +possible. -Because of The great work done by [SardemFF7](https://github.com/SardemFF7/) the code base is simplified and the -key and mouse handling improved. The libraries provided by SardemFF7 also made it possible to add a often requested -feature of icons (correctly using the icon-theme). A feature I never expected to be added. To top this off, SardemFF7 -added support to build rofi using [meson](http://mesonbuild.com/). +Because of The great work done by [SardemFF7](https://github.com/SardemFF7/) the +code base is simplified and the key and mouse handling improved. The libraries +provided by SardemFF7 also made it possible to add a often requested feature of +icons (correctly using the icon-theme). A feature I never expected to be added. +To top this off, SardemFF7 added support to build rofi using +[meson](http://mesonbuild.com/). -A last big addition and still in beta, is support for plugins. Allowing the addition of some weird/fancy features. -Currently two plugins are available, [blezz](https://gitcrate.org/qtools/rofi-blezz) a quick launch menu with it own -menu definition and [top](https://gitcrate.org/qtools/rofi-top/) displaying running processes. +A last big addition and still in beta, is support for plugins. Allowing the +addition of some weird/fancy features. Currently two plugins are available, +[blezz](https://gitcrate.org/qtools/rofi-blezz) a quick launch menu with it own +menu definition and [top](https://gitcrate.org/qtools/rofi-top/) displaying +running processes. -Beside these major changes, this release includes a lot of bug-fixes and small improvements. See the bottom of this -release notes for a more complete list of changes. +Beside these major changes, this release includes a lot of bug-fixes and small +improvements. See the bottom of this release notes for a more complete list of +changes. ## Theme engine -The biggest new feature of this release is the theme engine. Building on the changes made in v1.3.0 we implemented a new -theme engine and it has a completely new theme format. While the themes are a lot more verbose now, it does allow for a -lot of extra customizations. +The biggest new feature of this release is the theme engine. Building on the +changes made in v1.3.0 we implemented a new theme engine and it has a completely +new theme format. While the themes are a lot more verbose now, it does allow for +a lot of extra customizations. It is now possible to theme each widget in rofi independently: ### Colors -You can now set the color on each widget independent in most of the CSS supported color formats (hsl, cmyk, rgb, etc.) -and each color can have a transparency. There are three colors that can be set on each widget: +You can now set the color on each widget independent in most of the CSS +supported color formats (hsl, cmyk, rgb, etc.) and each color can have a +transparency. There are three colors that can be set on each widget: * **background-color** - Used to draw the background of the widget. Each widget is drawn on top of it parent, if the background is - transparent, you will see the parents widget. + Used to draw the background of the widget. Each widget is drawn on top of it + parent, if the background is transparent, you will see the parents widget. * **border-color** Used to draw the borders. * **text-color** @@ -46,51 +56,62 @@ and each color can have a transparency. There are three colors that can be set o ### Borders -On every widget we can now configure a border for each of the four sides, the color of the border, the style of the -border (solid or dashed) and the radius of the corners can be set. +On every widget we can now configure a border for each of the four sides, the +color of the border, the style of the border (solid or dashed) and the radius of +the corners can be set. ![border1](rofi-border.png) -This combined with (fake) transparency can make for a very nice looking, rounded rofi experience. +This combined with (fake) transparency can make for a very nice looking, rounded +rofi experience. ![border2](rofi-border-transp.png) ### Fonts -An often made request was support for different fonts for the entry box and the list. With the new theme, it is possible -to change the font and size of all widgets. +An often made request was support for different fonts for the entry box and the +list. With the new theme, it is possible to change the font and size of all +widgets. ![fonts](rofi-fonts.png) -> Note that opening a fonts is one of the slowest operations during rofi startup; having multiple fonts could have a -> significant impact on startup times. +> Note that opening a fonts is one of the slowest operations during rofi +> startup; having multiple fonts could have a significant impact on startup +> times. ### Flexible layout -To top all these changes, as an advanced feature the whole layout of the window can be changed. Making it possible to -mimic the original dmenu view, or make it appear as a minimal context menu. +To top all these changes, as an advanced feature the whole layout of the window +can be changed. Making it possible to mimic the original dmenu view, or make it +appear as a minimal context menu. ![dmenu](rofi-dmenu.png) ## Error reporting -The new theme parser will also be more verbose when encountering parsing errors, hopefully helping debugging and -modifying themes. +The new theme parser will also be more verbose when encountering parsing errors, +hopefully helping debugging and modifying themes. -For example when forgetting a trailing ';' will report where it failed, and what it expected (a ';'). +For example when forgetting a trailing ';' will report where it failed, and what +it expected (a ';'). ![rofi-error](rofi-error.png) ## Importing -The new theme parser also support importing and overriding. This allow you to make make modifications to an existing -theme, without having to completely copy it. For example, I want to use the `arthur` theme (shipped with rofi) but use -fake transparency and change the font off the result list. +The new theme parser also support importing and overriding. This allow you to +make make modifications to an existing theme, without having to completely copy +it. For example, I want to use the `arthur` theme (shipped with rofi) but use +fake transparency, change the font off the result list and import a set of +overriding colors from `mycolors`. ```css // Import the default arthur theme -@import "arthur" +@theme "arthur" + +// Load in overriding of colors from mycolors. +@import "mycolors" /* on the window widget, set transparency to use a screenshot of the screen. */ #window { @@ -104,9 +125,11 @@ fake transparency and change the font off the result list. ## Icons -Another often made request, I never expected to be implemented, was icon support. With the help of SardemFF7 an -implementation was possible that correctly follows the XDG icon specification and does not negatively impact the +Another often made request, I never expected to be implemented, was icon +support. With the help of SardemFF7 an implementation was possible that +correctly follows the XDG icon specification and does not negatively impact the performance. Currently the drun and the window switcher can application icons. +To enable icons, set the `show-icons` property to `true`. ![icons](rofi-icons.png) @@ -115,8 +138,8 @@ performance. Currently the drun and the window switcher can application icons. ## More flexible key and mouse bindings Thanks to another great work of SardemFF7 you can now configure how the mouse -behave and bind modifier keys. It also improves on error messages. It will now -detect duplicate bindings. +behave and bind modifier keys. It also improves on error messages. For example +it will now detect duplicate bindings. For example to select an entry on single click, instead of double click: @@ -127,8 +150,9 @@ rofi -show run -me-select-entry '' -me-accept-entry 'Mouse1' ## Fuzzy Matching -With thanks to Fangrui Song, the `fuzzy` matcher will now use a ranking similar to `fzf` to sort the results. -This should hopefully to improve the results, something a lot of users will appreciate. +With thanks to Fangrui Song, the `fuzzy` matcher will now use a ranking similar +to `fzf` to sort the results. This should hopefully to improve the results, +something a lot of users will appreciate. Without: @@ -143,13 +167,15 @@ With: > This feature is still in beta stage. -It is now possible to add custom mode via C plugins. This is allows interactive modi to be added to rofi. -For example it is possible to have `top` (display linux processes) mode: +It is now possible to add custom mode via C plugins. This is allows interactive +modi to be added to rofi. For example it is possible to have `top` (display +linux processes) mode: ![rofi top](rofi-top.png) -This mode allows sorting of the result on different keys (cpu usage, memory, etc.) to be selected, programs to be killed -and refreshes the results every 2 seconds. +This mode allows sorting of the result on different keys (cpu usage, memory, +etc.) to be selected, programs to be killed and refreshes the results every 2 +seconds. See [here](https://gitcrate.org/qtools/rofi-top). @@ -158,9 +184,10 @@ See [here](https://gitcrate.org/qtools/rofi-top). > This feature is in alpha stage. -The new theme format can now (as an alpha) feature be used to set rofi's configuration. In the future, when we add -wayland support, we want to get rid of the current Xresources (X11) based configuration format. -You can see how this would look using: `rofi -dump-config`. +The new theme format can now (as an alpha) feature be used to set rofi's +configuration. In the future, when we add wayland support, we want to get rid of +the current Xresources (X11) based configuration format. You can see how this +would look using: `rofi -dump-config`. ## Detailed Changelog @@ -169,7 +196,8 @@ You can see how this would look using: `rofi -dump-config`. * Keybinding. Duplicate bindings will now be reported. * Invalid commandline options. * Etc. -* Customizable highlight, allowing underline, strikethrough, italic, bold, small caps and the color to be set. +* Customizable highlight, allowing underline, strikethrough, italic, bold, small + caps and the color to be set. * Give up when keyboard is not grabbed in first 5 seconds. * Improve manpage * rofi (1)