Document the fact (bug?) that the -a option will normally process

root's calendar files three times, once each for root, toor and
daemon.

This relates to bug 246943, but does not solve it.  See discussion in
bug report for more details.

PR:		246943
Reported by:	wcarson.bugzilla@disillusion.net
This commit is contained in:
Greg Lehey 2020-09-29 05:49:45 +00:00
parent a9f476580e
commit 314c5b3583

View File

@ -70,9 +70,24 @@ Print lines from today and the next
.Ar num
days (forward, future).
.It Fl a
Process the ``calendar'' files of all users and mail the results
Process the ``calendar'' files for users found in
.Pa /etc/passwd
and mail the results
to them.
This requires super-user privileges.
This can result in multiple messages for specific files, since
.Pa /etc/passwd
does not require home directories to be unique.
In particular, by default
.Ar root ,
.Ar toor
and
.Ar daemon
share the same home directory.
If this directory contains calendar information,
.Nm
will process the file three times.
.Pp
This option requires super-user privileges.
.It Fl B Ar num
Print lines from today and the previous
.Ar num