### New client properties │ │ │
* client.focusable is now read/write (compared to read only in the previous
│ │ │ versions)
│ │ │ * client.valid tells if the client still really exist or if the object is waiting to
│ │ │ be deleted
│ │ │ * client.floating is now a client property
│ │ │ * client.x / client.y / client.width / client.height are
│ │ │ - client.geometry aliases
│ │ │ + client.geometry aliases
│ │ │ * client.first_tag is a convenience wrapper for c:tags()[1]
│ │ │
#### Client signaling │ │ │
There is now an awesome.unix_signal signal table with all platform specific
│ │ │ signals and their indices. There is also an awesome.kill() function to send
│ │ │ signals to clients. This can be used, among other thing, to pause and resume
│ │ │ clients.
│ │ │
### New client rules (awful.rules) │ │ │ @@ -994,15 +994,15 @@ │ │ │
* awful.prompt.run │ │ │
### Timers are no longer part of the C API │ │ │
Use gears.timer. │ │ │
### Deprecated functions │ │ │
The previous Awesome API mixed different conventions. There was a major │ │ │ undertaking in 4.0 to make the API coherent and well documented. │ │ │
Those functions have been renamed or converted to methods: │ │ │ -
* awful.client.jumpto │ │ │ +
* awful.client.jumpto
│ │ │ * awful.client.visible
│ │ │ * awful.client.tiled
│ │ │ * awful.client.moveresize
│ │ │ * awful.client.movetotag
│ │ │ * awful.client.toggletag
│ │ │ * awful.client.movetoscreen
│ │ │ * awful.client.mark
│ │ │ @@ -1013,24 +1013,24 @@
│ │ │ * awful.client.isfixed
│ │ │ * awful.client.floating.get
│ │ │ * awful.client.floating.toggle
│ │ │ * awful.client.dockable.get
│ │ │ * awful.client.dockable.set
│ │ │ * awful.client.property.get
│ │ │ * awful.client.property.set
│ │ │ -* awful.client.get_transient_for_matching
│ │ │ -* awful.client.is_transient_for
│ │ │ +* awful.client.get_transient_for_matching
│ │ │ +* awful.client.is_transient_for
│ │ │ * awful.mouse.client_under_pointer
│ │ │ * awful.mouse.client.dragtotag.border
│ │ │ * awful.mouse.client.corner
│ │ │ * awful.screen.getdistance_sq
│ │ │ -* awful.screen.padding
│ │ │ +* awful.screen.padding
│ │ │ * awful.tag.move
│ │ │ * awful.tag.swap
│ │ │ -* awful.tag.delete
│ │ │ +* awful.tag.delete
│ │ │ * awful.tag.gettags
│ │ │ * awful.tag.setscreen
│ │ │ * awful.tag.getscreen
│ │ │ * awful.tag.selectedlist
│ │ │ * awful.tag.selected
│ │ │ * awful.tag.setmwfact
│ │ │ * awful.tag.getmwfact
│ │ ├── ./usr/share/doc/awesome/doc/images/AUTOGEN_awful_widget_layoutlist_popup.svg
│ │ │ @@ -15,120 +15,120 @@
│ │ │
│ │ │
**pretend** (*boolean*): │ │ │
Do not apply the new geometry. This is useful if only the return values is │ │ │ necessary. │ │ │
**honor_workarea** (*boolean*): │ │ │
Take workarea into account when placing the drawable (default: false) │ │ │
**honor_padding** (*boolean*): │ │ │ -
Take the screen padding into account (see screen.padding) │ │ │ +
Take the screen padding into account (see screen.padding) │ │ │
**tag** (*tag*): │ │ │
Use a tag geometry │ │ │
**margins** (*number* or *table*): │ │ │
A table with left, right, top, bottom keys or a number │ │ │
**parent** (client, wibox, mouse or screen): │ │ │
A parent drawable to use a base geometry │ │ │
**bounding_rect** (table): │ │ ├── ./usr/share/doc/awesome/doc/libraries/awful.spawn.html │ │ │ @@ -189,15 +189,15 @@ │ │ │ any other unix shell language syntax │ │ │ * When shell variables are defined as part of the command │ │ │ * When the command is a shell alias │ │ │
Note that a shell is **not** a terminal emulator. A terminal emulator is
│ │ │ something like XTerm, Gnome-terminal or Konsole. A shell is something like
│ │ │ bash, zsh, busybox sh or Debian ash.
│ │ │
If you wish to open a process in a terminal window, check that your terminal │ │ │ - emulator supports the common -e option. If it does, then something like │ │ │ + emulator supports the common -e option. If it does, then something like │ │ │ this should work: │ │ │
awful.spawn(terminal.." -e my_command") │ │ │
Note that some terminals, such as rxvt-unicode (urxvt) support full commands │ │ │ using quotes, while other terminal emulators require to use quoting. │ │ │
**Understanding clients versus PID versus commands versus class**: │ │ │
A *process* has a *PID* (process identifier). It can have 0, 1 or many │ │ │ *window*s.