suckless
/
slstatus
mirror of git://git.suckless.org/slstatus
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Convert slstatus.1 to mandoc, simplify it and remove -h 

We also change the semantics of -v to only return the version
information.
There is now no need for usage() to exit with anything other than 1.
This commit is contained in:
Laslo Hunhold 2017-08-10 21:36:29 +02:00 committed by Aaron Marcher
parent 8dad4910bf
commit 958c34052a
No known key found for this signature in database
GPG Key ID: 74B048E5C2474F9A
2 changed files with 42 additions and 40 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

68
slstatus.1
View File

@ -1,34 +1,38 @@
.TH SLSTATUS 1 slstatus
.SH NAME
slstatus \- suckless status
.SH SYNOPSIS
.B slstatus
.RB [ \-dhov ]
.SH DESCRIPTION
slstatus is a suckless and lightweight status monitor for window managers that use WM_NAME as statusbar (e.g. DWM) or any other status bars as long as they support reading from stdin. It is written in pure C without any extern programs being executed and only reads from files most of the time. slstatus is meant to be a better alternative to Bash scripts (inefficient) and Conky (bloated and written in C++).
.SH OPTIONS
.TP
.B \-d
run slstatus as daemon in background
.TP
.B \-h
display help
.TP
.B \-o
output continuously to console instead of WM_NAME
.TP
.B \-n
output to console once and exit
.TP
.B \-v
display version and copyright details
.SH CUSTOMIZATION
.B slstatus
.Dd 2017-08-10
.Dt SLSTATUS 1
.Os suckless.org
.Sh NAME
.Nm slstatus
.Nd suckless status monitor
.Sh SYNOPSIS
.Nm
.Oo
.Op Fl v
|
.Oo
.Op Fl d
.Op Fl o | n
.Oc
.Oc
.Sh DESCRIPTION
.Nm
is a suckless status monitor for window managers that use WM_NAME (e.g. dwm) or
stdin to fill the status bar.
By default,
.Nm
outputs to WM_NAME.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl d
Daemonize.
.It Fl n
Write to stdout once and exit.
.It Fl o
Write to stdout continuously.
.It Fl v
Write version information to stdout and exit.
.El
.Sh CUSTOMIZATION
.Nm
can be customized by creating a custom config.h and (re)compiling the source
code. This keeps it fast, secure and simple.
.SH AUTHORS
See the LICENSE file for the authors.
.SH LICENSE
See the LICENSE file for the terms of redistribution.
.SH BUGS
See the FIXME's in the code.

14
slstatus.c
View File

@ -70,7 +70,7 @@ static const char *vol_perc(const char *card);
static const char *wifi_perc(const char *iface);
static const char *wifi_essid(const char *iface);
static void sighandler(const int signo);
static void usage(const int eval);
static void usage(void);
char *argv0;
static unsigned short int delay = 0;
@ -838,10 +838,10 @@ sighandler(const int signo)
}
static void
usage(const int eval)
usage(void)
{
fprintf(stderr, "usage: %s [-d] [-o] [-n] [-v] [-h]\n", argv0);
exit(eval);
exit(1);
}
int
@ -865,16 +865,14 @@ main(int argc, char *argv[])
nflag = 1;
break;
case 'v':
printf("slstatus (C) 2016-2017 slstatus engineers\n");
printf("slstatus-"VERSION"\n");
return 0;
case 'h':
usage(0);
default:
usage(1);
usage();
} ARGEND
if ((dflag && oflag) || (dflag && nflag) || (oflag && nflag)) {
usage(1);
usage();
}
if (dflag && daemon(1, 1) < 0) {
err(1, "daemon");