Package: suckless-tools Version: 38-1 Severity: important Tags: patch What is the most important fact a user would need to know about a screen locker? How to unlock the screen? Disagree?
Does he get to know that in the present manpage? No, no, and NO!! Therefore I set the severity to "important", but I do also suggest a suitable patch of slock(1). Also the pages ssid(1), swarp(1), and wmname(1) are improved for better coverage. Do not add any attribution to me in any reworked manual page, should you decide to be inspired by this bug report. Regards, Mats Erik Andersson, DM
--- suckless-tools-38/debian/manpages/slock.1.orig +++ suckless-tools-38/debian/manpages/slock.1 @@ -5,14 +5,23 @@ .SH SYNOPSIS .B slock +.RB [ \-v ] .SH DESCRIPTION .B slock -is a simple screen locker utility for X, +is a simple screen locker utility for X. +The screen will be kept in an inert state until +the user types his password. In doing so there +is no visual indication that anything is going on, +except possibly a slight glow from the background. .SH OPTIONS .B slock -has no options. +prints its version when fed with \fB\-v\fR. + +.SH ENVIRONMENT +.B slock +uses DISPLAY to determine which display to act on. .SH SEE ALSO .B Homepage @@ -21,4 +30,5 @@ .SH AUTHOR slock was written by Anselm R. Garbe <\figarb...@gmail.com\fR>. .PP -This manual page was written by Daniel Baumann <\fidan...@debian.org\fR>, for the Debian project (but may be used by others). +This manual page was written by Daniel Baumann <\fidan...@debian.org\fR>, +for the Debian project (but may be used by others). --- suckless-tools-38/debian/manpages/ssid.1.orig +++ suckless-tools-38/debian/manpages/ssid.1 @@ -5,14 +5,25 @@ .SH SYNOPSIS .B ssid +.RB [ -v ] +.IR cmd " [ " args " ]" .SH DESCRIPTION .B ssid is an extremly simple setsid replacement. +It executes any given command after first +assuming the present session identity, +and possibly after forking to get a correct +process group. .SH OPTIONS .B ssid -has no options. +only prints its version when fed with \fB\-v\fR. + +.SH NOTES +Like with all forking software, the shell interpreter +might misplace a line feed when displaying output +from the invoked command. This is a timing artefact. .SH SEE ALSO .B Homepage @@ -21,4 +32,5 @@ .SH AUTHOR ssid was written by Anselm R. Garbe <\figarb...@gmail.com\fR>. .PP -This manual page was written by Daniel Baumann <\fidan...@debian.org\fR>, for the Debian project (but may be used by others). +This manual page was written by Daniel Baumann <\fidan...@debian.org\fR>, +for the Debian project (but may be used by others). --- suckless-tools-38/debian/manpages/swarp.1.orig +++ suckless-tools-38/debian/manpages/swarp.1 @@ -5,21 +5,30 @@ .SH SYNOPSIS .B swarp +.RB [ \-v "] " +.I xpos ypos .SH DESCRIPTION .B swarp is a generic pointer warping utility for X. +The pointer is moved to the indicated absolute position, +giving focus to the root window. .SH OPTIONS .B swarp -has no options. +prints its version when fed with \fB\-v\fR. + +.SH ENVIRONMENT +.B swarp +uses DISPLAY to determine which display to act on. .SH SEE ALSO -.BR Homepage .B Homepage <\fIhttp://www.suckless.org/\fR> .SH AUTHOR -swarp was written by Anselm R. Garbe <\figarb...@gmail.com\fR> and Sander van Dijk <\fia.h.vand...@gmail.com\fR>. +swarp was written by Anselm R. Garbe <\figarb...@gmail.com\fR> and +Sander van Dijk <\fia.h.vand...@gmail.com\fR>. .PP -This manual page was written by Daniel Baumann <\fidan...@debian.org\fR>, for the Debian project (but may be used by others). +This manual page was written by Daniel Baumann <\fidan...@debian.org\fR>, +for the Debian project (but may be used by others). --- suckless-tools-38/debian/manpages/wmname.1.orig +++ suckless-tools-38/debian/manpages/wmname.1 @@ -4,18 +4,26 @@ wmname \- prints/sets window manager name .SH SYNOPSIS -.B wmname [\fIWM_NAME\fR] +.B wmname +.RI "[\-v] [ " WM_NAME " ]" .SH DESCRIPTION .B wmname -prints/sets the window manager name property of the root window similiar to how hostname(1) behaves. -. +prints or sets the window manager name property of the root window, +somewhat similiar to how \fBhostname\fR(1) acts for network identities. +Without argument the EWMH name is recovered and printed. +.PP .B wmname -is a nice utility to fix problems with JDK versions and other broken programs assuming a reparenting window manager for instance. +is a nice utility to fix problems with JDK versions and other broken +programs, which are assuming a reparenting window manager. .SH OPTIONS .B wmname -has no options. +prints its version when fed with \fB\-v\fR. + +.SH ENVIRONMENT +.B wmname +uses DISPLAY to determine which display to act on. .SH SEE ALSO .B Homepage
signature.asc
Description: Digital signature
