Updated Utilities (markdown)

[etc/awesome.git] / Utilities.md

diff --git a/Utilities.md b/Utilities.md
index a5c29ac2522f0278bf0e5280d88ecbb3c621f67b..3ab9245721b74940ab3a67a1471c258a342ce21e 100644 (file)
--- a/Utilities.md
+++ b/Utilities.md
@@ -43,6 +43,64 @@ they all take one argument, which is the text to markup, except `fg.color` and `
     markup.fg.color(text, color)
     markup.bg.color(text, color)
 
     markup.fg.color(text, color)
     markup.bg.color(text, color)
 

+dynamic tagging
+---------------
+
+That is:
+
+- create a new tag;
+- rename current tag;
+- delete current tag.
+
+If you delete a tag, any rule set on it shall be broken, so be careful.
+
+Use it with key bindings like these:
+
+    awful.key({ modkey, "Shift" }, "n", function () lain.util.create_tag(mypromptbox) end),
+    awful.key({ modkey, "Shift" }, "r", function () lain.util.rename_tag(mypromptbox) end),
+    awful.key({ modkey, "Shift" }, "d", function () lain.util.delete_tag() end),
+
+useless\_gaps\_resize
+---------------------
+
+Changes `beautiful.useless_gaps_width` on the fly.
+
+The function takes an integer argument, being the amount of pixel to add/remove to gaps.
+
+You could use it with these keybindings:
+
+    -- On the fly useless gaps change
+    awful.key({ altkey, "Control" }, "+", function () lain.util.useless_gaps_resize(1) end),
+    awful.key({ altkey, "Control" }, "-", function () lain.util.useless_gaps_resize(-1) end),
+
+where `altkey=Mod1`, or you could use it like this:
+
+    mywidget:buttons(awful.util.table.join (
+          awful.button({}, 4, function() lain.util.useless_gaps_resize(-1) end),
+          awful.button({}, 5, function() lain.util.useless_gaps_resize(1) end)
+          end)
+    ))
+
+so when hovering the mouse over `mywidget`, you can adjust useless gaps size by scrolling with the mouse wheel.
+
+tag\_view\_nonempty
+-------------------
+
+This function lets you jump to the next/previous non-empty tag.
+It takes two arguments:
+
+* `direction`: `1` for next non-empty tag, `-1` for previous.
+* `sc`: Screen which the taglist is in. Default is `mouse.screen` or `1`. This
+  argument is optional.
+
+You can use it with key bindings like these:
+
+    -- Non-empty tag browsing
+    awful.key({ altkey }, "Left", function () lain.util.tag_view_nonempty(-1) end),
+    awful.key({ altkey }, "Right", function () lain.util.tag_view_nonempty(1) end),
+
+where `altkey = "Mod1"`.
+

 menu\_clients\_current\_tags
 ----------------------------
 
 menu\_clients\_current\_tags
 ----------------------------
 


@@ -70,8 +128,7 @@ the currently used layout. Use it with a client keybinding like this:
                ...
        )
 
                ...
        )
 

-If you want to "de-magnify" it, just reset the clients floating state to
-`false` (hit `Mod4`+`CTRL`+`Space`, for example).
+If you want to "de-magnify" it, just retype the keybinding.

 
 niceborder\_{focus, unfocus}
 ----------------------------
 
 niceborder\_{focus, unfocus}
 ----------------------------


@@ -98,56 +155,4 @@ This requires to define additional colors in your `theme.lua`. For example:
        theme.border_normal_highprio = "#A03333"
 
        theme.border_focus_lowprio   = "#3333FF"
        theme.border_normal_highprio = "#A03333"
 
        theme.border_focus_lowprio   = "#3333FF"

-       theme.border_normal_lowprio  = "#333366"
-
-tag\_view\_nonempty
--------------------
-
-This function lets you jump to the next/previous non-empty tag.
-It takes two arguments:
-
-* `direction`: `1` for next non-empty tag, `-1` for previous.
-* `sc`: Screen which the taglist is in. Default is `mouse.screen` or `1`. This
-  argument is optional.
-
-You can use it with key bindings like these:
-
-    -- Non-empty tag browsing
-    awful.key({ altkey }, "Left", function () lain.util.tag_view_nonempty(-1) end),
-    awful.key({ altkey }, "Right", function () lain.util.tag_view_nonempty(1) end),
-
-where `altkey = "Mod1"`.
-
-prompt\_rename\_tag
--------------------
-
-This function enables you to dynamically rename the current tag you have focused.
-
-You can use it with a key binding like this:
-
-    awful.key({ modkey, "Shift" }, "r", function () lain.util.prompt_rename_tag(mypromptbox) end)
-
-Credits goes to [minism](https://bbs.archlinux.org/viewtopic.php?pid=1315135#p1315135).
-
-useless\_gaps\_resize
----------------------
-
-Changes `beautiful.useless_gaps_width` on the fly.
-
-The function takes an integer argument, being the amount of pixel to add/remove to gaps.
-
-You could use it with these keybindings:
-
-    -- On the fly useless gaps change
-    awful.key({ altkey, "Control" }, "+", function () lain.util.useless_gaps_resize(1) end),
-    awful.key({ altkey, "Control" }, "-", function () lain.util.useless_gaps_resize(-1) end),
-
-where `altkey=Mod1`, or you could use it like this:
-
-    mywidget:buttons(awful.util.table.join (
-          awful.button({}, 4, function() lain.util.useless_gaps_resize(-1) end),
-          awful.button({}, 5, function() lain.util.useless_gaps_resize(1) end)
-          end)
-    ))
-
-so when hovering the mouse over `mywidget`, you can adjust useless gaps size by scrolling with the mouse wheel.
\ No newline at end of file
+       theme.border_normal_lowprio  = "#333366"
\ No newline at end of file