ubase

suckless linux base utils
git clone git://git.2f30.org/ubase
Log | Files | Refs | README | LICENSE

commit 7d47c075ccf3f0eaf0a8bdc77e7d65428be3ed59
parent 1392fce27a91b1df06e4c421af801f225ff67d23
Author: sin <sin@2f30.org>
Date:   Sat, 12 Apr 2014 13:38:43 +0100

Manpage overhaul

Diffstat:
Mchvt.1 | 10++++------
Mclear.1 | 5++---
Mdf.1 | 22++++++++--------------
Meject.1 | 13+++++--------
Mhalt.8 | 18++++++++----------
Mid.1 | 16++++++----------
Mlsmod.8 | 7+++----
Mlsusb.8 | 7+++----
Mmknod.1 | 39+++++++++++----------------------------
Mstat.1 | 16++++++----------
Mwho.1 | 25++++++++-----------------
11 files changed, 64 insertions(+), 114 deletions(-)

diff --git a/chvt.1 b/chvt.1 @@ -1,10 +1,8 @@ -.TH CHVT 1 ubase\-VERSION +.TH CHVT 1 ubase-VERSION .SH NAME -chvt \- change foreground virtual terminal +\fBchvt\fR - change foreground virtual terminal .SH SYNOPSIS -.B chvt -.I N +\fBchvt\fI N .SH DESCRIPTION -.B chvt -brings /dev/ttyN to the foreground. This has the +\fBchvt\fR brings /dev/ttyN to the foreground. This has the same effect as Ctrl-Alt-FN. diff --git a/clear.1 b/clear.1 @@ -1,4 +1,3 @@ -.TH CLEAR 1 ubase\-VERSION -.OS Linux +.TH CLEAR 1 ubase-VERSION .SH NAME -clear \- clear the screen +\fBclear\fR - clear the screen diff --git a/df.1 b/df.1 @@ -1,24 +1,18 @@ -.TH DF 1 ubase\-VERSION -.OS Linux +.TH DF 1 ubase-VERSION .SH NAME -df \- show file system usage +\fBdf\fR - show file system usage .SH SYNOPSIS -.B df -.RB [ \-ahsi ] +\fBdf\fR [\fB-ahsi\fR] .SH DESCRIPTION -df displays the amount of disk space available on a file system. +\fBdf\fR displays the amount of disk space available on a file system. If no arguments are given, df shows all the file systems using 512-byte blocks. .SH OPTIONS .TP -.BI \-a -Show all file systems including dummy ones. +\fB-a\fR Show all file systems including dummy ones. .TP -.BI \-h -Not implemented. +\fB-h\fR Not implemented. .TP -.BI \-s -Not implemented. +\fB-s\fR Not implemented. .TP -.BI \-i -Not implemented. +\fB-i\fR Not implemented. diff --git a/eject.1 b/eject.1 @@ -1,14 +1,11 @@ -.TH EJECT 1 ubase\-VERSION -.OS Linux +.TH EJECT 1 ubase-VERSION .SH NAME -eject \- eject removable media +\fBeject\fR - eject removable media .SH SYNOPSIS -.B eject -.RB [ \-t ] +\fBeject\fR [\fB-t\fR] .SH DESCRIPTION -eject allows the CD-ROM tray to be opened or closed under software +\fBeject\fR allows the CD-ROM tray to be opened or closed under software control. If no arguments are given, the CD-ROM tray is opened. .SH OPTIONS .TP -.BI \-t -If supported, close the CD-ROM tray. +\fB-t\fR If supported, close the CD-ROM tray. diff --git a/halt.8 b/halt.8 @@ -1,16 +1,14 @@ -.TH HALT 8 ubase\-VERSION -.OS Linux +.TH HALT 8 ubase-VERSION .SH NAME -halt \- Halt, power-off or reboot the machine +\fBhalt\fR - Halt, power-off or reboot the machine .SH SYNOPSIS -.B halt -.RB [ \-pr ] +\fBhalt\fR [\fB-pr\fR] .SH DESCRIPTION -halt can be used to halt, power-off or reboot the machine. +\fBhalt\fR can be used to power-off or reboot the machine. +This is a low-level tool and should not be used directly or data-loss +can happen if the filesystems are not properly unmounted first. .SH OPTIONS .TP -.BI \-p -power-off the machine. +\fB-p\fR power-off the machine. .TP -.BI \-r -reboot the machine. +\fB-r\fR reboot the machine. diff --git a/id.1 b/id.1 @@ -1,18 +1,14 @@ -.TH ID 1 ubase\-VERSION +.TH ID 1 ubase-VERSION .SH NAME -id \- print real and effective user and group IDs +\fBid\fR - print real and effective user and group IDs .SH SYNOPSIS -.B id -.RB [ -G ] -.RB [ user | uid ] +\fBid\fR [\fB-G\fR] \fR[\fIuser\fR|\fIuid\fR] .SH DESCRIPTION -Print user and group information of the calling process to standard output. +\fBid\fR prints user and group information of the calling process to standard output. If a login name or uid is specified, the user and group information of that user is displayed. .SH OPTIONS .TP -.B \-G -Display group information as whitespace separated numbers, in no particular -order. +\fB-G\fR Display group information as whitespace separated numbers, in no particular order. .SH SEE ALSO -.IR who(1) +who(1) diff --git a/lsmod.8 b/lsmod.8 @@ -1,7 +1,6 @@ -.TH lsmod 8 ubase\-VERSION -.OS Linux +.TH lsmod 8 ubase-VERSION .SH NAME -lsmod \- list loaded kernel modules +\fBlsmod\fR - list loaded kernel modules .SH DESCRIPTION -lsmod parses `/proc/modules' and shows the loadable kernel modules that are +\fBlsmod\fR parses `/proc/modules' and shows the loadable kernel modules that are currently loaded. diff --git a/lsusb.8 b/lsusb.8 @@ -1,7 +1,6 @@ -.TH LSUSB 8 ubase\-VERSION -.OS Linux +.TH LSUSB 8 ubase-VERSION .SH NAME -lsusb \- list USB devices +\fBlsusb\fR - list USB devices .SH DESCRIPTION -lsusb searches in `/sys/bus/usb/devices' for usb buses and connected devices and prints +\fBlsusb\fR searches in `/sys/bus/usb/devices' for usb buses and connected devices and prints them one by one. diff --git a/mknod.1 b/mknod.1 @@ -1,40 +1,23 @@ -.TH MKNOD 1 ubase\-VERSION +.TH MKNOD 1 ubase-VERSION .SH NAME -mknod \- create a special device file - +\fBmknod\fR - create a special device file .SH SYNOPSIS -.B mknod -.RB [ \-m -.IR mode ] -.I name -.I type -.I major -.I minor - +\fBmknod\fR [\fB-m \fImode\fR] \fIname type major minor .SH DESCRIPTION -.B mknod -Creates a special device file named -.I name -with major number -.IR major , -and minor number -.IR minor . - -.IR type -specifies what kind of special file will be created, +\fBmknod\fR reates a special device file named \fIname\fR +with major number \fImajor\fR, and minor number \fIminor\fR. +\fItype\fR specifies what kind of special file will be created and must be one of: .TP -.BR u \ or\ c +\fBu\fR or \fBc\fR A character device. .TP -.BR b +\fBb\fR A block device. - .SH OPTIONS .TP -.B \-m "mode" +\fB-m\fR \fImode\fR Set the mode of the new file based on the octal value of -.IR mode . - +\fImode\fR. .SH SEE ALSO -.IR mknod (2) +mknod (2) diff --git a/stat.1 b/stat.1 @@ -1,17 +1,13 @@ -.TH STAT 1 ubase\-VERSION +.TH STAT 1 ubase-VERSION .SH NAME -stat \- display file status +\fBstat\fR - display file status .SH SYNOPSIS -.B stat -.RB [ \-L ] -.RI [ file ...] +\fBstat\fR [\fB-L\fR] [\fIfile...\fR] .SH DESCRIPTION -.B stat -displays information about the given files or stdin if no files +\fBstat\fR displays information about the given files or stdin if no files are specified. .SH OPTIONS .TP -.B \-L -follow links +\fB-L\fR follow links .SH SEE ALSO -.IR stat (2) +stat (2) diff --git a/who.1 b/who.1 @@ -1,27 +1,18 @@ -.TH WHO 1 ubase\-VERSION +.TH WHO 1 ubase-VERSION .SH NAME -who \- print who has logged on +\fBwho\fR - print who has logged on .SH SYNOPSIS -.B who -.RB [ -m ] - +\fBwho\fR [\fB-m\fR] .SH DESCRIPTION -.B who -prints a list of who has logged on, their controlling tty, and the +\fBwho\fR prints a list of who has logged on, their controlling tty, and the time at which they logged on. .SH OPTIONS .TP -.B \-m -only show users on current tty +\fB-m\fR only show users on current tty .TP -.B \-l -also print LOGIN processes - +\fB-l\fR also print LOGIN processes .SH BUGS -.B who -relies on the utmp file to be updated responsibly. This +\fBwho\fR relies on the utmp file to be updated responsibly. This doesn't always happen, which can cause who to print completely bogus data. - -.SH SEE ALSO -.IR utmp (5) +utmp(5)