Bladeren bron

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.
Laslo Hunhold 8 jaren geleden
bovenliggende
commit
958c34052a
2 gewijzigde bestanden met toevoegingen van 42 en 40 verwijderingen
  1. 36 32
      slstatus.1
  2. 6 8
      slstatus.c

+ 36 - 32
slstatus.1

@@ -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

@@ -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");