Browse Source

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.
master
Laslo Hunhold 7 years ago
committed by Aaron Marcher
parent
commit
958c34052a
No known key found for this signature in database GPG Key ID: 74B048E5C2474F9A
2 changed files with 42 additions and 40 deletions
  1. +36
    -32
      slstatus.1
  2. +6
    -8
      slstatus.c

+ 36
- 32
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.

+ 6
- 8
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");


Loading…
Cancel
Save