Compare commits

..

4 Commits

Author SHA1 Message Date
Leonardo Hernández Hernández
e45a0bc355
document status output 2024-09-27 22:27:53 -06:00
Leonardo Hernández Hernández
452c13c403
Use a subsection for mouse commands
and avoid splitting the last line
2024-09-27 22:27:53 -06:00
Leonardo Hernández Hernández
4f6945a7d5
document mouse button actions
[sevz: commit message is mine. The content was written by scottro11 and shared
in https://codeberg.org/dwl/dwl/issues/697]

Closes: https://codeberg.org/dwl/dwl/issues/697
2024-09-27 22:27:32 -06:00
Leonardo Hernández Hernández
35f171d5b2
drop CAVEATS section from the man page
Since 71f11e6cf63289d51f152469a0da81a85fe2608c it is not longer the case
2024-09-27 20:26:52 -06:00
4 changed files with 55 additions and 57 deletions

View File

@ -61,7 +61,6 @@ dist: clean
install: dwl
mkdir -p $(DESTDIR)$(PREFIX)/bin
rm -f $(DESTDIR)$(PREFIX)/bin/dwl
cp -f dwl $(DESTDIR)$(PREFIX)/bin
chmod 755 $(DESTDIR)$(PREFIX)/bin/dwl
mkdir -p $(DESTDIR)$(MANDIR)/man1

View File

@ -102,7 +102,7 @@ automatically, you will need to configure it prior to launching `dwl`, e.g.:
Information about selected layouts, current window title, app-id, and
selected/occupied/urgent tags is written to the stdin of the `-s` command (see
the `STATUS INFORMATION` section in `_dwl_(1)`). This information can be used to
the `STATUS INFORMATION` section in `dwl(1)`). This information can be used to
populate an external status bar with a script that parses the
information. Failing to read this information will cause dwl to block, so if you
do want to run a startup command that does not consume the status information,

103
dwl.1
View File

@ -103,83 +103,84 @@ These might differ depending on your keyboard layout.
.Ss Mouse commands
.Bl -tag -width 20n -offset indent -compact
.It Mod-Button1
Move focused window while dragging.
Tiled windows will be toggled to the floating state.
Move focused window while dragging. Tiled windows will be toggled to the floating state.
.It Mod-Button2
Toggle focused window between floating and tiled state.
Toggles focused window between floating and tiled state.
.It Mod-Button3
.El
Resize focused window while dragging. Tiled windows will be toggled to the floating state.
.Sh STATUS INFORMATION
.Nm
writes its status information to standard output.
If the
.Fl s
option is given, the status information is written to the standard input of the
child process instead.
prints its status information to standard output. When the -s option is
given then the status information is printed to the standard input of the child
process.
.Pp
Said information has the following format:
.Bd -ragged -offset indent
.Ar <monitor>
.Ar <component>
.Ar <data>
.Aq Em monitor
.Aq Em component
.Aq Em data
.Ed
.Pp
.Bl -tag -width 11n -offset 0 -compact
.It Ar <monitor>
.It Aq Em monitor
is the name given to the output.
.It Ar <component>
.It Aq Em component
is one of (in order)
.Em title ,
.Em appid ,
.Em fullscreen ,
.Em floating ,
.Em selmon ,
.Em tags ,
.Em layout .
.It Ar <data>
changes depending on
.Ar <component> .
.Bl -tag -width 10n -compact
.Em title
.Em appid
.Em fullscreen
.Em floating
.Em selmon
.Em tags
.Em layout
\&.
.It Aq Em data
changes depending of
.Aq Em component
.Bl -tag -width fullscreen -compact
.It Em title
The title of the focused window on
.Ar <monitor>
.Aq Em monitor
or nothing if there is no focused window.
.It Em appid
The app_id of the focused window on
.Ar <monitor>
.Aq Em monitor
or nothing if there is no focused window.
.It Em fullscreen
Prints 1 if the focused window on
.Ar <monitor>
.Aq Em monitor
is in fullscreen state, otherwise prints 0. If there is no focused
window it prints nothing.
.It Em floating
Prints 1 if the focused window on
.Ar <monitor>
.Aq Em monitor
is in floating state, otherwise prints 0. If there is no focused
window it prints nothing.
.It Em selmon
Prints 1 if
.Ar <monitor>
.Aq Em monitor
is the selected monitor, otherwise prints 0.
.It Em tags
Prints four bitmasks in the following order:
.Bl -bullet -width 2n -compact
.It
Occupied tags of
.Ar <monitor> .
.Aq Em monitor
\&.
.It
Selected tags of
.Ar <monitor> .
.Aq Em monitor
\&.
.It
Tags of the focused window on
.Ar <monitor> .
.Aq Em monitor
\&.
.It
Tags where a window on
.Ar <monitor>
Tags where a where a window on
.Aq Em monitor
requested activation or has urgency hints.
.El
The bitmasks are 32-bit unsigned decimal integers.
The bitmasks are a 32-bit unsigned integer.
.It Em layout
Prints the symbol of the current layout.
.El
@ -187,24 +188,24 @@ Prints the symbol of the current layout.
.Ss Examples
When there is a selected window:
.Bd -literal -offset indent
HDMI\-A\-1 title \(ti/source/repos/dwl > man \-l dwl.1
HDMI\-A\-1 appid footclient
HDMI\-A\-1 fullscreen 0
HDMI\-A\-1 floating 0
HDMI\-A\-1 selmon 1
HDMI\-A\-1 tags 271 4 4 0
HDMI\-A\-1 layout [T]
HDMI-A-1 title ~/source/repos/dwl > man -l dwl.1
HDMI-A-1 appid footclient
HDMI-A-1 fullscreen 0
HDMI-A-1 floating 0
HDMI-A-1 selmon 1
HDMI-A-1 tags 271 4 4 0
HDMI-A-1 layout [T]
.Ed
.Pp
When there is no selected window:
.Bd -literal -offset indent
HDMI\-A\-1 title
HDMI\-A\-1 appid
HDMI\-A\-1 fullscreen
HDMI\-A\-1 floating
HDMI\-A\-1 selmon 1
HDMI\-A\-1 tags 271 512 0 0
HDMI\-A\-1 layout [T]
HDMI-A-1 title
HDMI-A-1 appid
HDMI-A-1 fullscreen
HDMI-A-1 floating
HDMI-A-1 selmon 1
HDMI-A-1 tags 271 512 0 0
HDMI-A-1 layout [T]
.Ed
.Sh ENVIRONMENT
These environment variables are used by
@ -248,9 +249,9 @@ Start
with s6 in the background:
.Dl dwl \-s \(aqs6\-svscan <&\-\(aq
.Sh SEE ALSO
.Xr dwm 1 ,
.Xr foot 1 ,
.Xr wmenu 1 ,
.Xr dwm 1 ,
.Xr xkeyboard-config 7
.Sh BUGS
All of them.

6
dwl.c
View File

@ -2082,7 +2082,6 @@ powermgrsetmode(struct wl_listener *listener, void *data)
wlr_output_commit_state(m->wlr_output, &state);
m->asleep = !event->mode;
updatemons(NULL, NULL);
}
void
@ -2437,8 +2436,7 @@ setup(void)
wlr_linux_dmabuf_v1_create_with_renderer(dpy, 5, drw));
}
if ((drm_fd = wlr_renderer_get_drm_fd(drw)) >= 0 && drw->features.timeline
&& backend->features.timeline)
if ((drm_fd = wlr_renderer_get_drm_fd(drw)) >= 0 && drw->features.timeline)
wlr_linux_drm_syncobj_manager_v1_create(dpy, 1, drm_fd);
/* Autocreates an allocator for us.
@ -2464,7 +2462,7 @@ setup(void)
wlr_viewporter_create(dpy);
wlr_single_pixel_buffer_manager_v1_create(dpy);
wlr_fractional_scale_manager_v1_create(dpy, 1);
wlr_presentation_create(dpy, backend, 2);
wlr_presentation_create(dpy, backend);
wlr_alpha_modifier_v1_create(dpy);
/* Initializes the interface used to implement urgency hints */