Awesome 3.4 to git master

---

  This article is not ready. Please share your own information on 3.4 to git master migration

---

This page describes what changes has Awesome undergone in its master branch. You should use it as a guidline for what to change in your widgets and configuration files in order to migrate to the git master version.

Note that sooner or later these changes will make it to the release and you'll need to adjust to them anyway.

Contents 1 "widget" library replacement 2 Textbox text assignment 3 Signals 4 awful.menu 4.1 menu_keys

"widget" library replacement

There is no longer a thing like widget in the API, so different widgets which were provided by its type parameter can be found in different places.

One of them is a new module wibox. Please note that wibox is no longer a part of the standart API, so you need to require("wibox") it.

• textbox - migrated to wibox.widget.textbox()

• imagebox - migrated to wibox.widget.imagebox()

• systray - migrated to wibox.widget.systray()

Textbox text assignment

You should no longer simply assign the text to the text property of the textbox widget. Instead you should use the following functions:

• set_markup(box, text) - set the text to the box considering the pango markup

• set_text(box, text) - set the text to the box ignoring the pango markup

Signals

You should replace all calls of the add_signal function with the connect_signal functions. Respectively remove_signal becomes disconnect_signal.

awful.menu

awful.menu module has undergone a lot of changes. One of them is the modified method of setting the size of the entries. You no longer set it as:

  mymenu = awful.menu({ items = { ..... },
                        width = 300, height = 30 })

but it is rather like:

  mymenu = awful.menu({ items = { ...... },
                        theme = { width = 300, height = 30 } })

menu_keys

A new key enter has been added to awful.menu_keys. So if you redefine the default menu_keys in your rc.lua, you will need to update it to include the new entry. Something like:

   awful.menu.menu_keys = { up    = { "k", "Up" },
                            down  = { "j", "Down" },
                            exec  = { "l", "Return", "Right" },
                            -- the new item
                            enter = { "Right" },
                            --
                            back  = { "h", "Left" },
                            close = { "q", "Escape" },
                          }