svn commit: r366243 - head/usr.bin/calendar

[Greg Lehey]

Author: grog
Date: Tue Sep 29 05:49:45 2020
New Revision: 366243
URL: https://svnweb.freebsd.org/changeset/base/366243

Log:
  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 at disillusion.net

Modified:
  head/usr.bin/calendar/calendar.1

Modified: head/usr.bin/calendar/calendar.1
==============================================================================
--- head/usr.bin/calendar/calendar.1	Tue Sep 29 05:08:45 2020	(r366242)
+++ head/usr.bin/calendar/calendar.1	Tue Sep 29 05:49:45 2020	(r366243)
@@ -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