sbase/head.1

.Dd 2015-10-08
.Dt HEAD 1
.Os sbase
.Sh NAME
.Nm head
.Nd display initial lines of files
.Sh SYNOPSIS
.Nm
.Op Fl n Ar num | Fl Ns Ar num
.Op Ar file ...
.Sh DESCRIPTION
.Nm
writes
.Ar num
lines of each
.Ar file
to stdout.
If no
.Ar file
is given
.Nm
reads from stdin.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl n Ar num | Fl Ns Ar num
Display initial
.Ar num
|
.Sy N
lines.
Default is 10.
.El
.Sh SEE ALSO
.Xr tail 1
.Sh STANDARDS
The
.Nm
utility is compliant with the
.St -p1003.1-2013
specification.
.Pp
The
.Op Fl Ns num
syntax is an extension to that specification.
Use ISO-date-format in manpages The one specified by mdoc is hard to read for non-native speakers from countries which read the date day-first (like Germany, Greece, North-Korea, Swamp,...). This is also consistent with how we generally specify dates at suckless.org. 2015-10-08 15:15:08 +00:00			`.Dd 2015-10-08`
remove sbase-VERSION from man page, fix sponge.1 date 2015-01-31 13:20:02 +00:00			`.Dt HEAD 1`
Add .Os sbase and sed replace to .Os sbase $(VERSION) in make install 2015-01-31 19:37:03 +00:00			`.Os sbase`
Add mandoc-manpage for head(1) and clean up code and mark it as finished in the README. 2015-01-25 21:01:26 +00:00			`.Sh NAME`
			`.Nm head`
			`.Nd display initial lines of files`
			`.Sh SYNOPSIS`
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. 2015-01-30 20:17:58 +00:00			`.Nm`
head: Fix usage and manpage -N is not a flag but rather a number specification. Be consistent and use -num to be consistent with -n num. num is properly highlighted now as well. 2015-03-05 08:10:00 +00:00			`.Op Fl n Ar num \| Fl Ns Ar num`
Add mandoc-manpage for head(1) and clean up code and mark it as finished in the README. 2015-01-25 21:01:26 +00:00			`.Op Ar file ...`
			`.Sh DESCRIPTION`
			`.Nm`
			`writes`
			`.Ar num`
			`lines of each`
			`.Ar file`
			`to stdout.`
man pages: improve consistency 2015-02-01 19:52:28 +00:00			`If no`
			`.Ar file`
			`is given`
Add mandoc-manpage for head(1) and clean up code and mark it as finished in the README. 2015-01-25 21:01:26 +00:00			`.Nm`
fix head manpage 2011-05-25 10:56:04 +00:00			`reads from stdin.`
Add mandoc-manpage for head(1) and clean up code and mark it as finished in the README. 2015-01-25 21:01:26 +00:00			`.Sh OPTIONS`
			`.Bl -tag -width Ds`
head: Fix usage and manpage -N is not a flag but rather a number specification. Be consistent and use -num to be consistent with -n num. num is properly highlighted now as well. 2015-03-05 08:10:00 +00:00			`.It Fl n Ar num \| Fl Ns Ar num`
Make wording more consistent in head.1 and tail.1 2015-02-09 19:04:54 +00:00			`Display initial`
Add mandoc-manpage for head(1) and clean up code and mark it as finished in the README. 2015-01-25 21:01:26 +00:00			`.Ar num`
			`\|`
			`.Sy N`
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command. 2020-03-01 22:37:31 +00:00			`lines.`
			`Default is 10.`
Add mandoc-manpage for head(1) and clean up code and mark it as finished in the README. 2015-01-25 21:01:26 +00:00			`.El`
			`.Sh SEE ALSO`
			`.Xr tail 1`
			`.Sh STANDARDS`
			`The`
			`.Nm`
			`utility is compliant with the`
POSIX 2013 audit Mostly manpage-shuffling according to the changes in the corrigendum, wording changes and more idiomatic expressions. All this is finished up by marking the POSIX 2013 conformant tools with .St -p1003.1-2013 which is not available in older mandoc builds or nroff, but which reflects what we actually did, so who cares? This is a huge step and it's not far until we can release sbase 0.1. 2015-03-27 16:22:48 +00:00			`.St -p1003.1-2013`
Add mandoc-manpage for head(1) and clean up code and mark it as finished in the README. 2015-01-25 21:01:26 +00:00			`specification.`
			`.Pp`
Remove judging word from head.1 and tail.1 as well If it's obsolete, why include it? No, the point here is that the ARGNUM-syntax has it's place among us fellow neckbeards. Let's not degrade it. 2015-03-13 22:54:13 +00:00			`The`
head: Fix usage and manpage -N is not a flag but rather a number specification. Be consistent and use -num to be consistent with -n num. num is properly highlighted now as well. 2015-03-05 08:10:00 +00:00			`.Op Fl Ns num`
			`syntax is an extension to that specification.`