--- awesome screen API
-- @author Julien Danjou <julien@danjou.info>
-- @copyright 2008-2009 Julien Danjou
module("screen")

--- Screen is a table where indexes are screen number. You can use screen[1]
-- to get access to the first screen, etc. Alternatively, if RANDR information
-- is available, you can use output names for finding screen objects.
-- Each screen has a set of properties.
-- @field geometry The screen coordinates. Immutable.
-- @field workarea The screen workarea.
-- @field index The screen number.
-- @field outputs If RANDR information is available, a list of outputs for this
-- screen and their size in mm.
-- @class table
-- @name screen

--- Get the number of screen.
-- @return The screen count, at least 1.
-- @name count
-- @class function

--- Add a signal to a screen.
-- @param name A signal name.
-- @param func A function to call when the signal is emitted.
-- @name connect_signal
-- @class function

--- Remove a signal to a screen.
-- @param name A signal name.
-- @param func A function to remove
-- @name disconnect_signal
-- @class function

--- Emit a signal to a screen.
-- @param name A signal name.
-- @param ... Various arguments, optional.
-- @name emit_signal
-- @class function