documentation update and disallow tag name change

Signed-off-by: Julien Danjou <julien@danjou.info>

client.c

@@ -1237,6 +1237,20 @@ luaA_client_newindex(lua_State *L)
 /** Client index.
  * \param L The Lua VM state.
  * \return The number of elements pushed on stack.
+ * \luastack
+ * \lfield name The client title.
+ * \lfield class The client class, 2 strings long.
+ * \lfield pid The client PID, if available.
+ * \lfield floating_placement The floating placement used for this client.
+ * \lfield screen Client screen number.
+ * \lfield hide Define if the client must be hidden, i.e. never mapped.
+ * \lfield icon_path Path to the icon used to identify.
+ * \lfield floating True always floating.
+ * \lfield honorsizehints Honor size hints, i.e. respect size ratio.
+ * \lfield border_width The client border width.
+ * \lfield border_color The client border color.
+ * \lfield coords The client coordinates.
+ * \lfield titlebar The client titlebar.
  */
 static int
 luaA_client_index(lua_State *L)

mouse.c

@@ -1063,6 +1063,9 @@ luaA_mouse_new(lua_State *L)
 /** Index for mouse.
  * \param L The Lua VM state.
  * \return The number of elements pushed on stack.
+ * \luastack
+ * \lfield coords Mouse coordinates.
+ * \lfield screen Mouse screen number.
  */
 static int
 luaA_mouse_index(lua_State *L)

statusbar.c

@@ -499,6 +499,11 @@ luaA_statusbar_widget_get(lua_State *L)
 /** Statusbar index.
  * \param L The Lua VM state.
  * \return The number of elements pushed on stack.
+ * \luastack
+ * \lfield align The alignment.
+ * \lfield fg Foreground color.
+ * \lfield bg Background color.
+ * \lfield position The position.
  */
 static int
 luaA_statusbar_index(lua_State *L)

tag.c

@@ -343,6 +343,13 @@ luaA_tag_new(lua_State *L)
 /** Tag index.
  * \param L The Lua VM state.
  * \return The number of elements pushed on stack.
+ * \luastack
+ * \lfield name Tag name.
+ * \lfield layout Tag layout.
+ * \lfield selected True if the client is selected to be viewed.
+ * \lfield mwfact Master width factor.
+ * \lfield nmaster Number of master windows.
+ * \lfield ncol Number of column for slave windows.
  */
 static int
 luaA_tag_index(lua_State *L)
@@ -399,13 +406,6 @@ luaA_tag_newindex(lua_State *L)
 
     switch(a_tokenize(attr, len))
     {
-      case A_TK_NAME:
-        buf = luaL_checklstring(L, 3, &len);
-        p_delete(&(*tag)->name);
-        a_iso2utf8(&(*tag)->name, buf, len);
-        if((*tag)->screen != TAG_SCREEN_UNDEF)
-            widget_invalidate_cache((*tag)->screen, WIDGET_CACHE_TAGS);
-        return 0;
       case A_TK_LAYOUT:
         buf = luaL_checkstring(L, 3);
         l = name_func_lookup(buf, LayoutList);
@@ -448,7 +448,6 @@ luaA_tag_newindex(lua_State *L)
     return 0;
 }
 
-
 const struct luaL_reg awesome_tag_methods[] =
 {
     { "__call", luaA_tag_new },
@@ -466,4 +465,5 @@ const struct luaL_reg awesome_tag_meta[] =
     { "__tostring", luaA_tag_tostring },
     { NULL, NULL },
 };
+
 // vim: filetype=c:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=80

titlebar.c

@@ -518,6 +518,12 @@ luaA_titlebar_newindex(lua_State *L)
 /** Titlebar index.
  * \param L The Lua VM state.
  * \return The number of elements pushed on stack.
+ * \luastack
+ * \lfield align Alignment relative to the client.
+ * \lfield border_width Border width.
+ * \lfield border_color Border color.
+ * \lfield fg Foreground color.
+ * \lfield bg Background color.
  */
 static int
 luaA_titlebar_index(lua_State *L)