sbase/logger.1

.Dd 2015-10-08
.Dt LOGGER 1
.Os sbase
.Sh NAME
.Nm logger
.Nd make entries in the system log
.Sh SYNOPSIS
.Nm
.Op Fl is
.Op Fl p Ar priority
.Op Fl t Ar tag
.Op Ar message ...
.Sh DESCRIPTION
.Nm
provides a shell command interface to the
.Xr syslog 3
system log module and writes each
.Ar message
to the log.
If no
.Ar message
is given,
.Nm
logs stdin.
.Sh OPTIONS
.Bl -tag -width xxxxxxxxxxxx
.It Fl i
Add the logger process ID to each line in the log.
.It Fl p Ar priority
Set the message
.Ar priority
given symbolically as a
.Dq facility.level
pair. The default is
.Dq user.notice .
.It Fl s
Also log to stderr.
.It Fl t Ar tag
Add
.Ar tag
to each line in the log.
.El
.Sh SEE ALSO
.Xr syslogd 1 ,
.Xr syslog 3
.Sh STANDARDS
The
.Nm
utility is compliant with the
.St -p1003.1-2013
specification.
.Pp
The
.Op Fl ipst
flags are an extensions 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 LOGGER 1`
Add .Os sbase and sed replace to .Os sbase $(VERSION) in make install 2015-01-31 19:37:03 +00:00			`.Os sbase`
Implement POSIX 2008 compliant logger(1) 2014-12-04 11:34:39 +00:00			`.Sh NAME`
			`.Nm logger`
			`.Nd make entries in the system log`
			`.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`
Implement POSIX 2008 compliant logger(1) 2014-12-04 11:34:39 +00:00			`.Op Fl is`
			`.Op Fl p Ar priority`
			`.Op Fl t Ar tag`
			`.Op Ar message ...`
			`.Sh DESCRIPTION`
			`.Nm`
			`provides a shell command interface to the`
			`.Xr syslog 3`
Audit logger(1) 1) Update manpage to current style 2) Line spacing 3) Local variable grouping 4) check for getline >= 0 instead of != -1 5) error message cleanup 2015-03-06 23:08:43 +00:00			`system log module and writes each`
			`.Ar message`
			`to the log.`
			`If no`
			`.Ar message`
			`is given,`
			`.Nm`
			`logs stdin.`
Implement POSIX 2008 compliant logger(1) 2014-12-04 11:34:39 +00:00			`.Sh OPTIONS`
			`.Bl -tag -width xxxxxxxxxxxx`
			`.It Fl i`
Audit logger(1) 1) Update manpage to current style 2) Line spacing 3) Local variable grouping 4) check for getline >= 0 instead of != -1 5) error message cleanup 2015-03-06 23:08:43 +00:00			`Add the logger process ID to each line in the log.`
Implement POSIX 2008 compliant logger(1) 2014-12-04 11:34:39 +00:00			`.It Fl p Ar priority`
Audit logger(1) 1) Update manpage to current style 2) Line spacing 3) Local variable grouping 4) check for getline >= 0 instead of != -1 5) error message cleanup 2015-03-06 23:08:43 +00:00			`Set the message`
			`.Ar priority`
			`given symbolically as a`
Implement POSIX 2008 compliant logger(1) 2014-12-04 11:34:39 +00:00			`.Dq facility.level`
fix mandoc warnings - sort references in SEE ALSO section to section number, name. - cols.1: proper order of sections. - wrap lines to max 79 column length. 2015-01-31 13:43:27 +00:00			`pair. The default is`
Implement POSIX 2008 compliant logger(1) 2014-12-04 11:34:39 +00:00			`.Dq user.notice .`
			`.It Fl s`
Audit logger(1) 1) Update manpage to current style 2) Line spacing 3) Local variable grouping 4) check for getline >= 0 instead of != -1 5) error message cleanup 2015-03-06 23:08:43 +00:00			`Also log to stderr.`
Implement POSIX 2008 compliant logger(1) 2014-12-04 11:34:39 +00:00			`.It Fl t Ar tag`
Audit logger(1) 1) Update manpage to current style 2) Line spacing 3) Local variable grouping 4) check for getline >= 0 instead of != -1 5) error message cleanup 2015-03-06 23:08:43 +00:00			`Add`
			`.Ar tag`
			`to each line in the log.`
Implement POSIX 2008 compliant logger(1) 2014-12-04 11:34:39 +00:00			`.El`
			`.Sh SEE ALSO`
fix mandoc warnings - sort references in SEE ALSO section to section number, name. - cols.1: proper order of sections. - wrap lines to max 79 column length. 2015-01-31 13:43:27 +00:00			`.Xr syslogd 1 ,`
			`.Xr syslog 3`
Implement POSIX 2008 compliant logger(1) 2014-12-04 11:34:39 +00:00			`.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`
Implement POSIX 2008 compliant logger(1) 2014-12-04 11:34:39 +00:00			`specification.`
			`.Pp`
Audit logger(1) 1) Update manpage to current style 2) Line spacing 3) Local variable grouping 4) check for getline >= 0 instead of != -1 5) error message cleanup 2015-03-06 23:08:43 +00:00			`The`
Implement POSIX 2008 compliant logger(1) 2014-12-04 11:34:39 +00:00			`.Op Fl ipst`
Audit logger(1) 1) Update manpage to current style 2) Line spacing 3) Local variable grouping 4) check for getline >= 0 instead of != -1 5) error message cleanup 2015-03-06 23:08:43 +00:00			`flags are an extensions to that specification.`