Update release notes.

1 files changed, 96 insertions, 39 deletions

diff --git a/releasenotes/0.15.12/release-0.15.12.markdown b/releasenotes/0.15.12/release-0.15.12.markdown
index 6c808417..d83c4a0b 100644
--- a/releasenotes/0.15.12/release-0.15.12.markdown
+++ b/releasenotes/0.15.12/release-0.15.12.markdown
@@ -1,50 +1,107 @@
 # Release 0.15.12
 
-The 0.15.12 release of **rofi** focussed on improving overal user experience.
-This includes fixing problems with complex keyboard layouts, locale aware matching and more. This release also include
-(some experimental) speedups. If enabled, **rofi** will make full use of all available cores to speedup searching.
-The final improvement, it related to creating and distributing of themes. Thanks to the great work of SardemFF7 we now
-have an online themenator.
-Below I will highlight some of the bigger changes in more details
+The 0.15.12 release of **rofi** focussed on improving overall user experience.  These improvements mostly focussed on
+three things, first we tried to fix the problems with complex keyboard layouts, secondly we tried to make themeing of
+**rofi** easier and last we added several speedups.  Below I will highlight these bigger changes in more details
+
+## Keyboard Layouts
+
+**Rofi** used to have problems with keyboard layouts that used modifier keys to switch between different layouts (unsure
+how this is called). These problems should now belong to the past.
+
+**Note** the syntax for binding keys has slightly changed. The *Mod1*, *Mod2*, etc. keywords are no longer available.
+There was no good way to detect how these keys where mapped and if they could be used as modifiers. E.g. if the right
+alt (say *Mod3*) is configured to switch between layouts, it cannot work as modifier key to make a `Mod3-p` keybinding.
+**Rofi** will now check if the current layout has the *SuperR*,*SuperL*,*AltGr*,*HyperL*,*HyperR* keys available. If they
+are available they can be used for keybindings, if not, the user gets a warning.
+
+*screenshot warning*
 
 ## Speedups
 
+### DMenu reading from stdin
+
+**Rofi** used to have a custom `fgets` implementation that supported custom separators. The first version in here was
+slow and was improved. After a hint of it existence it has now been replaced by the Posix 2008 `getdelim`, this one is
+almost as fast as the new custom implementation.
+
+Overall this gave a speedup of 6x.
+
+*check speedup against previous release*
+
+### Multi-Core power
+
+Still disabled by default, **rofi** can now spawn multiple threads for filtering rows. Depending on the underlying
+hardware we saw a 1.5 times speedup running on a dual core ARM  and up to a 3.5 speedup on a quadcore (8 thread) i7.
+It uses Glib's GThreadPool and will therefor spawn threads when needed, and clean them up again when unused.
+
+To enable this option pass `-threads 0` option, this will autodetect the number number of hw-threads. Pass `-threads 4`
+to force it to use 4 threads. Setting the number to 1, disables it.
+
+
 ## Themes
 
+**Rofi** color theme can be specified in a lot of detail, using transparency to get the desired results. However this is
+not always the easiest to write down and testing it can be a hassle. To solve this we added a webgui for writing (and
+live previewing) themes and a theme repository.
+
+To help with this, you can now take screenshots of **rofi** from within **rofi** with a simple keybinding.
+
+*Add screenshot*
+ 
 ### Theme repository
 
+This has been requested several times and started somewhat on the website. This however got outdated quickly and neither
+the themes or the screenshots are correct anymore. To ease this the new repository allows themes to be easily added: you
+can export your current configuration directly using **rofi --dump-xresources-theme**, place it in the theme directory
+of the repository and the update script will automatically generate screenshots and update the page.
+
+The repository can be found [here](https://github.com/DaveDavenport/rofi-themes/)
+
+*add screenshot*
+
 ### Themenator
 
-### Dump themes
-
-To be removed:
-0.15.12 (unreleased):
-    New features:
-        - Initial `-dump` command for dmenu mode. (#216)
-        - Threading support.
-            - Parallel checking for ASCII.
-            - Parallel string matching.
-            - Autodetect number of HW-threads.
-            - Disabled by default.
-        - Highlight multiple selected rows (#287,#293)
-        - Dmenu can read from file instead of stdin.
-        - Regex matching (#113)
-        - Take Screenshot of rofi using keybinding.
-        - Hotkey for sorting: (#298)
-		- Option to set scrollbar width.
-    Improvements:
-		- Fix return code of multi-select.
-        - Update manpage (#289, #291)
-        - Improve speed of reading stdin in dmenu mode.
-        - Correctly handle modifier keys now. Should now support most weird keyboard layouts and switching between them.
-        (#268, #265, #286)
-        - Correctly set locale, fixing issues with entering special characters. (#282)
-        - DRun mode support `NoDisplay` setting (#283)
-        - Pango markup is matched when filtering. (#273)
-    Bug fixes:
-        - Improve error message (#290)
-        - Correctly switch to next entry on multi-select when list is filtered (#292)
-        - Switch __FUNCTION__ for __func__. (#288)
-        - Fix segfault on empty list and moving through it. (#256,#275)
-        - Fix one off of colors (#269)
-        - Drun fix uninitialized memory (#285)
+The second tool is a website allowing you to easily create themes and preview all changes life, the [themenator]()
+Big thanks goes to `SardemFF7` who got tired of me complaining, took the very rough prototype and turned it into
+something beautiful. 
+
+Hopefully people will make beautiful themes and submit them to the [theme
+repository](https://github.com/DaveDavenport/rofi-themes/).
+
+
+## Full ChangeLog
+
+### New features:
+- Initial `-dump` command for dmenu mode. (#216)
+- Threading support.
+    - Parallel checking for ASCII.
+    - Parallel string matching.
+    - Autodetect number of HW-threads.
+    - Disabled by default.
+- Highlight multiple selected rows (#287,#293)
+- Dmenu can read from file instead of stdin.
+- Regex matching (#113)
+- Take Screenshot of rofi using keybinding.
+- Hotkey for sorting: (#298)
+- Option to set scrollbar width.
+
+### Improvements:
+
+- Fix return code of multi-select.
+- Update manpage (#289, #291)
+- Improve speed of reading stdin in dmenu mode.
+- Correctly handle modifier keys now. Should now support most weird keyboard layouts and switching between them.
+(#268, #265, #286)
+- Correctly set locale, fixing issues with entering special characters. (#282)
+- DRun mode support `NoDisplay` setting (#283)
+- Pango markup is matched when filtering. (#273)
+
+### Bug fixes:
+
+- Improve error message (#290)
+- Correctly switch to next entry on multi-select when list is filtered (#292)
+- Switch __FUNCTION__ for __func__. (#288)
+- Fix segfault on empty list and moving through it. (#256,#275)
+- Fix one off of colors (#269)
+- Drun fix uninitialized memory (#285)