From 57a19e3b866cb7d4991a20f4a2fd3629617e95f1 Mon Sep 17 00:00:00 2001 From: Hiltjo Posthuma Date: Fri, 30 Jan 2015 21:17:58 +0100 Subject: [PATCH] add some mandoc pages and fix some warnings - add .Os, it is mandatory. - don't redeclare .Nm when it's not needed. - fix some warnings (checked with mandoc -Tlint). - remove some leftover old stuff. --- basename.1 | 2 +- cal.1 | 3 ++- cat.1 | 3 ++- chgrp.1 | 40 +++++++++++++++++++++++----------------- chmod.1 | 3 ++- chown.1 | 39 +++++++++++++++++++++------------------ chroot.1 | 39 +++++++++++++++++++-------------------- cksum.1 | 3 ++- cmp.1 | 3 +-- cols.1 | 2 +- comm.1 | 3 ++- cron.1 | 3 +-- cut.1 | 7 ++++--- date.1 | 3 ++- dirname.1 | 3 ++- echo.1 | 3 ++- env.1 | 3 ++- expand.1 | 3 ++- expr.1 | 3 ++- false.1 | 3 ++- fold.1 | 3 ++- grep.1 | 7 ++++--- head.1 | 3 ++- kill.1 | 12 +++++------- link.1 | 2 ++ ln.1 | 5 +++-- logger.1 | 3 +-- logname.1 | 3 ++- ls.1 | 3 ++- mkdir.1 | 3 ++- mkfifo.1 | 3 ++- mv.1 | 3 ++- nice.1 | 3 ++- nl.1 | 5 ++--- nohup.1 | 3 ++- paste.1 | 3 ++- printf.1 | 4 ++-- pwd.1 | 2 +- renice.1 | 3 ++- rm.1 | 3 ++- rmdir.1 | 3 ++- sleep.1 | 3 ++- strings.1 | 2 +- tail.1 | 35 +++++++++++++++++++---------------- tee.1 | 3 ++- touch.1 | 3 ++- tr.1 | 3 ++- true.1 | 3 ++- tty.1 | 25 ++++++++++++++----------- unlink.1 | 29 +++++++++++++++-------------- wc.1 | 38 ++++++++++++++++++++------------------ yes.1 | 20 +++++++++++--------- 52 files changed, 231 insertions(+), 183 deletions(-) diff --git a/basename.1 b/basename.1 index 6a58548..5bab4a2 100644 --- a/basename.1 +++ b/basename.1 @@ -5,7 +5,7 @@ .Nm basename .Nd strip leading path components .Sh SYNOPSIS -.Nm basename +.Nm .Ar path .Op Ar suffix .Sh DESCRIPTION diff --git a/cal.1 b/cal.1 index 29162bc..a96a08d 100644 --- a/cal.1 +++ b/cal.1 @@ -1,10 +1,11 @@ .Dd January 18, 2015 .Dt CAL 1 sbase\-VERSION +.Os .Sh NAME .Nm cal .Nd show calendar .Sh SYNOPSIS -.Nm cal +.Nm .Op Fl 1 | Fl 3 | Fl y | Fl n Ar nmonths .Op Fl s | Fl m | Fl f Ar firstday .Op Fl c Ar columns diff --git a/cat.1 b/cat.1 index b78e7a9..d9202b5 100644 --- a/cat.1 +++ b/cat.1 @@ -1,10 +1,11 @@ .Dd January 16, 2015 .Dt CAT 1 sbase\-VERSION +.Os .Sh NAME .Nm cat .Nd concatenate files .Sh SYNOPSIS -.Nm cat +.Nm .Op Fl u .Op Ar file ... .Sh DESCRIPTION diff --git a/chgrp.1 b/chgrp.1 index 77bc69d..9e3a718 100644 --- a/chgrp.1 +++ b/chgrp.1 @@ -1,22 +1,28 @@ -.TH CHGRP 1 sbase\-VERSION -.SH NAME -chgrp \- change the file group ownership -.SH SYNOPSIS -.B chgrp -.RB [ \-R ] -.I groupname -.I file... -.SH DESCRIPTION -.B chgrp +.Dd January 30, 2015 +.Dt CHGRP 1 sbase\-VERSION +.Os +.Sh NAME +.Nm chgrp +.Nd change the file group ownership +.Sh SYNOPSIS +.Nm +.Op Fl R +.Ar groupname +.Op Ar file... +.Sh DESCRIPTION +.Nm sets the group id of the files specified by -.IR file +.Ar file to the gid of the group named -.IR group. +.Ar group. If the -.IR R +.Fl R flag is specified, this process is recursively applied to everything in -.IR file. - -.SH SEE ALSO -.IR chown (1) chown (2) chmod (1) chmod (2) getgrnam (3) +.Ar file . +.Sh SEE ALSO +.Xr chown 1 , +.Xr chown 2 , +.Xr chmod 1 , +.Xr chmod 2 , +.Xr getgrnam 3 diff --git a/chmod.1 b/chmod.1 index 06a4a80..41931c8 100644 --- a/chmod.1 +++ b/chmod.1 @@ -1,10 +1,11 @@ .Dd January 17, 2015 .Dt CHMOD 1 sbase\-VERSION +.Os .Sh NAME .Nm chmod .Nd change file mode .Sh SYNOPSIS -.Nm chmod +.Nm .Op Fl R .Ar mode .Op Ar file ... diff --git a/chown.1 b/chown.1 index 66c1407..1b70bf0 100644 --- a/chown.1 +++ b/chown.1 @@ -1,20 +1,23 @@ -.TH CHOWN 1 sbase\-VERSION -.SH NAME -chown \- change file ownership -.SH SYNOPSIS -.B chown -.RB [ \-Rr ] -.RI [ owner ][: group ] -.RI [ file ...] -.SH DESCRIPTION -.B chown +.Dd January 30, 2015 +.Dt CHOWN 1 sbase\-VERSION +.Os +.Sh NAME +.Nm chown +.Nd change file ownership +.Sh SYNOPSIS +.Nm +.Op Fl Rr +.Op Ar owner Op Ar :group +.Op Ar file ... +.Sh DESCRIPTION +.Nm changes the user or group ownership for the given files. -.SH OPTIONS -.TP -.B \-R -equivalent to -r. -.TP -.B \-r +.Sh OPTIONS +.Bl -tag -width Ds +.It Fl R +equivalent to \-r. +.It Fl r change directory ownership recursively. -.SH SEE ALSO -.IR chown (2) +.El +.Sh SEE ALSO +.Xr chown 2 diff --git a/chroot.1 b/chroot.1 index a556b95..9fe9ad7 100644 --- a/chroot.1 +++ b/chroot.1 @@ -1,26 +1,25 @@ -.TH CHROOT 1 sbase\-VERSION -.SH NAME -chroot \- invoke a command with a different root directory -.SH SYNOPSIS -.B chroot -.IR dir -.RI [ command -.RI [ arg ...]] - -.SH DESCRIPTION -.B chroot +.Dd January 30, 2015 +.Dt CHROOT 1 sbase\-VERSION +.Os +.Sh NAME +.Nm chroot +.Nd invoke a command with a different root directory +.Sh SYNOPSIS +.Nm +.Ar dir +.Op Ar command Op Ar arg ... +.Sh DESCRIPTION +.Nm runs -.IR command +.Ar command after changing the root directory to -.IR dir +.Ar dir with the -.B chroot +.Xr chroot 2 system call, and changing the working directory to the new root. - If -.IR command +.Op Ar command is not specified, an interactive shell is started in the new root. - -.SH SEE ALSO -.IR chroot (2) -.IR chdir (2) +.Sh SEE ALSO +.Xr chdir 2 , +.Xr chroot 2 diff --git a/cksum.1 b/cksum.1 index 4ddb7ce..4f55aaa 100644 --- a/cksum.1 +++ b/cksum.1 @@ -1,10 +1,11 @@ .Dd January 17, 2015 .Dt CKSUM 1 sbase\-VERSION +.Os .Sh NAME .Nm cksum .Nd compute file checksum .Sh SYNOPSIS -.Nm cksum +.Nm .Op Ar file ... .Sh DESCRIPTION .Nm diff --git a/cmp.1 b/cmp.1 index 02eb107..38dfb80 100644 --- a/cmp.1 +++ b/cmp.1 @@ -5,7 +5,7 @@ .Nm cmp .Nd compare two files .Sh SYNOPSIS -.Nm cmp +.Nm .Op Fl l | Fl s .Ar file1 file2 .Sh DESCRIPTION @@ -14,7 +14,6 @@ compares two files byte by byte. If the files differ, .Nm prints the byte and line number at which the difference occurred. -.Pp .Sh OPTIONS .Bl -tag -width Ds .It Fl l diff --git a/cols.1 b/cols.1 index ef6a801..6a4ec14 100644 --- a/cols.1 +++ b/cols.1 @@ -5,7 +5,7 @@ .Nm cols .Nd columnize output .Sh SYNOPSIS -.Nm cols +.Nm .Op Fl c Ar chars .Op Ar file ... .Sh DESCRIPTION diff --git a/comm.1 b/comm.1 index 6248483..db5253f 100644 --- a/comm.1 +++ b/comm.1 @@ -1,10 +1,11 @@ .Dd January 18, 2015 .Dt COMM 1 sbase\-VERSION +.Os .Sh NAME .Nm comm .Nd select or reject lines common to two files .Sh SYNOPSIS -.Nm comm +.Nm .Op Fl 123 .Ar file1 .Ar file2 diff --git a/cron.1 b/cron.1 index 7185bc8..48195c3 100644 --- a/cron.1 +++ b/cron.1 @@ -5,13 +5,12 @@ .Nm cron .Nd clock daemon .Sh SYNOPSIS -.Nm cron +.Nm .Op Fl f Ar file .Op Fl n .Sh DESCRIPTION .Nm schedules commands to be run at specified dates and times. -.Pp .Sh OPTIONS .Bl -tag -width Ds .It Fl f Ar file diff --git a/cut.1 b/cut.1 index 0ef177d..9777c39 100644 --- a/cut.1 +++ b/cut.1 @@ -1,17 +1,18 @@ .Dd January 22, 2015 .Dt CUT 1 sbase\-VERSION +.Os .Sh NAME .Nm cut .Nd extract columns of data .Sh SYNOPSIS -.Nm cut +.Nm .Fl b Ar list .Op Fl n .Op Ar file ... -.Nm cut +.Nm .Fl c Ar list .Op Ar file ... -.Nm cut +.Nm .Fl f Ar list .Op Fl d Ar delim .Op Fl s diff --git a/date.1 b/date.1 index 2d3bb89..67061b9 100644 --- a/date.1 +++ b/date.1 @@ -1,10 +1,11 @@ .Dd January 23, 2015 .Dt DATE 1 sbase\-VERSION +.Os .Sh NAME .Nm date .Nd print date and time .Sh SYNOPSIS -.Nm date +.Nm .Op Fl d Ar time .Op Fl u .Op Cm + Ns Ar format diff --git a/dirname.1 b/dirname.1 index 7397051..afbc12e 100644 --- a/dirname.1 +++ b/dirname.1 @@ -1,10 +1,11 @@ .Dd January 23, 2015 .Dt DIRNAME 1 sbase\-VERSION +.Os .Sh NAME .Nm dirname .Nd strip final path component .Sh SYNOPSIS -.Nm dirname +.Nm .Ar path .Sh DESCRIPTION .Nm diff --git a/echo.1 b/echo.1 index db333f9..81190f2 100644 --- a/echo.1 +++ b/echo.1 @@ -1,10 +1,11 @@ .Dd January 23, 2015 .Dt ECHO 1 sbase\-VERSION +.Os .Sh NAME .Nm echo .Nd print arguments .Sh SYNOPSIS -.Nm echo +.Nm .Op Fl n .Op Ar string ... .Sh DESCRIPTION diff --git a/env.1 b/env.1 index bd6672b..cf57f88 100644 --- a/env.1 +++ b/env.1 @@ -1,10 +1,11 @@ .Dd January 24, 2015 .Dt ENV 1 sbase\-VERSION +.Os .Sh NAME .Nm env .Nd modify the environment, then print it or run a command .Sh SYNOPSIS -.Nm env +.Nm .Op Fl i .Oo Fl u Ar variable Oc ... .Oo Ar variable Ns = Ns Ar value Oc ... diff --git a/expand.1 b/expand.1 index ffdaea6..5c6a2a2 100644 --- a/expand.1 +++ b/expand.1 @@ -1,10 +1,11 @@ .Dd January 25, 2015 .Dt EXPAND 1 sbase\-VERSION +.Os .Sh NAME .Nm expand .Nd expand tabs to spaces .Sh SYNOPSIS -.Nm expand +.Nm .Op Fl i .Op Fl t Ar tablist .Op Ar file ... diff --git a/expr.1 b/expr.1 index ad08057..f133abf 100644 --- a/expr.1 +++ b/expr.1 @@ -1,10 +1,11 @@ .Dd January 25, 2015 .Dt EXPR 1 sbase\-VERSION +.Os .Sh NAME .Nm expr .Nd evaluate expression .Sh SYNOPSIS -.Nm expr +.Nm .Ar expression .Sh DESCRIPTION .Nm diff --git a/false.1 b/false.1 index 0dc65a8..a237c67 100644 --- a/false.1 +++ b/false.1 @@ -1,10 +1,11 @@ .Dd January 16, 2015 .Dt FALSE 1 sbase\-VERSION +.Os .Sh NAME .Nm false .Nd return failure .Sh SYNOPSIS -.Nm false +.Nm .Sh DESCRIPTION .Nm returns a status code indicating failure. diff --git a/fold.1 b/fold.1 index 7638729..da4567e 100644 --- a/fold.1 +++ b/fold.1 @@ -1,10 +1,11 @@ .Dd January 25, 2015 .Dt FOLD 1 sbase\-VERSION +.Os .Sh NAME .Nm fold .Nd wrap lines to width .Sh SYNOPSIS -.Nm fold +.Nm .Op Fl bs .Op Fl w Ar width .Op Fl N diff --git a/grep.1 b/grep.1 index bb43a2c..79145cd 100644 --- a/grep.1 +++ b/grep.1 @@ -1,10 +1,11 @@ .Dd November 21, 2014 .Dt GREP 1 sbase\-VERSION +.Os .Sh NAME .Nm grep .Nd search files for patterns .Sh SYNOPSIS -.Nm grep +.Nm .Op Fl EFHchilnqsvx .Op Fl e Ar pattern .Op Fl f Ar file @@ -56,8 +57,8 @@ Print nothing, only return status. Suppress the error messages ordinarily written for nonexistent or unreadable files. .It Fl v Select lines which do -.B not -Match the pattern. +.Sy not +match the pattern. .It Fl w The expression is searched for as a word (as if surrounded by '\<' and '\>'). .It Fl x diff --git a/head.1 b/head.1 index fb29278..97e432e 100644 --- a/head.1 +++ b/head.1 @@ -1,10 +1,11 @@ .Dd January 25, 2015 .Dt HEAD 1 sbase\-VERSION +.Os .Sh NAME .Nm head .Nd display initial lines of files .Sh SYNOPSIS -.Nm head +.Nm .Op Fl n Ar num .Op Fl N .Op Ar file ... diff --git a/kill.1 b/kill.1 index dd6e1bf..48af1c2 100644 --- a/kill.1 +++ b/kill.1 @@ -5,22 +5,20 @@ .Nm kill .Nd signal processes .Sh SYNOPSIS -.Nm kill +.Nm .Op Fl s Ar signal_name .Ar pid ... -.Nm kill +.Nm .Fl l Op Ar exit_status -.Nm kill +.Nm .Fl Ar signal_name .Ar pid ... -.Nm kill +.Nm .Fl Ar signal_number .Ar pid ... .Sh DESCRIPTION .Nm -by default sends a -.I TERM -signal to the given processes. +by default sends a TERM signal to the given processes. .Sh OPTIONS .Bl -tag -width Ds .It Fl s Ar signal_name diff --git a/link.1 b/link.1 index 1d3cea4..61af963 100644 --- a/link.1 +++ b/link.1 @@ -1,7 +1,9 @@ .Dd January 25, 2015 .Dt LINK 1 sbase\-VERSION +.Os .Sh NAME .Nm link +.Nd call the link function .Ar target .Ar name .Sh DESCRIPTION diff --git a/ln.1 b/ln.1 index 28f74b9..5816397 100644 --- a/ln.1 +++ b/ln.1 @@ -1,15 +1,16 @@ .Dd January 26, 2015 .Dt LN 1 sbase\-VERSION +.Os .Sh NAME .Nm ln .Nd link files .Sh SYNOPSIS -.Nm ln +.Nm .Op Fl f .Op Fl L | Fl P | Fl s .Ar target .Op Ar name -.Nm ln +.Nm .Op Fl f .Op Fl L | Fl P | Fl s .Ar target ... diff --git a/logger.1 b/logger.1 index 99d76a7..23adc89 100644 --- a/logger.1 +++ b/logger.1 @@ -5,7 +5,7 @@ .Nm logger .Nd make entries in the system log .Sh SYNOPSIS -.Nm logger +.Nm .Op Fl is .Op Fl p Ar priority .Op Fl t Ar tag @@ -15,7 +15,6 @@ provides a shell command interface to the .Xr syslog 3 system log module. -.Pp .Sh OPTIONS .Bl -tag -width xxxxxxxxxxxx .It Fl i diff --git a/logname.1 b/logname.1 index 7ba7a68..0848e78 100644 --- a/logname.1 +++ b/logname.1 @@ -1,10 +1,11 @@ .Dd January 26, 2015 .Dt LOGNAME 1 sbase\-VERSION +.Os .Sh NAME .Nm logname .Nd show login name .Sh SYNOPSIS -.Nm logname +.Nm .Sh DESCRIPTION .Nm writes the login name of the current user to stdout. diff --git a/ls.1 b/ls.1 index 0bb6269..25ba2dc 100644 --- a/ls.1 +++ b/ls.1 @@ -1,10 +1,11 @@ .Dd January 20, 2015 .Dt LS 1 sbase\-VERSION +.Os .Sh NAME .Nm ls .Nd list directory contents .Sh SYNOPSIS -.Nm ls +.Nm .Op Fl 1acdFHhiLlrtU .Op Ar file ... .Sh DESCRIPTION diff --git a/mkdir.1 b/mkdir.1 index 535af96..05f83dc 100644 --- a/mkdir.1 +++ b/mkdir.1 @@ -1,10 +1,11 @@ .Dd January 26, 2015 .Dt MKDIR 1 sbase\-VERSION +.Os .Sh NAME .Nm mkdir .Nd create directories .Sh SYNOPSIS -.Nm mkdir +.Nm .Op Fl p .Op Fl m Ar mode .Ar name ... diff --git a/mkfifo.1 b/mkfifo.1 index 91e4c8b..bbe57e3 100644 --- a/mkfifo.1 +++ b/mkfifo.1 @@ -1,10 +1,11 @@ .Dd January 28, 2015 .Dt MKFIFO 1 sbase\-VERSION +.Os .Sh NAME .Nm mkfifo .Nd create named pipes .Sh SYNOPSIS -.Nm mkfifo +.Nm .Op Fl m Ar mode .Ar name ... .Sh DESCRIPTION diff --git a/mv.1 b/mv.1 index 55c111e..83648fa 100644 --- a/mv.1 +++ b/mv.1 @@ -1,10 +1,11 @@ .Dd January 28, 2015 .Dt MV 1 sbase\-VERSION +.Os .Sh NAME .Nm mv .Nd move files and directories .Sh SYNOPSIS -.Nm mv +.Nm .Op Fl f | Fl i .Ar source ... .Ar destination diff --git a/nice.1 b/nice.1 index bfd955c..6357353 100644 --- a/nice.1 +++ b/nice.1 @@ -1,10 +1,11 @@ .Dd January 28, 2015 .Dt NICE 1 sbase\-VERSION +.Os .Sh NAME .Nm nice .Nd run command with altered niceness .Sh SYNOPSIS -.Nm nice +.Nm .Op Fl n Ar inc .Ar cmd .Op Ar arg ... diff --git a/nl.1 b/nl.1 index f8e7cd8..83ed50e 100644 --- a/nl.1 +++ b/nl.1 @@ -5,7 +5,7 @@ .Nm nl .Nd line numbering filter .Sh SYNOPSIS -.Nm nl +.Nm .Op Fl b Ar type .Op Fl i Ar incr .Op Fl s Ar sep @@ -33,8 +33,7 @@ Only non-empty lines (default). Only lines which match .Ar expr , a regular expression as defined in -.IR regex (7). -.TP +.Xr regex 7 .El .It Fl i Ar incr Defines the increment between numbered lines. diff --git a/nohup.1 b/nohup.1 index 83cf1e2..b8c1372 100644 --- a/nohup.1 +++ b/nohup.1 @@ -1,10 +1,11 @@ .Dd January 28, 2015 .Dt NOHUP 1 sbase\-VERSION +.Os .Sh NAME .Nm nohup .Nd run command immune to hangups .Sh SYNOPSIS -.Nm nohup +.Nm .Ar cmd .Op Ar arg ... .Sh DESCRIPTION diff --git a/paste.1 b/paste.1 index 7e426bc..eb7ff44 100644 --- a/paste.1 +++ b/paste.1 @@ -1,10 +1,11 @@ .Dd January 29, 2015 .Dt PASTE 1 sbase\-VERSION +.Os .Sh NAME .Nm paste .Nd merge lines of files in parallel or sequentially .Sh SYNOPSIS -.Nm paste +.Nm .Op Fl s .Op Fl d Ar list .Ar file ... diff --git a/printf.1 b/printf.1 index 23585c9..5d3a4da 100644 --- a/printf.1 +++ b/printf.1 @@ -39,11 +39,11 @@ .Nm printf .Nd formatted output .Sh SYNOPSIS -.Nm printf +.Nm .Ar format .Op Ar argument ... .Sh DESCRIPTION -.Nm printf +.Nm formats and prints its arguments, after the first, under control of the .Ar format . diff --git a/pwd.1 b/pwd.1 index 11aa7f8..143c0f6 100644 --- a/pwd.1 +++ b/pwd.1 @@ -5,7 +5,7 @@ .Nm pwd .Nd print working directory .Sh SYNOPSIS -.Nm pwd +.Nm .Op Fl LP .Sh DESCRIPTION .Nm diff --git a/renice.1 b/renice.1 index 127ccc0..6a48fd9 100644 --- a/renice.1 +++ b/renice.1 @@ -1,10 +1,11 @@ .Dd January 29, 2015 .Dt RENICE 1 sbase\-VERSION +.Os .Sh NAME .Nm renice .Nd change niceness of processes .Sh SYNOPSIS -.Nm renice +.Nm .Fl n Ar inc .Op Fl g | Fl p | Fl u .Ar id ... diff --git a/rm.1 b/rm.1 index 6ba2e13..58c32f1 100644 --- a/rm.1 +++ b/rm.1 @@ -1,10 +1,11 @@ .Dd January 30, 2015 .Dt RM 1 sbase\-VERSION +.Os .Sh NAME .Nm rm .Nd remove directory entries .Sh SYNOPSIS -.Nm rm +.Nm .Op Fl f | Fl i .Op Fl Rr .Ar file ... diff --git a/rmdir.1 b/rmdir.1 index ba4c1d3..63cd0ed 100644 --- a/rmdir.1 +++ b/rmdir.1 @@ -1,10 +1,11 @@ .Dd January 30, 2015 .Dt RMDIR 1 sbase\-VERSION +.Os .Sh NAME .Nm rmdir .Nd remove directories .Sh SYNOPSIS -.Nm rmdir +.Nm .Op Fl p .Ar directory ... .Sh DESCRIPTION diff --git a/sleep.1 b/sleep.1 index d4ca314..f4ebbee 100644 --- a/sleep.1 +++ b/sleep.1 @@ -1,10 +1,11 @@ .Dd January 30, 2015 .Dt SLEEP 1 sbase\-VERSION +.Os .Sh NAME .Nm sleep .Nd wait for a number of seconds .Sh SYNOPSIS -.Nm sleep +.Nm .Ar num .Sh DESCRIPTION .Nm diff --git a/strings.1 b/strings.1 index 47727df..5746fd6 100644 --- a/strings.1 +++ b/strings.1 @@ -5,7 +5,7 @@ .Nm strings .Nd print the strings of pritable characters in files .Sh SYNOPSIS -.Nm strings +.Nm .Op Ar file ... .Sh DESCRIPTION .Nm diff --git a/tail.1 b/tail.1 index a20262e..02468e1 100644 --- a/tail.1 +++ b/tail.1 @@ -1,20 +1,23 @@ -.TH TAIL 1 sbase\-VERSION -.SH NAME -tail \- display final lines of files -.SH SYNOPSIS -.B tail -.RB [ \-n -.IR lines ] -.RI [ file ] -.SH DESCRIPTION -.B tail +.Dd January 30, 2015 +.Dt TAIL 1 sbase\-VERSION +.Os +.Sh NAME +.Nm tail +.Nd display final lines of files +.Sh SYNOPSIS +.Nm +.Op Fl n Ar lines +.Op Ar file +.Sh DESCRIPTION +.Nm writes the last 10 lines of the file to stdout. If no file is given, tail reads from stdin. -.SH OPTIONS -.TP -.BI \-n " lines" +.Sh OPTIONS +.Bl -tag -width Ds +.It Fl n Ar lines outputs the given number of lines. If -.I lines +.El +.Ar lines begins with '+' it is used as an offset from the beginning of the file. -.SH SEE ALSO -.IR head (1) +.Sh SEE ALSO +.Xr head 1 diff --git a/tee.1 b/tee.1 index 81d95ed..457fc84 100644 --- a/tee.1 +++ b/tee.1 @@ -1,10 +1,11 @@ .Dd January 23, 2015 .Dt TEE 1 sbase\-VERSION +.Os .Sh NAME .Nm tee .Nd duplicate stdin .Sh SYNOPSIS -.Nm tee +.Nm .Op Fl ai .Op Ar file ... .Sh DESCRIPTION diff --git a/touch.1 b/touch.1 index a1c2ce0..74237e0 100644 --- a/touch.1 +++ b/touch.1 @@ -1,10 +1,11 @@ .Dd January 20, 2014 .Dt TOUCH 1 sbase\-VERSION +.Os .Sh NAME .Nm touch .Nd set file timestamps .Sh SYNOPSIS -.Nm touch +.Nm .Op Fl acm .Op Fl t Ar stamp .Ar file ... diff --git a/tr.1 b/tr.1 index 75d0658..3cc1681 100644 --- a/tr.1 +++ b/tr.1 @@ -1,10 +1,11 @@ .Dd January 16, 2015 .Dt TR 1 sbase\-VERSION +.Os .Sh NAME .Nm tr .Nd translate characters .Sh SYNOPSIS -.Nm tr +.Nm .Op Fl c | Fl C .Op Fl sd .Ar set1 set2 diff --git a/true.1 b/true.1 index 63c68d5..b7319e1 100644 --- a/true.1 +++ b/true.1 @@ -1,10 +1,11 @@ .Dd January 16, 2015 .Dt TRUE 1 sbase\-VERSION +.Os .Sh NAME .Nm true .Nd return success .Sh SYNOPSIS -.Nm true +.Nm .Sh DESCRIPTION .Nm returns a status code indicating success diff --git a/tty.1 b/tty.1 index 8e4a919..ba97b54 100644 --- a/tty.1 +++ b/tty.1 @@ -1,13 +1,16 @@ -.TH TTY 1 sbase\-VERSION -.SH NAME -tty \- print terminal name -.SH SYNOPSIS -.B tty -.SH DESCRIPTION -.B tty +.Dd January 30, 2015 +.Dt TTY 1 sbase\-VERSION +.Os +.Sh NAME +.Nm tty +.Nd print terminal name +.Sh SYNOPSIS +.Nm +.Sh DESCRIPTION +.Nm prints the name of the terminal open on stdin. -.P -The status code is 0 if stdin is a terminal, and 1 if not. If an error occurred +.Pp +The status code is 0 if stdin is a terminal, and 1 if not. If an error occurred the status code is 2. -.SH SEE ALSO -.IR ttyname (3) +.Sh SEE ALSO +.Xr ttyname 3 diff --git a/unlink.1 b/unlink.1 index 0aa0bc9..789b35d 100644 --- a/unlink.1 +++ b/unlink.1 @@ -1,16 +1,17 @@ -.TH UNLINK 1 sbase\-VERSION -.SH NAME -unlink \- call the unlink function -.SH SYNOPSIS -.B unlink -.RB file -.SH DESCRIPTION -.B unlink +.Dd January 30, 2015 +.Dt UNLINK 1 sbase\-VERSION +.Os +.Sh NAME +.Nm unlink +.Nd call the unlink function +.Sh SYNOPSIS +.Nm +.Ar file +.Sh DESCRIPTION +.Nm calls the -.IR unlink +.Xr unlink 2 function on -.IR file. - - -.SH SEE ALSO -.IR unlink (2) +.Ar file. +.Sh SEE ALSO +.Xr unlink 2 diff --git a/wc.1 b/wc.1 index 70c1e6f..86842cf 100644 --- a/wc.1 +++ b/wc.1 @@ -1,25 +1,27 @@ -.TH WC 1 sbase\-VERSION -.SH NAME -wc \- word count -.SH SYNOPSIS -.B wc -.RB [ \-clmw ] -.RI [ file ...] -.SH DESCRIPTION -.B wc +.Dd January 30, 2015 +.Dt WC 1 sbase\-VERSION +.Os +.Sh NAME +.Nm wc +.Nd word count +.Sh SYNOPSIS +.Nm +.Op Fl clmw +.Op Ar file ... +.Sh DESCRIPTION +.Nm +.Pp prints the number of lines, words, and bytes in each file. If any flags are given, wc will print only the requested information. If no files are given, wc reads stdin. -.SH OPTIONS -.TP -.B \-c +.Sh OPTIONS +.Bl -tag -width Ds +.It Fl c print the number of bytes. -.TP -.B \-l +.It Fl l print the number of lines. -.TP -.B \-m +.It Fl m print the number of characters, not bytes. -.TP -.B \-w +.It Fl w print the number of words. +.El diff --git a/yes.1 b/yes.1 index 89e07cb..4b93383 100644 --- a/yes.1 +++ b/yes.1 @@ -1,10 +1,12 @@ -.TH YES 1 sbase\-VERSION -.SH NAME -yes \- output a string repeatedly -.SH SYNOPSIS -.B yes -.RB [ string ... ] -.SH DESCRIPTION -.B yes +.Dd January 30, 2015 +.Dt YES 1 sbase\-VERSION +.Os +.Sh NAME +.Nm yes +.Nd output a string repeatedly +.Sh SYNOPSIS +.Nm +.Op Ar string ... +.Sh DESCRIPTION +.Nm will repeatedly output 'y' or the strings specified. -