some more simplifications of intro comment in dwm.h, this should suffice for comments in dwm

keyboard
Anselm R. Garbe 18 years ago
parent cbfc69e310
commit a1e9362d38
  1. 34
      dwm.h

34
dwm.h

@ -5,30 +5,24 @@
* dynamic window manager is designed like any other X client as well. It is * dynamic window manager is designed like any other X client as well. It is
* driven through handling X events. In contrast to other X clients, a window * driven through handling X events. In contrast to other X clients, a window
* manager like dwm selects for SubstructureRedirectMask on the root window, to * manager like dwm selects for SubstructureRedirectMask on the root window, to
* receive events about child window appearance and disappearance. Only one X * receive events about window appearance and disappearance. Only one X
* connection at a time is allowed to select for this event mask. * connection at a time is allowed to select for this event mask.
* *
* Calls to fetch an X event from the event queue of the X connection are * Calls to fetch an X event from the X event queue connection are blocking.
* blocking. Due the fact, that dwm reads status text from standard input, a * Due reading status text from standard input, a select-driven main loop has
* select-driven main loop has been implemented which selects for reads on the * been implemented which selects for reads on the X connection and
* X connection and STDIN_FILENO to handle all data smoothly and without * STDIN_FILENO to handle all data smoothly and without busy-loop quirks. The
* busy-loop quirks. The event handlers of dwm are organized in an array which * event handlers of dwm are organized in an array which is accessed whenever a
* is accessed whenever a new event has been fetched. This allows event * new event has been fetched. This allows event dispatching in O(1) time.
* dispatching in O(1) time.
* *
* Each child window of the root window is called a client in window manager * Each child of the root window is called a client, except windows which have
* terminology, except windows which have set the override_redirect flag. * set the override_redirect flag. Clients are organized in a global
* Clients are organized in a global doubly-linked client list, the focus * doubly-linked client list, the focus history is remembered through a global
* history is remembered through a global stack list. Each client contains an * stack list. Each client contains an array of Bools of the same size as the
* array of Bools of the same size as the global tags array to indicate the * global tags array to indicate the tags of a client. For each client dwm
* tags of a client. There are no other data structures to organize the clients * creates a small title window which is resized whenever the WM_NAME or
* in tag lists. All clients which have at least one tag enabled of the current * _NET_WM_NAME properties are updated or the client is resized.
* tags viewed, will be visible on the screen, all other clients are banned to
* the x-location x + 2 * screen width. This avoids having additional layers
* of workspace handling.
* *
* For each client dwm creates a small title window which is resized whenever
* the WM_NAME or _NET_WM_NAME properties are updated or the client is resized.
* Keys and tagging rules are organized as arrays and defined in the config.h * Keys and tagging rules are organized as arrays and defined in the config.h
* file. These arrays are kept static in event.o and tag.o respectively, * file. These arrays are kept static in event.o and tag.o respectively,
* because no other part of dwm needs access to them. The current mode is * because no other part of dwm needs access to them. The current mode is

Loading…
Cancel
Save