dispatchers: add documentation for fullscreenstate (#892)

* dispatchers: add documentation for fullscreenstate

This is a WIP and needs feedback to clarify a few things. Specifically whether fullscreen is planned for deprecation and the functionality of state 3 "maximize and fullscreen."

* add details for maximize and fullscreen

* remove incorrect deprecation statement

pages/Configuring/Dispatchers.md

@@ -41,7 +41,7 @@ layout pages (See the sidebar).
 | setfloating | sets the current window's floating state to true | left empty / `active` for current, or `window` for a specific window |
 | settiled | sets the current window's floating state to false | left empty / `active` for current, or `window` for a specific window |
 | fullscreen | toggles the focused window's fullscreen mode | 0 - fullscreen (takes your entire screen), 1 - maximize (keeps gaps and bar(s)) |
-| fullscreenstate | sets the focused window's fullscreen mode and the one sent to the client | `internal client`, where internal and client can be `-1` - current, `0` - none, `1` - maximize, `2` - fullscreen, `3` - maximize and fullscreen |
+| fullscreenstate | sets the focused window's fullscreen mode and the one sent to the client | `internal client`, where internal (the hyprland window) and client (the application) can be `-1` - current, `0` - none, `1` - maximize, `2` - fullscreen, `3` - maximize and fullscreen. |
 | dpms | sets all monitors' DPMS status. Do not use with a keybind directly. | `on`, `off`, or `toggle`. For specific monitor add monitor name after a space |
 | pin | pins a window (i.e. show it on all workspaces) _note: floating only_ | left empty / `active` for current, or `window` for a specific window |
 | movefocus | moves the focus in a direction | direction |
@@ -240,3 +240,29 @@ address:0x13371337 nomaxsize 0
 address:0x13371337 opaque toggle
 address:0x13371337 immediate unset
 ```
+
+### Fullscreenstate
+
+`fullscreenstate internal client`
+
+The `fullscreenstate` dispatcher decouples the state that Hyprland maintains for a window from the fullscreen state that is communicated to the client.  
+
+`internal` is a reference to the state maintained by Hyprland.
+
+`client` is a reference to the state that the application receives.
+
+| Value | State | Description |
+| --- | --- | --- |
+| -1 | Current | Maintains the current fullscreen state. |
+| 0 | None | Window allocates the space defined by the current layout. |
+| 1 | Maximize | Window takes up the entire working space, keeping the margins. |
+| 2 | Fullscreen | Window takes up the entire screen. |
+| 3 | Maximize and Fullscreen | The state of a fullscreened maximized window. Works the same as fullscreen. |
+
+For example:
+
+`fullscreenstate 2 0` Fullscreens the application and keeps the client in non-fullscreen mode.  
+
+This can be used to prevent Chromium-based browsers from going into presentation mode when they detect they have been fullscreened.  
+
+`fullscreenstate 0 2` Keeps the window non-fullscreen, but the client goes into fullscreen mode within the window.